物流快递查询API接口怎么对接（中通、申通、韵达/顺丰、韵达）

2021-08-26 23:39:06

快递查询API接口是使用的物流单号即可实现查询物流信息。主要应用在电商商城、ERP系统商、WMS系统商、快递柜、银行等企业。多家快递物流公司接口统一接入，建议对接接口提供商，一次性可以接入多家快递，在后期的技术维护也会省下很多工作。

目前快递查询API接口有两种实现方式，一种是主动查询，一种是订阅接口推送数据。以快递鸟接口为例（接口对接需要接口秘钥，这里用的是测试的，不能够正式使用，可以到快递鸟官网申请http://www.kdniao.com/，是免费申请秘钥的）最后附有两个方法的demo

一.主动查询（即时查询API）

1）接口规则

a、查询接口支持按照运单号查询(单个查询，并发不超过10个/S)。

b、指定的物流运单号选择相应的快递公司编码，格式不对或则编码错误都会返失败的信息。如EMS物流单号应选择快递公司编码（EMS）

c、返回的物流跟踪信息按照发生的时间升序排列。

d、接口指令1002。

e、请求地址：http://api.kdniao.cc/Ebusiness/EbusinessOrderHandle.aspx

 2）系统级和应用级输入参数

3）返回结果参数

4）JSON请求示例

{

"OrderCode": "",

"ShipperCode": "SF",

"LogisticCode": "118650888018"
}

// "SF"为顺丰快递公司编码，其他编码可在快递鸟官网下载

5）JSON返回示例

//没有物流轨迹的

{

"EBusinessID": "1109259",

"Traces":[],

"OrderCode": "",

"ShipperCode": "SF",

"LogisticCode": "118461988807",

"Success": true,

"Reason": null

}

//有物流轨迹的

{

"EBusinessID": "1109259",

"OrderCode":"",

"ShipperCode": "SF",

"LogisticCode": "118461988807",

"Success": true,

"CallBack":"",

"State": 3,

"Reason": null,

"Traces":[

    {

       "AcceptTime": "2014/06/25 08:05:37",

       "AcceptStation": "正在派件..(派件人:邓裕富,电话:18718866310)[深圳 市]",

       "Remark": null

    },

    {

       "AcceptTime": "2014/06/25 04:01:28",

       "AcceptStation": "快件在 深圳集散中心 ,准备送往下一站 深圳 [深圳市]",

       "Remark": null

    },

    {

        "AcceptTime": "2014/06/2501:41:06",

       "AcceptStation": "快件在 深圳集散中心 [深圳市]",

       "Remark": null

    },

    {

       "AcceptTime": "2014/06/24 20:18:58",

       "AcceptStation": "已收件[深圳市]",

       "Remark": null

    },

    {

       "AcceptTime": "2014/06/24 20:55:28",

       "AcceptStation": "快件在 深圳 ,准备送往下一站 深圳集散中心 [深圳市]",

       "Remark": null

    },

    {

       "AcceptTime": "2014/06/25 10:23:03",

       "AcceptStation": "派件已签收[深圳市]",

       "Remark": null

    },

    {

       "AcceptTime": "2014/06/25 10:23:03",

       "AcceptStation": "签收人是：已签收[深圳市]",

       "Remark": null

    }

]

}

二.订阅接口推送数据（物流跟踪API）

订阅查询接口是定制化服务，用户可将订单信息订阅给快递公司，快递公司更新轨迹后，将实时转换成标准接口形式，推送给用户，起到实时推送的作用，提高效率。

同时用户订阅的数据还能选择是否通知快递员上门，实现在线下单功能。另外，快递鸟还有在途监控、电子面单等其他的接口方案，可以根据公司需求来选择。

1）接口规则

a、订单接收的信息(分给了的网点，业务员的信息)，会通过推送接口推给客户（订阅并发不超过30次/S）客户需要按要求实现接口。

b、仅支持Json格式。

c、请求指令1008。

d、测试接口地址：http://testapi.kdniao.cc:8081/api/dist

e、联调通过后请更换为正式地址：http://api.kdniao.cc/api/dist

f、分发及订阅接口需要客户方实现回调接口，回调RequestType(1008)

2）系统级和应用级参数

系统级输入参数

应用级输入参数

类型

是否必须

描述

RequestData（必填参数，请求内容，JSON格式,须和DataType一致））

CallBack

String

用户自定义回调信息

MemberID

String

会员标识(备用字段)

WareHouseID

String

仓库标识(备用字段)

CustomerName

String

电子面单客户账号

（与快递网点申请）

CustomerPwd

String

电子面单密码

SendSite

String

收件网点标识

ShipperCode

String

快递公司编码

LogisticCode

String

快递单号

OrderCode

String

订单编号

MonthCode

String

月结编码

PayType

Int

邮费支付方式:

1-现付，2-到付，3-月结，4-第三方支付

ExpType

String

快递类型：1-标准快件

Cost

Double

寄件费（运费）

OtherCost

Double

其他费用

Receiver

Company

String

收件人公司

Name

String

收件人

Tel

String

电话

Mobile

String

手机

PostCode

String

收件人邮编

ProvinceName

String

收件省（如广东省，不要缺少“省”）

CityName

String

收件市（如深圳市，不要缺少“市”）

ExpAreaName

String

收件区（如福田区，不要缺少“区”或“县”）

Address

String

收件人详细地址

Sender

Company

String

发件人公司

Name

String

发件人

Tel

String

发件人电话

Mobile

String

发件人手机

PostCode

String

发件人邮编

ProvinceName

String

发件省（如广东省，不要缺少“省”）

CityName

String

发件市（如深圳市，不要缺少“市”）

ExpAreaName

String

发件区（如福田区，不要缺少“区”或“县”）

Address

String

发件详细地址

StartDate

String

上门取货时间段:

"yyyy-MM-dd HH:mm:ss"格式化，本文中所有时间格式相同

EndDate

String

Weight

Double

物品总重量kg

Quantity

Int

件数/包裹数

Volume

Double

物品总体积m3

Remark

String

备注

IsNotice

Int

是否分发到快递公司：1-不分发；0-分发.默认为0

IsSendMessage

Int

是否订阅短信

0-不需要；1-需要

AddService

Name

String

增值服务名称

Value

String

增值服务值

CustomerID

String

客户标识(选填)

Commodity

GoodsName

String

商品名称

GoodsCode

String

商品编码

Goodsquantity

Int

件数

GoodsPrice

Double

商品价格

GoodsWeight

Double

商品重量kg

GoodsDesc

String

商品描述

GoodsVol

Double

商品体积m3

EBusinessID

String

商户ID

RequestType

String

请求指令类型：1008

DataSign

String

数据内容签名

DataType

String

请求、返回数据类型：2-json；

3）返回结果参数

同步返回

参数名称

类型

必须要求

说明

EBusinessID

String

电商用户ID

UpdateTime

String

时间

Success

Bool

成功与否:true,false

Reason

String

失败原因

EstimatedDeliveryTime

String

订单预计到货时间yyyy-mm-dd

4）JSON请求示例

{

"ShipperCode":"SF",

"OrderCode":"SF201608081055208281",

"LogisticCode":"3100707578976",

"PayType":"1",

"ExpType":"1",

"CustomerName":"",

"CustomerPwd":"",

"MonthCode":"",

"IsNotice":"0",

"Sender":{

    "Name":"1255760",

    "Tel":"",

   "Mobile":"13700000000",

    "ProvinceName":"广东省",

    "CityName":"深圳市",

    "ExpAreaName":"福田区",

    "Address":"测试地址"

},

"Receiver":{

    "Name":"1255760",

    "Tel":"",

   "Mobile":"13800000000",

    "ProvinceName":"广东省",

    "CityName":"深圳市",

    "ExpAreaName":"龙华新区",

    "Address":"测试地址2"

},

"Commodity":[

    {

        "GoodsName":"书本"

    }

]

}

5）JSON返回示例

{

"EBusinessID":"1151847",

"UpdateTime": "2016-08-0916:42:38",

"Success": true,

"Reason": ""

"EstimatedDeliveryTime":"2016-8-12"

}
即时查询APIdemo

物流跟踪APIdemo

码农公寓

相关文章