订单信息修改
1.功能描述
用于修改导入成功未打印的订单信息;不支持批量导入需逐一提交;
2.接口信息
请求地址 | b.kuaidi100.com/v7/open/api… |
通信协议 | HTTPS |
请求方式 | POST |
字符集 | UTF-8 |
请求Conent-Type | application/x-www-form-urlencoded |
3.接口规则
- 未打印前的订单可通过此接口进行修改,已打印产生快递单号的订单,不支持修改;
- “订单信息修改接口”的请求参数同“订单信息导入接口”,提交修改请求时,只需传入对应的“order_number”及需要修改的信息即可;
4.请求参数
名称 | 类型 | 是否必填 | 描述 |
---|---|---|---|
app_key | String | 是 | 由快递100提供,接入应用的唯一标识 ([快递管家官网API服务],管理中的App Key) |
access_token | String | 是 | 授权注册时获取的access_token(访问令牌) |
timestamp | long | 是 | 时间戳,自1970年01月01日起到现在的秒数, 例: 1502963129 |
sign | String | 是 | 签名,签名算法参照【签名说明】 |
data | String | 是 | Json字符串,贵方的订单信息数据 |
data参数
同"订单信息导入接口"data参数
示例:
app_key=LeWFeuaGwdf&access_token=uoKbfafdfafcCce×tamp=1502963129&sign=3CF35D130E8B197553ADE1BAEA2615F0&data={
"receiver":{
"company": "金蝶集团",
"mobile": "13888885555",
"name": "刘生",
"addr": "安徽亳州涡阳县牌坊镇陈兰大药房"
},
"order_number": "ord123456"
}
5.返回参数
名称 | 类型(字符长度) | 是否必填 | 描述 |
---|---|---|---|
status | String(5) | 是 | 200:成功401:失败 |
message | String(30) | 是 | 成功/失败原因 |
示例:
成功:
{
"status": "200",
"message": "success"
}
失败:
{
"status": "401",
"message": "签名方式有误"
}
6.接口异步回调信息
请求的Content-Type:application/json;charset=UTF-8
6.1.请求参数
名称 | 类型(字符长度) | 是否必填 | 描述 |
---|---|---|---|
app_key | String | 是 | 由快递100提供,接入应用的唯一标识 ([快递管家官网API服务],管理中的App Key) |
timestamp | long | 是 | 时间戳,自1970年01月01日起到现在的秒数, 例: 1502963129 |
type | String | 是 | 回调接口推送类型,固定为:UPDATE_SEND |
sign | String | 否 | 签名,签名算法参照【签名说明】 |
data | String | 是 | Json字符串 |
└order_number | String(30) | 是 | 订单编号 |
└status | String(5) | 是 | 200:成功 401:失败 |
└message | String(30) | 是 | 成功/失败原因 |
示例:
成功:
{
"app_key": "LeWFeuaGwx1v",
"data":{
"order_number":"ORD123456",
"status": "200",
"message": "success"
},
"type": "UPDATE_SEND",
"timestamp": 1596100607
}
失败:
{
"app_key": "LeWFeuaGwx1v",
"data": {
"order_number":"ORD123456",
"status": "401",
"message": "订单不存在"
},
"type": "UPDATE_SEND",
"timestamp": 1596100607
}
6.2.返回参数
名称 | 类型(字符长度) | 是否必填 | 描述 |
---|---|---|---|
status | String(5) | 是 | 200:成功 400:失败 |
示例:
成功:
{“status”:200}
失败:
{“status”:400}