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

Connector for Mirakl Marketplaces puts WooCommerce products on marketplaces that run on Mirakl: Worten, PcComponentes, Carrefour, Leroy Merlin, Decathlon and others. The price and stock of each offer come from the shop, and the result for every product shows up in the admin. Pro brings marketplace orders into WooCommerce, accepts them, sends the carrier and tracking number back, and works with several marketplaces at once.

What the buyer sees

A buyer on the marketplace sees your product in the marketplace catalogue with your price, quantity, condition and lead time. The marketplace finds the product by its EAN (or another code it uses), so your offer sits on the same product page as those of other sellers. When a product runs out or you switch it off, its quantity on the marketplace becomes 0.

What the admin gets

WooCommerce → Mirakl: the Mirakl address of the marketplace and the API key of your shop (the marketplace gives both to its sellers). “Check connection” reads the shop name, currency, offer conditions and carriers. The key is stored encrypted. Per marketplace: a markup in percent and a fixed amount, an exchange rate when the currency differs, the offer condition, lead time and logistic class.

Products get a “Mirakl” tab: sell or not, EAN or another code, condition, lead time, an own marketplace price. The same tab shows what went to each marketplace and whether it accepted the offer, or its reason when it did not. “Link offers already on the marketplaces” links the offers your shop already has on a marketplace to your products by SKU or EAN; the fields the plugin does not manage (description, logistic class, quantity limits) stay as they are.

In Pro, marketplace orders come into WooCommerce every 5 minutes and the stock is taken at once. A new order is accepted by itself when every product is known and in stock; otherwise it waits “On hold” with Accept and Refuse buttons. Once the buyer has paid, the order gets the address and moves to “Processing”. A completed order sends the carrier and tracking number to the marketplace, a cancelled one refuses or cancels it there. The buyer’s invoice is uploaded from the order screen.

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 WooCommerce → Mirakl and press “Check connection”.
2. If you already sell on the marketplace, “Link offers already on the marketplaces” links the existing offers to your products, so nothing is doubled.
3. You switch on “Sell on Mirakl marketplaces” in the products; each needs an EAN, by which the marketplace finds it in its catalogue.
4. Price and stock changes go into a queue sent every 5 minutes, only what changed; the answer of the marketplace shows in the product.
5. In Pro, orders come into WooCommerce, and shipping and cancellations go back to the marketplace.

Under the hood

• Mirakl Seller API with the API key of your shop; the key is stored encrypted.
• Price: the gross shop price, a markup in percent and a fixed amount, an exchange rate. Without a rate no price is sent, so a wrong one never goes out. A WooCommerce sale can be sent as a marketplace discount with its dates.
• Stock: stock minus a safety reserve; a default quantity for products without stock management; 0 for products switched off, unpublished or out of stock.
• Only changes are sent; the plugin keeps to the Mirakl request limits by itself, the rest waits in the queue.
• API log of 300 requests without the key or buyer data.
• Pro: orders with prices with or without tax, shipping and commission; WooCommerce e-mails to marketplace buyers are off until you switch them on.
• HPOS compatible. Pro includes Spanish, Portuguese, French and Italian translations.

How to install

1. Plugins → Add New → Upload Plugin: choose the zip and activate.
2. WooCommerce → Mirakl: paste the Mirakl address of the marketplace and the API key of your shop, press “Check connection”, save.
3. Set the markup, the exchange rate (when the marketplace currency differs), the offer condition and the lead time.
4. Link existing offers with “Link offers already on the marketplaces”, switch on selling in the products, press “Send changes now”.
5. For Pro: paste the key or start the 7-day trial at the bottom of the settings page.

The “Download free” button gives the free version. Pro is the full archive; it appears in your account after a purchase or a trial.