首頁 > API文檔 > 智選物流API
智選物流API提供智能選擇快遞公司的服務,根據用户提供的收派件地址、物流協議價格、客服留言等數據,智選物流將根據到不到件、近三天的實時時效和協議價格,再結合客服留言,為用户推薦最適合的物流公司,在超區、時效均保證的前提下,為用户節省快遞費用。
(1)電商平台、電商ERP審單環節,通過智選物流直接選擇最優快遞公司
(2)APP、公眾號、PC網站等提供的下單模塊,通過智選物流提供到件、時效信息、價格信息供用户下單時選擇
1.智選物流
1.1.智選物流
1.1.1.功能説明
同一線路不同快遞公司的時效對比,幫助商家選擇服務能力好的快遞公司,可根據快遞覆蓋區域,運費、時效、服務等綜合判斷最優快遞。
1.1.2.接口規則
(1)、接口只支持Json格式參數,接口指令2006。只支持POST請求方式,utf-8編碼。
(2)、支持增值服務,保價、代收貨款、貨款直退、貨款墊付等。
(3)、測試地址://sandboxapi.kdniao.com:8080/kdniaosandbox/gateway/exterfaceInvoke.json
(3)、正式地址://api.kdniao.com/api/exrecommend/
1.1.3.系統級輸入參數

1.1.4.應用級輸入參數

Detail參數:


ExpressList參數:

1.1.5.返回結果參數

1.1.6.JSON請求示例
{ "MemberID": "123456", "WarehouseID": "1", "Detail": [ { "OrderCode": "12345", "OriginalExpCode":"SF", "EstimatedShipTime":"2017-02-16 12:13:12" "IsCOD": 0, "Sender": { "ProvinceName": "廣東省", "CityName": "廣州", "ExpAreaName": "龍崗區", "Subdistrict": "布吉街道", "Address": "518000" }, "Receiver": { "ProvinceName": "廣東", "CityName": "梅州", "ExpAreaName": "豐順", "Subdistrict": "布吉街道", "Address": "518000" }, "Goods": [ { "ProductName": "包", "Volume": "", "Weight": "1" } ] }, { "OrderCode": "12346", "IsCOD": 0, "Sender": { "ProvinceName": "廣東省", "CityName": "廣州", "ExpAreaName": "龍崗區", "Subdistrict": "布吉街道", "Address": "518000" }, "Receiver": { "ProvinceName": "湖南", "CityName": "長沙", "ExpAreaName": "龍崗區", "Subdistrict": "布吉街道", "Address": "518000" }, "Goods": [ { "ProductName": "包", "Volume": "", "Weight": "1" } ] } ] }
1.1.7.JSON返回示例
{ "EBusinessID": "1257227", "Success": true, "RecommendDetail": [ { "ExpressList": [ { "ExpCode": "ZTO", "ExpName": "中通速遞", "LineName": "", "Fee": 10.00, "EstimatedDeliveryTime": 44.20, "SpecificDeliveryTime ":"2017-02-12 09:12", "IsSupport": "1", "RecommendReason": 0, "Remark": "" }, { "ExpCode": "ZTO", "ExpName": "中通速遞", "LineName": "", "Fee": 10.00, "EstimatedDeliveryTime": 44.20, "IsSupport": "1", "RecommendReason": 1, "Remark": "" }, { "ExpCode": "JYM", "ExpName": "加運美", "SpecificDeliveryTime ":"2017-02-12 09:12", "LineName": "", "EstimatedDeliveryTime": 15.23, "IsSupport": "1", "RecommendReason": 2, "Remark": "" } ], "OrderCode": "12345" }, { "ExpressList": [ { "ExpCode": "ZTO", "ExpName": "中通速遞", "SpecificDeliveryTime ":"2017-02-12 09:12", "LineName": "", "Fee": 16.00, "EstimatedDeliveryTime": 48.26, "IsSupport": "1", "RecommendReason": 0, "Remark": "" }, { "ExpCode": "ZTO", "ExpName": "中通速遞", "SpecificDeliveryTime ":"2017-02-12 09:12", "LineName": "", "Fee": 16.00, "EstimatedDeliveryTime": 48.26, "IsSupport": "1", "RecommendReason": 1, "Remark": "" }, { "ExpCode": "SF", "ExpName": "順豐快遞", "LineName": "", "EstimatedDeliveryTime": 38.33, "IsSupport": "1", "RecommendReason": 2, "Remark": "" } ], "OrderCode": "12346" } ] }
1.2.運費模板導入接口
1.2.1.功能説明
ERP服務商也可以將用户的協議物流公司及其協議價格先保存到快遞鳥運費模板系統中,智選物流每次計算時:
若接口傳遞了協議公司和價格,那麼默認按照接口提供的數據進行計算;
若接口沒有提供數據,則快遞鳥獲取以保存的運費模板進行計算。
若用户接口和運費模板均沒有提供協議公司和價格,或者接口中用户ID、倉庫ID為空,或者系統找不到匹配的用户ID、倉庫ID,則快遞鳥默認使用市場價格進行計算。
用户的協議價格若發生變化(新增、修改和刪除),ERP服務商需將該倉庫的全量數據同步到快遞鳥,快遞鳥將對應倉庫的數據進行全量更新。
ERP服務商需統一用户ID並保證用户ID的唯一性,若智選物流接口傳遞的用户ID與運費模板的用户ID不一致或因為ID不唯一而造成數據錯亂,均會影響智選物流接口的計算結果。
全量數據傳輸時需保證數據的完整性,否則會影響智選物流接口的結果。
1.2.2.接口規則
(1)、僅支持Json格式
(2)、請求指令2004
(3)、測試接口地址:
//sandboxapi.kdniao.com:8080/kdniaosandbox/gateway/exterfaceInvoke.json
(4)、聯調通過後請更換為正式地址:
//api.kdniao.com/Ebusiness/EbusinessOrderHandle.aspx
1.2.3.系統級輸入參數

1.2.4.應用級輸入參數


IntervalList

1.2.5.返回結果參數

1.2.6.JSON請求示例
{ "MemberID": "123456", "WarehouseID": "123456", "Detail": [ { "ShipperCode": "SF", "ExpenseTemplate":"次日達", "SendProvince": "廣東", "SendCity": "廣州", "SendExpArea": "天河", "ReceiveProvince": "廣東", "ReceiveCity": "深圳", "ReceiveExpArea": "龍崗", "ShippingType":0 "FirstWeight": "1", "FirstFee": "8", "AdditionalWeight": "1", "AdditionalFee": "10", "WeightFormula": "" }, { "ShipperCode": "YD", "ExpenseTemplate":"", "SendProvince": "廣東", "SendCity": "廣州", "SendExpArea": "天河", "ReceiveProvince": "湖南", "ReceiveCity": "長沙", "ReceiveExpArea": "雨花", "ShippingType":0 "FirstWeight": "", "FirstFee": "", "AdditionalWeight": "", "AdditionalFee": "", "WeightFormula": "{{w-0}-0.4}*{{{1000-w}-0.4}+1}*4.700+ {{w-1000}-0.6}*[(w-1000)/1000]*4.700" } ] }
1.2.7.JSON返回示例
{ "EBusinessID": "1257227", "Success": true, "MemberID": "123456" }