快递100 API

快递单号回传及订单发货接口

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	时间范围错误，请调整时间范围重试

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.kuaidi100.com/ent/logistics/send' \
--data-urlencode 'key=' \
--data-urlencode 'sign=' \
--data-urlencode 'param='

响应示例

{
    "result": true,
    "returnCode": 200,
    "message": "SUCCESS"
}

请求参数

Body 参数application/x-www-form-urlencoded

key

string

必需

授权码，请申请企业版获取

sign

string

必需

32位大写，签名，用于验证身份，按MD5 (param + key + secret)的顺序进行MD5加密，不需要加上“+”号

param

string

业务级参数

必需

返回响应

🟢200成功

application/json

Body

result

boolean

提交结果

必需

true表示成功

returnCode

integer

返回编码

必需

message

string

返回报文描述

必需

售后（退货）订单获取结果推送接口

获取店铺授权超链接接口