The Mirakl Connect connector brings your seller-fulfilled orders from Mirakl Connect into the app, and sends order acceptance, fulfillments, products, and inventory back to Mirakl Connect. You connect by signing in to Mirakl Connect and authorizing Pipe17, so you don’t need to enter API keys.
With this connector, you can:
- Bring seller-fulfilled orders from Mirakl Connect into the app every 5 minutes.
- Accept orders in Mirakl Connect when they’re ready for fulfillment in the app, or refuse them when you cancel them first.
- Send fulfillments with tracking details to Mirakl Connect.
- Send product details and available inventory to Mirakl Connect.
Setup
Before you begin
- An active Mirakl Connect seller account, with the marketplaces you sell on already connected to Mirakl Connect.
- A Mirakl Connect user that can sign in and authorize third-party apps for your account. You don’t need API keys. You authorize Pipe17 by signing in to Mirakl Connect.
- Orders that you ship yourself. The app brings in only seller-fulfilled orders.
- If you plan to send products or inventory, SKUs in the app that match the SKUs you use in Mirakl Connect.
Prepare Mirakl Connect
- 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 Connect sign-in page during setup, and the connection uses that user’s access.
Note: Always connect to Mirakl Connect 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 in the app.
- Click Add Integration, and then select MIRAKL Connect. The connection pop-up opens.
- Under Select MIRAKL environment, select MIRAKL Production (https://miraklconnect.com). This is the default.
- Click Connect.
- Sign in to Mirakl Connect, and then authorize Pipe17 to access your account. Mirakl Connect returns you to the app when the connection is complete.
- Turn on the flows you want to use: Pull locations from MIRAKL, Pull orders from MIRAKL, Push fulfillments to MIRAKL, Push products to MIRAKL, and Push inventory to MIRAKL.
Note: Turn on Pull locations from MIRAKL. Mirakl Connect doesn’t share warehouses, so this creates one location named after your integration. By default, the app sends inventory only from that location.
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 Connect again.
- Navigate to Locations and check that a location named after your integration appears.
- In the integration settings, add the channel order ID of one recent seller-fulfilled test order to Pull only orders with specific order IDs. The order must be awaiting acceptance, payment, or shipment in Mirakl Connect, and created after Exclude orders created before this date. Save the settings.
- Wait about 5 minutes. The app checks Mirakl Connect for orders every 5 minutes.
- Navigate to Orders and search for the channel order ID. If the order is awaiting payment, it has the tag
PENDING_PAYMENT. - If the order was awaiting acceptance, check in Mirakl Connect that its lines are accepted once the order is Ready for Fulfillment in the app.
- Remove the order ID from Pull only orders with specific order IDs and save, so the app brings in all orders.
Settings
| Setting | Description | Options/Default |
|---|---|---|
| Exclude orders created before this date | Skips orders created in Mirakl Connect before this date. If you move the date into the past, older orders come into the app only after they’re updated in Mirakl Connect. | Optional. Default: integration creation date |
| Pull only orders with specific order IDs | Brings in only the orders with the channel order IDs you list. Use this while testing. | Optional. Empty pulls all |
| Process only products with specific SKUs | Sends only the products with the SKUs you list. | Optional. Empty sends all |
| Force product catalog resync | Sends all products to Mirakl Connect again on the next run. Turns off automatically when the sync starts. | On/Off. Default: Off |
| When pulling inventory from Pipe17, use totals across all fulfillment locations | Sends the total available quantity across all your fulfillment locations. When off, the app sends inventory only from the location that this integration creates. | 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. | 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. | Optional |
| Force inventory resync | Sends inventory for all products to Mirakl Connect again on the next run. Turns off automatically when the sync starts. | On/Off. Default: Off |
Flows
| Flow | Direction | Notes |
|---|---|---|
| Locations | Mirakl Connect → Pipe17 | Mirakl Connect doesn’t share warehouses, so the app creates one location named after your integration. |
| Orders | Mirakl Connect → Pipe17 | Runs every 5 minutes. Brings in seller-fulfilled orders that are awaiting acceptance, awaiting payment, or awaiting shipment. Orders awaiting payment get the tag PENDING_PAYMENT. Updates stop once an order in the app moves past Ready for Fulfillment. |
| Order cancellations | Mirakl Connect → Pipe17 | When an order is closed in Mirakl Connect, the app cancels it. Orders that Mirakl Connect closes automatically aren’t canceled. |
| Order acceptance | Pipe17 → Mirakl Connect | When an order awaiting acceptance becomes Ready for Fulfillment in the app, the app accepts its lines in Mirakl Connect. If you cancel the order before acceptance, the app refuses its lines. After an order is accepted, cancellations in the app aren’t sent to Mirakl Connect. |
| Fulfillments | Pipe17 → Mirakl Connect | Sends each fulfillment to Mirakl Connect as a shipment with tracking number, tracking URL, carrier, and shipped lines. |
| Products | Pipe17 → Mirakl Connect | Sends SKU, title, UPC, images, base price, and discount price. Products that are unpublished or disabled in the app are sent with a quantity of 0. |
| Inventory | Pipe17 → Mirakl Connect | Sends available quantity for each SKU. Negative quantities are sent as 0. |
Troubleshooting
-
The integration shows Error right after you connect
You may have selected a Mirakl development or pre-production environment. Those are Mirakl test environments. Open the integration, select MIRAKL Production (https://miraklconnect.com) under Select MIRAKL environment, click Connect, and authorize Pipe17 again. -
No location appears for the integration
Turn on Pull locations from MIRAKL and wait a few minutes. Without this location, the app has no inventory to send to Mirakl Connect unless you turn on When pulling inventory from Pipe17, use totals across all fulfillment locations. The integration stops with a token error
Your Mirakl Connect authorization expired or was revoked. Open the integration, click Connect, and authorize Pipe17 in Mirakl Connect again.An order from Mirakl Connect doesn’t appear in the app
The app brings in only seller-fulfilled orders that are awaiting acceptance, payment, or shipment, and created after Exclude orders created before this date. Also check that Pull only orders with specific order IDs is empty unless you’re testing.An order has the error “Failed to retrieve order from MIRAKL”
The app couldn’t find the order in Mirakl Connect when it tried to accept it. Check that the order still exists in Mirakl Connect and that the integration is connected to the right environment.A fulfillment has the error “Failed to resolve order”
The app couldn’t find the Mirakl Connect order for the fulfillment. This happens when the order didn’t come from this integration. Only fulfillments for Mirakl Connect orders can be sent.Inventory doesn’t update in Mirakl Connect
By default, the app sends inventory only from this integration’s location. Turn on When pulling inventory from Pipe17, use totals across all fulfillment locations, or check your SKU include and exclude lists. To learn more, see Using Locations.
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