快递物流查询接口是指快递查询网对外开放的应用程序接口,开发人员能够通过调用该接口与快递查询网进行交互,并基于该接口开发自己的快递查询应用程序。目前比较常用的接口有快递鸟、菜鸟、快递100等。

1、应用场景

电商网站用户打开“我的订单”时调用此API显示物流信息详情;或者是电商管理后台的物流系统,客服在对账前查询所有运单的签收状态,并追踪问题。

 

python 快递鸟接口 快递接口api_java


2、快递查询接口分类

物流轨迹查询接口有即时查询和订阅查询两种,即时是请求即返回数据,订阅则是订阅快递单号到接口,有物流轨迹更新则全量返回数据。 

快递鸟即时接口可以查询3000次,3000以上接订阅接口,统一接口模式接入,常用快递均支持查询,还有订阅接口、在线下单接口、电子面单接口,接口均不收取费用,        没有要求用户添加外链,支持600家国内外快递物流查询。

 快递100每天可以免费查询2000次,超过2000次收费,每次0.06~0.1元不等,如果查询的量大的话可以降低费用,免费的接口有几家常用快递不支持接口模式,只支持   htmlAPI,要求用户添加外链,支持300多家国内外快递物流查询。

 快递网每天可以免费查询500次,超过500次收费,每次0.05元,只有即时查询和订阅推送接口,要求用户添加外链,支持395家国内外快递物流查询。

3、对接说明

不同公司的快递查询接口接入类似,都需要注册 ,申请账号获取KEY和ID,如果是订阅接口需要技术联调。以快递鸟及时查询接口接入为例。

根据快递单号和快递公司编码查询物流轨迹信息。接口需要指定快递单号的快递公司编码,格式不对或则编码错误都会返失败的信息。如:EMS物流单号应选择快递公司编码(EMS返回的物流跟踪信息按照发生的时间升序排列。

接口支持的消息接收方式为HTTP POST

3.1请求系统级参数

参数名称

类型

说明

必须要求

RequestData

String

请求内容需进行URL(utf-8)编码。请求内容JSON或XML格式,须和DataType一致。

R

EBusinessID

String

商户ID,请在我的服务页面查看。

R

RequestType

String

请求指令类型:1002

R

DataSign

String

数据内容签名:把(请求内容(未编码)+AppKey)进行MD5加密,然后Base64编码,最后进行URL(utf-8)编码。详细过程请查看Demo。

R

DataType

String

请求、返回数据类型:1-xml,2-json;默认为xml格式

O

3.2请求内容字段定义

参数

类型

说明

必须要求

OrderCode

String

订单编号

O

ShipperCode

String

快递公司编码

R

LogisticCode

String

物流单号

R

3.3返回参数定义

参数名称

类型

说明

必须要求

EBusinessID

String

用户ID

R

OrderCode

String

订单编号

O

ShipperCode

String

快递公司编码

R

LogisticCode

String

物流运单号

R

Success

Bool

成功与否

R

Reason

String

失败原因

O

State

String

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

R

Traces

Trace

AcceptTime

String

时间

R

AcceptStation

String

描述

R

Remark

String

备注

O