> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://doc.common-services.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Orders

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

![PrestaShop Mirakl Orders Statuses + Revert Mirakl import](https://storage.crisp.chat/users/helpdesk/website/-/3/f/a/8/3fa8ee645cd13200/screencapture-ps8-common-servi_11tq4md.png)

Select the correct marketplace first: [Multi-marketplace](https://doc.common-services.com/en/article/multi-marketplace-720rdi/).

**Note:** **Carriers** are configured in the [Transport](https://doc.common-services.com/en/article/transport-19lde4g/) 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](https://doc.common-services.com/en/article/import-orders-1roj2fa/).

---

### 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](https://doc.common-services.com/en/article/transport-19lde4g/).

---

### 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](https://doc.common-services.com/en/article/transport-19lde4g/) (Mondial Relay integration).

## Next

[Transport](https://doc.common-services.com/en/article/transport-19lde4g/), [Settings](https://doc.common-services.com/en/article/settings-19rveg8/), [Import orders](https://doc.common-services.com/en/article/import-orders-1roj2fa/), [Scheduled tasks](https://doc.common-services.com/en/article/scheduled-tasks-2og48k/), [Filters](https://doc.common-services.com/en/article/filters-fsvt4n/).