快递鸟预约取件 API 接口代码流程

188 阅读3分钟

预约取件 API 为用户提供了在线下单,预约快递员上门揽件的功能,为用户解决在线发货需求。快递鸟现已支持快递、快运业务,同城配业务即将上线。已覆盖国内主流物流公司,更多公司持续接入入中。

应用场景

1.此接口用于通知快递公司快递员上门揽件,适用电商平台、打单工具、ERP 系统、WEB 端、APP 移动端、小程序 2.支持自定义预约时间,实时预约,实时返回预约成功或失败结果,不遗漏订单,快递公司会在两小时内联系发件人并上门揽件 3.已支持顺丰速运、百世快递、中通快递、圆通速递、韵达速递、优速快递、德邦快递、EMS、宅急送等物流公司,并持续增加中

功能说明

使用流程

API 参数

一、接口描述/说明

(1)在线下单接口是快递鸟提供给独立电商、仓储管理系统、物流供应链等物流系统平台使用的下单接口。(2)为客户解决在线发货需求,商户通过网络选择快递公司发送请求通知快递公司有快递要发货。(3) 客户把数据通过此接口转发到快递鸟,由快递鸟为您安排快递员上门取件的服务。(4)订单编号(OrderCode)不可重复提交,重复提交系统会返回具体错误代码。(5)接口支持的消息接收方式为 HTTP POST,请求方法的编码格式(utf-8):"application/x-www-form-urlencoded;charset=utf-8"。(6)接口地址: API 测试地址:sandboxapi.kdniao.com:8080/kdniaosandb…正式地址:api.kdniao.com/api/OOrderS…

请求系统级参数说明:

二、接口参数

请求内容字段定义:

三、示例

请求示例 JSON

{
        "OrderCode": "012657018199",
        "ShipperCode": "SF",
        "PayType": 1,
        "MonthCode": "1234567890",
        "ExpType": 1,
        "Cost": 1.0,
        "OtherCost": 1.0,
        "Sender": {
          "Company": "LV",
          "Name": "快递鸟",
          "Mobile": "15018442396",
          "ProvinceName": "上海",
          "CityName": "上海市",
          "ExpAreaName": "青浦区",
          "Address": "明珠路"
        },
        "Receiver": {
          "Company": "GCCUI",
          "Name": "Yann",
          "Mobile": "15018442396",
          "ProvinceName": "北京",
          "CityName": "北京市",
          "ExpAreaName": "朝阳区",
          "Address": "三里屯街道"
        },
        "Commodity": [
      {
            "GoodsName": "鞋子",
            "Goodsquantity": 1,
            "GoodsWeight": 1.0
          }
        ],
        "AddService": [
          {
            "Name": "COD",
            "Value": "1020",
      "CustomerID": "1234567890"
          }
        ],
        "Weight": 1.0,
        "Quantity": 1,
        "Volume": 0.0,
        "Remark": "小心轻放"
      }

返回示例 JSON

{
        "EBusinessID": "1237100",
        "Success": true,
        "Order": {
            "OrderCode": "012657018199",
            " ShipperCode ": " SF ",
            " LogisticCode ": "615123456789"
        },
        "ResultCode": "100",
        "Reason": ""
    }

接入流程