实时快递查询接口
POST
https://poll.kuaidi100.com/poll/query.do请求参数(body)
名称 | 类型 | 是否必需 | 示例值 | 描述 |
---|---|---|---|---|
customer | String | 是 | 授权码,请申请企业版获取 | |
sign | String | 是 | 签名, 用于验证身份, 按param + key + customer 的顺序进行MD5加密(注意加密后字符串一定要转32位大写), 不需要加上“+”号 | |
Θparam | Object | 是 | 由其他字段拼接 | |
└ com | string | 是 | yuantong | 查询的快递公司的编码, 一律用小写字母 下载编码表格 |
└ num | string | 是 | 12345678 | 查询的快递单号, 单号的最大长度是32个字符 |
└ phone | string | 否 | 13888888888 | 收、寄件人的电话号码(手机和固定电话均可,只能填写一个,顺丰速运和丰网速运必填,其他快递公司选填。如座机号码有分机号,分机号无需传入。) |
└ from | string | 否 | 广东深圳 | 出发地城市 |
└ to | string | 否 | 北京朝阳 | 目的地城市,到达目的地后会加大监控频率 |
└ resultv2 | int | 否 | 1 | 添加此字段表示开通行政区域解析功能。0:关闭(默认),1:开通行政区域解析功能以及物流轨迹增加物流状态名称 6: 开通行政解析功能以及物流轨迹增加物流高级状态名称、状态值并且返回出发、目的及当前城市信息 |
└show | String | 否 | 0 | 返回格式:0:json格式(默认),1:xml,2:html,3:text |
└order | String | 否 | desc | 返回结果排序:desc降序(默认),asc 升序 |
1.6 运单快递状态(state)说明
物流状态值 | 物流状态名称 | 高级物流状态值 | 高级物流状态名称 | 含义 |
---|---|---|---|---|
1 | 揽收 | 1 | 揽收 | 快件揽件 |
101 | 已下单 | 已经下快件单 | ||
102 | 待揽收 | 待快递公司揽收 | ||
103 | 已揽收 | 快递公司已经揽收 | ||
0 | 在途 | 0 | 在途 | 快件在途中 |
1001 | 到达派件城市 | 快件到达收件人城市 | ||
1002 | 干线 | 快件处于运输过程中 | ||
1003 | 转递 | 快件发往到新的收件地址 | ||
5 | 派件 | 5 | 派件 | 快件正在派件 |
501 | 投柜或驿站 | 快件已经投递到快递柜或者快递驿站 | ||
3 | 签收 | 3 | 签收 | 快件已签收 |
301 | 本人签收 | 收件人正常签收 | ||
302 | 派件异常后签收 | 快件显示派件异常,但后续正常签收 | ||
303 | 代签 | 快件已被代签 | ||
304 | 投柜或站签收 | 快件已由快递柜或者驿站签收 | ||
6 | 退回 | 6 | 退回 | 快件正处于返回发货人的途中 |
4 | 退签 | 4 | 退签 | 此快件单已退签 |
401 | 已销单 | 此快件单已撤销 | ||
14 | 拒签 | 收件人拒签快件 | ||
7 | 转投 | 7 | 转投 | 快件转给其他快递公司邮寄 |
2 | 疑难 | 2 | 疑难 | 快件存在疑难 |
201 | 超时未签收 | 快件长时间派件后未签收 | ||
202 | 超时未更新 | 快件长时间没有派件或签收 | ||
203 | 拒收 | 收件人发起拒收快递,待发货方确认 | ||
204 | 派件异常 | 快件派件时遇到异常情况 | ||
205 | 柜或驿站超时未取 | 快件在快递柜或者驿站长时间未取 | ||
206 | 无法联系 | 无法联系到收件人 | ||
207 | 超区 | 超出快递公司的服务区范围 | ||
208 | 滞留 | 快件滞留在网点,没有派送 | ||
209 | 破损 | 快件破损 | ||
8 | 清关 | 8 | 清关 | 快件清关 |
10 | 待清关 | 快件等待清关 | ||
11 | 清关中 | 快件正在清关流程中 | ||
12 | 已清关 | 快件已完成清关流程 | ||
13 | 清关异常 | 货物在清关过程中出现异常 | ||
14 | 拒签 | \ | \ | 收件人拒签快件 |
注:如需物流状态高级状态名称及状态值需要 resultv2 传 “6” 返回,如需物流状态高级状态名称需要 resultv2 传 “4” 返回
1.8 信息代码含义
信息代码 | 信息内容描述 | 原因及建议处理方式 |
---|---|---|
200 | 查询成功 | 查询成功 |
400 | 找不到对应公司 | 提交数据不完整或者账号未充值, 检查提交的格式是否为x-www-form-urlencoded的post格式 |
500 | 查询无结果,请隔段时间再查 | 表示查询失败,或没有POST提交 |
501 | 服务器错误 | 快递100的服务器出现间歇或临时性异常,有时如果因为不按规范提交请求,比如快递公司参数没有按照文档规定填写等,也会报此错误 |
502 | 服务器繁忙 | 快递100的服务器出现间歇或临时性异常,请联系快递100排查原因 |
503 | 验证签名失败 | 请检查加密方式,param + key + customer 的顺序进行MD5加密,加密后字符串转大写 |
601 | key已过期 | 没有可用单量,账号需要充值使用 |
二、快递公司编码
如果您需要的公司不在此列表,请联系在线客服添加
三、demo下载
JAVA示例代码 PHP示例代码 PYTHON示例代码 .NET示例代码
四、注意事项
1、贵司连续5次com字段为空或者不符合《快递100快递公司编码规则》,快递100API将会通过快递单号的数据自动调用智能识别接口,判断合适的快递公司编号,返回对应的快递信息。 2、贵司com字段数据符合《快递100快递公司编码规则》时,同一错误快递单号连续调用接口5次,快递100API接口将返回500(查询无结果,请隔段时间再查)。需要注意的是:该次调用的单号会列入贵司的调用数据内,列入计费账单内。
请求参数
授权码,请申请企业版获取
签名, 用于验证身份, 按param + key + customer 的顺序进行MD5加密(注意加密后字符串一定要转32位大写), 不需要加上“+”号
示例代码
返回响应
快递单当前状态,默认为0在途,1揽收,2疑难,3签收,4退签,5派件,8清关,14拒签等10个主状态,如需要返回高级状态,请参考 resultv2 传值
快递单明细状态标记,暂未实现,请忽略
是否签收标记,请忽略,明细状态请参考state字段
快递公司编码,一律用小写字母
最新查询结果,数组,包含多项,全量,倒序(即时间最新的在最前),每项都是对象,对象包含字段请展开
本数据元对应的物流状态名称,只有实时查询接口中提交resultv2标记后才会出现
本数据元对应的高级物流状态值,实时查询接口中提交resultv2=4或6标记后才会出现
本数据元对应的行政区域的编码,只有实时查询接口中提交resultv2标记后才会出现
本数据元对应的行政区域的名称,只有实时查询接口中提交resultv2标记后才会出现
本数据元对应的行政区域经纬度,resultv2=4或6标记后才会出现
本数据元对应的行政区域拼音,resultv2=4或6标记后才会出现
{
"message": "ok",
"state": "0",
"status": "200",
"condition": "F00",
"ischeck": "0",
"com": "yuantong",
"nu": "V030344422",
"data": [
{
"context": "上海分拨中心/装件入车扫描",
"time": "2012-08-28 16:33:19",
"ftime": "2012-08-28 16:33:19"
},
{
"context": "上海分拨中心/下车扫描",
"time": "2012-08-27 23:22:42",
"ftime": "2012-08-27 23:22:42"
}
]
}