调度计划回传接口
基本信息
接口名称 |
|
请求方式 |
Post application/x-www-form-urlencoded |
功能描述 |
菜鸟速递将运输调度计划回传给商家 |
编码 |
UTF-8 |
入参
项目 |
名称 |
类型 |
必填 |
描述 |
备注 |
对接码 |
logistic_provider_id |
String |
是 |
双方约定 |
|
签名 |
data_digest |
String |
是 |
Base64(Md5(logistics_interface+双方约定的secretKey)) ,具体参见0.2 签名方法 |
x-www-form-urlencoded格式可能会出现加号变空格的情况,发请求之前可以对签名进行urlencode |
业务报文 |
logistics_interface |
String |
是 |
JSON |
logistics_interface内容
项目 |
名称 |
类型 |
必填 |
描述 |
示例 |
运输计划id |
transportPlanId |
String |
是 |
|
05480264 |
司机姓名 |
driverName |
String |
是 |
|
张三 |
司机电话 |
driverPhone |
String |
是 |
|
13111111111 |
车次信息 |
serialNo |
String |
是 |
|
20-02017 |
车牌号 |
licensePlateNumber |
String |
是 |
|
|
车型 |
carType |
String |
否 |
|
|
操作时间 |
operateTime |
String |
是 |
yyyy-MM-dd HH:mm:ss |
|
是否作废 |
isCancel |
Boolean |
否 |
|
|
承揽订单 |
orders |
List<Order> |
|
|
Order内容
项目 |
名称 |
类型 |
必填 |
描述 |
备注 |
交易订单号 |
tradeNo |
String |
否 |
|
|
仓储订单号 |
storeOrderCode |
String |
是 |
|
|
运单号 |
mailNo |
String |
是 |
|
出参
项目 |
名称 |
类型 |
必填 |
描述 |
备注 |
成功标识 |
success |
Boolean |
是 |
|
|
错误码 |
errorCode |
String |
否 |
|
|
错误说明 |
errorMsg |
String |
否 |
|
示例报文:
请求:
仅供参考,实际测试账号需联系菜鸟速递开发提供
logistic_provider_id: edi_test_json
logistics_interface:
{
"transportPlanId": "20200421110417560",
"driverName": "测试司机",
"driverPhone": "18878778879",
"carNumber": "浙G88998",
"carType": "",
"serialNo":"20-02017",
"operateTime": "2018-11-06 16:20:01",
"isCancel": false,
"orders": [{
"tradeNo": "testrt202004200001",
"storeOrderCode": "",
"mailNo": "FU19390000016930079"
}]
}
data_digest: X32nVItKE9Vfd4yY5QOtnw==