# 訂單狀態變更通知
## 1、基本信息
接口描述:訂單狀態變更時,通過請求推送訂單時的參數notify_url發起訂單回調通知。
回調請求的簽名方式與請求參數與API調用方式一致。
## 2、平臺參數
| 參數名稱 | 是否必填 | 范例 | 參數說明 |
| ---- | ---- | ---- | ---- |
| appkey | 是 | G86JM5RJ3h69ZHX286 | 為每個應用提供的唯一標識 |
| timestamp | 是 | 1604027239 | 本次調用的秒級時間戳 |
| nonce | 是 | 741852 | 隨機數 |
| sign| 是 | f30fc2aeb50c984bea266ba285ce2e8d9617253f | 簽名規則,詳見開發須知 |
| operate | 是 | delivery_asign | 變更事件碼 |
## 3、通知body參數
接入方可通過接收到body參數進行訂單狀態同步變更。
| 參數名稱|類型| 范例 | 參數說明 |
| ---- | ---- | ---- | ---- |
| ordersn |String| 20200728144905060634| 接入方訂單編號,即推送訂單時傳入的ordersn_third |
|status|String|3|訂單狀態碼|
|status_cn|String|已完成|訂單狀態碼說明|
|delivery_status|String|4|配送狀態碼|
|delivery_status_cn|String|已完成|配送狀態碼說明|
|detail|String|訂單已完成|變更事件說明|
|delivery_assign_time|String|1595918956|配送員接單時間|
|delivery_success_time|String|1595918963|配送員送達時間|
|cancel_reason|String|長時間無配送員接單|取消訂單理由|
|deliveryer|Array||配送員信息,同查詢訂單API中的deliveryer字段
消息示例
{
"ordersn": "20200728144905060634",
"status": 2,
"status_cn": "已接單",
"delivery_status": 2,
"delivery_status_cn": "待取貨",
"detail": "配送員已接單",
"delivery_assign_time": "1595918956",
"delivery_success_time": "",
"deliveryer": {
"id": 1,
"title": "張三",
"sex": "男",
"mobile": "15364816003",
"location_x": "37.791461",
"location_y": "112.57536315918"
}
}
## 4、返回值說明
接入方在收到訂單回調后,需返回JSON字符串{"errno":0,"message":"success"},若未按要求返回,默認回調失敗,會以一定的規則繼續進行回調通知。
#### 變更事件碼說明 operate
|事件碼|說明|
| --- | --- | --- | --- | --- | --- |
|delivery_assign|配送員已接單|
|cancel|訂單已取消|
|end|訂單已完成|
|delivery_instore|配送員已取貨|
|delivery_transfer|訂單已被配送員轉單,正在重新分配配送員|
|direct_transfer_agree|訂單已由新的配送員進行配送|
|re_notify_deliveryer_collect|訂單已被重新調度,正在分配配送員|