快递100 API

下单回调接口

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	返回的提示

响应示例

{
    "result": true,
    "returnCode": "200",
    "message": "提交成功"
}

请求参数

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

taskId

string

任务ID

可选

sign

string

可选

签名。MD5 (param +salt)

param

string

参数主体

可选

返回响应

🟢200成功

application/json

Body

result

boolean

必需

提交结果。true提交成功，false失败

returnCode

string

返回编码

必需

message

string

返回报文描述

必需

商家寄件下单接口

商家寄件下单取消接口