5.同步配送状态
### candao.rider.updateDeliveryStatus
>供应商系统订单状态变更通知到开放平台,开放平台通知骑手系统是否继续配送;此接口请求结果为同步返回,业务级处理结果为异步通知,供应商需要根据回调接口【配送公司回传配送状态++candao.rider.pushDeliveryStatus++】的结果判断操作结果,成功或失败时都会回调。
官方文档:[http://open-api.can-dao.com/#/documents?page_code=32-3](http://open-api.can-dao.com/#/documents?page_code=32-3)
#### 注意事项
-
### 业务数据
#### 必传字段
- deliverySysType:配送系统,==即物流公司,如蜂鸟==
- businessId(可选):业务配送订单id 优先传该字段作为配送单id,==businessId可能在骑手派单后,回调返回,待定==。
- extOrderId:平台订单id,==即我们的订单号==
- subStoreId(可选):供应商侧门店 ID,即我们的 ==OUTLET_CODE==
- driverStatus: 配送状态,参见枚举类driverStatus
> 骑手状态
1:待推送(用于配送系统不支持预约单情况下,开放平台保留订单延迟推送的状态);
2:待接单;3:骑手系统已确认;5:已分配;6:已到店;7:配送中;10:已送达;15:已取消;21:妥投异常收货;-7:妥投异常操作失败;22:妥投异常操作完成;23:待商家确认收货;24:商家确认收货;-1:呼叫失败;-2:配送异常;-3:取消失败;4:待转派(15、-1,-2 需要重新呼叫骑手);-4:分配超时;-5:取餐超时;-6:妥投异常;
8:转派中(表示DMS当前转派的第三方骑手公司失败,正转派下一家骑手公司 或 DMS出现配送异常,正转派其他骑手);9:门店自送;-100:未知状态
- reason:取消原因
### 请求示例
```JSON
{
"data":{
"deliverySysType":"foops",
"extOrderId":"71636551195320",
"subStoreId":"46489361",
"extStoreName":"两粒米智慧餐饮",
"driverStatus":-1,
"reason":"接口调试"
},
"accessKey":"185a4bd62df35dc8",
"actionName":"candao.rider.updateDeliveryStatus",
"timestamp":1636603089093,
"ticket":"3f8fe111-f938-475e-b878-26c072fd2451",
"sign":"154358a91f1c1a99a40fbcb5edc5a91e",
"serviceType":"pos",
"vendor":""
}
```
### 返回示例
```JSON
{
"status": 2,
"msg": "骑手状态存在变更",
"logId": "6e0becce-4c4c-ea48-3309-5f3c-79a0ddf2",
"serverTime": 1636603310252,
"ticket": "3f8fe111-f938-475e-b878-26c072fd2451"
}
```