快递单号回传及订单发货接口
POST
https://api.kuaidi100.com/ent/logistics/send回传快递公司和快递单号给电商平台,并且修改订单状态为已发货状态。
param数据结构
参数名称 | 数据类型 | 是否必填 | 参数描述 |
---|---|---|---|
shopType | string | 是 | 店铺类型,TAOBAO:淘宝,JINGDONG:京东,TOUTIAO:抖店,PINDUODUO:拼多多,KUAISHOU:快手 ,ALI1688:阿里1688 ,KUAITUANTUAN:快团团, DINGXIANG:丁香医生 ,WEIPINHUI:唯品会,YOUZAN:有赞,WEIDIAN:微店。 |
shopId | string | 是 | 店铺ID |
orderNum | string | 是 | 订单号,需要填写正确,否则会被电商平台的风控系统拦截 |
kuaidiCom | string | 是 | 快递公司编码,需要填写正确,否则会被电商平台的风控系统拦截,编码请查看参数字典 |
kuaidiNum | string | 是 | 快递单号,需要填写正确,否则会被电商平台的风控系统拦截 |
subOrderNums | string | 否 | 需要拆单发货的子订单集合,针对的是一笔交易下有多个子订单需要分开发货的场景;1次可传人多个子订单号,子订单间用英文逗号隔开;为空表示不做拆单发货(当前仅支持淘宝店铺类型) |
七、 信息代码含义
信息代码 | 信息内容描述 | 原因及建议处理方式 |
---|---|---|
200 | 成功 | 成功 |
101 | 请求格式错误 | 请求为post方式的application/x-www-form-urlencoded,而不是application/json,请勿用错格式提交参数 |
102 | 签名验证失败 | 32位大写,按MD5 (param + key + secret)的顺序进行MD5加密,不需要加上“+”号,secret在授权邮件里面有。注意加密的param参数值必须要和请求提交的param值一致(包括param里面属性字段的顺序) |
103 | 缺少必填参数 | 根据文档补充必填参数的赋值 |
104 | 参数错误 | 根据文档修改参数值 |
401 | KEY过期 | 没有可用单量,账号需要充值再使用 |
402 | 客户不存在 | 账号错误,请检查账号信息是否有误 |
500 | 系统繁忙,请稍后再试 | 快递100的服务器出现间歇或临时性异常,请联系快递100排查原因 |
60101 | 暂不支持该店铺类型 | 检查店铺类型是否填写有误 |
60102 | 店铺授权错误 | 获取店铺授权信息失败,请联系快递100排查原因 |
60103 | 店铺未授权,请授权后再调用 | 店铺未授权或者授权已过期,请重新授权 |
60104 | 店铺授权已过期,请重新授权后再调用 | 店铺授权已过期,请重新授权 |
60201 | 时间范围过大,请调整时间范围重试 | |
60202 | 时间范围错误,请调整时间范围重试 |
请求参数
Body 参数application/x-www-form-urlencoded
key
string
必需
授权码,请申请企业版获取
sign
string
必需
32位大写,签名,用于验证身份,按MD5 (param + key + secret)的顺序进行MD5加密,不需要加上“+”号
param
string
业务级参数
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
result
boolean
提交结果
true表示成功
returnCode
integer
返回编码
message
string
返回报文描述
示例
{
"result": true,
"returnCode": 200,
"message": "SUCCESS"
}
最后修改时间: 2 年前