物流跟踪API-快递单推送（物流信息api）

网友投稿 457 2022-06-07


上一篇文章我们讲解了订阅服务功能。我们已经完成了如何把物流订单订阅到快递鸟，快递鸟也能接收到我们的订单信息，接下来就需要快递鸟实时的将最新的物流轨迹推送到我们服务器，我们既然要接收快递鸟的信息，就需要提供一个服务地址给快递鸟，以C#为列，我们新建一个接收页面，我的接收文件：　testReceive.aspx，把他部署到服务器，

接收地址：http://你的域名.com/testReceive.aspx

登陆快递鸟官网，通过快递鸟提供的沙箱调试页面进去测试接口

调试页面地址：

http://kdniao.com/UserCenter/v2/SandBox/PushQueryParam.aspx

 

测试的截图：

 

一、接口描述/说明

推送接口(商户实现)

（1）客户需要按快递鸟要求开发接口，保证信息的正常接收。
（2）快递鸟主动推送时，物流信息接收接口由客户提供。
（3）接口支持的消息接收方式为HTTP POST，请求方法的编码格式(utf-8)："application/x-www-form-urlencoded;charset=utf-8"。
（4）运单物流信息全量推送(每次推送的运单物流信息包括运单当前所有的的物流信息)。

请求系统级参数说明：

参数名称

类型

说明

必须要求

RequestData

String

请求内容需进行URL(utf-8)编码。请求内容只支持JSON格式。

R

RequestType

String

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

R

DataSign

String

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

R

备注：R-必填（Required），O-可选（Optional），C-报文中该参数在一定条件下可选（Conditional）

 

二、接口参数

推送接口

应用级输入参数

参数名称

类型

说明

必须要求

EBusinessID

String

用户电商ID

R

PushTime

String

推送时间

R

Count

String

推送物流单号轨迹个数

R

Data

String

推送物流单号轨迹集合

R

订阅查询结果（RequestType：101）

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

请求内容字段定义:

参数

类型

说明

必须要求

Data

EBusinessID

String

商户ID

O

ShipperCode

String

快递公司编码

R

LogisticCode

String

快递单号

R

Success

Bool

成功与否：true,false

R

Reason

String

失败原因

O

State

String

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

R

CallBack

String

订阅接口的Bk值

O

Traces

Traces

AcceptTime

String

时间

R

AcceptStation

String

描述

R

Remark

String

备注

O

EstimatedDeliveryTime

String

预计到达时间yyyy-mm-dd

O

货款状态（RequestType：107）

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

请求内容字段定义:

参数名称

类型

说明

必须要求

Data

EBusinessID

String

用户电商ID

O

OrderCode

String

订单编号

O

ShipperCode

String

快递公司编码

R

LogisticCode

String

物流运单号

R

Success

Bool

成功与否

R

Reason

String

失败原因

O

State

String

物流状态:0-无轨迹,1-已揽收, 2-在途中 201-到达派件城市，3-签收,4-问题件

R

CallBack

String

订阅接口的Bk值

O

OrderState

String

订单货款状态：1-待出款；2-已出款；3-已收款

O

AccountName

String

返款银行卡开户人（例：**伟、*佳）

O

AccountTel

String

返款银行卡手机末四位

O

AccountNum

String

返款银行卡末四位

O

返回参数定义

参数名称

类型

说明

必须要求

EBusinessID

String

用户ID

R

UpdateTime

String

时间

R

Success

Bool

成功与否：true，false

R

Reason

String

失败原因

O

 

推送接口(商户实现)

请求示例 JSON (订阅查询结果)


版权声明：本文内容由网络用户投稿，版权归原作者所有，本站不拥有其著作权，亦不承担相应法律责任。如果您发现本站中有涉嫌抄袭或描述失实的内容，请联系我们jiasou666@gmail.com 处理，核实后本网站将在24小时内删除侵权内容。

标签：测试接口
上一篇:Spring-cloud微服务实战【八】：API网关zuul（Spring Cloud微服务实战）
下一篇:RestTemplate---Spring提供的轻量Http Rest 风格API调用工具
相关文章

 发表评论

暂时没有评论，来抢沙发吧~