快递在途监控API接口代码

官网：快递鸟

API参数

一、接口描述/说明

1.即时查询(增值版)接口

（1）查询接口支持按照运单号查询(单个查询)。
（2）接口需要指定快递单号的快递公司编码，格式不对或则编码错误都会返失败的信息。
如：EMS物流单号应选择快递公司编码（EMS）查看快递公司编码
（3）返回的物流跟踪信息按照发生的时间升序排列。
（4）接口指令8001。
（5）接口支持的消息接收方式为HTTP POST，请求方法的编码格式(utf-8)："application/x-www-form-urlencoded;charset=utf-8"。
（6）接口地址： API测试地址：http://sandboxapi.kdniao.com:8080/kdniaosandbox/gateway/exterfaceInvoke.json
API正式地址：https://api.kdniao.com/Ebusiness/EbusinessOrderHandle.aspx
 

请求系统级参数说明：

参数名称类型说明必须要求
RequestDataString请求内容需进行URL(utf-8)编码。请求内容JSON格式，须和DataType一致。是
EBusinessIDString商户ID，请在我的服务页面查看。是
RequestTypeString请求指令类型：8001是
DataSignString数据内容签名：把(请求内容(未编码)+AppKey)进行MD5加密，然后Base64编码，最后 进行URL(utf-8)编码。详细过程请查看Demo。是
DataTypeString请求、返回数据类型：2-json；否

2.订阅(增值版)接口

（1）此功能为专业定制，为特殊商户提供订阅服务，快递鸟系统会定时推送新的物流信息到商户系统。
（2）订阅快递号需指定相应的快递公司编码，格式不对或则编码错误都会返失败的信息。
如：EMS物流单号应选择快递公司编码（EMS）查看快递公司编码
（3）接口支持的消息接收方式为HTTP POST，请求方法的编码格式(utf-8)："application/x-www-form-urlencoded;charset=utf-8"。
（4）接口地址： API测试地址：http://sandboxapi.kdniao.com:8080/kdniaosandbox/gateway/exterfaceInvoke.json
API正式地址：https://api.kdniao.com/api/dist

请求系统级参数说明：

参数名称类型说明必须要求
RequestDataString请求内容需进行URL(utf-8)编码。请求内容JSON格式，须和DataType一致。是
EBusinessIDString商户ID，请在我的服务页面查看。是
RequestTypeString请求指令类型：8008是
DataSignString数据内容签名：把(请求内容(未编码)+AppKey)进行MD5加密，然后Base64编码，最后 进行URL(utf-8)编码。详细过程请查看Demo。是
DataTypeString请求、返回数据类型：2-json；否

3.推送(增值版)接口(商户实现)

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

请求系统级参数说明：

参数名称类型说明必须要求
RequestDataString请求内容需进行URL(utf-8)编码。请求内容只支持JSON格式。是
EBusinessIDString102-轨迹查询结果, 107-货款状态。是

二、接口参数

1.即时查询(增值版)接口

请求内容字段定义：

参数名称类型说明必须要求
OrderCodeString订单编号否
ShipperCodeString快递公司编码是
LogisticCodeString物流单号是

返回参数定义：

参数名称类型说明必须要求
EBusinessIDString用户ID是
OrderCodeString订单编号否
ShipperCodeString快递公司编码是
LogisticCodeString物流运单号否
SuccessBool成功与否是
ReasonString失败原因否
StateString物流状态：2-在途中,3-签收,4-问题件是
StateExString增值物流状态： 1-已揽收， 2-在途中， 201-到达派件城市， 202-派件中， 211-已放入快递柜或驿站， 3-已签收， 311-已取出快递柜或驿站， 4-问题件， 401-发货无信息， 402-超时未签收， 403-超时未更新， 404-拒收（退件）， 412-快递柜或驿站超时未取是
LocationString增值所在城市是
Traces
AcceptTimeString时间是
AcceptStationString描述是
LocationString当前城市否
ActionString当前状态否
RemarkString备注否

2.订阅(增值版)接口

请求内容字段定义：

参数名称类型说明必须要求
CallbackString用户自定义回调信息。否
MemberIDString会员标识。否
WareHouseIDString仓库标识否
CustomerNameString电子面单客户号否
CustomerPwdString电子面单密码否
SendSiteString收件网点标识(名称)否
ShipperCodeString快递公司编码 详细编码参考《快递鸟接口支持快递公司编码.xlsx》是
LogisticCodeString快递单号是
OrderCodeString订单编号否
MonthCodeString月结编号否
PayTypeInt(1)运费支付方式： 1-现付，2-到付，3-月结，4-第三方支付否
ExpTypeString(2)快递类型：1-标准快件 详细快递类型参考《快递公司快递业务类型.xlsx》否
CostDouble快递运费否
OtherCostDouble快递运费否
ReceiverCompanyString收件人公司否
NameString收件人是
TelString电话与手机，必填一个是
MobileString
PostCodeString收件地邮编(ShipperCode为EMS、YZPY时必填)否
ProvinceNameString收件省 (如广东省，不要缺少“省”；如是直辖市，请直接传北京、上海等； 如是自治区，请直接传广西壮族自治区等)是
CityNameString收件市(如深圳市，不要缺少“市”)是
ExpAreaNameString收件区/县(如福田区，不要缺少“区”或“县”)是
AddressString收件人详细地址是
SenderCompanyString发件人公司否
NameString发件人是
TelString电话与手机，必填一个是
MobileString
PostCodeString发件地邮编(ShipperCode为EMS、YZPY时必填)否
ProvinceNameString发件省 (如广东省，不要缺少“省”； 如是直辖市，请直接传北京、上海等； 如是自治区，请直接传广西壮族自治区等)是
CityNameString发件市(如深圳市，不要缺少“市”)是
ExpAreaNameString发件区/县(如福田区，不要缺少“区”或“县”)是
AddressString发件人详细地址是
IsNoticeInt(1)是否通知快递员上门揽件：0-通知；1-不通知；不填则否
StartDateString上门揽件时间段，格式：YYYY-MM-DD HH24:MM:SS否
EndDateString否
WeightDouble月结编号否
MonthCodeString包裹总重量kg否
QuantityInt(2)包裹数，一个包裹对应一个运单号，如果是大于1个包裹，返回则按照子母件的方式返回母运单号和子运单号否
VolumeDouble包裹总体积m3否
RemarkString备注否
IsSendMessageInt(1)是否订阅短信： 0-不需要；1-需要否
AddServiceNameString增值服务名称否
ValueString增值服务值否
CustomerIDString客户标识否
CommodityGoodsNameString商品名称否
GoodsCodeString商品编码否
GoodsquantityInt(5)商品件数否
GoodsPriceString商品价格否
GoodsWeightString商品重量kg否
GoodsDescString商品描述否
GoodsVolDouble商品体积m3否

返回参数定义：

参数名称类型说明必须要求
EBusinessIDString用户ID是
UpdateTimeString时间是
SuccessBool成功与否：true，false是
ReasonString失败原因否
EstimatedDeliveryTimeString订单预计到货时间yyyy-mm-dd（即将上线）否

3.推送(增值版)接口

应用级输入参数

参数名称类型说明必须要求
EBusinessIDString用户电商ID是
PushTimeString推送时间是
CountString推送物流单号轨迹个数是
DataString推送物流单号轨迹集合是

订阅查询(增值版)结果（RequestType：102）

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

请求内容字段定义:

参数类型说明必须要求
DataEBusinessIDString商户ID否
OrderCodeString订单编号否
ShipperCodeString快递公司编码是
LogisticCodeString快递单号R
SuccessBool成功与否：true,false是
ReasonString失败原因否
StateString物流状态: 0-无轨迹，1-已揽收，2-在途中 201-到达派件城市，3-签收,4-问题件是
StateExString增值物流状态： 1-已揽收， 2-在途中， 201-到达派件城市， 202-派件中， 211-已放入快递柜或驿站， 3-已签收， 311-已取出快递柜或驿站， 4-问题件， 401-发货无信息， 402-超时未签收， 403-超时未更新， 404-拒收（退件）， 412-快递柜或驿站超时未取是
LocationString增值所在城市是
CallBackString订阅接口的Bk值否
Traces
TraceAcceptTimeString时间是
AcceptStationString描述是
ActionString当前状态是
LocationString当前城市是
RemarkString备注否
EstimatedDeliveryTimeString预计到达时间yyyy-mm-dd否
PickerInfoPersonNameString快递员姓名否
PersonTelString快递员电话否
PersonCodeString快递员工号否
StationNameString网点名称否
StationAddressString网点地址否
StationTelString网点电话否
SenderInfoPersonNameString派件员姓名否
PersonTelString派件员电话否
PersonCodeString派件员工号否
StationNameString派件网点名称否
StationAddressString派件网点地址否
StationTelString派件网点电话否

返回参数定义

参数名称类型说明必须要求
EBusinessIDString用户ID是
UpdateTimeString时间是
SuccessBool成功与否：true，false是
ReasonString失败原因否

三、示例

即时查询(增值版)接口

请求示例 JSON

{"OrderCode": "","ShipperCode": "QFKD","LogisticCode": "390141793061"
}

返回示例 JSON

没有物流轨迹的{"EBusinessID":"1261585","Traces":[],"OrderCode":"","ShipperCode":"QFKD","LogisticCode":"390141793061","Success":false,"Reason":null
}有物流轨迹的{"EBusinessID":"1261585","ShipperCode":"QFKD","Success":true,"LogisticCode":"390141793061","State":"3","StateEx":"3","Location":"威海市","Traces":[{"AcceptTime":"2016-10-26 18:31:38","AcceptStation":"【北京环铁站】的【互优图书】已收件","Location":"北京市","Action":"1"},{"AcceptTime":"2016-10-26 19:53:50","AcceptStation":"快件在【北京环铁站】装车,正发往【北京分拨中心】","Location":"北京市","Action":"2"},{"AcceptTime":"2016-10-26 21:00:13","AcceptStation":"快件到达【北京分拨中心】,上一站是【北京环铁站】","Location":"北京市","Action":"2"},{"AcceptTime":"2016-10-26 21:06:27","AcceptStation":"快件在【北京分拨中心】装车,正发往【青州分拨中心】","Location":"北京市","Action":"2"},{"AcceptTime":"2016-10-27 11:04:43","AcceptStation":"快件到达【北京分拨中心】,上一站是【】","Location":"北京市","Action":"2"},{"AcceptTime":"2016-10-27 13:04:43","AcceptStation":"快件在【北京分拨中心】装车,正发往【青州分拨中心】","Location":"北京市","Action":"2"},{"AcceptTime":"2016-10-27 20:06:03","AcceptStation":"快件到达【青州分拨中心】,上一站是【】","Location":"潍坊市","Action":"2"},{"AcceptTime":"2016-10-27 22:06:03","AcceptStation":"快件在【青州分拨中心】装车,正发往【威海】","Location":"潍坊市","Action":"2"},{"AcceptTime":"2016-10-28 09:53:53","AcceptStation":"快件到达【威海】,上一站是【青州分拨中心】","Location":"威海市","Action":"2"},{"AcceptTime":"2016-10-28 10:44:39","AcceptStation":"快件到达【威海】,上一站是【青州分拨中心】","Location":"威海市","Action":"2"},{"AcceptTime":"2016-10-28 10:48:03","AcceptStation":"【威海】的【王奕凯】正在派件","Location":"威海市","Action":"202"},{"AcceptTime":"2016-10-28 18:09:45","AcceptStation":"已签收,签收人是【毕森】,签收网点是【威海】","Location":"威海市","Action":"3"}]
}

订阅(增值版)接口

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

返回示例 JSON

{"EBusinessID":"1151847","UpdateTime":"2016-08-09 16:42:38","Success":true,"Reason":""
}

推送接口(增值版)

请求示例 JSON[订阅查询(增值版)]

{"EBusinessID":"1261585","Count":"1","PushTime":"2016-11-03 11:54:34","Data":[{"EBusinessID":"1261585","ShipperCode":"ZTO","LogisticCode":"416071867790","Success":true,"State":"2","Traces":[{"AcceptTime":"2016-10-28 17:54:18","AcceptStation":"杭州钱江开发区 的 悠可1 已收件","Location":"杭州市","Action":"1"},{"AcceptTime":"2016-10-28 19:10:59","AcceptStation":"快件离开 杭州钱江开发区 已发往 上海","Location":"杭州市","Action":"2"},{"AcceptTime":"2016-10-28 21:49:34","AcceptStation":"快件已到达 杭州中转部","Location":"杭州市","Action":"2"},{"AcceptTime":"2016-10-28 22:39:12","AcceptStation":"快件离开 杭州中转部 已发往 上海","Location":"杭州市","Action":"2"},{"AcceptTime":"2016-10-29 02:07:53","AcceptStation":"快件已到达 上海航空部","Location":"上海市","Action":"2"},{"AcceptTime":"2016-10-29 02:36:04","AcceptStation":"快件离开 上海 已发往 杨浦同济","Location":"上海市","Action":"2"},{"AcceptTime":"2016-10-29 03:28:29","AcceptStation":"快件已到达 上海","Location":"上海市","Action":"2"},{"AcceptTime":"2016-10-29 07:25:46","AcceptStation":"快件已到达 杨浦同济","Location":"上海市","Action":"2"},{"AcceptTime":"2016-10-29 07:27:02","AcceptStation":"杨浦同济 的 近邻宝 正在派件","Location":"上海市","Action":"402"}],"StateEx":"402","Location":"上海市"}]
}

返回示例JSON

{"EBusinessID":"1151847","UpdateTime":"2016-08-09 16:42:38","Success":true,"Reason":""
}

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.xdnf.cn/news/149979.html

如若内容造成侵权/违法违规/事实不符，请联系一条长河网进行投诉反馈，一经查实，立即删除！

相关文章

ret2dl_resolve

ret2dl_resolve

前言： ret2dl_resolve 是一种利用漏洞进行攻击的技术，主要针对使用动态链接库的程序。它的核心原理是利用程序的重定位机制，通过构造特定的函数返回地址，来劫持控制流并执行攻击者选择的代码。以下是对 ret2dl_resolve 原理的详细…
阅读更多...
[oeasy]python035_根据序号得到字符_chr函数_字符_character_

[oeasy]python035_根据序号得到字符_chr函数_字符_character_

字符(character) 回忆上次内容 上次了解了ord函数 ord 的意思是 ordinal(序号) ord函数 可以 根据字符得到序号 那么 可以 反过来 吗？ 根据序号 得到字符可以 吗？🤔 ord的逆运算 首先进入游乐场 ord 根据参数"h" 得到序号104 chr…
阅读更多...
EtherCAT转Profient协议网关简述

EtherCAT转Profient协议网关简述

Profinet 转 EtherCAT 的连接与通信问题一直是许多人关注的焦点，也常常给人们带来诸多困惑。在此，我们将深入剖析这一问题，并为大家提供切实可行的解决方案。WL-PN-ECATM型设备在这方面表现卓越，能够有效解决这一难题。接下来&…
阅读更多...
视频制作软件哪个好？前十名推荐！

视频制作软件哪个好？前十名推荐！

在视频制作领域，选择合适的软件是提升创作效率和作品质量的关键。本文将根据软件的适用人群：新手入门和专业领域，以及推荐的书籍，为您详细介绍视频制作软件的前十名。 新手入门级别： 1.影忆 功能特点：新手入…
阅读更多...
实现领域驱动设计（DDD）系列详解：集成限界上下文

实现领域驱动设计（DDD）系列详解：集成限界上下文

一个项目中通常存在着多个限界上下文，并且我们需要在它们之间进行集成。 在上下文映射图中存在两种主要形式：一种是通过绘制一些简单的框图来展示它们之间的集成关系；另一种则是通过代码来实现这些集成关系。 到了具体的技术实现&#xff0…
阅读更多...
设计模式之备忘录

设计模式之备忘录

一、备忘录设计模式概念 备忘录模式（Memento） 是一种行为设计模式， 允许在不暴露对象实现细节的情况下保存和恢复对象之前的状态。 适用场景 当你需要创建对象状态快照来恢复其之前的状态时， 可以使用备忘录模式。当直接访问对象的…
阅读更多...
羽毛球场馆预约系统，便捷管理预约

羽毛球场馆预约系统，便捷管理预约

全国羽毛球运动的热度不断上升，在健身行业中掀起了一股羽毛球热潮。同时羽毛球运动的风靡，也吸引了不少人入局，各种大大小小的羽毛球馆不断出现，为大众的羽毛球喜好提供了场地。 随着互联网的发展，羽毛球馆也开始向线…
阅读更多...
双控开关接入NVBoard

双控开关接入NVBoard

导入NVBoard git仓库：https://github.com/NJU-ProjectN/nvboard 按照ysyx手册的要求，初始化NVBoard项目。 由于GitHub在国外，可能会超时无响应： 解决方案是修改代理。 当前的运行环境是VM VirtualBox虚拟机，网卡是…
阅读更多...
豆包PixelDance：超越Runway和Sora的AI视频模型出炉

豆包PixelDance：超越Runway和Sora的AI视频模型出炉

2024年9月24日，北京——字节跳动在火山引擎发布会上，震撼发布了两款AI视频模型：豆包视频生成的PixelDance模型和Seaweed模型，标志着AI视频技术迈入了一个全新的纪元。今天，我们将聚焦于豆包PixelDance模型，…
阅读更多...
ffplay播放器研究分析

ffplay播放器研究分析

ffplay研究分析意义 ffplay.c是FFmpeg源码⾃带的播放器，调⽤FFmpeg和SDL API实现⼀个⾮常有⽤的播放器。 例如哔哩哔哩著名开源项⽬ijkplayer也是基于ffplay.c进⾏⼆次开发。 ffplay实现了播放器的主体功能，掌握其原理对于我们独⽴开发播放器⾮常有帮助…
阅读更多...
加固与脱壳01 - 环境搭建

加固与脱壳01 - 环境搭建

虚拟机 VMWare 多平台可用，而且可以直接激活，需要先注册一个账号 https://support.broadcom.com/group/ecx/productdownloads?subfamilyVMwareWorkstationPro KALI 类Ubuntu系统，官方提供了 vmware 版本，直接下载就可以使用。…
阅读更多...
Vue3:element-plus el-Table列表合计处理显示字符串类型/计算合计数值

Vue3:element-plus el-Table列表合计处理显示字符串类型/计算合计数值

需求整理 1.使用element组件库中的 el-table组件实现图上 底部当前页合计的功能。在一般的情况下，只需要计算数值部分的值，因为组件中的方法中处理的就是将值的类型转换成数值类型，像string类型的字符串的话，在进行转换的时候会出…
阅读更多...
认识URL

认识URL

目录 url定义 定义 实例 url组成 组成 大家看到这时是否会有疑问：我们常用的端口号8080和http默认端口号有什么关系？ url定义 定义 url就是统一资源定位符，简称网址。目的是使用url用于访问网络上的资源 实例 url组成 组成 实例&a…
阅读更多...
微信小程序开发第八课

微信小程序开发第八课

一 公告 1.1 微信小程序端 #js###const api require("../../config/settings.js") Page({data: {noticeList: [{title: 公告标题1,create_time: 2024-04-25,content: 公告内容描述1，公告内容描述1，公告内容描述1。, // 可以根据实际情况添加…
阅读更多...
如何用Stable Diffusion XL模型，绘制精致的二次元插图，学完就能用！

如何用Stable Diffusion XL模型，绘制精致的二次元插图，学完就能用！

哈喽大家好，我是画画的小强，持续分享AI相关知识干活。 今天给大家推荐一款Stable Diffusion XL二次元模型，这款模型在C站的下载排行很高，而且质量绘制出的二次元人物和场景都非常的棒！那么首先介绍一些什么是Stable D…
阅读更多...
火了！清华大学终于把Python整理成动画片了，教学通俗易懂，学完即可就业！

火了！清华大学终于把Python整理成动画片了，教学通俗易懂，学完即可就业！

在当今人工智能时代，编程技能的重要性日益凸显。而Python作为一门广泛应用且易于学习的编程语言，就受到了众多学习者的青睐。 清华大学，作为国内顶尖的高等学府，其教育资源与师资力量无需多言。这部动画版教程，正是集…
阅读更多...
Frontiers出版社系列SCISSCI合集

Frontiers出版社系列SCISSCI合集

【SciencePub学术】本期，小编根据WOS数据库，整理了一下Frontiers出版社系列的SCI&SSCI合集，以供各位学者投稿参考！ 来源：WOS数据库 Frontiers系列期刊中，Frontiers in Immunology以其5.7分的影响因子位…
阅读更多...
st7735调试记录

st7735调试记录

由于该模块陪我已经超过十年，最近想起来学习下lvgl，于是乎将其拿出来，尝试使能该模块从而学会lvgl 第一步肯定是找到资料确定下该模块是否好用。于是到网络上找到如下资料进行验证： https://pan.baidu.com/s/1CEunLuGUqLABR6I0UZ…
阅读更多...
海外云手机在电商运营中的优势解析

海外云手机在电商运营中的优势解析

近年来，海外云手机被越来越多人熟知，凭借云计算与电子商务的结合，成为出海电商企业高效、灵活的运营工具。本文将从多个角度详细解析海外云手机在电商运营中的主要优势。 一、成本节约 相比传统出海电商所依赖的实体设备如手机和电脑&#xf…
阅读更多...
RPC框架开发——理解项目功能

RPC框架开发——理解项目功能

目录 一、RPC的概念 二、使用分布式架构 三、进一步改进 四、最终框架 一、RPC的概念 RPC（Remote Procedure Call，远程过程调用）是一种通信机制，使得客户端能够像调用本地函数一样调用远程服务器上的函数。本质上是客户端需要…
阅读更多...
最新文章

Copyright @ 2022~2023