一、订阅接口

1.1 订阅请求地址

<p>https://poll.kuaidi100.com/poll</p>

1.2 订阅请求类型

post

1.3 订阅输入参数

请求参数（header）

请求参数（body）

1.4 订阅请求参数示例

    schema = json
    param = {
        "company": "ems",
        "number": "1136281381675",
        "from": "广东省深圳市南山区",
        "to": "北京市朝阳区",
        "key": "XXX ",
        "parameters": {
            "callbackurl": "您的回调接口的地址，如http://www.您的域名.com/kuaidi?callbackid=...",
            "salt": "XXXXXXXXXX",
            "resultv2": "1",
            "autoCom": "1",
            "interCom"： "1",
            "departureCountry": "CN",
            "departureCom": "ems",
            "destinationCountry": "JP",
            "destinationCom": "japanposten"
        }
    }

1.5 订阅返回信息代码含义

result: true表示成功，false表示失败

1.6 订阅返回示例（JSON格式）

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

二、推送接口

2.1 推送请求地址

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

2.2 推送请求类型

post

2.3 推送输入参数

请求参数（header）

请求参数（body）

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": "上海市"
            }
        ]
    },
    "destResult": {
        "message": "ok",
        "state": "0",
        "status": "200",
        "condition": "F00",
        "ischeck": "0"     ,
        "com": "speedpost",
        "nu": "EX015142583SG",
        "data": [
        {
                "context": "[01000]Final delivery Delivered to: SLOVESNOV",
                "time": "2016-05-24 14:00:00",
                "ftime": "2016-05-24 14:00:00",
                "status": "签收",
                "areaCode": null,
                "areaName": null
            }
        ]
    }
}

2.5 运单签收状态服务说明

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

2.7 推送返回示例

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

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

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

三、快递公司编码

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

四、demo下载

<a href=“https://github.com/kuaidi100-api/java-demo” style=“color: #027eff;” target="_blank" rel=“nofollow noopener noreferrer”><u>JAVA示例代码</u></a>    <a href=“https://github.com/kuaidi100-api/php-demo” style=“color: #027eff;” target="_blank" rel=“nofollow noopener noreferrer”><u>PHP示例代码</u></a>    <a href=“https://github.com/kuaidi100-api/python-demo” style=“color: #027eff;” target="_blank" rel=“nofollow noopener noreferrer”><u>PYTHON示例代码</u></a>    <a href=“https://github.com/kuaidi100-api/.net-demo” style=“color: #027eff;” target="_blank" rel=“nofollow noopener noreferrer”><u>.NET示例代码</u></a>

一、快递信息推送API产品介绍

快递100信息推送服务提供运单查询、追踪的功能，用于企业对寄出的物品进行物流追踪。

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

二、快递信息推送API应用场景

让顾客登录您的网站、APP、小程序后，直接在“我的订单”页面内就能看到订单的物流状态。

能开发自动的、批量查单功能，自动筛选出“已签收”、“疑难件”等状态的单号，减轻跟单人员的压力。

改变订单的状态与交易流程，例如只要运单号变为“已签收”，就能让订单变更为可以确认退换货等。

核销销售人员，根据“已签收”的运单数，就能算出销售人员的业绩。

评估与选择快递公司，可获得快递实际在途时间，评估快递公司的时效，优化快递选择；

助结算运费，找出“已签收”的单及签收时间，便能轻松应对货到付款的结算与对账。

三、系统结构与流程

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

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

1. 收费方式

快递信息推送接口属于查询类接口，企业注册快递100账号后可以在企业管理后台查看查询类接口套餐<a href=“https://api.kuaidi100.com/service/query” target="_blank">查看查询类接口套餐</a>并购买。

2. 收费价格

查询类接口预充值收费套餐：充值即可开通使用，无需合同流程。

查询类接口按单收费，一个自然月内同一个运单多次查询只收一次费用。

3. 开具发票

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

官方源文档：

https://api.kuaidi100.com/document/5f0ffa7f2977d50a94e1023b.html

https://api.kuaidi100.com/document/5f0ffa8f2977d50a94e1023c.html