下单回调接口
POST
/订单有状态变更是会触发回调,回调后如果没有得到合作方正确返回,会重复回调多2次,即最多回调3次。间隔30分钟。
param数据结构:
参数名 | 是否必填 | 类型 | 说明 |
---|---|---|---|
kuaidicom | 是 | string | 快递公司的编码,一律用小写字母,见《快递公司编码》,选填。 |
kuaidinum | 是 | string | 快递单号,单号的最大长度是32个字符。 |
status | 是 | string | 状态码 |
message | 是 | string | 状态描述 |
data | 是 | data | 订单内容 |
data数据结构:
参数名 | 是否必填 | 类型 | 说明 |
---|---|---|---|
orderId | 是 | string | 平台订单ID |
status | 是 | int | 订单状态: 0:'下单成功'; 1:'已接单'; 2:'收件中'; 9:'用户主动取消'; 10:'已取件'; 11:'揽货失败'; 12:'已退回'; 13:'已签收'; 14:'异常签收';15:'已结算' ;99:'订单已取消';101:'运输中';200:'已出单';201:'出单失败';610:'下单失败';155:'修改重量'(注意需要在寄件工单中发起异常反馈并由快递100服务人员确认调重后才会有此状态回调,回调内容包含修改重量后的重量、运费、费用明细、业务类型) |
courierName | 否 | string | 快递员姓名 |
courierMobile | 否 | string | 快递员电话 |
weight | 否 | string | 计费重量,单位:kg |
defPrice | 否 | string | 标准运费,单位:元 |
freight | 否 | string | 折后运费,单位:元 |
volume | 否 | string | 体积,单位:cm³ |
actualWeight | 否 | string | 称重重量,单位:kg |
ΘfeeDetails | 否 | list | 费用明细,明细项目请展开 |
└ feeType | 否 | string | 费用类型,参考:八、费用类型(feeType)说明 |
└ feeDesc | 否 | string | 费用名称 |
└ amount | 否 | string | 费用明细金额,单位:元 |
└ payStatus | 否 | string | 支付状态,支付失败:-1;未支付:0;已支付:1 ;无需支付:2;已退款:3 |
printTaskId | 否 | string | 打印任务ID |
label | 否 | string | 面单短链,下单请求中returnType为20时返回 |
2.4 回调响应报文及错误码解释
字段名称 | 字段含义 |
---|---|
result | true表示成功,false表示失败。如果提交回调接口的地址失败,30分钟后重新回调,3次仍旧失败的,自动放弃 |
returnCode | 200: 提交成功 500: 服务器错误 其他错误请自行定义 |
message | 返回的提示 |
请求参数
Body 参数application/x-www-form-urlencoded
taskId
string
任务ID
sign
string
可选
签名。MD5 (param +salt)
param
string
参数主体
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
result
boolean
必需
提交结果。true提交成功,false失败
returnCode
string
返回编码
message
string
返回报文描述
示例
{
"result": true,
"returnCode": "200",
"message": "提交成功"
}
最后修改时间: 2 years ago