Conrad Marketplace Connector (Mirakl)

Edition: CS-Cart & Multi-Vendor · Latest version: 1.0.0 · Compatible with: CS-Cart & Multi-Vendor 4.17.2 – 4.21.x, PHP 7.4 – 8.3 · Changelog: view

Connects CS-Cart and Multi-Vendor to the Conrad marketplace, which runs on the Mirakl marketplace platform: offers created by EAN, price and stock sent as imports, orders accepted only within your stock and imported, tracking and refunds sent, returns accepted, with your own seller API key.

What it does

Maps CS-Cart categories and products to offers on the marketplace (offers are matched to the Conrad catalogue by EAN) and creates them with an offer import (Mirakl OF01). The import is written down before it is sent: if the answer is lost, the import is found again (OF04) and polled instead of being sent a second time.
Reads the result of every import (OF02 and the error report OF03) and shows the marketplace’s reason on the product that was rejected.
Reads Conrad’s category tree (H11) for the category mapping and the offer fields of your account (AF01), for example lead time, shipping class or warehouse, for the field mapping.
Sends stock (stock import STO01) and price (price import PRI01) at the next sync after a change (a product edit, a storefront sale, a cancellation). The stock sent leaves out the units of orders you accepted that Conrad has not released for shipping yet.
Accepts new orders (OR21, an option) line by line and only within your stock: a line you cannot deliver (not enough units, a withdrawn or unknown offer, a disabled product) is refused, never accepted and oversold. The units of an accepted order stay reserved until the order is imported. Each order is imported exactly once (the import is claimed before the order is placed, and an order placed before is found again instead of being placed twice) with its accepted lines, buyer, delivery and billing address and prices as sold. Your shop sends the Conrad buyer no e-mail unless you switch it on.
Sends your carrier, tracking number and tracking link (OR23) and the shipment confirmation (OR24) once every unit of the order is in a shipment; in Multi-Vendor owner mode over the orders of every vendor in the order.
The CS-Cart order status follows Conrad forward only: a status you set yourself (for example Complete) is never changed back, and a return of part of the order is a note, not a cancellation.
Cancels order lines you cannot deliver (OR33) and refunds shipped lines (OR28, a credit note to the buyer), each once; accepts return requests (RT21).
Removing a product mapping, or deleting a product, withdraws its live offer (quantity 0) instead of leaving a purchasable offer behind.
The API key is stored encrypted; test and live mode are separate; “Test connection” reads your shop (A01) and checks the currency of the market.
A job queue with automatic retries (5 minutes, 15 minutes, 1 hour, 3 hours, 12 hours), a log with filters and CSV export in which buyer data (e-mail, phone, address) is masked.
Multi-Vendor: marketplace owner mode (one seller account for the whole marketplace) or one seller account per vendor in the vendor panel; a vendor never uses the owner’s API key.

Markets in the operator file, one connection per country: Germany (named by Conrad itself), Austria, the Netherlands, France and Italy (named by connector guides, not by a Conrad document), Belgium (named by some guides only) and Switzerland (CHF; named by no public source). Use a market only when Conrad enabled it for your account. Prices are in EUR, in CHF for Switzerland. Conrad admits approved sellers only. See Conformance and unverified facts.

Built on the Mirakl engine

Conrad is one of many marketplaces that run on Mirakl. This add-on contains a generic Mirakl driver (Drivers\Mirakl) and one operator file (Drivers\Mirakl\Operators\Conrad.php) with everything that is specific to Conrad. Other Mirakl marketplaces are separate Kavio Labs products that reuse the engine with their own operator file. See Developer notes, which cites every Mirakl operation used, and the conformance table.

Compatibility

CS-Cart, CS-Cart Ultimate, Multi-Vendor and Multi-Vendor Ultimate 4.17.2 to 4.21.x.
PHP 7.4 to 8.3, depending on your CS-Cart version.
The queue needs a cron job (a command line or a secret web address; see Configuration).

What this version does not do

It does not create products that are missing in the Conrad catalogue (the Mirakl product import P41 is not used): an EAN the marketplace does not know is reported back as rejected.
Offer prices are plain prices: no volume, channel or scheduled prices (the Mirakl price import replaces all prices of an offer).
Refunds are whole lines of shipped orders; partial refunds, refunds before shipping, incidents and customer messages are handled in the marketplace back office.
One tracking number per order: multi-parcel shipments with a tracking id per parcel are finished in the back office. In Multi-Vendor the tracking number of the latest vendor shipment is sent.
Uninstalling does not touch your offers at Conrad: withdraw them first (see Installation).

Next steps

Conrad is a trademark of its owner and Mirakl is a trademark of Mirakl; they are named here only to say what this add-on connects to. This add-on is not affiliated with, endorsed by or certified by Conrad or Mirakl.