商家寄件下单取消接口
POST
https://order.kuaidi100.com/order/borderbestapi.do对下完单进行取消操作。对于不需邮寄的订单请及时进行取消,当月订单最晚需在次月8日前取消,否则将无法取消。
param数据结构:
参数名 | 是否必填 | 类型 | 说明 |
---|---|---|---|
taskId | 是 | string | 任务ID |
orderId | 是 | string | 订单ID |
cancelMsg | 是 | string | 取消原因,例:暂时不寄件了 |
4.5 信息代码含义
信息代码 | 信息内容描述 | 原因及建议处理方式 |
---|---|---|
200 | 提交成功 | 提交成功 |
400 | 参数错误 | 请根据技术文档请求,注意参数类型及是否必填。 |
500 | 服务器错误 | 快递100的服务器出理间隙或临时性异常,有时如果因为不按规范提交请求,比如快递公司参数写错等,也会报此错误 |
501 | 重复提交 | 重复提交了请求 |
503 | 签名认证失败 | 请检查加密方式,param + t + key + secret 的顺序进行MD5加密,加密后字符串转大写,不用加上“+”号 |
600 | 您不是合法的用户(即授权Key出错) | 账号无可用单量,需要充值 |
601 | KEY已过期 | 账号无可用单量,需要充值 |
说明:
快递公司 | 编码 |
---|---|
中通 | zhongtong |
圆通 | yuantong |
申通 | shentong |
韵达 | yunda |
天天 | tiantian |
百世(汇通) | huitongkuaidi |
宅急送 | zhaijisong |
极兔 | jtexpress |
请求参数
Body 参数application/x-www-form-urlencoded
method
string
必需
业务类型(默认:cancelBest)
key
string
必需
授权码, 请申请企业版获取
sign
string
必需
32****位大写,签名,用于验证身份,按MD5 (param +t+key+ secret)的顺序进行MD5加密,不需要加上“+”号。secret在企业管理后台可以查看。
t
string
必需
时间戳如:1576123932000
param
string
由其他字段拼接
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
result
boolean
必需
提交结果。true提交成功,false失败
returnCode
string
返回编码
message
string
返回报文描述
data
object
这里默认为空
示例
{
"result": true,
"returnCode": "200",
"message": "提交成功",
"data": {}
}
最后修改时间: 2 年前