Requirements for successful Product mapping

1. Each Product variant needs a unique SKU
2. The external shop must be connected to your Cropster account

SKUs

The connection between the Products in your online shop and your Cropster account is established through unique SKU (Stock Keeping Unit) numbers.

Before you proceed with mapping the Products, it will be necessary to assign a unique SKU to each of your Product variants in Shopify or WooCommerce.

If you connect multiple shops selling the same products to your Cropster account, make sure to use the same SKU number for the Product variants.

Shopify/Woocommerce/Beans integration

If you have not yet connected your external Shopify or Woocommerce/Beans shop to Cropster, follow the appropriate article to do so before proceeding:

• Setting up the Shopify Integration
• Setting up the WooCommerce/Beans Integration

Setting up new Products and Variants

The steps are as follows:

1. Select Products
2. Map options
3. Define variants
4. Define bundles

Selecting Products

In this step, all newly detected Products will be displayed for each store that you are synchronizing. 
All new Products are checked by default. 
By selecting the checkbox labeled 'Include previously ignored or unlinked Products,' you can also include additional products that have not been mapped before.
 

1. Go through the Products one by one. 
   Uncheck all non-coffee Products like merchandise, coffee equipment, or coffee that you no longer offer for sale. 
2. Select the Product type:
   • Product
   • Bundle
3. Select the Product's name in Cropster by clicking on the dropdown. 
4. Click Next step to go to the mapping options.
   

   

Mapping units and grind styles

Next, you will be directed to the Map options page.

You need to map all the different options contained within the Products you have chosen to sync
Cropster supports two different types of options:

Package units and Grind styles.

1. By default, all options will be checked and already mapped if the option is recognized. 
2. Uncheck options that refer to non-coffee products. 
3. Map the Units: 
   
   • Select the respective Option name in Cropster from the list for all weight unit options. 
   • If the weight unit is not available, please create a support ticket to request the unit to be added.
4. Map all Grind styles:
   • For each option related to Grind styles, ensure you check the corresponding box and then choose the appropriate Grind style from the provided list for each option.
   • If the grind style does not exist yet, type in the name and click + Create [grind style] to add that Grind style on the fly.
     Learn how to add new Grind styles.
5. Click Next step to define variants.

Defining variants

Next, you will be asked to match the individual Product variants with the correct Unit and Grind style based on the options you defined in the previous step. 

1. All products and their variants will show up in this step with their SKUs.
   • By default, all units and grind styles should already be prefilled, according to how you have mapped the options in the previous step. 
   • If a product has no SKU defined, an error message appears:
     

     

     
      
2. Go back to your external shop and define an SKU for all products missing an SKU, then click Sync again. 
3. Double-check the variants to make sure there are no mapping errors. 
4. Once you are satisfied, click Next to define Product bundles.

Defining bundles

If you checked the Bundle checkbox next to any of the products in the first step, you will be asked to define your bundle components on this step.

1. All Product bundles and their variants will show up in this step with their SKUs. 
2. Select the product variants included in the bundle per variant. 
3. Click Save and finish once you are happy with the result. 

After the initial mapping process you will be forwarded to the Products overview page where all products you have created, will show up as Unreviewed.

Mapping Products to Profiles

In this step, you need to link your Products to Profile groups or Blend profiles.

1. Log in to the online platform C-sar. 
2. Navigate to Commerce > Products on the main menu bar.
3. You will be directed to the Products overview page. 
4. Click Edit on the right side of the page, at the Product you would like to map. 
5. Scroll down to Type and select the type of profile you would like to map the product to.
6. Select the Profile group for Single origin/ Pre-Roast blend or select the Blend profile for Post-roast blends.
   

   

7. (Optional) Edit the Product name, add a Cropster Product ID, or Notes to your product.
8. Click Update product to confirm your changes. 
9. The status of the Product changes now to Reviewed, which indicates the Product is ready.
10. Proceed with the steps above for all Products. 
    

    

Mapping new Products after the initial setup

To initiate the mapping process for newly added products after the initial mapping process, you have two options:

• Via the Orders overview page
• Via the Products page

Via the Orders overview page

1. Log in to the online platform C-sar.
2. Navigate to Commerce > Orders on the main menu bar.
3. You will be directed to the Orders overview page. 
4. Click the Synchronize button on the top right side of the page. 
   

   

5. If there are new Products or mapping options available from the online store, you'll be forwarded to the Map new Products and variants page.
6. To view products that have been previously ignored or not linked, simply select the checkbox labeled Include previously ignored or unlinked products.
7. Follow these steps to map the new Products and options. 

Via the Products overview page

1. Log in to the online platform C-sar.
2. Navigate to Commerce > Products on the main menu bar.
3. You will be directed to the Products overview page. 
4. Click the Synchronize button on the top right side of the page. 
   

   

5. If there are new Products or mapping options available from the online store, a warning pops up at the top:
   

   

6. Click the Map new products and variants button to get to the Map new products and variants page.
7. Follow the steps above to map the new products and options. 

FAQs

What if I mapped the wrong Product?
You can easily fix that by following the steps below: 

1. Navigate to Orders > Products and look for the Product you have mapped incorrectly.
2. Access the Product detail page by clicking on the Product name.
   

   

3. Click on the Edit button. 
   

   

4. Click Unlink to unmap the Product.
   

   

5. Click on Update product.
6. Now you can initiate the Product mapping when syncing the shop. 

What if I mapped the wrong unit or grind style?
You can always review your options in the Commerce settings. 

1. Navigate to the Gear icon on the top right side of the online platform C-sar.
2. Select Commerce Settings > Mapped options. 
   

   

3. By clicking on the Edit option, you can review and revise the Mapped units and grind styles with external shops.

Congratulations! You have learned how to map your Products.

Your opinion matters. If you have further questions, feedback, or concerns, please submit a support ticket directly from support.cropster.com.