Settings
Open Add-ons > Manage add-ons > Conrad Marketplace Connector (Mirakl) > Settings.
General
Section titled “General”| Setting | Default | Description |
|---|---|---|
| Enable | On | When off, no new work is started. Jobs of work that is already under way are still processed. |
| Marketplace owner mode | On | On: every order is processed with the marketplace owner’s account and vendors have no connection page. Off: each vendor connects their own account. |
| Debug log | Off | Also stores every HTTP call with masked request and response. The API key and buyer data (e-mail, phone, name, address) are never stored. |
| Log retention (days) | 90 | Older log entries are removed by the cron run. |
| Sync interval (minutes) | 15 | How often stock and price are pushed, orders imported and shipments reported. Mirakl allows an offer import once per minute at most and recommends every 5 minutes. |
| Status of imported orders | O | CS-Cart status of a new imported order (Open: you still have to ship it). |
| Payment method ID for imported orders | empty | Empty = the first active payment method. |
Connection
Section titled “Connection”The API key is not an ordinary setting: it is entered on the Connection page and stored encrypted (AES-256-GCM, key derived from your store’s own secret). It is never shown again; leave the key field empty to keep the saved value.
| Field | Description |
|---|---|
| Mode | Test uses the test API URL and key; Live uses the live ones. |
| API URL | The Mirakl address of your Conrad seller account, https, no port, no user name, no query; a path is kept and a trailing /api is removed. Conrad gives it to you with the seller access; the add-on does not guess it. Addresses with an IP number, localhost or a non-public name are refused. |
| API key | The key of your marketplace user (sent in the Authorization header). |
| Market | Germany, Austria, the Netherlands, France, Italy, Belgium, Switzerland. Selects the currency: EUR, CHF for Switzerland (prices are converted with the CHF rate of your shop, or the fixed rate on the Rules page). Germany is named by Conrad itself; Austria, the Netherlands, France and Italy by connector guides; Belgium by some guides only; Switzerland by none. The list marks every market that Conrad itself does not name. One connection per country. |
| Shop ID | Optional. Conrad’s “Store Id”; sent as shop_id when your user has access to several shops. |
| Channel code | Optional. Import only the orders of this sales channel. |
| Offer condition code | Optional. The code of the condition “New” in your marketplace (the add-on reads the list with OF61 and picks the one named new / neu / nieuw / neuf / nuovo when this is empty). |
| Product ID type | Optional. The Mirakl product-id-type of your offers; default EAN. Conrad’s own seller pages list a product ID and the manufacturer part number, so check your catalogue’s identifier with Conrad. |
| Accept new orders automatically | Yes (default): every new order is answered at the next import run, line by line: lines within your stock are accepted, other lines are refused. No: you answer in the seller back office, the order is imported afterwards. |
Price markup and rounding, stock buffer, default delivery time (sent as the lead time to ship; Conrad assumes same-day shipping when it is empty, and adds time of its own on its shop), VAT default, status mapping from the marketplace order state to CS-Cart statuses (applied forward only, never over Complete, Declined, Failed, Canceled or a status you set yourself), Send the shop e-mails to the buyer (off by default: imported Conrad orders send the buyer no e-mail from your shop) and your carrier tracking link are on the Rules page of the add-on. “Seller ships with an own carrier” is on by default because the seller ships on Conrad.
The queue runs from cron. Use either the command line or the secret web address shown in the Cron section of the settings:
php /path/to/store/admin.php --dispatch=kv_conrad.cronhttps://your-store.example/index.php?dispatch=kv_conrad.cron&key=<secret>
Log and jobs
Section titled “Log and jobs”- Log lists every call, job and import with filters (level, action, text, dates) and a CSV export. Order and import ids are kept; buyer e-mail addresses, phone numbers, names and addresses are replaced by
***. - Jobs lists the queue. A job that fails is retried after 5 minutes, 15 minutes, 1 hour, 3 hours and 12 hours, then marked “Gave up”; use Retry to queue it again.
Multi-Vendor
Section titled “Multi-Vendor”In the vendor panel a vendor sees only their own records and counters. With the marketplace owner mode off the vendor also gets the Connection tab for their own seller account. Running the whole queue and refreshing the shared reference data are admin-only.