Themes built on the Twig templating engine are now deprecated and require migration to Vitrin to ensure continued support and compatibility with Zid.

Update Order by ID

POST

https://api.zid.sa/v1/managers/store/orders/{order-id}/change-order-status

Please note that if the order is shipped through an integrated shipping company, then we cannot update the order status from "Ready" to "New".

To deliver the order through a shipping company, you need to change the order status to ready, and send the inventory_address_id value with your request, hence shipping companies need to know which pickup point to get the package from.
To get a list of your current inventory addresses along with their ids, please check the inventory addresses API endpoint.

Available order statuses are as follows: (new, preparing, ready, indelivery, delivered, cancelled)

The endpoint now accepts a custom status code in addition to predefined codes.

🔑 Scopes

orders.read_write - Orders Read & Write

🔑 Permission

can:orders.status.change

Request

Path Params

Header Params

Body Params multipart/form-data

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.zid.sa/v1/managers/store/orders//change-order-status' \
--header 'Authorization: Authorization: Bearer [your token]' \
--header 'Accept: application/json' \
--header 'Accept-Language: ar' \
--header 'X-MANAGER-TOKEN: X-MANAGER-TOKEN: [your token]' \
--form 'order_status=""' \
--form 'inventory_address_id=""' \
--form 'tracking_number=""' \
--form 'tracking_url=""' \
--form 'waybill_url=""'

Responses

🟢200Single order status updated

application/json

Body

Example

{}

Modified at 2025-09-16 12:09:40

Orders

Get Order Credit Notes