快递查询接口种类及对接方法

简幽 简幽     2022-09-20     671

关键词:

    目前快递查询接口有两种方式可以对接,一是和顺丰、圆通、中通、天天、韵达、德邦这些快递公司一一对接接口,二是和快递鸟这样第三方集成接口一次性对接多家常用快递。第一种耗费时间长,但是是直接和快递公司合作,第二种虽然是间接对接,但是对接简便,对后期的接口维护可以省很多时间和人力成本。

    集成接口还有其他公司提供,有其他需要可以去找,快递鸟其实能满足电商、ERP系统商这些企业需求了。这里就以快递鸟为例说说对接方法。

    快递鸟物流查询接口有免费和收费版本,对接周期大概在一天左右,他们有写好的demo,可以直接使用。

    一.即时查询接口(免费)

1.   接口规则

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

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

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

(4)、接口指令1002。

(5)、请求地址:http://api.kdniao.cc/Ebusiness/EbusinessOrderHandle.aspx

 

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

系统级输入参数

类型

应用级输入参数

必须要求

说明

RequestData

String

OrderCode

O

订单编号

请求内容,JSON格式,和DataType一致

ShipperCode

R

快递公司编码

LogisticCode

R

物流单号

EBusinessID

String

 

R

电商ID

RequestType

String

R

请求指令类型:1002

DataSign

String

R

数据内容签名

DataType

String

R

请求、返回数据类型: 2-json;

3.   返回结果参数

参数名称

类型

必须要求

说明

EBusinessID

String

R

电商用户ID

OrderCode

String

O

订单编号

ShipperCode

String

R

快递公司编码

LogisticCode

String

R

物流运单号

CallBack

String

O

用户标识

Success

Bool

R

成功与否

Reason

String

O

失败原因

State

String

R

物流状态: 0-无轨迹 2-在途中,3-签收,4-问题件

Traces/物流轨迹详情

AcceptTime

String

R

时间

AcceptStation

String

R

描述

Remark

String

O

备注

 

4.   示例

//请求示例
{ "OrderCode": "", "ShipperCode": "SF", "LogisticCode": "118650888018" }

 

//返回示例
//没有物流轨迹的 { "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/25 01: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 } ] }

  

    二.物流跟踪接口(免费)

   2.1请求接口

    物流跟踪接口和即时查询接口的区别:

    查询次数-物流跟踪接口不限次数,即时查询接口每天只能查询3000次

    接口使用-物流跟踪接口使用订阅单号异步推送的方式,就是如有物流轨迹更新,则推送给用户,后期用户需要查询的时候调用本地数据库就可以了,而即时查询接口是即时返回的方式,就是请求一次,返回一次

1.   接口规则

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

(2)、仅支持Json格式。

(3)、请求指令1008。

(4)、测试接口地址:http://testapi.kdniao.cc:8081/api/dist

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

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

 

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

系统级输入参数

应用级输入参数

类型

是否必须

描述

RequestData(必填参数,请求内容,JSON格式,须和DataType一致))

CallBack

String

O

用户自定义回调信息

MemberID

String

O

会员标识(备用字段)

WareHouseID

String

O

仓库标识(备用字段)

CustomerName

String

O

电子面单客户账号

(与快递网点申请)

CustomerPwd

String

O

电子面单密码

SendSite

String

O

收件网点标识

ShipperCode

String

R

快递公司编码

LogisticCode

String

R

快递单号

OrderCode

String

O

订单编号

MonthCode

String

O

月结编码

PayType

Int

O

邮费支付方式:

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

ExpType

String

O

快递类型:1-标准快件

Cost

Double

O

寄件费(运费)

OtherCost

Double

O

其他费用

Receiver

Company

String

O

收件人公司

Name

String

O

收件人

Tel

String

O

电话

Mobile

String

O

手机

PostCode

String

O

收件人邮编

ProvinceName

String

O

收件省(如广东省,不要缺少“省”)

CityName

String

O

收件市(如深圳市,不要缺少“市”)

ExpAreaName

String

O

收件区(如福田区,不要缺少“区”或“县”)

Address

String

O

收件人详细地址

Sender

Company

String

O

发件人公司

Name

String

O

发件人

Tel

String

O

发件人电话

Mobile

String

O

发件人手机

PostCode

String

O

发件人邮编

ProvinceName

String

O

发件省(如广东省,不要缺少“省”)

CityName

String

O

发件市(如深圳市,不要缺少“市”)

ExpAreaName

String

O

发件区(如福田区,不要缺少“区”或“县”)

Address

String

O

发件详细地址

StartDate

String

O

上门取货时间段:

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

EndDate

String

O

Weight

Double

O

物品总重量kg

Quantity

Int

O

件数/包裹数

Volume

Double

O

物品总体积m3

Remark

String

O

备注

IsNotice

Int

O

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

IsSendMessage

Int

O

是否订阅短信

0-不需要;1-需要

AddService

Name

String

0

增值服务名称

Value

String

0

增值服务值

CustomerID

String

0

客户标识(选填)

Commodity

GoodsName

String

O

商品名称

GoodsCode

String

O

商品编码

Goodsquantity

Int

O

件数

GoodsPrice

Double

O

商品价格

GoodsWeight

Double

O

商品重量kg

GoodsDesc

String

O

商品描述

GoodsVol

Double

O

商品体积m3

EBusinessID

 

String

R

商户ID

RequestType

String

R

请求指令类型:1008

DataSign

String

R

数据内容签名

DataType

String

R

请求、返回数据类型:2-json;

 

3.   返回结果参数(同步返回是否调用成功)

参数名称

类型

必须要求

说明

EBusinessID

String

R

电商用户ID

UpdateTime

String

R

时间

Success

Bool

R

成功与否:true,false

Reason

String

O

失败原因

EstimatedDeliveryTime

String

O

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

 

4.   调用示例

//请求示例
{ "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":"书本" } ] }

 

//返回示例
{ "EBusinessID": "1151847", "UpdateTime": "2016-08-09 16:42:38", "Success": true, "Reason": "" "EstimatedDeliveryTime":"2016-8-12" }

  

   2.2接收接口

这个是用户在订阅单号成功且有物流轨迹更新后,快递鸟的推送

客户通过下单、订阅接口,把运单号在快递鸟系统订阅。运单物流信息有更新,快递鸟通过推送接口把更新的信息推送给客户。推送接口由用户按照快递鸟规则实现。商户开放接口,快递鸟定时将最新的物流轨迹推送到商户平台。

优点:客户不需要关注轨迹变化,一旦有更新,快递鸟自动推送。

缺点:对客户的服务器性能有所要求,快递鸟定时请求接口,对客户的服务器有一定的影响,客户服务器异常将接受不到最新数据。

快递鸟推送接口根据业务不同,会根据RequestType的分类推送不同的数据,用户需对推送的数据进行分类保存。原推送接口无需变化,快递鸟会根据推送版本进行推送。

1.   接口规则

(1)、客户服务器必须稳定,并且有一定的接受数据能力(需要在5S内给快递鸟返回成功示例,超时会判断推送失败)。快递鸟通过多线程推送物流信息给客户。

(2)、客户需要按快递鸟要求开发接口,保证信息的正常接收。客户接数据后,存储并马上返回接收响应。如果客户对数据进行处理,再做出响应。这会造成网络超时,传输效率低下。

(3)、主动推送时物流信息接收接口由客户提供,接口必须按照快递鸟的要求实现。

(4)、客户提供接口地址,用户登陆用户管理后台-----调试平台-----推送接口进行测试---(成功返回示例后)才可以配置。

(5)、接口只支持Json数据格式。

(6)、POST方式请求。

 

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

系统级输入参数

应用级输入参数

类型

必须要求

说明

RequestData

EBusinessID

String

R

用户电商ID

推送数据经url转码utf-8

PushTime

推送时间

Count

推送物流单号轨迹个数

Data

推送物流单号轨迹集合

RequestType

 

String

R

101-轨迹查询结果, 107-货款状态

DataSign

String

R

数据内容签名(把(请求内容(未编码)+AppKey)进行MD5加密,然后Base64编码)

 


3.   订阅查询结果(RequestType:101)

通过轨迹查询(订阅查询)接口订阅到快递鸟的数据,快递鸟推送时,会将推送的RequestType的值置为101同时返回下列数据

参数名称

类型

必须要求

说明

Data

EBusinessID

String

O

电商用户ID

OrderCode

String

O

订单编号

ShipperCode

String

R

快递公司编码

LogisticCode

String

R

物流运单号

Success

Bool

R

成功与否

Reason

String

O

失败原因

State

String

R

物流状态:

0-无轨迹

2-在途中

3-签收

4-问题件

CallBack

String

O

订阅接口的Bk值

Traces

String

R

物流轨迹详情

EstimatedDeliveryTime

String

O

预计到达时间yyyy-mm-dd

PickerInfo

Object

O

收件员信息

SenderInfo

Object

O

派件员信息

注:通过订单分发与电子面单接口自动订阅的运单,会返回预计达到时间,收派件人员网点信息,当前快件所在省市等字段

 

参数名称

类型

必须要求

说明

Traces

AcceptTime

String

R

时间

AcceptStation

String

R

描述

Remark

String

O

备注

 

3.  订阅查询(增值版)结果(RequestType:102)

这个是增值收费项,不想用收费的不支付就不会有这个服务,通过轨迹查询(订阅查询)接口订阅到快递鸟的数据,快递鸟推送时,会将推送的RequestType的值置为102同时返回下列数据

参数名称

类型

必须要求

说明

Date

EBusinessID

String

O

电商用户ID

OrderCode

String

O

订单编号

ShipperCode

String

R

快递公司编码

LogisticCode

String

R

物流运单号

Success

Bool

R

成功与否

Reason

String

O

失败原因

State

String

R

物流状态:

0-无轨迹

2-在途中

3-签收

4-问题件

StateEx

String

O

增值物流状态:

1-已揽收

2-在途中

201-到达派件城市

202-派件中

211-已放入快递柜或驿站

3-已签收

311-已取出快递柜或驿站

4-问题件

401-发货无信息

402-超时未签收

403-超时未更新

404-拒收(退件)

412-快递柜或驿站超时未取

Location

String

O

当前城市

CallBack

String

O

订阅接口的Bk值

Traces

String

R

物流轨迹详情

EstimatedDeliveryTime

String

O

预计到达时间yyyy-mm-dd

PickerInfo

Object

O

收件员信息

SenderInfo

Object

O

派件员信息

注:通过订单分发与电子面单接口自动订阅的运单,会返回预计达到时间,收派件人员网点信息,当前快件所在省市等字段

 

参数名称

类型

必须要求

说明

Traces

AcceptTime

String

R

时间

AcceptStation

String

R

描述

Location

String

O

当前城市

Action

String

O

当前状态

Remark

String

O

备注

 

4.  货款状态(RequestType:107)

用户通过电子面单使用快递鸟货到付款等金融服务时,快递鸟会将该订单的金融状态通过接口推送给用户。

参数名称

类型

必须要求

说明

Response

EBusinessID

String

O

电商用户ID

OrderCode

String

O

订单编号

ShipperCode

String

R

快递公司编码

LogisticCode

String

R

物流运单号

Success

Bool

R

成功与否

Reason

String

O

失败原因

State

String

R

物流状态:

0-无轨迹

2-在途中

3-签收

4-问题件

CallBack

String

O

订阅接口的Bk值

OrderState

String

O

订单货款状态:

1-待出款;

2-已出款;

3-已收款

AccountName

String

O

返款银行卡开户人(例:**伟、*佳)

AccountTel

String

O

返款银行卡手机末四位

AccountNum

String

O

返款银行卡末四位

注:通过订单分发与电子面单接口自动订阅的运单,会返回预计达到时间,收派件人员网点信息,当前快件所在省市等字段

 

4.  返回结果参数

参数名称

类型

必须要求

说明

EBusinessID

String

R

用户ID

UpdateTime

String

R

时间

Success

String

R

成功与否

Reason

String

O

失败原因

 

5.  示例

//快递鸟请求接收接口示例
订阅查询结果示例: { "EBusinessID": "1109259", "Count": "2", "PushTime": "2015-03-11 16:21:06", "Data": [ { "EBusinessID": "1109259", "OrderCode": "", "ShipperCode": "EMS", "LogisticCode": "5042260908504", "Success": true, "Reason": "", "State": "2", "CallBack": "0", "Traces": [ { "AcceptTime": "2015-03-06 21:16:58", "AcceptStation": "深圳市横岗速递营销部已收件,(揽投员姓名:钟定基;联系电话:)", "Remark": "" }, { "AcceptTime": "2015-03-07 14:25:00", "AcceptStation": "离开深圳市 发往广州市", "Remark": "" }, { "AcceptTime": "2015-03-08 00:17:00", "AcceptStation": "到达广东速递物流公司广航中心处理中心(经转)", "Remark": "" }, { "AcceptTime": "2015-03-08 01:15:00", "AcceptStation": "离开广州市 发往北京市(经转)", "Remark": "" }, { "AcceptTime": "2015-03-09 09:01:00", "AcceptStation": "到达北京黄村转运站处理中心(经转)", "Remark": "" }, { "AcceptTime": "2015-03-09 18:39:00", "AcceptStation": "离开北京市 发往呼和浩特市(经转)", "Remark": "" }, { "AcceptTime": "2015-03-10 18:06:00", "AcceptStation": "到达 呼和浩特市 处理中心", "Remark": "" }, { "AcceptTime": "2015-03-11 09:53:48", "AcceptStation": "呼和浩特市邮政速递物流分公司金川揽投部安排投递(投递员姓名:安长虹;联系电话:18047140142)", "Remark": "" } ] }, { "EBusinessID": "1109259", "OrderCode": "", "ShipperCode": "EMS", "LogisticCode": "5042260943004", "Success": true, "Reason": "", "State": "2", "CallBack": "0", "Traces": [ { "AcceptTime": "2015-03-07 15:26:09", "AcceptStation": "深圳市横岗速递营销部已收件,(揽投员姓名:周宏彪;联系电话:13689537568)", "Remark": "" }, { "AcceptTime": "2015-03-08 16:32:00", "AcceptStation": "离开深圳市 发往广州市", "Remark": "" }, { "AcceptTime": "2015-03-09 00:58:00", "AcceptStation": "到达广东速递物流公司广航中心处理中心(经转)", "Remark": "" }, { "AcceptTime": "2015-03-09 01:15:00", "AcceptStation": "离开广州市 发往北京市(经转)", "Remark": "" }, { "AcceptTime": "2015-03-10 05:20:00", "AcceptStation": "到达北京黄村转运站处理中心(经转)", "Remark": "" }, { "AcceptTime": "2015-03-10 11:59:00", "AcceptStation": "离开北京市 发往廊坊市(经转)", "Remark": "" }, { "AcceptTime": "2015-03-10 14:23:00", "AcceptStation": "到达廊坊市处理中心(经转)", "Remark": "" }, { "AcceptTime": "2015-03-11 08:55:00", "AcceptStation": "离开廊坊市 发往保定市(经转)", "Remark": "" } ] } ] } 货款状态: { "EBusinessID": "1109259", "Count": "2", "PushTime": "2015/3/11 16:21:06", "Data": [ { "EBusinessID": "1109259", "OrderCode": "", "ShipperCode": "EMS", "LogisticCode": "5042260908504", "Success": true, "Reason": "", "State": "2", "CallBack": "0", "OrderState":"1", "AccountName":"张三", "AccountTel":"13800000000", "AccountNum":"0321" }, { "EBusinessID": "1109259", "OrderCode": "", "ShipperCode": "EMS", "LogisticCode": "5042260908522", "Success": true, "Reason": "", "State": "2", "CallBack": "0", "OrderState":"1", "AccountName":"张三", "AccountTel":"13800000011", "AccountNum":"0321" } ] }

  

//用户接收后返回
{ "EBusinessID": "1109259", "UpdateTime": "2015-03-11 16: 26: 11", "Success": true, "Reason": "" }

  

国际快递查询轨迹api接口如何对接?

像UPS,联邦快递这些API接口怎么对接参考技术A需要用一个系统对接另一个系统,需要技术人员对接接口,看是否需要改变字段或者开发语言等等,同时对接完成后需要两边的系统测试数据传输的稳定性,这边建议使用快递鸟这... 查看详情

微信小程序快递鸟快递查询接口对接

微信小程序快递查询接口对接指南1、登录快递鸟官网注册页面注册快递鸟账号网址:http://www.kdniao.com/reg2、登录快递鸟用户管理后台网址:http://www.kdniao.com/login注:登录快递鸟用户管理后台后获得用户ID和APIKey,此用于保证应用... 查看详情

查快递,对接哪个接口比较好?

快递查询接口可以直接找物流公司对接,也可以找第三方接口服务商一次性对接所有快递公司的查询接口,做的比较好的就是菜鸟、快递鸟,目前淘宝和天猫等阿里的都用菜鸟,其他的大部分电商平台比如美团、云集、凯叔讲故... 查看详情

圆通电子面单接口对接及调试

  电子面单接口是快递鸟提供给独立电商、仓储管理系统、物流供应链等物流系统平台使用的下单接口,满足客户在线发货需求并提供打印面单的服务,客户通过网络选择物流公司发送请求通知贵公司有快递要发货,把数... 查看详情

java对接快递鸟单号查询自动识别接口,调用示例

...询功能时,只需要录入单号即可完成查询,无需用户输入快递公司。(2)电商网站要在快递鸟查询或者订阅运单时,可通过单号识别先行判断物流公司后,再订阅到快递鸟。API参数一、接口描述/说明(1)该接口仅对运单号做出... 查看详情

常用电子面单接口对接技术文档

 一.电子面单接口类型及定义1.快递电子面单接口:快递公司自己开发的电子面单服务,商家使用必须快递公司上门做系统对接,使用一家快递则需要对接一次。2.菜鸟电子面单接口:可一次对接15家快递公司,无需和每一家... 查看详情

java查询快递物流信息api接口写法免费

效果图:  快递查询API接口是使用的物流单号即可实现实时查询物流信息。主要应用在电商商城、ERP系统商、WMS系统商、快递柜、银行等企业。多家快递物流公司接口统一接入,建议对接接口提供商,一次性可以接入多家... 查看详情

求快递查询api,想接入一个到自己网站上?

我们公司网站刚对接了快递鸟的物流查询接口,综合对比多家选择了快递鸟。在快递查询接口领域比较知名的了,有在途监控、在途监控地图版、快递查询、在途监控国际版等接口,支持1600+国内外主流物流快递公司,一次性对... 查看详情

顺丰电子面单api接口怎么接入?

...技术A目前我国电子面单的接口主要有三种方式,分别是快递公司电子面单接口、快递鸟电子面单接口、菜鸟电子面单接口1、快递公司接口由各个快递公司单独开发的接口,面向商家。商家需先注册账号申请对接,快递鸟与快递... 查看详情

电子面单批量打印接口对接(含打印控件)

...下梳理和使用方法介绍。目前支持批量打印电子面单的有快递鸟、菜鸟和快递公司。但是快递公司仅能打印本公司的电子面单,对于电商等发货商来说不太适用,菜鸟教适合淘系商家,快递鸟则比较通用,这里介绍快递鸟电子面... 查看详情

电商适用电子面单接口对接案例

电子面单接口现在有快递公司、菜鸟和快递鸟提供快递公司是一家家合作,要接口文档,逐一对接菜鸟和快递鸟是电子面单接口集成方,能打印多家快递电子面单,菜鸟目前支持15家,快递鸟支持20家,基本上都是常用的快递,... 查看详情

万物皆可集成系列:低代码对接阿里物流api实现快递跟踪

随着各大电商网购平台的发展,快递业已形成一个规模庞大的产业,据统计,全球快递企业已超过千家,而快递查询对于电商平台而言是最基础的功能之一,通过输入快递单号,不用区分具体是哪家快递公... 查看详情

万物皆可集成系列:低代码对接阿里物流api实现快递跟踪

随着各大电商网购平台的发展,快递业已形成一个规模庞大的产业,据统计,全球快递企业已超过千家,而快递查询对于电商平台而言是最基础的功能之一,通过输入快递单号,不用区分具体是哪家快递公... 查看详情

ems快递单号查询快递鸟接口(代码片段)

EMS快递查询调用快递鸟提供的快递查询API标准接口,快速对接100多家快递公司的物流轨迹查询,本篇文章实现<EMS>的快递单号查询。首先我们准备好需要用到的资源,这里推荐大家去爱奇艺查看视频教程:https://www.iqiyi.com/v_1... 查看详情

免费圆通电子面单接口对接

  电子面单接口是快递鸟提供给独立电商、仓储管理系统、物流供应链等物流系统平台使用的下单接口,满足客户在线发货需求并提供打印面单的服务,客户通过网络选择物流公司发送请求通知贵公司有快递要发货,把数... 查看详情

各种电子面单_api接口

...作打印电子面单。 一.电子面单接口类型及定义 1.快递电子面单接口:快递公司自己开发的电子面单服务,商家使用必须快递公司上门做系统对接,使用一家快递则需要对接一次。 2 查看详情

物流即使查询api-java篇

...一篇文章我们介绍了一个物流服务提供商,推荐大家使用快递鸟接口,主要介绍了如何注册账号,获得密钥,找不到注册地址的,我在发一下:http://kdniao.com/reg之前也聊过如何利用快递鸟提供的接口来实现即时查询。也提供了C#... 查看详情

顺丰快递怎么一直显示准备送往下一站

...当时卖家承诺一号肯定到的啊....货单号是109847545462  快递信息中显示“准备送往下一站”的意思是快件正在某站点整理归类,准备撞车发往下一中间站。如果长时间出现该信息,有可能是因为物流信息系统更新比较慢,或者... 查看详情