How to set up a Conrad channel (API)

Conrad is a marketplace that focuses on electronics and technology operating in Germany, the Netherlands, Austria, Italy, France and Belgium.

In this article, you’ll learn how to set up a Conrad channel to create and manage your listings on Conrad.

---

Before you start

You’ll need:

• A Conrad seller account

• A Mirakl account

• Products with valid EANs

Good to know

• The following countries are available: Germany, France, Italy, Netherlands, Austria, Czech Republic

• Each store account = one sales channel. To sell in multiple countries, you’ll need to open a new store account and create a new Conrad channel per store.

• If you previously used a Conrad feed, make sure to delete or clear any mapped attributes in your Mirakl shop before starting.

---

1

Create a connection

1. In Channable, go to Projects > [Your project] > Channels.

2. Click + Create channel.

3. In the search bar, enter “Conrad” and select Conrad - API.

4. Click + Add a new connection.

5. At Connect with, click Conrad to select it.

6. For Label, give your connection a descriptive name (e.g. “Conrad”).

7. Click Connect with Conrad. You will be redirected to Mirakl to log in to your account and verify your connection.

8. Confirm any permissions. You will be redirected back to Channable.

9. Click Create to finalize your connection.

2

Configure your channel settings

After creating your connection, set your Conrad channel settings:

1. For Name, give your channel a descriptive name.

2. For Unique ID per item, select the field containing your product id.

3. For Language, select the language your product data is in.

4. For Use master rule group, select a master rule group to apply to your channel (if you have one).

5. Click Save.

3

Create your product listings

Follow the steps below to set up your channel:

1

Categorize your products

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. Create filters to map each product to their correct category.

• Uncategorized Items: Products that still need to be reviewed and categorized.

Learn more: Marketplaces: Categorization step

2

Set up rules

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

• Rule templates: Commonly used rules you can adjust and customize.

• Rules setup: Set up rules to refine your product data (filter, modify, and/or enhance fields).

Learn more: Marketplaces: Rules step

3

Build your listings

The Build step is where you configure your product listings to match marketplace requirements.

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: common fields across products (EAN, prices, titles). Mapping them ensures uniform product information.

• Use static or dynamic values:

  • Static values: Fixed values that don’t change (e.g. brand)

  • Dynamic values: Fields that update from linked data (e.g. stock, prices)

Category-specific attributes

• Category-specific attributes apply to product categories (e.g. size for clothing). Fill in attributes required for the selected category.

Tip: Click Auto-map fields to automatically map using information using information from your other channels or other similar setups. Learn more.

Best practices for Mirakl marketplaces

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

• Seller's Product ID for single/simple products:

  • SellerProductId is the Parent ID, SellerArticleId refers to variant items.

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

Mirakl guide: Mirakl guide: settings and solutions

4

Check the quality of your setup

The Quality step provides feedback before activation. It highlights mandatory and optional errors.

Actions:

• View items: See products with specific issues.

• View in build: Redirects to the Build step to map missing information.

• Set categories: Goes to the Categories step.

• Show source: Available for ID fields. Redirects to Settings.

Solve errors, prioritizing mandatory ones first.

Learn more: Marketplaces: Quality step

5

Preview before activating

The Preview step displays the attributes you mapped in Build and provides an overview of products and potential errors.

Filtering:

• Filter by error: Use the All dropdown to show only products with errors or a specific error.

• Filter by category: Use the All categories dropdown.

Before you continue:

• Review Shared attributes: Ensure mandatory shared attributes are filled.

• Review Category-specific attributes: Ensure mandatory category-specific attributes are filled.

• Check for errors: Correct any red-marked fields.

Learn more: Marketplaces: Preview step

4

Additional requirements for Conrad (Build step - Shared attributes)

These are specific shared attributes and settings you must consider for Conrad.

Lead time to ship

• Specifies time until package is handed to the shipping provider. Overwrites Mirakl’s default.

• If empty, Conrad assumes same-day shipping. Conrad Shop adds 1–2 days to the specified lead time.

How to set:

1. At Lead time to ship, click +.

2. Click Static values.

3. Select the time (in days) between receiving the order and shipping it.

Shipping class

1. At Shipping class, click + .

2. Click Static values.

3. Select the relevant class.

Possible classes:

Logistics class Value	Logistics class ID	Description
Small & Medium 1	SM1	10 kg and below
Small & Medium 2	SM2	Over 10 kg through 15 kg
Small & Medium 3	SM3	Over 15 kg through 31.5 kg
Bulk Shipment	bulk	From 31.5 kg through 40 kg
Pallet Shipment	pallet	Over 40 kg through 500 kg
Extra Logistic Class 1*	extra1	Specific price for Extra logistic 1
Extra Logistic Class 2*	extra2	Specific price for Extra logistic 2
Free shipping	free	Free shipping
Fulfillment Small & Medium 1	FSM1	Fulfillment 10 kg and below
Fulfillment Small & Medium 2	FSM2	Fulfillment over 10 kg through 15 kg
Fulfillment Small & Medium 3	FSM3	Fulfillment over 15 kg through 31.5 kg
Fulfillment Bulk Shipment	fbulk	Bulky over 31.5 kg through 40 kg
Fulfillment Pallet Shipment	fpallet	Pallet over 40 kg through 500 kg
Fulfillment Extra Logistic 1	fextra1	Fulfillment Additional 1
Fulfillment Extra Logistic 2	fextra2	Fulfillment Additional 2
Fulfillment Free shipping	fulfree	Fulfillment Free shipping (no shipping costs allowed)
OCI assortment	oci	OCI assortment (no shipping costs)

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

Reverse charge applies

• Ensures tax information is correctly communicated to Conrad. Reverse charge shifts VAT responsibility to the customer (customer must have valid VAT ID).

How to set:

1. At Reverse charge applies, click +.

2. Click Static values.

3. Select True if it applies, False if not.

Warehouse ID

• Communicates the warehouse location configured in Conrad. Up to 5 storage locations (IDs 1–5).

How to set:

1. At Warehouse ID, click + .

2. Click Static values.

3. Select the warehouse number.

Units of measurement

• Specifies the unit used to calculate price per unit (helps consumers compare costs).

How to set:

1. At Units of measurement, click + .

2. Click Static values.

3. Select the measurement type.

Units table:

Unit	Description
KG	Kilograms
L	Liters
M	Meters
M2	Square meters
M3	Cubed meters

Quantity

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

How to assign:

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 your field.

Example rules (identifying from title):

• If all → then take quantity_per_pack and set to value 1

• If title contains "2-pack" OR title contains "2pcs" → then take quantity_per_pack and set to value 2

• If title contains "4-pack" OR title contains "4pcs" → then take quantity_per_pack and set to value 4

1. Go to Build.

2. In Shared attributes, for Quantity, select the project field you created.

Private Copy Tax

• For France, map the correct ‘copie privée’ amount (in euros). This is a legal levy for certain media products.

Eco-contributions

• France requires adding eco-contributions for applicable products.

5

Send your product listings to Conrad

1. Select the Settings step in [your Conrad channel].

2. Click Activate API.

3. Click Save.

4. Click X to return to the Channel overview page.

5. Click Run now to send your product listings to Conrad.

6

Check your product listings for errors

Go to the Result step and click the Feedback tab. This shows processing errors for your product data.

Resolving errors (important: not all errors prevent listing; use Successful tab as source of truth):

1. In Description, click the error name to view affected products.

2. In ID, click the ID number and scroll to see a red highlighted callout indicating the error. Hover the callout for details.

   • If mapping error: click View in build to go to the attribute to map/re-map (highlighted in blue).

3. For more information about an attribute and accepted values, hover over .

4. Resolve the error.

5. Repeat for remaining errors. When ready, click Run now to run the channel again.

Check successfully listed products in the Successful tab.