How to set up a Conrad channel (API)

Set up your product data by assigning categories to your products. 

• Smart Categorization: Automatically assigns product categories using our algorithm.
• Manual Categorization: Manually assign product categories with custom rules. You can create detailed filters to map each product to their correct category.
• Uncategorized Items: Products that still need to be reviewed and categorized.

Learn more about categorizing for marketplaces

Rules help you quickly optimize your product data for your target marketplace. 

• Rule templates: Commonly used rules you can adjust and customize for your needs.
• Rules setup: Set up rules to refine your product data. With rules, you can filter, modify, and/or enhance data fields to meet marketplace requirements.

Read more about using rules for marketplaces

The Build step is where you configure your product listings to match marketplace requirements. It’s an essential step for getting your products live and avoiding errors.

Mandatory and optional fields: 

• Mandatory fields : Required to list your products on this marketplace
• Recommended : Suggested to avoid errors
• Optional : Not required to list

Shared attributes

Shared attributes are the common fields that apply across your products, such as EAN, prices, and titles. Mapping your shared attributes ensures uniform and consistent product information across your listings.

• Use static or dynamic Values:
  • Static values: Fixed values that don’t change (e.g. brand name, manufacturer)
  • Dynamic values: Fields that automatically update based on the linked data (e.g. stock, prices)

Category-specific attributes

Category-specific attributes fields that specifically apply to your product's categories. This step helps fine-tune your listings to meet category requirements for your marketplace.

Fill in attributes that are specific to the selected category (e.g. size for clothing or dimensions for furniture.) 

Learn more about the Build step for marketplaces

Best practices for Mirakl marketplaces

Adding multiple attribute values: Separate multiple values in an attribute with a pipe symbol "|" for proper detection and processing. 

Seller's Product ID for single/simple products: There are two attributes called SellerArticleId and SellerProductId. SellerProductId is the Parent ID, while SellerArticleId refers to variant items. 

• For single products, both SellerArticleId and SellerProductId must be filled with the same value.

For more information on Mirakl Marketplace errors, how-to's, and best practices, check out our dedicated guide.

The Quality step provides feedback on your channel before you activate it. It highlights mandatory and optional errors to ensure your product data meets requirements to list on the marketplace.

1. Solve errors, prioritizing mandatory errors first.

Actions

• View items: See products with specific issues.
• View in build: Redirects to the Build step to map missing information.
• Set categories: Directs to the Categories step to categorize items.
• Show source: Available for ID fields. Directs to the Settings step.

Learn more about the Quality step for marketplaces

The Preview step displays the attributes you mapped in the Build step, helping you check if everything is configured correctly by providing an overview of your products and potential errors.

Filtering:

• Filter by error: Click the All dropdown and select if you would like to filter to display only products with errors, or products with a specific error.
• Filter by category: Click the All categories dropdown and select the category you want to filter by.

Learn more about the Preview step for marketplaces

Specifies the time until the package is handed over to the shipping service provider. This value overwrites Mirakl’s default settings.
If you keep this field empty, Conrad will assume the item will be shipped the same day. In the Conrad Shop, 1–2 days are added to the specified shipping lead time.

1. At Lead time to ship, click .
2. Click Static values.
3. Select the time (in days) between receiving the order and shipping it.

1. At Shipping class, click
2. Click Static values.
3. Select the relevant class.

Possible classes:

* Extra Logistic Class 1 and 2 are only activated in Germany

This setting ensures your tax information is correctly communicated to Conrad.

The reverse-charge procedure shifts the responsibility for paying VAT. Instead of the company making the delivery paying VAT, the customer is responsible for paying VAT costs to the tax authorities. The customer must have a valid VAT identification number.

1. At Reverse charge applies, click .
2. Click Static values.
3. Specify whether the regulation applies to your products:
   1. Select True if it applies.
   2. Select False if it does not apply.

Communicates the warehouse location you configured in your Conrad account. You can specify up to 5 storage locations in your Conrad account. Each warehouse location is identified by a number (1 to 5).

1. At Warehouse ID, click .
2. Click Static values.
3. Select the number identifier for the warehouse your products are housed in.

Specifies the unit used to calculate the price per unit of a product. This ensures consumers can easily compare costs. 

1. At Units of measurement, click .
2. Click Static values.
3. Select the measurement type for your products.

Specifies how many units are in the product (e.g. a 4-pack of earplugs has a quantity of ‘4’). Allows Conrad to display price per unit and total price for a 4-pack.

To assign this to specific products:

1. Go to Rules.
2. Click to add a new project field.
3. Give your field a descriptive name (e.g. quantity_per_pack)
4. For Type, select Number.
5. Click Create.
6. Create a rule to fill in your rule data. 

7. Go to the Build step.
8. In the Shared attributes tab, for Quantity, select the project field you created.

To comply with French regulation, ensure you map the correct ‘copie privee’ amount (in euros). 

In France, the private copying levy is a legal requirement compensating authors and rights holders for private copies made using blank media such as CDs, DVDs, external hard drives, and USB drives. This levy is included in the sale price of these blank media items and distributed to the creators and rights holders through collective management organizations.