Overview

Map your online store products to Cropster to synchronize orders and automate inventory tracking. This process ensures that every Product variant sold in Shopify or WooCommerce correctly corresponds to a roast profile or inventory item in C-sar.

Prerequisites

• An active shop integration (Shopify or WooCommerce/Beans).
• Unique SKUs assigned to every product variant in your online store.
• WooCommerce users: 
  • WooCommerce version: 5.8 or higher.
  • Product type: All products must be variable products to synchronize with Cropster.

Mapping Products and Product variants

The system prompts you to map products the first time you connect a store and whenever it detects new items during synchronization.

Step 1: Select products

1. Review the list of newly detected products.
2. Uncheck non-coffee items (e.g., merchandise, equipment).
3. Select the Product type: Product or Bundle.
4. Choose the corresponding Product name in Cropster from the dropdown menu.
5. Click Next step.

Step 2: Map units and Grind styles

1. Review the Package units and Grind styles.
2. Uncheck any options that refer to non-coffee items.
3. Select the Option name in Cropster for all weight units.
4. Select the appropriate Grind style from the list. (Optional) Type a name and click + Create [grind style] to add a new style immediately.
5. Click Next step.

Step 3: Define variants

1. Review the pre-filled variants. The system matches them based on the SKUs and options defined in the previous steps.
2. If an SKU is missing, return to your online store, assign the SKU, and click Sync again.
3. Click Next once all variants are correct.
    

Step 4: Define bundles 

1. Identify the product variants included in each bundle.
2. Click Save and finish.

New products now appear on the Products overview page with an Unreviewed status.

Step 5: Link Products to Profiles

To finalize mapping, you must link products to their specific production groups.

1. Navigate to Commerce > Products.
2. Click Edit next to the product you wish to map.
   

   

3. Scroll to Type and select the Profile category.
4. Select a *Profile group (for single-origins/pre-roast blends) or a Blend profile (for post-roast blends).
   

   

5. (Optional) Update the *Name, Cropster Product ID, or Notes.
   *Indicates mandatory fields.
6. Click Update product. The status changes to Reviewed.

Mapping new products after the initial setup

1. If you add new items to your online store, use one of these methods to map them:
   • Via Orders overview page: Navigate to Commerce > Orders and click Synchronize.
     

     

   • Via Products overview page: Navigate to Commerce > Products and click Synchronize.
     

     

2. If new items are detected, click Map new products and variants and follow the mapping steps above.

FAQs

How do I fix a product that was mapped incorrectly?

1. Navigate to Commerce > Products and select the Product name.
2. Click Edit.
   

   

3. Click Unlink and then Update product.
   

   

    

4. Run a new synchronization to re-map the item.