Mirakl Connector for OpenCart — offers, prices, stock and orders of Worten, PcComponentes, Carrefour, Leroy Merlin

Mirakl Connector connects OpenCart to marketplaces that run on Mirakl: Worten, PcComponentes, Carrefour, Leroy Merlin, Decathlon and others. The module links your existing offers to the products of the shop and keeps their price and stock as in the shop. Pro adds several marketplaces with one stock, orders in OpenCart with acceptance, shipping with tracking and new offers by EAN.

What the buyer sees

A buyer on the marketplace sees your product in the marketplace catalogue with the price and quantity from OpenCart, with your markup and in the marketplace currency. The marketplace finds the product by its EAN, so your offer sits on the same product page as those of other sellers. A product that is switched off or sold out gets quantity 0 on the marketplace.

What the admin gets

Extensions → Modules → Mirakl Connector: the Mirakl address of the marketplace, the API key and, if needed, the shop ID. “Check” saves the form and reads the shop, currency, offer conditions and carriers. The key is stored encrypted. Per marketplace: exchange rate, tax, a markup in percent and a fixed amount, special price, safety stock, offer condition, lead time and the product code type.

“Import offers” reads all offers of your shop on the marketplace and links them to products: by SKU first, then by EAN. Ambiguous ones are not linked, and the list with the reasons shows at once. From then on, price and stock go out of a queue once a minute per marketplace, only what changed, and the answer of the marketplace for each offer shows in the module and in the product. The fields the marketplace would reset (description, lead time, logistic class, discount) are sent back as they were.

In Pro, marketplace orders are read every 5 minutes. A new order is accepted by itself when every product and the stock are there; otherwise it waits for your decision with accept and refuse buttons. The OpenCart order is created once the buyer has paid, with the address, phone and totals. Shipping with carrier and tracking number goes from the order panel or by an OpenCart status, cancellation from the panel; cancellations and refunds on the marketplace change the status and put the stock back.

How it works, step by step

1. The marketplace gives you its Mirakl address and the API key of your shop; you paste them into the module and press “Check”.
2. “Import offers” links your offers on the marketplace to products by SKU or EAN.
3. Price and stock of a product go to the marketplace after every change, through a queue once a minute.
4. The Mirakl tab of a product shows what goes to each marketplace and what is there now.
5. In Pro, orders come into OpenCart, and shipping and cancellations go back to the marketplace.

Under the hood

• The API key is stored encrypted (AES-256 with HMAC).
• Only changes are sent; the module keeps to the Mirakl request limits by itself.
• Exchange rate from the shop currencies or set by hand, tax for prices without VAT, rounding to cents.
• Pro: shipping zone by region name, for Spain by postcode, for France by department.
• Pro: order statuses go through the OpenCart history, so other modules (invoices, alerts, accounting) see them as ordinary orders.
• API log over 30 days.

How to install

1. OpenCart 4.x and 3.x: Extensions → Installer, upload the archive for your version without renaming the file. OpenCart 2.3: copy the contents of the upload/ folder of the archive to the shop root.
2. OpenCart 3.x and 2.3: Extensions → Modifications → Refresh.
3. Extensions → Modules → Mirakl Connector → install → edit.
4. Paste the Mirakl address and the API key, press “Check”, then “Import offers” on the Offers tab.
5. For Pro: paste the key or start the 7-day trial on the Licence tab.