电子面单API为用户提供电子面单下单服务,快递鸟连接多家物流公司,一次接入即可对接多家物流公司电子面单下单通道,为订单信息化、标准化提供保障服务。但是有很多朋友不知道快递鸟API接口的操作流程,今天就来分享一下。
一、接口描述/说明
1.电子面单接口
(1)电子面单接口是快递鸟提供给独立电商、仓储管理系统、物流供应链等物流系统平台使用的下单接口。
(2)为客户解决在线发货需求,商户通过网络选择快递公司发送请求通知快递公司有快递要发货。
(3) 客户把数据通过此接口转发到快递鸟,由快递鸟为您安排快递员上门取件的服务。
(4)订单编号(OrderCode)不可重复提交,重复提交系统会返回具体错误代码。
(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/api/EOrderService
请求系统级参数说明:
参数名称
类型
说明
必须要求
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格式
否
2.订单取消接口
(1)只支持有成功下单记录的订单进行取消。
(2)只支持对未揽件的订单进行取消。
(3)订单取消后,订单号仍不可重复使用。
(4)订单取消后快递单号的回收规则以快递公司为准。
(5)接口地址: API测试地址:http://sandboxapi.kdniao.com:8080/kdniaosandbox/gateway/exterfaceInvoke.json
API正式地址:https://api.kdniao.com/api/EOrderService
请求系统级参数说明:
参数名称
类型
说明
必须要求
RequestData
String
请求内容需进行URL(utf-8)编码。请求内容JSON格式,须和DataType一致。
是
EBusinessID
String
商户ID,请在我的服务页面查看。
是
RequestType
String
请求指令类型:1147
是
DataSign
String
数据内容签名:把(请求内容(未编码)+AppKey)进行MD5加密,然后Base64编码,最后 进行URL(utf-8)编码。详细过程请查看Demo。
是
DataType
String
请求、返回数据类型:只支持JSON格式
否
3.单号余量查询接口
请求系统级参数说明:
参数名称
类型
说明
必须要求
RequestData
String
请求内容需进行URL(utf-8)编码。请求内容JSON格式,须和DataType一致。
是
EBusinessID
String
商户ID,请在我的服务页面查看。
是
RequestType
String
请求指令类型:1127
是
DataSign
String
数据内容签名:把(请求内容(未编码)+AppKey)进行MD5加密,然后Base64编码,最后 进行URL(utf-8)编码。详细过程请查看Demo。
是
DataType
String
请求、返回数据类型:只支持JSON格式
否
4.客户号申请接口
请求系统级参数说明:
参数名称
类型
说明
必须要求
RequestData
String
请求内容需进行URL(utf-8)编码。请求内容JSON格式,须和DataType一致。
是
EBusinessID
String
商户ID,请在我的服务页面查看。
是
RequestType
String
请求指令类型:1127
是
DataSign
String
数据内容签名:把(请求内容(未编码)+AppKey)进行MD5加密,然后Base64编码,最后 进行URL(utf-8)编码。详细过程请查看Demo。
是
DataType
String
请求、返回数据类型:只支持JSON格式
否
5.客户号推送接口
(1)推送时会推送RequestType、RequestData和DataSign三个参数 (格式:RequestData={数据}&EBusinessID=1237100 &PushTime=2017-04-18 23:34:29&RequestType=1117) 。
请求系统级参数说明:
参数名称
类型
说明
必须要求
RequestData
String
请求内容需进行URL(utf-8)编码。请求内容JSON格式,须和DataType一致。
是
EBusinessID
String
商户ID,请在我的服务页面查看。
是
RequestType
String
请求指令类型:1117
是
DataSign
String
数据内容签名:把(请求内容(未编码)+AppKey)进行MD5加密,然后Base64编码,最后 进行URL(utf-8)编码。详细过程请查看Demo。
是
DataType
String
请求、返回数据类型:只支持JSON格式
否