Conrad Marketplace Connector (Mirakl) changelog

All notable changes to Conrad Marketplace Connector (Mirakl) (kv_conrad) are documented here. The format follows Keep a Changelog and the project uses Semantic Versioning.

[Unreleased]

[1.0.0] - 2026-11-09

Added

Initial release.
Connection page with the seller API URL and API key (encrypted), test and live mode, market choice (Germany, Austria, the Netherlands, France, Italy; Belgium and Switzerland marked as not publicly confirmed; EUR, CHF for Switzerland) and a connection test.
Job queue with retries and back-off, cron (command line and secret address), log viewer with CSV export; buyer data (e-mail, phone, name, address) is masked in the log.
Mirakl engine (Drivers\Mirakl) with an operator file for Conrad: Mirakl Seller API client with the API key in the Authorization header.
Category mapping with markup from Conrad’s category tree (H11); offer fields of your account (AF01) mapped to product features; the product attributes Conrad defines per category (PM11) shown for reference.
Offers created by EAN with an offer import (OF01) that is stored before it is sent and found again with OF04 when the answer is lost; result per line (OF02, OF03).
Stock (STO01) and price (PRI01) imports with their results, only for changes; a removed mapping or deleted product withdraws its live offer (quantity 0) instead of leaving it purchasable.
Order acceptance (OR21) line by line and only within stock (units promised to other orders, orders accepted but not placed yet and disabled or withdrawn offers are taken into account); orders imported without duplicates with buyer, addresses, company and tax number and prices as sold.
Tracking (OR23) and shipment validation (OR24) once every unit of the order is shipped; cancellation of lines (OR33) for orders that are not shipped; refund of shipped lines (OR28), once, from the Orders page; return requests accepted (RT21).
Multi-Vendor: owner mode or one seller account per vendor; a vendor never uses the owner’s API key; queue-wide actions are admin only; caches and counters are scoped per account.
CS-Cart, CS-Cart Ultimate, Multi-Vendor and Multi-Vendor Ultimate 4.17.2 to 4.21.x; license client and Upgrade Synchronizer.

Fixed before the first release (release audit 2026-11-09)

Refunds (OR28) send the line price without shipping as amount and the line’s shipping as shipping_amount (the shipping was counted twice), carry the order currency, and a line refunded in full counts as complete, so a retry adopts the earlier refund.
An order with a refused or cancelled line is imported with its accepted lines; the refused line no longer blocks the import.
Multi-Vendor owner mode: an order with products of several vendors gets its tracking and shipment validation once every vendor’s order is fully shipped; status follow, returns, refund and cancel checks work on the vendors’ orders.
Accepted orders that wait for the payment keep their units reserved until they are imported: the stock sent to Conrad and the acceptance of the next orders leave them out.
The order status follows Conrad forward only and never changes Complete, Declined, Failed, Canceled or a status set by the merchant; a return of part of an order is a note, the “returned” status needs every unit back.
A mapping removed while its offer is being created is never listed again; the created offer is withdrawn.
Every order is imported exactly once: the import is claimed before the order is placed, an order placed before (a crash in between, a reinstall) is adopted, and orders last changed before the installation are not imported.
Imported orders send no shop e-mail to the Conrad buyer unless the new Rules option “Send the shop e-mails to the buyer” is on.
Re-check fixes: after a reinstall an order imported days earlier by the previous installation is matched by its Conrad creation date and adopted, never placed again; the shipment step reads the order first, sends tracking only in shipping, closes orders cancelled or refused at Conrad (“Closed at Conrad”) and rotates orders that cannot be reported yet so newer orders are never held up.
Stock changes from storefront sales go out with the next sync; the offer import lookup (OF04) only adopts API imports in NORMAL mode and reads every page; a shipment is recorded only when Conrad accepted it; refund, cancel and shipment refusals are logged; market labels are language variables and name their public source.