【快递物流查询API接口推荐：解析37种物流状态及行政区划解析】

快递物流查询 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");
    /**
     * 实时快递查询接口
     */
    @Test
    public 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，接入高效，数据信息丰富完善，功能强大。通过本文的指南，相信您可以快速完成接口对接，并利用这项技术提升用户体验和业务效率。