Installation and setup

Requirements

• CS-Cart, CS-Cart Ultimate, Multi-Vendor or Multi-Vendor Ultimate 4.17.2 or later.
• Administrator access to the store’s admin panel.
• An approved seller account on the Conrad marketplace with API access. Conrad decides who may sell: you apply through Conrad’s seller contact form (Conrad names a German VAT registration and a warehouse in Germany as requirements; for the Netherlands integrators name a Dutch VAT number and warehouse, so confirm the rules for your country with Conrad). After approval you receive access to Conrad’s Mirakl seller environment, its address and the API key. If your back office has no API key section, ask Conrad seller support to enable API access.
• A cron job on your server (see step 7 below).

Install the add-on

1. Download the kv_conrad-<version>.zip package from your Kavio Labs or CS-Cart Marketplace account.
2. In the admin panel, open Add-ons > Manage add-ons.
3. Click the gear button and choose Manual installation, then upload the archive.
4. Find Conrad Marketplace Connector (Mirakl) in the list and make sure its status is Active.
5. Enter your license key under Settings > License (Kavio Labs downloads) and click Check now.

Connect the marketplace

1. Open Orders > Conrad (the add-on page) and the Connection tab.
2. In the Test block enter the API URL of your seller account (the Mirakl address you got from Conrad, https only, without /api) and the API key (created in the seller back office under your user settings, API key). A Mirakl API key belongs to one environment, so the test and the live block have their own URL and key. The add-on does not guess the address: Conrad does not publish it.
3. Choose your Market (Germany, Austria, the Netherlands, France, Italy; Belgium and Switzerland are marked as not confirmed). It sets the currency of prices. One store account of Conrad is one sales channel, so a second country is a second connection.
4. Optional fields: Shop ID (Conrad’s “Store Id”, only needed when your user belongs to several shops), Channel code (import only the orders of one sales channel), Offer condition code (the code of “New”; empty = read from the marketplace), Product ID type (default EAN) and Accept new orders automatically (see Usage).
5. Save and click Test connection: a green message shows your shop name, its currency and its channels. A warning appears when the shop currency differs from the market’s.
6. Switch to Live mode only after a successful test and enter the live URL and key; test again.
7. Add the cron job from the settings page (Cron section), every minute is fine. Overlapping runs are prevented.
8. Map your categories to Conrad’s categories (Categories) and the offer fields Conrad requires (Offer fields), then add products (Listings).

Multi-Vendor

By default the marketplace owner connects one account for all vendors (Marketplace owner mode on) and vendors have no Connection tab. Switch it off to let each vendor connect their own seller account in the vendor panel. A vendor never uses the owner’s API key, and queue-wide actions (run the queue now, refresh the shared reference data) are for the marketplace admin only.

Update

1. Upload the new package the same way. Your settings, credentials and data are kept.
2. The add-on adds missing tables and settings by itself on the first request after the update.

See CHANGELOG for what changed in each version.

Uninstall

Open Add-ons > Manage add-ons, click the add-on’s gear button and choose Uninstall. This removes the add-on’s settings, language variables and database tables, including the stored credentials and the order map. Offers that are live at Conrad stay there with their last quantity, and nothing updates them any more: withdraw them first (remove the mappings on Listings and let the queue run until the rows are gone), or set them to 0 in the Conrad back office.

Installing again later does not create your Conrad orders a second time: orders that Conrad changed for the last time before the new installation are not imported, and an order that is changed later is matched with the CS-Cart order that carries its Conrad order number in the notes.