一、地图轨迹订阅接口

1.1 接口格式

1.使用http协议表单提交的方式进行信息交互，字符编码默认统一采用UTF-8，数据格式：application/x-www-form-urlencoded；

2.字段类型约定：需要严格依据字段表格中给出的参数格式和大小进行开发。

3.字段解析约定：参数字段中的必选字段是每次调用接口时都要求必须传入的；

1.2 请求地址

http://poll.kuaidi100.com/pollmap

请求报文：

param数据结构：

parameters数据结构：

1.3 请求示例

schema = json
  param = {
    "company": "ems",
    "number": "1136281381675",
    "from": "广东省深圳市南山区",
    "to": "北京市朝阳区",
    "key": "XXX ",
    "parameters": {
      "callbackurl": "您的回调接口的地址，如http://www.您的域名.com/kuaidi?callbackid=...",
      "salt": "*",
      "phone": "",
      "ordertime": "2020-12-31 08:09:00"
    }
  }

1.4 订阅返回结果

1.5 订阅响应报文示例（json格式）

{
  "result": true,
  "returnCode": "200",
  "message": "提交成功"
}

1.6 状态码附表

二、推送接口

1.使用http协议表单提交的方式进行信息交互，字符编码默认统一采用UTF-8，数据格式：application/x-www-form-urlencoded；

2.字段类型约定：需要严格依据字段表格中给出的参数格式和大小进行开发。

3.字段解析约定：参数字段中的必选字段是每次调用接口时都要求必须传入的；

2.1 推送请求地址

由贵司在订阅请求中通过callbackurl字段提供

2.2 推送请求方式

post

2.3 推送输入参数

请求参数（header）

请求报文（body）

param对应参数

lastResult对应参数

2.4 推送输入参数示例

param = {
    "status": "polling",
    "billstatus": "got",
    "message": "",
    "autoCheck": "1",
    "comOld": "yuantong",
    "comNew": "ems",
    "lastResult": {
        "message": "ok",
        "state": "0",
        "status": "200",
        "condition": "F00",
        "ischeck": "0",
        "com": "yuantong",
        "nu": "V030344422",
        "data": [{
            "context": "上海分拨中心/装件入车扫描 ",
            "time": "2012-08-28 16:33:19",
            "ftime": "2012-08-28 16:33:19",
            "status": "在途",
            "areaCode": "310000000000",
            "areaName": "上海市"
        }, {
            "context": "上海分拨中心/下车扫描 ",
            "time": "2012-08-27 23:22:42",
            "ftime": "2012-08-27 23:22:42",
            "status": "在途",
            "areaCode": "310000000000",
            "areaName": "上海市"
        }],
        "routeInfo": {
            "from": {
                "number": "CN3100",
                "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小时"
    }
}

2.5 轨迹链接应用示例

<img src="https://p3-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/2a1e3b91df2e4db8afb5eefc50d76c6f~tplv-k3u1fbpfcp-zoom-1.image" style="zoom:60%">

重要提醒：

（1）对于status= abort而且message中包含“3天”关键字而且comNew为空的快递单，需要增加以下处理逻辑：

• 如果有专门的工作人员，可以:将快递单罗列给工作人员，由工作人员判断此单是否为假单：如果此单是真实单，则将此单重新向快递100提交一次；如果此单是假单，则将此单标记为假单，而且不再将此单提交给快递100。如果没有专门的工作人员，请直接用以下第二种方法进行操作；

• 如果没有专门的工作人员，可以：在收到status=abort而且message中包含“3天”关键字而且comNew为空的提示10分钟后，将此快递单重新向快递100提交订阅，如果重新提交后仍然收到status= abort，则再次重新向快递100提交，如此，在同一月中如果重复提交3~4次都仍然收到status= abort，则此单为假单，不需要再将此单提交给快递100。

  对于同一自然月内重复提交的快递单，结算时只计一次费用，对于跨了两个自然月重复提交的结算单，结算两次费用。

（2）如果判断到status=abort且comNew不为空，则不需要重新提交订阅，且将贵司原来的快递公司编码改为comNew后的值，或在贵司数据库中增加一个快递公司编码为comNew+原来单号的运单；

（3）如果判断到status=polling且autoCheck=1，则此单为纠正公司编码后的跟踪信息，应保存。

• 关于data：我方每次推送的都是完整的、全量的快递查询结果，而不是部分最新、增量的状态。由于同一快递单查询结果的数据源可能变动，不同数据源之间的结果略有差异，建议每次删除旧的数据后再写入新的数据。
• 时间建议以ftime为准，不要使用time，time的存在仅仅为了兼容。

2.6 推送响应报文及错误码解释

2.7 推送返回示例

当我方调用贵方的回调接口（callbackurl）时，贵方需要先将我方提交的数据保存至贵方的数据库，接着向我方返回是否成功接收的响应报文及代码，即贵公司直接在回调接口的地址的response中填写如下内容：

{
  "result":true,
  "returnCode":"200",
  "message":"成功"
}

注意：对于status= abort（message中包含“3天查询无记录”或者“60天无变化”）的快递单，也需要返回成功接收的响应报文及代码。

2.8 运单签收状态（已签收、退回等）增值服务说明

​ 默认状态下，在推送时我们提供了ischeck字段表示快递单是否签收（含正常签收，退回签收两种情况），通过state字段提供签收的具体状态，state具体如下：

签收状态服务能够对目前市面上大多数快递单状态进行准确判定。

若state=0,则condition如下值代表如下状态：

三、快递公司编码

<a href="https://api.kuaidi100.com/manager/openapi/download/kdbm.do" style="color: #027eff;" target="_blank"><u>下载表格</u></a>

一、地图轨迹推送服务API产品介绍

快递100地图轨迹推送服务接口提供快递单号的地图轨迹展示、物流节点文字信息及预计送达时间，可视化展示物流轨迹信息。

通过地图轨迹推送服务接口，企业提交快递单号，快递100接收到后便对这些运单进行跟踪，当运单状态发生变化的时候，快递100便通过调用回调接口将运单的跟踪信息和地图轨迹推送给贵公司，直到这些运单号的生命周期结束（一般以“已签收”为准）。对于某个单号，当贵方正确提交订阅了后，我们一般会在15分钟左右后进行第一次监控，如果监控到单号本身有了跟踪信息，即进行第一次推送，否则等待下一次监控。此后我们一般每4小时进行一次监控，并会根据单号的状态等因素作调整。

二、地图轨迹推送服务API应用场景

1. 让顾客登录您的网站、APP、小程序后，直接在“我的订单”页面内就能看到订单的物流状态和快递地图轨迹；
2. 和物流轨迹文字信息一同展示给顾客，可视化订单的在途状态；
3. 获得物流途径城市的信息，监控快递时效；
4. 预估包裹的到达时间，以及提示包裹还需多长时间到达，识别快递状态·，发送提醒客户签收短信；
5. 能开发自动的、批量查单功能，自动筛选出“已签收”、“疑难件”等状态的单号，减轻跟单人员的压力；
6. 改变订单的状态与交易流程，例如只要运单号变为“已签收”，就能让订单变更为可以确认退换货等；
7. 核销销售人员，根据“已签收”的运单数，就能算出销售人员的业绩；
8. 评估与选择快递公司，可获得快递实际在途时间，评估快递公司的时效，优化快递选择；
9. 助结算运费，找出“已签收”的单及签收时间，便能轻松应对货到付款的结算与对账；

三、系统结构与流程

<img src="https://p3-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/0fc2759fd0754030a6992d61b6e363ec~tplv-k3u1fbpfcp-zoom-1.image" alt="img" style="zoom: 67%;" />

四、快递信息推送API费用结算

1.收费方式

地图轨迹推送服务属于增值类服务，该服务同时支持物流文字信息以及地图链接，即包含了快递信息推送服务的功能。注册快递100企业账号后可以在企业管理后台查看地图轨迹套餐价格并购买。

2.收费价格

新品限时特惠，活动时间：2021年1月1日-2021年3月31日，充值后即可开通使用。

快递查询地图轨迹按单计费，一个自然月内同一个运单多次查询只收一次费用。该接口单独计费。

3. 开具发票

快递100支持开具增值税发票，用户购买完成后可在企业管理后台-费用中心-支付记录-请求开票。默认开具电子增值税普通发票，1000元以上可支持开具增值税专用发票。

官方源文档：

http://api.kuaidi100.com/document/603f45a0a52d305ab4d2a078.html

http://api.kuaidi100.com/document/603f47dfa62a19500e19866f.html

更多相关文章

1. 快递100快递实时快递查询接口API案例代码
2. 快递100快递信息订阅推送API接口案例代码
3. IT牛人进阶的必经之路
4. 快递单号批量查询软件，自动识别快递单号派送动态
5. Centos下堡垒机Jumpserver V3.0环境部署完整记录（1）-安装篇
6. 快递单号查询，自动快递单号查询软件
7. 融云 iOS 常见问题总汇
8. 市值两百亿，30亿就出售，快递黑马被京东集团收购
9. Git推送代码实战

随机推荐

1. [Android 博客]收集一些不错的，关于androi
2. android应用自定义字体
3. Android 控件使用参数集锦
4. Android架构组件-Lifecycle
5. Android API中文文档Button
6. Android开发软件
7. Android 资源聚集地
8. android中TextView内容过长加省略号
9. android 输入法出现挤压屏幕、android输
10. Android 对象序列化之追求完美的 Serial