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 (Required) from the dropdown menu. Products that exactly match one in Cropster are linked automatically. To add a new product, type a name and click + Create "[name]". To create all remaining products at once, click + Create remaining in the info message.
5. Click Next step.

Step 2: Map units and Grind styles

1. Review the options from your online store.
2. Uncheck any options that refer to non-coffee items.
3. For each option, select the Type: Unit and Grind style.
4. Check the Option name in Cropster (Required). Cropster pre-fills it if it finds a match.
   • Units: Check the amount and unit (g, kg, oz, or lb). For example, 250 and g. You can enter any bag size. By default, Cropster uses the unit from your user settings: g for metric and lb for imperial.
     Note: 250 g and 0.25 kg are saved as two different bag sizes. To avoid duplicate bag sizes, use the same unit for the same bag size across all your products.
   • Grind styles: Grind styles that exactly match a Cropster grind style are linked automatically. For all others, select a grind style from the list, or type a name and click + Create "[name]". To create all remaining grind styles at once, click + Create remaining in the info message.
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. If needed, change the amount and unit of a variant.
2. If an SKU is missing, return to your online store, assign the SKU, and click Sync again.
3. Click Next step 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 the Profile group/Blend profile (Required): a profile group for single-origins and pre-roast blends, or a blend profile for post-roast blends.

   

5. If needed, update the Name, Cropster Product ID, or Notes.
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.

     

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.

How do I fix a unit or grind style that was mapped incorrectly?
Update the mapping on the Mapped options page. You can also unmap an option that you do not want suggested again. Changes only apply to future synchronizations. Existing variants are not updated.

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