# 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](https://platform.conrad.de/en/seller/competence-center/loslegen/anmeldung_kontoerstellung.html)
* 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.

***

{% stepper %}
{% step %}

### 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.
   {% endstep %}

{% step %}

### 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**.
   {% endstep %}

{% step %}

### Create your product listings

Follow the steps below to set up your channel:

{% stepper %}
{% step %}

#### 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](https://helpcenter.channable.com/list-advertise/sell-on-marketplaces/get-started-with-marketplaces/marketplaces-categorization-step "mention")
{% endstep %}

{% step %}

#### 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](https://helpcenter.channable.com/list-advertise/sell-on-marketplaces/get-started-with-marketplaces/marketplaces-rules-step "mention")  
{% endstep %}

{% step %}

#### 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.

{% hint style="success" %}
**Tip:** Click **Auto-map fields** to automatically map using information using information from your other channels or other similar setups. [Learn more](https://helpcenter.channable.com/list-advertise/sell-on-marketplaces/auto-map-fields-for-marketplaces-apis).
{% endhint %}

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](https://helpcenter.channable.com/list-advertise/sell-on-marketplaces/mirakl-marketplaces/mirakl-guide-settings-and-solutions "mention")
{% endstep %}

{% step %}

#### 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](https://helpcenter.channable.com/list-advertise/sell-on-marketplaces/get-started-with-marketplaces/marketplaces-quality-step "mention")
{% endstep %}

{% step %}

#### 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](https://helpcenter.channable.com/list-advertise/sell-on-marketplaces/get-started-with-marketplaces/marketplaces-preview-step "mention")
{% endstep %}
{% endstepper %}
{% endstep %}

{% step %}

### 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

7. Go to Build.
8. 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](https://helpcenter.channable.com/list-advertise/sell-on-marketplaces/mirakl-marketplaces/setting-up-mirakl-eco-contributions).
  {% endstep %}

{% step %}

### 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.
   {% endstep %}

{% step %}

### 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.
{% endstep %}
{% endstepper %}