ShipWave Channels

Connecting Mirakl-powered marketplaces

Use one ShipWave adapter to sell on Tesco UK, B&Q, Argos, Walmart.fr, Fnac, and dozens of other Mirakl operators.

What is Mirakl?

Mirakl is the marketplace platform that powers more than 400 operator marketplaces worldwide, including Tesco UK, B&Q, Argos, Walmart Marketplace.fr, Fnac/Darty, El Corte Inglés, Decathlon, Best Buy Canada, and many more. They all share the same API spec, so a single ShipWave adapter connects you to every Mirakl marketplace you have a seller account on. You add one channel per operator (one for Tesco, one for B&Q, etc.).

Before you start

From your operator’s seller portal you will need three things:

API key – usually found under My account → API key or Settings → My API key. It is a long opaque string and is the only credential ShipWave needs to authenticate.
Operator API domain – the base URL of your operator’s Mirakl instance (e.g. tesco.mirakl.net, diy.mirakl.net for B&Q, argos.mirakl.net). Your operator’s integration guide lists this.
Shop ID – a numeric ID assigned by the operator when your seller account was approved. Visible in the seller dashboard URL or under your account settings.

You also need approval from each operator individually — Mirakl does not federate seller status across marketplaces.

Connecting your account

Go to Admin → Marketplace → Channels and click New Channel.
Select Mirakl as the platform.
Enter the Operator Domain (e.g. tesco.mirakl.net), your Shop ID and your API key.
Choose the Shopify store to use as the product source.
Name the channel something obvious (e.g. “Tesco UK”, “B&Q”) — you will likely have several Mirakl channels.
Click Create Channel. ShipWave checks the key against the operator’s /api/account endpoint and confirms it belongs to the Shop ID you entered before saving the channel.

How orders flow in

ShipWave polls the operator’s /api/orders endpoint every 30 minutes (an operator webhook, if configured, triggers an earlier check). New orders in WAITING_ACCEPTANCE are accepted automatically. Once the customer has been debited and the order reaches SHIPPING — the point where Mirakl releases the final delivery address — ShipWave imports it and creates a matching paid order in your Shopify store, tagged with the marketplace and channel name (for example mirakl and tesco-uk) and carrying the marketplace order number in its note. Lines are matched to your Shopify variants by SKU. The buyer’s marketplace email is not copied to Shopify, so Shopify never emails a marketplace customer.

Shipping and tracking

You can ship marketplace orders two ways:

With a ShipWave label. ShipWave sends the tracking number to the operator and confirms the order as shipped.
From your own system through Shopify. If your warehouse or ERP (for example Unleashed) fulfils the Shopify copy of the order and adds tracking there, ShipWave picks up that Shopify fulfilment and sends its tracking to the operator, then confirms the order as shipped. Mirakl holds one tracking number per order, so ShipWave waits until the whole Shopify order is fulfilled. Tracking added later, for example by Royal Mail Click & Drop after your ERP picks the order, is sent as soon as it appears.

Carrier names are matched to the carriers your operator has configured (Royal Mail, DPD, Evri, Yodel and so on). A carrier the operator does not list is sent by name with its tracking link.

Cancellations

When the operator or customer cancels a marketplace order before it ships, ShipWave cancels it in ShipWave and in Shopify (restocking the items) without emailing the customer from Shopify. If only some lines are cancelled, ShipWave removes those lines from the Shopify order so your warehouse does not ship them. Cancelling the Shopify copy yourself cancels the order on the marketplace too, using one of the operator’s cancellation reasons. Marketplaces that handle cancellations as refunds, such as Tesco, are cancelled by a full refund automatically, and partial refunds are blocked where the marketplace only allows full refunds. A cancellation that arrives after a shipment was recorded is flagged on the order for review instead of being applied automatically. Returns, customer messages, payouts and your seller scorecard are on the channel’s Tools page.

Listings and inventory sync

Mirakl is offer-based: an offer attaches your price and stock to a product in the operator’s catalog, matched by EAN/GTIN. If your offers already exist (for example, created in the operator’s seller portal), open the channel and click Import listings: ShipWave links each offer to a Shopify variant by SKU, or by a unique EAN. From then on Shopify is the stock source of record — every Shopify inventory change is sent to the operator as a stock-only update that leaves price and description untouched. New to the marketplace? Open the channel’s Tools → Create products: pick your Shopify products and the marketplace category, and ShipWave prefills the category’s attributes (title, description, images, barcode, brand, colour, VAT and more) from Shopify, checks every required field and barcode, and submits products and offers together for the marketplace’s product review. Each variant needs a valid EAN/GTIN in its barcode field. Rejected lines from the marketplace’s import report appear on the listing with the marketplace’s message. For the full listing workflow see Bulk listing operations.

Common issues

“Mirakl connection failed” when creating the channel – the API key, operator domain or Shop ID is wrong, or the key belongs to a different shop. Check all three in the operator portal.

“Offer rejected: invalid product” – the EAN does not exist in the operator’s catalog. Submit a product creation request through the operator portal first; once approved the offer push will succeed.

Order not in ShipWave yet – Mirakl only releases orders for shipping after the customer is debited. Orders awaiting acceptance or payment appear once they reach SHIPPING.

Inventory not updating – stock updates are asynchronous imports on the operator side and can take several minutes to apply. If still stale, check the channel’s sync log for errors such as “No Mirakl offer exists for this shop SKU”, which means the offer has not been created or linked yet.