Booking & couriers
POST
/v1/shipping/bookBook (asynchronous)
Queues the booking and answers 202 immediately — the AWB is not in this response and will not be.
That is deliberate: returning anything else restarts the courier-fallback loop and risks booking one parcel with two couriers and debiting the wallet twice. The AWB usually exists within 8 seconds; collect it from GET /v1/orders/status?order_no=….
Omit logistic_id for AUTO mode, where the courier is chosen by your ranking and rules. Supply it to force one.
Request body
| Field | Type | Description |
|---|---|---|
| order_idrequired | integer | From create. |
| logistic_id | integer | Force a courier. Omit for AUTO. |
Responses
| Status | Meaning |
|---|---|
| 202 | {status:"queued", idem_key} — or {status:"queued", mode:"auto"}. |
400order_id must be a positive integer | Missing or malformed. |
403cannot create booking for another sender | The order is not yours. |