Articles on: Mirakl (PrestaShop)

Orders

Mirakl module Orders tab: map PrestaShop ↔ Mirakl order statuses.


PrestaShop Mirakl Orders Statuses + Revert Mirakl import


Select the correct marketplace first: Multi-marketplace.


Note: Carriers are configured in the Transport tab (Standard, incoming mapping, Carrier Code Mapping). They are no longer chosen in this tab. On import, shipping fees come from Mirakl; the PrestaShop carrier is mainly for display / invoicing.


To import orders: Import orders.



Step 1 — Orders Statuses


For each row, choose a PrestaShop status:


  • Choose a default incoming order status — status when a new Mirakl order is imported.
  • Choose a default sent order status — PrestaShop status meaning Shipped. When you set an order to this status (with a tracking number), the module notifies Mirakl.
  • Choose a default received order status — Delivered status (shown only if the marketplace supports it).
  • Choose a default canceled order status — PrestaShop status for orders canceled / closed on Mirakl.


Below the canceled status:


  • Mirakl States — which Mirakl states trigger cancellation (Ctrl/Cmd for multi-select): CANCELED, CLOSED, REFUSED, INCIDENT_CLOSED.
  • Lookback days — how many days back to sync (e.g. 5).


Save the configuration.



Step 2 — Test shipment to Mirakl


  1. Import a Mirakl order (using the incoming status configured above).
  2. On the PrestaShop order, enter a tracking number (required).
  3. Move the order to the configured sent / shipped status.
  4. Check in Mirakl: status updated + tracking sent (Mirakl then notifies the customer).


If it fails: enable Debug Mode (Authentication tab), change the status again, and send the output to support.


Note: If you use bulk update tools (e.g. Expeditor), confirm with your provider that integration with the Mirakl module is correct.


See also carrier code mapping: Transport.



Step 3 — Revert Mirakl import (tool)


Deletes a PrestaShop order imported from Mirakl (and related links) so you can re-import the same Mirakl order.


Two URLs (JSON) are shown:


  • by PrestaShop order ID (ps_order_id);
  • by Mirakl order ID (mp_order_id).


Note: Troubleshooting only. Deletion is permanent on PrestaShop for eligible orders.



Step 4 — Repair Mondial Relay (if shown)


If the Mondial Relay module is installed and Mirakl pickup-point orders fail, a repair section may appear: select orders (or all) then Repair selected orders.


Additional URL tools are also under Transport (Mondial Relay integration).


Next


Transport, Settings, Import orders, Scheduled tasks, Filters.

Updated on: 15/10/2026

Was this article helpful?

Share your feedback

Cancel

Thank you!