订阅(轨迹地图版)

（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

curl --location --request POST 'http://prod-cn.your-api-server.com/api/dist' \ --header 'Content-Type: application/json' \ --data-raw '{ "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 }'

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

请求参数

Body 参数application/json

RequestData

string

必需

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

EBusinessID

string

必需

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

RequestType

string

必需

请求指令类型：1007

DataSign

string

必需

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

DataType

string

可选

请求、返回数据类型：只支持JSON格式

ShipperCode

string

必需

快递公司编码详细编码参考《快递鸟接口支持快递公司编码.xlsx》

OrderCode

string

订单编号

必需

LogisticCode

string

快递单号

必需

PayType

string

必需

运费支付方式： 1-现付，2-到付，3-月结，4-第三方支付

ExpType

string

必需

快递类型：1-标准快件详细快递类型参考《快递公司快递业务类型.xlsx》

CustomerName

string

电子面单客户号

必需

CustomerPwd

string

电子面单密码

必需

MonthCode

string

月结编号

必需

IsNotice

string

必需

是否通知快递员上门揽件：0-通知；1-不通知；不填则

Sender

object

必需

Company

string

发件人公司

可选

Name

string

发件人

必需

Tel

string

电话

必需

Mobile

string

手机

必需

PostCode

string

必需

发件地邮编(ShipperCode为EMS、YZPY时必填)

ProvinceName

string

必需

发件省 (如广东省，不要缺少“省”；如是直辖市，请直接传北京、上海等；如是自治区，请直接传广西壮族自治区等)

CityName

string

必需

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

ExpAreaName

string

必需

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

Address

string

发件人详细地址

必需

Receiver

object

必需

Company

string

收件人公司

可选

Name

string

收件人

必需

Tel

string

电话

必需

Mobile

string

手机

必需

PostCode

string

必需

收件地邮编(ShipperCode为EMS、YZPY时必填)

ProvinceName

string

必需

收件省 (如广东省，不要缺少“省”；如是直辖市，请直接传北京、上海等；如是自治区，请直接传广西壮族自治区等)

CityName

string

必需

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

ExpAreaName

string

必需

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

Address

string

收件人详细地址

必需

Commodity

array [object {7}]

必需

GoodsName

string

商品名称

必需

GoodsCode

string

商品编码

必需

Goodsquantity

integer

商品件数

必需

GoodsPrice

string

商品价格

必需

GoodsWeight

string

商品重量kg

必需

GoodsDesc

string

商品描述

必需

GoodsVol

string

商品体积m3

必需

IsReturnCoordinates

integer

必需

是否订阅短信： 0-不需要；1-需要

示例

返回响应

🟢200成功

application/json

Body

EBusinessID

string

用户ID

必需

UpdateTime

string

时间

必需

Success

boolean

必需

成功与否：true，false

Reason

string

失败原因

必需

SenderCityLatAndLng

string

发件城市经纬度

必需

ReceiverCityLatAndLng

string

收件城市经纬度

必需

EstimatedDeliveryTime

string

必需

订单预计到货时间YYYY-MM-DD HH24:MM:SS