内蒙古时时彩计划软件下载|内蒙古时时彩彩票软件|
首页 > API文档 > 预约取件API
预约取件API
申请API
预约取件API为用户提供了在线下单,预约快递员上门揽件的功能,为用户解决在线发货需求。现已支持快递、快运业务,同城配业务即将上线。已覆盖国内主流物流公司,更多公司?#20013;?#25509;入入中。
应用场景
(1)接口永久免费
(2)对接物流公司官方接口,订单实时预约,实时返回预约成功或失败标识
(3)支持自定义预约时间,不遗漏订单
(4)已支持三通一达(申通不支持)、顺丰、EMS、宅急送、德邦、优速等物流公司,并?#20013;?#22686;加中
(5)快递公司会在两小时内联系发件人并上门揽件
(6)需实名认证
功能说明
使用流程
API?#38382;?/td>
一、接口描述/说明
(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正式地址:http://api.kdniao.com/api/OOrderService
请求系统级?#38382;?#35828;明:
?#38382;?#21517;称类型说明必须要求
RequestDataString请求内容需进行URL(utf-8)编码。请求内容JSON格式,须和DataType一致。R
EBusinessIDString商户ID,请在我的服务页面查看。R
RequestTypeString请求指令类型:1001R
DataSignString数据内容签名:把(请求内容(未编码)+AppKey)进行MD5?#29992;埽?#28982;后Base64编码,最后 进行URL(utf-8)编码。详细过程请查看Demo。R
DataTypeString请求、返回数据类型:只支持JSON格式R
备注:R-必填(Required),O-可选(Optional),C-报文中该?#38382;?#22312;一定条件下可选(Conditional)
二、接口?#38382;?/div>
请求内容字段定义:
?#38382;?/th>类型说明必须要求
WarehouseIDString仓库标识O
WarehouseAddressString仓库地址O
CallBackString商户标识O
MemberIDString会员标识O
ShipperCodeString快递公司编码R
LogisticCodeString快递单号O
IsNoticeInt发货方式:0-上门揽件,1-网点?#32422;模?#40664;认为1O
PackingTypeInt包装类型:包装类型(快运字段)默认为 0; 0- 纸 1- 纤 2- 木 3- 托膜 4- 木托 99-其他O
IsReturnSignBillInt签收回单:1-需要,0-不需要,默认为0O
DeliveryMethodInt送货方式:0-自提,1-送货上门(不含?#19979;ィ?-送货?#19979;ァ#?#36866;用于快运类型订单,物流公司可能会收取费用),默认为0O
OrderCodeString订单编号R
MonthCodeString月结编码C
PayTypeInt邮费支付方式:1-?#25351;叮?-到付,3-月结,4-第三方支付R
ExpTypeInt快递类型:1-标准快件R
CostDouble寄件费(运费)O
OtherCostDouble其他费用O
ReceiverCompanyString收件人公司O
NameString收件人R
TelString电话与?#21482;?#24517;填一个R
MobileString
PostCodeString收件人?#26102;?/td>O
ProvinceNameString收件省(如广东省,不要缺少“省”)R
CityNameString收件市(如深圳市,不要缺少“?#23567;保?/td>R
ExpAreaNameString收件区(如福田区,不要缺少“区”或“县”)O
AddressString收件人详细地址R
SenderCompanyString发件人公司O
NameString发件人R
TelString电话与?#21482;?#24517;填一个R
MobileString
PostCodeString发件人?#26102;?/td>O
ProvinceNameString发件省(如广东省,不要缺少“省”)R
CityNameString发件市(如深圳市,不要缺少“?#23567;保?/td>R
ExpAreaNameString发件区(如福田区,不要缺少“区”或“县”)O
AddressString发件人详细地址R
StartDateString上门取货时间段:"yyyy-MM-dd HH:mm:ss"格?#20132;?#26412;文中所有时间格式相同O
EndDateStringO
WeightDouble物品总重量kgO
QuantityInt件数/包裹数O
VolumeDouble物品总体积m3O
RemarkString备注O
AddServices
AddServiceNameString增值服务名称O
ValueString增值服务值O
CustomerIDString客户标识(选填)O
Commoditys
CommodityGoodsNameString商品名称R
GoodsCodeString商品编码O
GoodsquantityInt商品数量O
GoodsPriceDecimal商品价格O
GoodsWeightDecimal商品重量O
GoodsDescString商品描述O
GoodsVolDouble商品体积m3O
返回?#38382;?#23450;义:
?#38382;?#21517;称类型说明必须要求
EBusinessIDString用户IDR
OrderOrderCodeString订单编号R
ShipperCodeString快递公司编码R
LogisticCodeString快递单号O
SuccessBool成功与否R
ResultCodeString结果编码R
ReasonString失败原因O
UniquerRequestNumberString唯一标识R
三、示例
请求示例 JSON
{
"OrderCode": "012657018199",
"ShipperCode": "SF",
"PayType": 1,
"MonthCode": "7553045845",
"ExpType": 1,
"Cost": 1.0,
"OtherCost": 1.0,
"Sender": {
  "Company": "LV",
  "Name": "Taylor",
  "Mobile": "15018442396",
  "ProvinceName": "上海",
  "CityName": "上海",
  "ExpAreaName": "青?#26234;?,
  "Address": "明珠路"
},
"Receiver": {
  "Company": "GCCUI",
  "Name": "Yann",
  "Mobile": "15018442396",
  "ProvinceName": "?#26412;?,
  "CityName": "?#26412;?,
  "ExpAreaName": "朝阳区",
  "Address": "三里屯?#20540;?
},
"Commodity": [
  {
    "GoodsName": "鞋子",
    "Goodsquantity": 1,
    "GoodsWeight": 1.0
  }
],
"AddService": [
  {
    "Name": "COD",
    "Value": "1020"
  }
],
"Weight": 1.0,
"Quantity": 1,
"Volume": 0.0,
"Remark": "小心轻放"
}
返回示例 JSON
失败:
{
    "EBusinessID": "1237100",
    "Success": false,
    "ResultCode": "105",
    "Reason": "该订单已经存在,请勿重复操作",
    "UniquerRequestNumber":"451d3c7c-b428-490a-a4ed-e368f15f6c74"
}
成功:
{
    "EBusinessID": "1237100",
    "Success": true,
    "Order": {
        "OrderCode": "012657018199",
        " ShipperCode ": " SF ",
        " LogisticCode ": ""
    },
    "ResultCode": "100",
    "Reason": ""
}
接入流程
demo下载

相关文档与更多帮助?

  • 帮助与文档
    立即获得接入帮助与?#38469;?#25991;档
  • ?#35797;?#19979;载
    获得DEMO与插件下载
  • API文档
    API接口接入?#38382;?#35828;明
30万+
数十万客户的选择
5.8亿次+
?#31449;?#22788;理物流数据?#38382;?/dd>
1450万+
?#31449;?#21315;万订单数据处理
418家+
支持全国418家物流商
在线咨询
商务合作群:
783245476
?#38469;?#23545;接群14:
665031725
?#38469;?#23545;接群11:
844089794
400-9633321
免费获取API
内蒙古时时彩计划软件下载
彩77彩票安卓 足彩总进球规则 极速快乐十分计划软件手机版 开心棋牌官方版下载安装 双色球开奖结果复式派奖 老北京时时彩开奖结果 赚钱成功的经历 25选7开奖公告 安徽11选5走势图360 重庆时时彩软件