# 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](/list-advertise/sell-on-marketplaces/get-started-with-marketplaces/marketplaces-categorization-step.md) {% 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](/list-advertise/sell-on-marketplaces/get-started-with-marketplaces/marketplaces-rules-step.md) {% 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](/list-advertise/sell-on-marketplaces/auto-map-fields-for-marketplaces-apis.md). {% 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](/list-advertise/sell-on-marketplaces/mirakl-marketplaces/mirakl-guide-settings-and-solutions.md) {% 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](/list-advertise/sell-on-marketplaces/get-started-with-marketplaces/marketplaces-quality-step.md) {% 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](/list-advertise/sell-on-marketplaces/get-started-with-marketplaces/marketplaces-preview-step.md) {% 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](/list-advertise/sell-on-marketplaces/mirakl-marketplaces/setting-up-mirakl-eco-contributions.md). {% 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 %} --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://helpcenter.channable.com/list-advertise/sell-on-marketplaces/mirakl-marketplaces/how-to-set-up-a-conrad-channel-api.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.