用快递100接口查询各快递物流信息

1、API地址

http://api.kuaidi100.com/api?id=[]&com=[]&nu=[]&valicode=[]&show=[0|1|2|3]&muti=[0|1]&order=[desc|asc]

注：为了防止恶意解释的情况，不能通过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调用示范

http://api.kuaidi100.com/api?id=xxxxxxxxxxxxx&com=tiantian&nu=11111&show=0&muti=1&order=desc

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：请点 快递查询接口(API)常见问题

• 技术支持：
  1. 发邮件至 kuaidi@kingdee.com，
  2. 论坛，
  3. QQ、电话等：见获得授权key的邮件。

 

出现“快递公司网络异常，请稍后查询”，是因为api.kuaidi100.com这种API不支持EMS、顺丰、圆通、中通和韵达等几家，我们的支持列表中有说明:这几家建议用另一种API：
1、切换到【跳转API】（免费，无需申请，跳转到快递100的网页显示结果）:

http://www.kuaidi100.com/openapi/api_3_02.shtml
2、切换到【手机API】（免费，无需申请，跳转到快递100手机站显示结果）：http://www.kuaidi100.com/openapi/mobileapi.shtml
3、切换到【iframe页】（免费，无需申请，嵌套页面，无法自定义公司和运单号）：http://www.kuaidi100.com/app/code.shtml
4、切换到【HtmlAPI】（免费，和api.kuaidi100.com共用Key，可自定义公司和运单号，嵌套页面显示结果，有快递100广告）：
http://www.kuaidi100.com/download/html_api(20140729).doc
5、付费方案（无限制），要了解请回复公司名、网站

 

7、附录

本文档下载地址：

下载地址

 

8、 物流编码

说明

以下是快递100对外开放的部份公司的列表，同时适用于HtmlAPI和 运单查询API（部份，具体区别请留意快递公司名称后的备注），另外国际类的可以直接点击国际邮政、EMS、快递类列表查看。

由于我们并没有将所有公司完全对外公布，如果在下面没有找到您所要的快递公司，请添加企业QQ 800036857转 小佰或 发邮件至 wensheng_chen@kingdee.com 咨询。

分类	快递公司代码	公司名称
A
	auspost	澳大利亚邮政(英文结果）
	aae	AAE
	anxindakuaixi	安信达
B
	huitongkuaidi	百世汇通
	baifudongfang	百福东方
	bht	BHT
	youzhengguonei	包裹/平邮/挂号信（暂只支持HtmlAPI,要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(中文结果)（暂只支持HtmlAPI,要JSON、XML格式结果和签收状态state请联系企业QQ 800036857 转“小佰”）
	ems	E邮宝（暂只支持HtmlAPI,要JSON、XML格式结果和签收状态state请联系企业QQ 800036857 转“小佰”）
	emsen	EMS（英文结果）（暂只支持HtmlAPI,要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	挂号信（暂只支持HtmlAPI,要JSON、XML格式结果和签收状态state请联系企业QQ 800036857 转“小佰”）
	youzhengguonei	国内邮件（暂只支持HtmlAPI,要JSON、XML格式结果和签收状态state请联系企业QQ 800036857 转“小佰”）
	youzhengguoji	国际邮件（暂只支持HtmlAPI,要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	伸通（暂只支持HtmlAPI,要JSON、XML格式结果和签收状态state请联系企业QQ 800036857 转“小佰”）
	shunfeng	顺丰速递（中文结果）（暂只支持HtmlAPI,要JSON、XML格式结果和签收状态state请联系企业QQ 800036857 转“小佰”）
	shunfengen	顺丰（英文结果）（暂只支持HtmlAPI,要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	圆通速递（暂只支持HtmlAPI,要JSON、XML格式结果和签收状态state请联系企业QQ 800036857 转“小佰”）
	yunda	韵达快运（暂只支持HtmlAPI,要JSON、XML格式结果和签收状态state请联系企业QQ 800036857 转“小佰”）
	yuntongkuaidi	运通快递
	youzhengguonei	邮政小包（国内），邮政包裹（国内）、邮政国内给据（国内）（暂只支持HtmlAPI,要JSON、XML格式结果和签收状态state请联系企业QQ 800036857 转“小佰”）
	youzhengguoji	邮政小包（国际），邮政包裹（国际）、邮政国内给据（国际）（暂只支持HtmlAPI,要JSON、XML格式结果和签收状态state请联系企业QQ 800036857 转“小佰”）
	yuanchengwuliu	远成物流
	yafengsudi	亚风速递
	yibangwuliu	一邦速递
	youshuwuliu	优速物流
	yuanweifeng	源伟丰快递
	yuanzhijiecheng	元智捷诚
	yuefengwuliu	越丰物流
	yuananda	源安达
	yuanfeihangwuliu	原飞航
	zhongxinda	忠信达快递
	zhimakaimen	芝麻开门
	yinjiesudi	银捷速递
	yitongfeihong	一统飞鸿（暂只能查天天网的单，其他商家要查，请发邮件至 wensheng_chen#kingdee.com(将#替换成@)开通权限)
Z
	zhongtong	中通速递（暂只支持HtmlAPI,要JSON、XML格式结果和签收状态state请联系企业QQ 800036857 转“小佰”）
	zhaijisong	宅急送
	zhongyouwuliu	中邮物流
	zhongxinda	忠信达
	zhongsukuaidi	中速快件
	zhimakaimen	芝麻开门
	zhengzhoujianhua	郑州建华（暂只能查好乐买的单，其他商家要查，请发邮件至 wensheng_chen#kingdee.com(将#替换成@)开通权限）
	zhongtianwanyun	中天万运