This endpoint allows you to update the state of an order based on your internal workflow.
Methods
Parameters
| Parameter | Mandatory | Type | Example | Description |
| shop_order_id | yes | string | "123456789" | The order reference inside your system |
| state | yes | string | choice | "paid" | The current state of the order. See the list of possible options below |
| datetime | yes | datetime | "2021-05-15T16:53:07+01:00" | Timestamp when the order changed to this status inside your system |
| location | no | string | "Schwedter strasse 36A 10435 Berlin" | The physical location of the order |
States available
| State | Description |
|---|---|
| new | The initial state of an order. It is set automatically on order creation |
| warehouse_handover | The state signifies that the order is being moved to the warehouse |
warehouse_new | Once the order has arrived at the new warehouse, it enters the “warehouse_new” state, indicating that it has been received and is ready for the next steps in the fulfilment process |
| paid | |
| in_production | A state representing the status of the order in your warehouse |
| in_preparation | A state representing the status of the order in your warehouse |
| shipped | The state is assigned automatically when the first shipment for the order gets created |
| refunded | The refunded state can only be assigned with this end-point if the order has NO order items. IF the order HAS order items, this state can only get triggered by the status of the order items |
| cancelled | The state represents that the order has been explicitly canceled, meaning it will not be processed or delivered. |
Do you want to know more about order states and event? Please find the page under the link: Explaining Statuses and Events