新增發快遞上門取件的介面-快遞鳥預約上門取件API對接

上門取件，是電商平臺為寄件使用者提供的透過一鍵下單到快遞員，並在2小時上門取件的寄件服務。適用於散客線上寄件、電商退貨上門取件等業務場景；透過API指令由系統自動將訊息傳送給物流公司和快遞員，由快遞員上門取貨攬件與線上收款；

快遞鳥為解決寄件客戶不用線下找快遞員、不用苦苦等待，透過上門取件服務讓客戶可以輕鬆選擇約定時間、地點完成寄件需求。

應用場景

1、移動端APP、公眾號、電商等提供的散客寄件下單模組，透過上門取件直接 預約快遞員上門攬件，支援線上支付運費；

2、電商平臺、自營電商售後退貨退款時，買家透過平臺直接預約快遞員上門攬件，支援線上支付運費；

一、介面描述/說明

（1）上門取件介面是快遞鳥提供給獨立電商、倉儲管理系統、物流供應鏈等物流系統平臺使用的下單介面。

（2）為客戶解決線上發貨需求，商戶透過網路選擇快遞公司傳送請求通知快遞公司有快遞要發貨。

（3） 客戶把資料透過此介面轉發到快遞鳥，由快遞鳥為您安排快遞員上門取件的服務。

（4）訂單編號（OrderCode）不可重複提交，重複提交系統會返回具體錯誤程式碼。

（5）介面支援的訊息接收方式為HTTP POST，請求方法的編碼格式(utf-8)："application/x-www-form-urlencoded;charset=utf-8"。

（6）介面地址： API測試地址：

API正式地址：

請求系統級引數說明

請求內容欄位定義：

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

返回示例：

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