1、API地址
]
注:为了防止恶意解释的情况,不能通过IP访问本网站及API,敬请原谅
2、输入参数说明
名称 | 类型 | 是否必需 | 描述 |
id | String | 是 | 身份授权Key,请点 进行申请(大小敏感) |
com | String | 是 | 要查询的快递公司代码,不支持中文, 对应的公司代码见后面第7章的《API URL 所支持的快递公司及参数说明》 。如果找不到您所需的公司,请发邮件至 kuaidi@kingdee 咨询(大小不敏感) |
nu | String | 是 | 要查询的快递单号,请勿带特殊符号,不支持中文(大小不敏感) |
valicode | String | 否 | 查询快递的电话号码,目前只有佳吉物流需要这个参数,其他公司请忽略 |
show | String | 否 | 返回类型。0:返回json字符串,1:返回xml对象,2:返回html对象,3:返回text文本。如果不填,默认返回json字符串 |
muti | Stirng | 是 | 返回信息数量,1:返回多行完整的信息,0:只返回一行信息。不填默认返回多行 |
order | Stirng | 否 | 排序。desc:按时间由新到旧排列,asc:按时间由旧到新排列。不填默认返回倒序(大小不敏感) |
3、返回结果说明
字段名称 | 字段含义 |
Message | 消息体 |
Data | 数据集合 |
Time | 每条数据的时间 |
Context | 每条数据的状态 |
state | 快递单当前的状态 。0:在途中,1:已发货,2:疑难件,3: 已签收 ,4:已退货。该状态还在不断完善中,有更多的参数需求,欢迎发邮件至 kuaidi@kingdee.com 提出 |
status | 查询的结果状态。0:运单暂无结果,1:查询成功,2:接口出现异常,408:验证码出错(仅适用于APICode url,可忽略) 。遇到其他情况,请按获得身份授权key的邮件中的方法获得技术支持。 |
4、API调用及返回结果示范
4.1 API调用示范
4.2 Json返回示例
{"message":"ok","status":"1","state":"3","data":[{"time":"2012-07-07 13:35:14","context":"客户已签收"},{"time":"2012-07-07 09:10:10","context":"离开 [北京_房山营业所_石景山营业厅] 派送中,递送员[温],电话[]"},{"time":"2012-07-06 19:46:38","context":"到达 [北京_房山营业所_石景山营业厅]"},{"time":"2012-07-06 15:22:32","context":"离开 [北京_房山营业所_石景山营业厅] 派送中,递送员[温],电话[]"},{"time":"2012-07-06 15:05:00","context":"到达 [北京_房山营业所_石景山营业厅]"},{"time":"2012-07-06 13:37:52","context":"离开 [北京_同城中转站] 发往 [北京_房山营业所_石景山营业厅]"},{"time":"2012-07-06 12:54:41","context":"到达 [北京_同城中转站]"},{"time":"2012-07-06 11:11:03","context":"离开 [北京运转中心_航空_驻站班组] 发往 [北京_同城中转站]"},{"time":"2012-07-06 10:43:21","context":"到达 [北京运转中心_航空_驻站班组]"},{"time":"2012-07-05 21:18:53","context":"离开 [福建_厦门支公司] 发往 [北京运转中心_航空]"},{"time":"2012-07-05 20:07:27","context":"已取件,到达 [福建_厦门支公司]"}]}
4.3 xml返回示例
<xml>
<message>ok</message> <status>1</status> <state>3</state> <data> <time>2012-07-07 13:35:14</time> <context>客户已签收</context> </data> <data> <time>2012-07-07 09:10:10</time> <context>离开 [北京_房山营业所_石景山营业厅] 派送中,递送员[温],电话[]</context> </data> <data> <time>2012-07-06 19:46:38</time> <context>到达 [北京_房山营业所_石景山营业厅]</context></data><data><time>2012-07-06 15:22:32</time> <context>离开 [北京_房山营业所_石景山营业厅] 派送中,递送员[温],电话[]</context> </data> <data> <time>2012-07-06 15:05:00</time> <context>到达 [北京_房山营业所_石景山营业厅]</context> </data> <data> <time>2012-07-06 13:37:52</time> <context>离开 [北京_同城中转站] 发往 [北京_房山营业所_石景山营业厅]</context> </data> <data> <time>2012-07-06 12:54:41</time> <context>到达 [北京_同城中转站]</context> </data> <data> <time>2012-07-06 11:11:03</time> <context>离开 [北京运转中心_航空_驻站班组] 发往 [北京_同城中转站]</context> </data> <data> <time>2012-07-06 10:43:21</time> <context>到达 [北京运转中心_航空_驻站班组]</context> </data> <data> <time>2012-07-05 21:18:53</time> <context>离开 [福建_厦门支公司] 发往 [北京运转中心_航空]</context></data> <data> <time>2012-07-05 20:07:27</time> <context>已取件,到达 [福建_厦门支公司]</context> </data> </xml>4.4 html返回示例
如下图照片所示,如果没有看到图片,请稍等或刷新本页:
4.5 text返回示例
时间 地点和跟踪进度
2012-07-07 13:35:14 客户已签收 2012-07-07 09:10:10 离开 [北京_房山营业所_石景山营业厅] 派送中,递送员[温],电话[] 2012-07-06 19:46:38 到达 [北京_房山营业所_石景山营业厅] 2012-07-06 15:22:32 离开 [北京_房山营业所_石景山营业厅] 派送中,递送员[温],电话[] 2012-07-06 15:05:00 到达 [北京_房山营业所_石景山营业厅] 2012-07-06 13:37:52 离开 [北京_同城中转站] 发往 [北京_房山营业所_石景山营业厅] 2012-07-06 12:54:41 到达 [北京_同城中转站] 2012-07-06 11:11:03 离开 [北京运转中心_航空_驻站班组] 发往 [北京_同城中转站] 2012-07-06 10:43:21 到达 [北京运转中心_航空_驻站班组] 2012-07-05 21:18:53 离开 [福建_厦门支公司] 发往 [北京运转中心_航空] 2012-07-05 20:07:27 已取件,到达 [福建_厦门支公司]
5、开发案例及插件支持
- 目前提供ASP、ASP.NET、PHP和Java等四个版本的开发实例,请点下载。
- 插件下载请点:
6、FAQ及技术支持
- FAQ:请点
- 技术支持:
- 发邮件至 kuaidi@kingdee.com,
- ,
- QQ、电话等:见获得授权key的邮件。
出现“快递公司网络异常,请稍后查询”,是因为api.kuaidi100.com这种API不支持EMS、顺丰、圆通、中通和韵达等几家,我们的支持列表中有说明:这几家建议用另一种API:
1、切换到【跳转API】(免费,无需申请,跳转到快递100的网页显示结果): http://www.kuaidi100.com/openapi/api_3_02.shtml 2、切换到【手机API】(免费,无需申请,跳转到快递100手机站显示结果): 3、切换到【iframe页】(免费,无需申请,嵌套页面,无法自定义公司和运单号): 4、切换到【HtmlAPI】(免费,和api.kuaidi100.com共用Key,可自定义公司和运单号,嵌套页面显示结果,有快递100广告): 5、付费方案(无限制),要了解请回复公司名、网站
7、附录
本文档下载地址:
8、 物流编码
说明
以下是快递100对外开放的部份公司的列表,同时适用于和 (部份,具体区别请留意快递公司名称后的备注),另外国际类的可以直接点击查看。
由于我们并没有将所有公司完全对外公布,如果在下面没有找到您所要的快递公司,请添加企业QQ 800036857转 小佰或 发邮件至 咨询。
分类 | 快递公司代码 | 公司名称 |
A | ||
auspost | 澳大利亚邮政(英文结果) | |
aae | AAE | |
anxindakuaixi | 安信达 | |
B | ||
huitongkuaidi | 百世汇通 | |
baifudongfang | 百福东方 | |
bht | BHT | |
youzhengguonei | 包裹/平邮/挂号信(暂只支持,要JSON、XML格式结果和签收状态state请联系企业QQ 800036857转“小佰”) | |
bangsongwuliu | 邦送物流 | |
C | ||
cces | 希伊艾斯(CCES) | |
coe | 中国东方(COE) | |
chuanxiwuliu | 传喜物流 | |
canpost | 加拿大邮政Canada Post(英文结果) | |
canpostfr | 加拿大邮政Canada Post(德文结果) | |
D | ||
datianwuliu | 大田物流 | |
debangwuliu | 德邦物流 | |
dpex | DPEX | |
dhl | DHL-中国件-中文结果 | |
dhlen | DHL-国际件-英文结果 | |
dhlde | DHL-德国件-德文结果(德国国内派、收的件) | |
dsukuaidi | D速快递 | |
disifang | 递四方 | |
E | ||
ems | EMS(中文结果)(暂只支持,要JSON、XML格式结果和签收状态state请联系企业QQ 800036857 转“小佰”) | |
ems | E邮宝(暂只支持,要JSON、XML格式结果和签收状态state请联系企业QQ 800036857 转“小佰”) | |
emsen | EMS(英文结果)(暂只支持,要JSON、XML格式结果和签收状态state请联系企业QQ 800036857 转“小佰”) | |
emsguoji | EMS-(中国-国际)件-中文结果/EMS-(China-International)-Chinese data(请联系企业QQ 800036857 转“小佰”开通) | |
emsinten | EMS-(中国-国际)件-英文结果/EMS-(China-International)-Englilsh data(请联系企业QQ 800036857 转“小佰”开通) | |
F | ||
fedex | Fedex-国际件-英文结果(说明:Fedex是国际件的英文结果,Fedex中国的请用“lianbangkuaidi”,Fedex-美国请用fedexus) | |
fedexcn | Fedex-国际件-中文结果 | |
fedexus | Fedex-美国件-英文结果(说明:如果无效,请偿试使用fedex) | |
feikangda | 飞康达物流 | |
feikuaida | 飞快达 | |
rufengda | 凡客如风达 | |
fengxingtianxia | 风行天下 | |
feibaokuaidi | 飞豹快递 | |
G | ||
ganzhongnengda | 港中能达 | |
guotongkuaidi | 国通快递 | |
guangdongyouzhengwuliu | 广东邮政 | |
youzhengguonei | 挂号信(暂只支持,要JSON、XML格式结果和签收状态state请联系企业QQ 800036857 转“小佰”) | |
youzhengguonei | 国内邮件(暂只支持,要JSON、XML格式结果和签收状态state请联系企业QQ 800036857 转“小佰”) | |
youzhengguoji | 国际邮件(暂只支持,要JSON、XML格式结果和签收状态state请联系企业QQ 800036857 转“小佰”) | |
gls | GLS | |
gongsuda | 共速达 | |
H | ||
huitongkuaidi | 汇通快运 | |
huiqiangkuaidi | 汇强快递 | |
tiandihuayu | 华宇物流 | |
hengluwuliu | 恒路物流 | |
huaxialongwuliu | 华夏龙 | |
tiantian | 海航天天 | |
haiwaihuanqiu | 海外环球 | |
hebeijianhua | 河北建华(暂只能查好乐买的单,其他商家要查,请发邮件至 wensheng_chen#kingdee.com(将#替换成@)开通权限 | |
haimengsudi | 海盟速递 | |
huaqikuaiyun | 华企快运 | |
haihongwangsong | 山东海红 | |
J | ||
jiajiwuliu | 佳吉物流 | |
jiayiwuliu | 佳怡物流 | |
jiayunmeiwuliu | 加运美 | |
jinguangsudikuaijian | 京广速递 | |
jixianda | 急先达 | |
jinyuekuaidi | 晋越快递 | |
jietekuaidi | 捷特快递 | |
jindawuliu | 金大物流 | |
jialidatong | 嘉里大通 | |
K | ||
kuaijiesudi | 快捷速递 | |
kangliwuliu | 康力物流 | |
kuayue | 跨越物流 | |
L | ||
lianhaowuliu | 联昊通 | |
longbanwuliu | 龙邦物流 | |
lanbiaokuaidi | 蓝镖快递 | |
lejiedi | 乐捷递(暂只能查好乐买的单,其他商家要查,请发邮件至 wensheng_chen#kingdee.com(将#替换成@)开通权限 | |
lianbangkuaidi | 联邦快递(Fedex-中国-中文结果)(说明:国外的请用 fedex) | |
lianbangkuaidien | 联邦快递(Fedex-中国-英文结果) | |
lijisong | 立即送(暂只能查好乐买的单,其他商家要查,请发邮件至 wensheng_chen#kingdee.com(将#替换成@)开通权限) | |
longlangkuaidi | 隆浪快递 | |
M | ||
menduimen | 门对门 | |
meiguokuaidi | 美国快递 | |
mingliangwuliu | 明亮物流 | |
O | ||
ocs | OCS | |
ontrac | onTrac | |
Q | ||
quanchenkuaidi | 全晨快递 | |
quanjitong | 全际通 | |
quanritongkuaidi | 全日通 | |
quanyikuaidi | 全一快递 | |
quanfengkuaidi | 全峰快递 | |
sevendays | 七天连锁 | |
R | ||
rufengda | 如风达快递 | |
S | ||
shentong | 伸通(暂只支持,要JSON、XML格式结果和签收状态state请联系企业QQ 800036857 转“小佰”) | |
shunfeng | 顺丰速递(中文结果)(暂只支持,要JSON、XML格式结果和签收状态state请联系企业QQ 800036857 转“小佰”) | |
shunfengen | 顺丰(英文结果)(暂只支持,要JSON、XML格式结果和签收状态state请联系企业QQ 800036857 转“小佰”) | |
santaisudi | 三态速递 | |
shenghuiwuliu | 盛辉物流 | |
suer | 速尔物流 | |
shengfengwuliu | 盛丰物流 | |
shangda | 上大物流 | |
santaisudi | 三态速递 | |
haihongwangsong | 山东海红 | |
saiaodi | 赛澳递 | |
haihongwangsong | 山东海红(暂只能查好乐买的单,其他商家要查,请发邮件至 wensheng_chen#kingdee.com(将#替换成@)开通权限) | |
sxhongmajia | 山西红马甲(暂只能查天天网的单,其他商家要查,请发邮件至 wensheng_chen#kingdee.com(将#替换成@)开通权限) | |
shenganwuliu | 圣安物流 | |
suijiawuliu | 穗佳物流 | |
T | ||
tiandihuayu | 天地华宇 | |
tiantian | 天天快递 | |
tnt | TNT(中文结果) | |
tnten | TNT(英文结果) | |
tonghetianxia | 通和天下(暂只能查好乐买的单,其他商家要查,请发邮件至 wensheng_chen#kingdee.com(将#替换成@)开通权限) | |
U | ||
ups | UPS(中文结果) | |
upsen | UPS(英文结果) | |
youshuwuliu | 优速物流 | |
usps | USPS(中英文) | |
W | ||
wanjiawuliu | 万家物流 | |
wanxiangwuliu | 万象物流 | |
weitepai | 微特派(暂只能查天天网的单,其他商家要查,请发邮件至 wensheng_chen#kingdee.com(将#替换成@)开通权限) | |
X | ||
xinbangwuliu | 新邦物流 | |
xinfengwuliu | 信丰物流 | |
xingchengjibian | 星晨急便(暂不支持,该公司已不存在) | |
xinhongyukuaidi | 鑫飞鸿(暂不支持,该公司已不存在) | |
cces | 希伊艾斯(CCES)(暂不支持,该公司已不存在) | |
xinbangwuliu | 新邦物流 | |
neweggozzo | 新蛋奥硕物流 | |
hkpost | 香港邮政 | |
Y | ||
yuantong | 圆通速递(暂只支持,要JSON、XML格式结果和签收状态state请联系企业QQ 800036857 转“小佰”) | |
yunda | 韵达快运(暂只支持,要JSON、XML格式结果和签收状态state请联系企业QQ 800036857 转“小佰”) | |
yuntongkuaidi | 运通快递 | |
youzhengguonei | 邮政小包(国内),邮政包裹(国内)、邮政国内给据(国内)(暂只支持,要JSON、XML格式结果和签收状态state请联系企业QQ 800036857 转“小佰”) | |
youzhengguoji | 邮政小包(国际),邮政包裹(国际)、邮政国内给据(国际)(暂只支持,要JSON、XML格式结果和签收状态state请联系企业QQ 800036857 转“小佰”) | |
yuanchengwuliu | 远成物流 | |
yafengsudi | 亚风速递 | |
yibangwuliu | 一邦速递 | |
youshuwuliu | 优速物流 | |
yuanweifeng | 源伟丰快递 | |
yuanzhijiecheng | 元智捷诚 | |
yuefengwuliu | 越丰物流 | |
yuananda | 源安达 | |
yuanfeihangwuliu | 原飞航 | |
zhongxinda | 忠信达快递 | |
zhimakaimen | 芝麻开门 | |
yinjiesudi | 银捷速递 | |
yitongfeihong | 一统飞鸿(暂只能查天天网的单,其他商家要查,请发邮件至 wensheng_chen#kingdee.com(将#替换成@)开通权限) | |
Z | ||
zhongtong | 中通速递(暂只支持,要JSON、XML格式结果和签收状态state请联系企业QQ 800036857 转“小佰”) | |
zhaijisong | 宅急送 | |
zhongyouwuliu | 中邮物流 | |
zhongxinda | 忠信达 | |
zhongsukuaidi | 中速快件 | |
zhimakaimen | 芝麻开门 | |
zhengzhoujianhua | 郑州建华(暂只能查好乐买的单,其他商家要查,请发邮件至 wensheng_chen#kingdee.com(将#替换成@)开通权限) | |
zhongtianwanyun | 中天万运 |