The MIRAKL connector links your Mirakl Connect seller account to Pipe17. You connect by signing in to Mirakl and authorizing Pipe17, so you don't need API keys. The connector brings Mirakl orders into the app and sends order acceptance, cancellations, fulfillments, and inventory back to Mirakl.
Which Mirakl connector? The app has three Mirakl tiles:
- MIRAKL MP connects one seller shop on a marketplace that runs on Mirakl, with the shop API key and the marketplace's Mirakl URL. See Connect MIRAKL MP to Pipe17.
- MIRAKL Connect connects your Mirakl Connect seller account. You sign in to Mirakl Connect and authorize Pipe17 (OAuth). See Connect Mirakl Connect to Pipe17.
- MIRAKL the older connector that also signs in to Mirakl Connect (OAuth), with an environment selector. This article covers this connector.
If you aren't sure which one your account uses, contact Pipe17 support.
With this connector, you can:
- Bring Mirakl orders into the app every 5 minutes, filtered by Mirakl order status.
- Accept orders in Mirakl when they come into the app or when they're sent to fulfillment.
- Refuse or discard Mirakl orders that you cancel in the app.
- Send fulfillments with tracking details to Mirakl.
- Send available inventory to Mirakl.
Setup
Before you begin
- An active Mirakl Connect seller account.
- A Mirakl user that can sign in and authorize third-party apps for your account. You authorize Pipe17 during setup, so you don't need API keys.
- If you plan to send inventory, SKUs in the app that match the offer SKUs you use in Mirakl.
Prepare Mirakl
- Sign in to Mirakl Connect with the user you'll use to authorize Pipe17, and check that you can see your orders.
- Note which user you signed in with. The app sends you to the Mirakl sign-in page during setup, and the connection uses that user's access.
Note: Always connect to production (https://miraklconnect.com). The pop-up also lists Mirakl development and pre-production environments. Those are Mirakl test environments and don't work with a live seller account.
Connect in the app
- Navigate to Integrations and click Add integration.
- Search for MIRAKL and select the MIRAKL tile (not MIRAKL MP or MIRAKL Connect). The Connect MIRAKL pop-up opens.
- Under Select MIRAKL environment, keep MIRAKL Production (https://miraklconnect.com). This is the default.
- Click Connect.
- Sign in to Mirakl, and then authorize Pipe17 to access your account. Mirakl returns you to the app when the connection is complete.
- Open the integration's Settings tab and turn on the flows you want to use: Push locations from MIRAKL, Pull orders from MIRAKL, Push fulfillments to MIRAKL, and Push inventory to MIRAKL. Save your changes.
Note: Despite its name, Push locations from MIRAKL creates a location in the app. Turn it on. Mirakl doesn't share warehouses, so the app creates one location named after your integration.
Note: If you click Add without credentials, the integration is added but doesn't sync until you connect it from its Connection Details tab and authorize Pipe17 in Mirakl.
Confirm the connection
- On Integrations, check that the integration shows Connected and that its switch is on. If it shows Error or Not Configured, open the integration, check that MIRAKL Production (https://miraklconnect.com) is selected, click Connect, and authorize Pipe17 in Mirakl again.
- Navigate to Locations and check that a location named after your integration appears. This can take a few minutes after you turn on Push locations from MIRAKL.
- In the integration settings, add the channel order ID of one test order to Pull only orders with specific order IDs. The order must be updated in Mirakl within the last 7 days and have a status that's selected in Pull MIRAKL orders only when status is set to one of following states (by default, WAITING_ACCEPTANCE and CANCELED). Turn on Pull orders from MIRAKL and save.
- Wait about 5 minutes. The app checks Mirakl for orders every 5 minutes.
- Navigate to Orders and search for the channel order ID.
- Remove the order ID from Pull only orders with specific order IDs and save, so the app brings in all orders.
Settings
You find these on the integration's Settings tab.
Flows
| Setting | Description | Options/Default |
|---|---|---|
| Push locations from MIRAKL | Creates one location in the app, named after your integration. Despite the label, this pulls a location into the app. | On/Off. Default: Off |
| Pull orders from MIRAKL | Brings Mirakl orders into the app. | On/Off. Default: Off |
| Push fulfillments to MIRAKL | Sends fulfillments with tracking details to Mirakl. | On/Off. Default: Off |
| Push inventory to MIRAKL | Sends available inventory to Mirakl. | On/Off. Default: Off |
Orders
| Setting | Description | Options/Default |
|---|---|---|
| Exclude orders created before this date | Skips orders created before this date. If you move the date into the past after the sync has started, older orders come into the app only after they're updated in Mirakl. | Optional. Default: integration creation date |
| Pull only orders with specific order IDs | Brings in only the orders with the channel order IDs you list, from orders updated in the last 7 days. Use this while testing. | Optional. Empty pulls all |
| Pull MIRAKL orders only when status is set to one of following states | Brings in only orders with one of the selected Mirakl statuses. | STAGING, WAITING_ACCEPTANCE, WAITING_DEBIT, WAITING_DEBIT_PAYMENT, SHIPPING, SHIPPED, TO_COLLECT, CLOSED, REFUSED, CANCELED. Default: WAITING_ACCEPTANCE, CANCELED |
| Mark MIRAKL order as Accepted, when creating order in Pipe17 | Accepts all lines of the order in Mirakl as soon as the order comes into the app. | On/Off. Default: Off |
| Mark MIRAKL order as Accepted, when order is sent to fulfillment | Accepts all lines of an order that's awaiting acceptance in Mirakl when the order is Sent to Fulfillment, partially fulfilled, or fulfilled in the app. | On/Off. Default: Off |
| Discard MIRAKL order when canceled in Pipe17 | When you cancel an order in the app, refuses its lines in Mirakl if the order is still awaiting acceptance, or discards the order otherwise. | On/Off. Default: Off |
Inventory
| Setting | Description | Options/Default |
|---|---|---|
| When pulling inventory from Pipe17, use totals across all fulfillment locations | Sends the total available quantity across all your fulfillment locations. Turn this on when you use Push inventory to MIRAKL (see Troubleshooting). | On/Off. Default: Off |
| Process inventory information only for products with specific SKUs | Sends inventory only for the SKUs you list. You can enter regular expressions. Matching uses the lowercase SKU, so enter SKUs in lowercase. | Optional. Empty sends all |
| Do not process inventory information for products with specific SKUs | Never sends inventory for the SKUs you list. You can enter regular expressions. Matching uses the lowercase SKU, so enter SKUs in lowercase. | Optional |
| Force inventory catalog resync | Sends inventory for all products to Mirakl again on the next run. | On/Off. Default: Off |
Flows
| Flow | Direction | Notes |
|---|---|---|
| Locations | Mirakl → Pipe17 | Mirakl doesn't share warehouses, so the app creates one location named after your integration. |
| Orders | Mirakl → Pipe17 | Runs every 5 minutes. Brings in orders with a status selected in the order status setting. The channel order ID is the Mirakl marketplace order ID, and the order source shows MIRAKL and the marketplace. Updates stop once an order in the app moves past Ready for Fulfillment. |
| Order acceptance | Pipe17 → Mirakl | Accepts order lines in Mirakl when the order comes into the app or is sent to fulfillment, depending on your settings. |
| Order cancellations | Pipe17 → Mirakl | With Discard MIRAKL order when canceled in Pipe17 on, refuses or discards the Mirakl order when you cancel it in the app. |
| Fulfillments | Pipe17 → Mirakl | Sends each fulfillment to Mirakl with tracking numbers, tracking URL, carrier, and shipped lines. |
| Inventory | Pipe17 → Mirakl | Sends available quantity for each SKU. Negative quantities are sent as 0. |
| Shipping methods | Mirakl → Pipe17 | Imports Mirakl shipping types once a day, so you can map them to your shipping methods. |
The MIRAKL connector doesn't send or pull products. Manage your offers in Mirakl.
Integration actions
On the integration's Integration Actions tab, you can run these one-time pulls from the Actions menu. To learn more, see Integration Actions.
- Pull orders from Mirakl by external order IDs: enter the IDs in Pull orders with specified external order IDs.
- Pull orders from Mirakl by date: enter a start date in Pull orders for shipments created after and a Time interval from 1h (default) to 48h.
Both actions have Ignore filters defined for integration. Turn it on to skip the order ID filter. The order status filter still applies.
Troubleshooting
- The integration shows Error right after you connect
You may have selected a Mirakl development or pre-production environment. Open the integration, select MIRAKL Production (https://miraklconnect.com) under Select MIRAKL environment, click Connect, and authorize Pipe17 again. - The integration stops with a token error
Your Mirakl authorization expired or was revoked. Open the integration, click Connect, and authorize Pipe17 in Mirakl again. - No location appears for the integration
Turn on Push locations from MIRAKL and wait a few minutes. - An order from Mirakl doesn't appear in the app
Check that its status is selected in Pull MIRAKL orders only when status is set to one of following states, that it was created after Exclude orders created before this date, and that Pull only orders with specific order IDs is empty unless you're testing. To bring in a missed order, run Pull orders from Mirakl by external order IDs. - An order has the error "Failed to retrieve order from MIRAKL"
The app couldn't find the order in Mirakl when it tried to accept, refuse, or discard it. Check that the order still exists in Mirakl and that the integration is connected to production. - A fulfillment has the error "Failed to resolve order"
The app couldn't find the Mirakl order for the fulfillment. This happens when the order didn't come from this integration. Only fulfillments for Mirakl orders can be sent. - Inventory doesn't update in Mirakl
Turn on When pulling inventory from Pipe17, use totals across all fulfillment locations, and check your SKU include and exclude lists (enter SKUs in lowercase). To learn more, see Using Locations. - Products don't sync to Mirakl
The MIRAKL connector doesn't sync products. Manage offers in Mirakl.
Need Help?
If you need additional assistance:
- Use Ask Pippen, our AI agent, located at the top of the platform page.
- Submit a support request with as much relevant detail as possible. Learn how to submit a request.
We’re here to help you succeed with your operations.
Comments
0 comments