Booking & couriers
POST
/v1/shipping/book/syncBook (synchronous)
Books inside the request and returns the AWB. It BLOCKS for the courier call — typically 30–40 seconds — so set your client timeout to at least 45s.
Prefer the asynchronous POST /v1/shipping/book unless your integration genuinely cannot poll. A transient courier failure here is handed to the durable worker, so a timeout on your side does not mean the parcel was not booked — check GET /v1/orders/status before retrying.
Request body
| Field | Type | Description |
|---|---|---|
| order_idrequired | integer | From create. |
| logistic_id | integer | Force a courier. Omit for AUTO (forward only). |
| operation | string | Forward booking or a return. One of book · reverse. |
Responses
| Status | Meaning |
|---|---|
| 200 | {status, awb, forward_id, logistic_id, order_id, courier_name, label_url}. |
400order_id and logistic_id must be positive integers | Malformed. |
422booking_failed | The courier refused. message is the courier's own words. |