Skip to main content

Setting up Conrad


Learn on this page how to set up the interface to Conrad. First, you have to carry out some preparatory settings in your plentymarkets system.

1. Activating the order referrer

An order referrer tags an order with the sales channel on which the order was generated. You also need to activate the order referrer in order to link items, characteristics etc. with Conrad. Go to Setup » Orders » Order referrer to activate the order referrer.

Activating the order referrer for Conrad:

  1. Go to Setup » Orders » Order referrer.

  2. Activate the referrer *Conrad*.

  3. Activate the referrer Mirakl.

  4. Save () the settings.

2. Defining a sales price

Sales prices define the conditions under which a variation is sold at a specific price and on a specific sales channel. That means that to sell variations on Conrad, you need a sales price in which the order referrer Conrad is activated. The price that you save for this sales price is the price that will be shown on Conrad.

Defining a sales price for Conrad:

  1. Go to Setup » Item » Sales prices » [Open sales price].
    Tip: No sales prices? Then create a new sales price first.

  2. Open the Settings tab.

  3. Activate the referrer Conrad.

  4. Activate the referrer Mirakl.

  5. Save () the settings.

3. Creating properties

Using properties, you can export fields to the marketplace that aren’t defined in plentymarkets by default. For further information on properties, refer to the Characteristics and properties page.

The following properties are automatically available in your plentymarkets system and will be mapped in the assistant:

  • Logistics class

    • This is the link of a variation with a certain market shipping profile. You can see the market shipping profiles in the market back end in the Platform settings > Shipping menu. The value in brackets is the value that has to be transferred.

  • Leadtime to ship

    • The so-called leadtime-to-ship is the time that a seller needs from the order acceptance to the shipping registration. Here, a whole number between 1 and 45 has to be transferred.

  • Reverse charge

    • This is the so-called Reverse-charge procedure. You can either transfer true or false.

  • update-delete

    • The option to delete an offer. If no value is selected at the variation, the market used update by default.

4. Generating the API key

To create the connection for Conrad between plentymarkets and Mirakl, you need an API key. To generate the API key, proceed as follows:

Generating the API key:

  1. Open the Mirakl back end.

  2. Click on the user icon ().

  3. Go to the API keys tab.

  4. Generate a new API key for Conrad.

  5. Copy the API key to your clipboard. You need this key to set up your Conrad account in plentymarkets.

5. Completing the Conrad assistant

Use the ConradExtension assistant in the Setup » Assistants » Plugins » [Select plugin set] menu to set up your Conrad account in plentymarkets.

Carrying out settings in the assistant:

  1. Go to Setup » Assistants » Plugins » [Select plugin set].

  2. Click on the assistant ConradExtension.

  3. Follow the instructions on the screen. If you need additional information about one of the options, expand the info box shown below this instruction ().

  4. In the step Summary, check your settings to makes sure they are correct.
    Tip: Click on the arrow in the step Summary () to show the settings.

  5. If everything is as it should be, click on Finalise.
    → The settings are saved.

Options in the assistant

Setting Explanation

Step Authentication

API environment

Select an API environment from the drop-down list. Get in touch with your contact person at Conrad to confirm which API environment you should select.
Note: If you switch to another API environment, e.g. from Test to Productive mode, you need to generate a new API key.

API key

Enter the API key that you generated.
Note: If you switch to another API environment, e.g. from Test to Productive mode, you need to generate a new API key.

Step Data exchange

Data exchange

Select processes for data exchange. This selection determines which data is exchanged between plentymarkets and Mirakl.

Step Refund mapping

Refund mapping

Map the refund reasons of Conrad to plentymarkets order statuses.

  1. Click on Add new entry.
    → A new line is inserted.

  2. From the drop-down list on the left, select the plentymarkets status.

  3. From the drop-down list on the right, select one of the Conrad refund reasons.
    The following reasons can be sent to Conrad:

    • 15 = Out of stock

    • 16 = Cancelled by client prior to shipping

    • 17 = Item returned

    • 18 = Item not received

    • 19 = Agreement found with the vendor

Step Cancellation mapping

Cancellation mapping

  1. Click on Add new entry.
    → A new line is inserted.

  2. From the drop-down list on the left, select the plentymarkets status.

  3. From the drop-down list on the right, select a Conrad cancellation reason.
    The following reasons can be sent to Conrad:

    • 34 = Cancellation: Wrong item ordered

    • 35 = Cancellation: Unwanted payment method

    • 37 = Cancellation: Delivery time too long

    • 39 = Agreement reached between customer and vendor

Step Warehouse selection

Warehouse selection

Select the warehouse you want to use for stock export.

Step Shipping profile mapping

Shipping profile mapping

For each shipping profile in plentymarkets, enter the corresponding abbreviation of the shipping service provider. You can find the abbreviations in the Mirakl menu Platform settings » Shipping.

Step Offer properties mapping

Offer properties mapping

From the drop-down list Logistic class, select the property Conrad Logistic class.
The Leadtime to ship and Reverse charge properties are selected by default.

  • Reverse charge: This is the so-called Reverse-charge procedure. You can either transfer true or false.

  • Leadtime to ship: The so-called leadtime-to-ship is the time that a seller needs from the order acceptance to the shipping registration. Here, a whole number between 1 and 45 has to be transferred.

  • Logistics class: This is the connection of a variation with a certain market shipping profile. The shipping profiles of the market are listed in the back end in the Platform settings » Shipping menu. The value in brackets is the value to be transferred.

  • update-delete: This is the option to delete an offer. If this field is not filled, update will be used automatically.

  • product-id-type: This field does not have to be defined. SHOP_SKU is transferred by default.

Step Offer export settings

Offer export settings

Here you can define the amount of stock that is exported for variations that are not limited to net stock or for variations where no stock is managed.


To top