接口文档

一、快递查询地图轨迹

一、 快递查询地图轨迹

1.1 接口格式

提供统一格式的HTTP POST或GET调用接口,并返回格式支持JSON，xml，text，html数据。

1.2 请求地址

https://poll.kuaidi100.com/poll/maptrack.do

请求参数：

参数名是否必填类型说明
customer是string授权码，请申请企业版获取
sign是string签名， 用于验证身份， 按param + key + customer 的顺序进行MD5加密（注意加密后字符串一定要转32位大写）， 不需要加上“+”号
param是param由其他字段拼接

param数据结构：

参数名是否必填类型说明
com是string查询的快递公司的编码， 一律用小写字母
num是string查询的快递单号， 单号的最大长度是32个字符
phone否string收、寄件人的电话号码（手机和固定电话均可，只能填写一个，顺丰单号必填，其他快递公司选填。如座机号码有分机号，分机号无需上传。）
from是string出发地信息，如：广东省深圳市南山区金蝶软件园
to是string目的地信息，如：北京朝阳区国际金融大厦
show否string返回格式：0：json格式（默认），1：xml，2：html，3：text
order否string返回结果排序:desc降序（默认）,asc 升序
orderTime否string订单下单时间，格式为（yyyy-MM-dd HH:mm:ss）如：2020-12-16 12:59:59

1.3 请求实例

customer=**
  sign=**
  param={
    "com":"ems",
    "num":"em263999513jp",
    "phone":"13868688888",
    "from":"广东省深圳市南山区金蝶软件园",
    "to":"北京朝阳区国际金融大厦",
    "show":"0",
    "order":"desc",
    "orderTime":"2020-12-16 12:59:59"
  }

1.4 返回结果

字段名称类型字段含义
messageString消息体，请忽略
stateInteger快递单当前状态，包括0在途，1揽收，2疑难，3签收，4退签，5派件，6退回，7转单，10待清关，11清关中，12已清关，13清关异常，14收件人拒签等13个状态
statusInteger通讯状态，请忽略
conditionString快递单明细状态标记，暂未实现，请忽略
ischeckInteger是否签收标记，请忽略，明细状态请参考state字段
comString快递公司编码,一律用小写字母
nuString单号
trailUrlString轨迹地图链接
arrivalTimeString预计到达时间
totalTimeString平均耗时
remainTimeString到达还需多少时间
isLoopBoolean是否存在环路
ΘrouteInfo 路由信息
└Θfrom 出发地行政区信息
└number 政区信息编码
└name 政区信息名
└Θcur 当前地行政区信息
└number 政区信息编码
└name 政区信息名
└Θto 目的地行政区信息
└number 政区信息编码
└name 政区信息名
Θdatadata最新查询结果，数组，包含多项，全量，倒序（即时间最新的在最前），每项都是对象，对象包含字段请展开
└ contextString内容
└ timeString时间，原始格式
└ ftimeString格式化后时间
└statusString本数据元对应的签收状态，只有实时查询接口中提交resultv2标记后才会出现
└areaCodeString本数据元对应的行政区域的编码，只有实时查询接口中提交resultv2标记后才会出现
└areaNameString本数据元对应的行政区域的名称，只有实时查询接口中提交resultv2标记后才会出现

1.5 提供数据内容

{
	"message": "ok",
	"nu": "YT4781863654577",
	"ischeck": "1",
	"com": "yuantong",
	"status": "200",
	"data": [{
		"time": "2020-11-30 13:19:56",
		"context": "圆通合作点【喵站】快件已到达财富金街院里3号底商驿站,联系电话18744663997",
		"ftime": "2020-11-30 13:19:56",
		"areaCode": null,
		"areaName": null,
		"status": "在途"
	}, {
		"time": "2020-09-12 17:40:58",
		"context": "【广东省深圳市平湖公司】 已收件 取件人: 刘杰珍 (18128837173)",
		"ftime": "2020-09-12 17:40:58",
		"areaCode": "CN440307003000",
		"areaName": "广东,深圳市,龙岗区,平湖",
		"status": "揽收"
	}],

	"state": "3",
	"condition": "00",
	"routeInfo": {
		"from": {
			"number": "CN4403",
			"name": "广东,深圳市"
		},
		"cur": {
			"number": "CN6101",
			"name": "陕西,西安市"
		},
		"to": {
			"number": "CN6101",
			"name": "陕西,西安市"
		}
	},
	"isLoop": false,
       "trailUrl":"https://api.kuaidi100.com/tools/map/bc80574d538262aecc897a469151f0e3",
	"arrivalTime": "2020-12-19 12:00",
	"totalTime": "2天1小时",
	"remainTime": "1天2小时"
}

1.6 运单签收状态服务说明

状态值名称含义
0在途快件处于运输过程中
1揽收快件已由快递公司揽收
2疑难快递100无法解析的状态，或者是需要人工介入的状态， 比方说收件人电话错误。
3签收正常签收
4退签货物退回发货人并签收
5派件货物正在进行派件
6退回货物正处于返回发货人的途中
7转投货物转给其他快递公司邮寄
10待清关货物等待清关
11清关中货物正在清关流程中
12已清关货物已完成清关流程
13清关异常货物在清关过程中出现异常
14拒签收件人明确拒收

1.7 轨迹链接应用示例

1.8 错误返回示例

{
"result":false,
"returnCode":"400",
"message":"找不到对应公司"
}
信息代码信息内容描述原因及建议处理方式
200查询成功查询成功
400参数权限问题数据不完整，找不到对应公司，非法IP，请申请授权，不支持此快递公司，单号问题等
500查询无结果，请隔段时间再查表示查询失败，去快递公司没获取有效数据
501服务器错误快递100的服务器出理间隙或临时性异常，有时如果因为不按规范提交请求，比如快递公司参数没有按照文档规定填写等，也会报此错误
502服务器繁忙快递100的服务器出理间隙或临时性异常，请联系快递100排查原因
503验证签名失败请检查加密方式，param + key + customer 的顺序进行MD5加密，加密后字符串转大写
601没该功能权限没有可用单量或没有开启权限
一、快递查询地图轨迹