快递鸟一次性对接2000+物流接口

API服务
首页>API服务>物流轨迹地图API

API组件列表
下单类接口
电子面单API
上门取件API
预约取件API
查询类接口
即时查询API
物流跟踪API
在途监控API
快递查询API
物流查询地图APIAlternate Text
增值类接口
物流短信API
单号识别API
智能地址解析API
首页 > API文档 > 物流轨迹地图API
物流轨迹地图API
申请API
快递鸟结合地图功能，提供给为电商、商城、生活应用、微信应用等个人APP，以接口API与嵌入式页面开放给客户使用，支持中通、韵达、圆通、申通等8家主流快递公司在地图上直观的展示包裹的位置和预计送达时间。
应用场景功能说明使用流程API参数接入流程demo下载
应用场景
（1）电商平台物流查询模块，供用户查询订单当前的物流状态
（2）电商、ERP后台的物流监控系统，客服在对账前查询所有运单的签收状态，并追踪问题
（3）电商、ERP后台实时预警模块，对各种问题件进行实时监控处理
（4）电商、ERP后台获取物流状态后，可结合其他服务进行使用，如通知短信、APP通知推送
（5）APP、公众号、网址等物流查询模块，供用户输入单号实时查询物流状态
功能说明
使用流程
API参数
一、接口描述/说明
1.即时查询(轨迹地图版)接口
（1）查询接口支持按照运单号查询(单个查询)。
（2）接口需要指定快递单号的快递公司编码，格式不对或则编码错误都会返失败的信息。
如：EMS物流单号应选择快递公司编码（EMS）查看快递公司编码
（3）返回的物流跟踪信息按照发生的时间升序排列。
（4）接口指令8003。
（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请求指令类型：8003是
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请求指令类型：8005是
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物流单号是
SenderCityNameString发件城市是
ReceiverCityNameString收件城市是
IsReturnCoordinatesInt是否返回城市经纬度 1 返回 2 不返回 默认1否
IsReturnRouteMapInt是否返回轨迹地图 1 返回 2 不返回 默认1否
返回参数定义：
参数名称类型说明必须要求
EBusinessIDString用户ID是
OrderCodeString订单编号否
ShipperCodeString快递公司编码是
LogisticCodeString物流运单号否
SenderCityLatAndLngString发件城市经纬度是
ReceiverCityLatAndLngString收件城市经纬度否
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备注否
Coordinates
LocationString城市否
LatAndLngString经纬度否
PreCoordinates
LocationString城市否
LatAndLngString经纬度否
EstimatedDeliveryTimeString预计到达时间是
RouteMapUrlString轨迹地图URL否
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否
IsReturnCoordinatesInt是否返回城市经纬度 1 返回 2 不返回 默认1否
返回参数定义：
参数名称类型说明必须要求
EBusinessIDString用户ID是
UpdateTimeString时间是
SuccessBool成功与否：true，false是
ReasonString失败原因否
EstimatedDeliveryTimeString订单预计到货时间YYYY-MM-DD HH24:MM:SS否
SenderCityLatAndLngString发件城市经纬度是
ReceiverCityLatAndLngString收件城市经纬度是
3.推送(轨迹地图版)接口
应用级输入参数
参数名称类型说明必须要求
EBusinessIDString用户电商ID是
PushTimeString推送时间是
CountString推送物流单号轨迹个数是
DataString推送物流单号轨迹集合是
订阅查询(轨迹地图版)结果（RequestType：102）
通过轨迹查询（订阅查询）接口订阅到快递鸟的数据，快递鸟推送时，会将推送的RequestType的值置为102，同时返回下列数据
请求内容字段定义:
参数类型说明必须要求
EBusinessIDString商户ID否
OrderCodeString订单编号否
ShipperCodeString快递公司编码是
LogisticCodeString快递单号R
SenderCityLatAndLngString发件城市经纬度是
ReceiverCityLatAndLngString收件城市经纬度是
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派件网点电话否
CoordinatesLocationString城市否
LatAndLngString经纬度否
PreCoordinatesLocationString城市否
LatAndLngString经纬度否
EstimatedDeliveryTimeString预计到达时间yyyy-mm-dd是
RouteMapUrlString轨迹地图URL否
返回参数定义
参数名称类型说明必须要求
EBusinessIDString用户ID是
UpdateTimeString时间是
SuccessBool成功与否：true，false是
ReasonString失败原因否
三、示例
即时查询(增值版)接口
请求示例 JSON
{
    "IsReturnCoordinates":1,
    "OrderCode":"",
    "ShipperCode":"YTO",
    "LogisticCode":"YT9259962006185",
    "SenderCityName":"泉州市",
    "ReceiverCityName":"亳州市"
}
返回示例 JSON
没有物流轨迹的{
    "ReceiverCityLatAndLng" : "33.8764100,115.7791400",
    "LogisticCode" : "YT9259962006184",
    "ShipperCode" : "YTO",
    "Traces" : [ ],
    "State" : "0",
    "SenderCityLatAndLng" : "24.8894600,118.6130000",
    "EBusinessID" : "1305585",
    "Reason" : "暂无轨迹信息",
    "Success" : true
}有物流轨迹的{
    "StateEx" : "2",
    "EstimatedDeliveryTime" : "2020-08-29 18:53:35",
    "PreCoordinates" : [ {
        "LatAndLng" : "24.8894600,118.6130000",
        "Location" : "泉州市"
    }, {
        "LatAndLng" : "32.9444800,117.3677900",
        "Location" : "蚌埠市"
    }, {
        "LatAndLng" : "33.8764100,115.7791400",
        "Location" : "亳州市"
    } ],
    "ShipperCode" : "YTO",
    "Traces" : [ {
        "Action" : "1",
        "AcceptStation" : "福建省泉州市德化县 揽收成功",
        "AcceptTime" : "2020-08-26 18:53:35",
        "Location" : "泉州市"
    }, {
        "Action" : "2",
        "AcceptStation" : "福建省泉州市德化县 已打包",
        "AcceptTime" : "2020-08-26 19:08:29",
        "Location" : "泉州市"
    }, {
        "Action" : "2",
        "AcceptStation" : "福建省泉州市德化县 已发出 下一站 泉州转运中心",
        "AcceptTime" : "2020-08-26 19:16:48",
        "Location" : "泉州市"
    }, {
        "Action" : "2",
        "AcceptStation" : "泉州转运中心 已发出 下一站 蚌埠转运中心",
        "AcceptTime" : "2020-08-26 21:52:38",
        "Location" : "蚌埠市"
    }, {
        "Action" : "2",
        "AcceptStation" : "蚌埠转运中心 已发出 下一站 安徽省亳州市",
        "AcceptTime" : "2020-08-28 03:05:43",
        "Location" : "亳州市"
    }, {
        "Action" : "2",
        "AcceptStation" : "安徽省亳州市 已收入",
        "AcceptTime" : "2020-08-28 11:59:43",
        "Location" : "亳州市"
    }, {
        "Action" : "2",
        "AcceptStation" : "安徽省亳州市 已收入",
        "AcceptTime" : "2020-08-28 11:59:43",
        "Location" : "亳州市"
    } ],
    "Coordinates" : [ {
        "LatAndLng" : "24.8894600,118.6130000",
        "Location" : "泉州市"
    }, {
        "LatAndLng" : "32.9444800,117.3677900",
        "Location" : "蚌埠市"
    }, {
        "LatAndLng" : "33.8764100,115.7791400",
        "Location" : "亳州市"
    } ],
    "EBusinessID" : "1305585",
    "Success" : true,
    "ReceiverCityLatAndLng" : "33.8764100,115.7791400",
    "LogisticCode" : "YT9259962006185",
    "State" : "2",
    "SenderCityLatAndLng" : "24.8894600,118.6130000",
    "Location" : "亳州市",
    "RouteMapUrl" : ""
}
订阅(增值版)接口
请求示例 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":"书本"
        }
    ],
    "IsReturnCoordinates": 1
}
返回示例 JSON
{
    "EBusinessID":"1151847",
    "UpdateTime":"2016-08-09 16:42:38",
    "Success":true,
    "Reason":"",
    "SenderCityLatAndLng":"113.88308,22.55329",
    "ReceiverCityLatAndLng":"113.88308,22.55329"
}
推送接口(增值版)
请求示例 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":"1261585",
    "UpdateTime":"2016-08-09 16:42:38",
    "Success":true,
    "Reason":""
}
接入流程
demo下载
接口接入技术文档
物流查询地图接口Demo工具.NET版
物流查询地图接口Demo工具.PHP版
物流查询地图接口Demo工具.JAVA版
物流查询地图接口Demo工具.PYTHON版
物流查询地图接口Demo工具.GO版
物流查询地图接口Demo工具.NODE.JS版

相关文档与更多帮助？

30万+
数十万客户的选择
5.8亿次+
日均处理物流数据次数
1450万+
日均千万订单数据处理
2000家+
支持全国2000+家物流商

热门产品

在途监控快递查询物流查询地图版电子面单物流管家SaaS管理工具企业寄件SaaS管理工具

解决方案

电商平台物流解决方案ISV系统商解决方案连锁门店发货解决方案商家打单发货解决方案退换货上门取件方案聚合寄件上门取件方案C2C上门取件方案国际物流查询解决方案

接口API

API接口文档快递鸟API接口DEMO下载

关于我们

公司介绍企业动态联系我们法律声明合作伙伴快递鸟接口服务协议用户隐私政策物流生态平台

友情链接

商派海淘转运FEC富润电商递易智能
咨询电话：400-8699-100服务邮箱：service@kdniao.com
微信公众号
微信订阅号
微信扫码寄件
版权所有：深圳市快金数据技术服务有限公司  粤ICP备15010928号-1增值电信业务许可证：合字B2-20230224粤公安备案号：44030402002993
技术对接x
扫码寄件x
在线咨询

Hi~ 我在线

欢迎您随时咨询
×
扫码查寄件
扫码寄件
技术对接
技术对接
试用开通