目录
- 快递物流查询API接口推荐：解析37种物流状态及行政区划解析
- 一、 物流查询接口推荐
- 二、对接指南与接口测试
- 注册与获取API Key
- 快速接入
- 接口测试
- 物流状态（state)说明：
- 测试代码示例（[直接拿去用]([java-demo-test](https://github.com/kuaidi100-api/kuadi100-api/blob/master/src/test/java/BaseServiceTest.java))）
- 响应结果(resultv2传4为案例)
- 三、总结
快递物流查询API接口推荐：解析37种物流状态及行政区划解析
在当今电商蓬勃发展、物流行业日益繁忙的时代，不管你是电商从业者还是普通消费者，能实时、准确地获取包裹的物流信息，那可太重要了。物流信息的掌握程度，不光影响消费者购物体验，对企业运营决策、客户满意度也有很大影响。
物流查询 API 作为一种强大的工具，开发者用它，能轻松把物流查询功能加到自己的应用、网站或者系统里，快速又精准地查到各种快递包裹的物流状态。
今天我就给大伙推荐一款超好用的物流查询接口，让你获取物流信息快人一步！
一、 物流查询接口推荐
选物流查询接口，快递100API开放平台这款真的香！要是用快递公司自己的开放平台，一家一家对接，非常麻烦。但用快递100就很方便，对接一次，圆通、中通、极兔、顺丰、申通、韵达等等2100 家快递公司的物流信息都能查，效率直接起飞。
也用过市面上同类型的接口产品，快递100的优势还是很大的。**它能解析 37 种高级物流状态，细节满满。而且还能给你返回收寄件地址、物流经过地区的行政区划和编码、经纬度，这些功能是别的产品不具备的。**有了这些，我们开发者那不得轻松很多 ？
二、对接指南与接口测试
快递100的物流查询接口分为实时查询和订阅推送。
-
实时查询：发送查询请求后，接口实时返回最新的全量物流轨迹信息。
-
订阅推送：我们订阅了某个快递单号后，每次有物流信息更新，接口会推送最新的全量物流轨迹信息到我们的系统里。
详细的可以参考我之前发布的文章《快递100 物流查询API全面解析》。
这里我们用快递100实时查询接口做演示。在对接物流查询API前，我们需要完成以下步骤：
注册与获取API Key
● 前往 快递100API开放平台 注册账号，每个用户有100个测试单量。
● 在企业管理后台-我的信息-企业信息中，获取 API Key 和 Secret。
快速接入
在快递100API开放平台官网有详细的接口文档，下载对应语言的SDK，查看文档中的示例代码，5分钟搞定接入，下面给大家实际演示一遍。
接口测试
请求参数这里，如果要开通行政解析功能以及物流轨迹增加物流高级状态名称、状态值并且返回出发、目的及当前城市信息，记得需要 resultv2 传 “4” 。
物流状态（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 | 破损 | 快件破损 | ||
| 210 | 销单 | 寄件人申请撤销寄件 | ||
| 8 | 清关 | 8 | 清关 | 快件清关 |
| 10 | 待清关 | 快件等待清关 | ||
| 11 | 清关中 | 快件正在清关流程中 | ||
| 12 | 已清关 | 快件已完成清关流程 | ||
| 13 | 清关异常 | 货物在清关过程中出现异常 | ||
| 14 | 拒签 | \ | \ | 收件人拒签快件 |
测试代码示例（直接拿去用）
- 需要修改的配置（ account.properties文件）参数来源于快递100后台
- 引入依赖
<dependency><groupId>com.github.kuaidi100-api</groupId><artifactId>sdk</artifactId><version>1.0.15</version>
</dependency>
- 核心测试代码
public class BaseServiceTest {String key = PropertiesReader.get("key");String customer = PropertiesReader.get("customer");/*** 实时快递查询接口*/@Testpublic void testQueryTrack() throws Exception{QueryTrackReq queryTrackReq = new QueryTrackReq();QueryTrackParam queryTrackParam = new QueryTrackParam();// 选择对应的快递公司queryTrackParam.setCom(CompanyConstant.ZT);// 快递单号，可以拿自己的快递号来测试queryTrackParam.setNum("7886*******705");queryTrackParam.setPhone("177*****266");// resultv2 默认不填为0，// 1： 开通行政区域解析功能以及物流轨迹增加物流状态名称 // 4: 开通行政解析功能以及物流轨迹增加物流高级状态名称、状态值并且返回出发、目的及当前城市信息
// queryTrackParam.setResultv2("1");queryTrackParam.setResultv2("4");String param = new Gson().toJson(queryTrackParam);queryTrackReq.setParam(param);queryTrackReq.setCustomer(customer);queryTrackReq.setSign(SignUtils.querySign(param ,key,customer));IBaseClient baseClient = new QueryTrack();HttpResult execute = baseClient.execute(queryTrackReq);System.out.println(JSON.toJSONString(execute));}
}
响应结果(resultv2传4为案例)
- 如图所示，红色框中返回了高级物流状态名称和值、途径地的行政区域解析成省市区、行政区域拼音和经纬度、收寄件地址的城市信息
有了高级物流状态解析，好处可多了。在后台和用户端界面，能更精准地知道包裹具体到哪一步了，不仅仅是知道 “在途、揽收、签收” 这些简单状态，像 “待揽收、投柜或驿站、转递” 这些情况都能清楚看到。
利用这些物流状态，还能开发自动批量查单功能。比如说，能自动把 “滞留”“疑难” 这些状态的单号挑出来，及时处理这些异常情况，跟单人员的压力就能小很多。再比如，运单号一变成 “已签收”，订单就能自动变为可确认退换货状态。
另外，接口返回的详细地址和行政区划信息也很有用。要是包裹出了问题，能靠这些信息快速找到包裹大概位置，缩小查找范围，处理异常件的效率就提高了。要是包裹在某个行政区好久都没动，马上联系当地网点去查就行。
三、总结
快递100物流查询API，接入高效，数据信息丰富完善，功能强大。通过本文的指南，相信您可以快速完成接口对接，并利用这项技术提升用户体验和业务效率。
