Connect a Mirakl marketplace to invtri

Before you add a storefront

• An approved seller account with the retailer. Each Mirakl marketplace is run by its retailer, which sets seller approval, any marketplace subscription and commission rates.
• The Mirakl Marketplaces channel on your licence, a premium channel added as a one-off.
• A shop API key from that marketplace’s seller back office: see Find your Mirakl shop API key.

Add the storefront

1. 1

   Choose the marketplace

   Pick it from invtri’s Mirakl list if it is there, or choose Other Mirakl marketplace. Either way, paste the marketplace’s API address yourself. Mirakl’s API reference shows the address as https://your-instance.mirakl.net, a “URL to be replaced by your Mirakl instance URL”¹.

2. 2

   Paste the key

   Enter the shop API key you generated in that marketplace’s seller back office.

3. 3

   Set the fee percentage

   Set this storefront’s fee percentage. The retailer sets its own commission, so check its current rate. invtri prices each storefront through your margin rules, and the fees feed your profit reporting.

4. 4

   Test the connection

   Test the connection before you list. If the test fails, check the key and the address.

What happens after you connect

• Listing: invtri lists your products by EAN against the retailer’s catalogue.
• Offers you already have: import them from the Mirakl inventory page in one click, and invtri keeps their stock and prices in sync.
• Orders: they arrive in your order tickets to accept or refuse, as Mirakl asks sellers to do with each new order².
• Auto-accept: optional for each storefront. It accepts orders your stock fully covers and leaves the rest for you.
• After dispatch: add the tracking number once and invtri sends it back. You can refund or cancel from invtri.