## 下配送單 ### 使用場景: * 1、商家可調用本接口向配送公司請求下配送單,配送公司會返回這一單的配送單號、配送費、預計騎手接單時間等信息。 * 2、如遇下單錯誤，請先確認一下編碼方式，python建議 json.dumps(b, ensure_ascii=False)，php建議 json_encode($arr, JSON_UNESCAPED_UNICODE) 可預約時間：達達：72小時內，閃送2小時以后，48小時以內 ~~~[api] post:/api/customer/order/businessOrderAdd *string:token=默認值#顧客端登錄令牌 *storeId#系統門店id *shopNo#商家門店編號,在配送公司登記,美團、閃送必填 *deliveryId#配送公司ID *openId#下單用戶的openid *senderName#發件人信息姓名,最長不超過256個字符 *senderCity#發件人信息城市名稱,如廣州市 *senderAddress#發件人信息地址(街道、小區、大廈等,用于定位) *senderAddressDetail#發件人信息地址詳情(樓號、單元號、層號) *senderPhone#發件人信息電話/手機號,最長不超過64個字符 *senderLng#發件人信息經度(火星坐標或百度坐標,和coordinateType字段配合使用,精確到小數點后6位) *senderLat#發件人信息緯度(火星坐標或百度坐標,和coordinateType字段配合使用,精確到小數點后6位) *receiverName#收件人姓名,最長不超過256個字符 *receiverCity#收件人城市名稱,如廣州市 *receiverAddress#收件人地址(街道、小區、大廈等,用于定位) *receiverAddressDetail#收件人地址詳情(樓號、單元號、層號) *receiverPhone#收件人電話/手機號,最長不超過64個字符 *receiverLng#收件人經度(火星坐標或百度坐標,和 coordinateType 字段配合使用,確到小數點后6位 *receiverLat#收件人緯度(火星坐標或百度坐標,和 coordinateType 字段配合使用,確到小數點后6位 *goodsValue#貨物價格,單位為元,精確到小數點后兩位(如果小數點后位數多于兩位,則四舍五入保留兩位小數),范圍為(0-5000] *goodsWeight#貨物重量,單位為kg,精確到小數點后兩位(如果小數點后位數多于兩位,則四舍五入保留兩位小數),范圍為(0-50] *cargoFirstClass#品類一級類目 *cargoSecondClass#品類二級類目 *wxaPath#商家小程序的路徑,建議為訂單頁面 *imgUrl#商品縮略圖url *goodsName#商品名稱 *goodsCount#商品數量 deliveryToken#預下單接口返回的參數,配送公司可保證在一段時間內運費不變 userId#小程序用戶id outTradeNo#支付訂單號 appKey#商家id,由配送公司分配的appkey appSecret#用配送公司提供的appSecret加密的校驗串 coordinateType=0#發件人信息坐標類型,0-火星坐標(高德,騰訊地圖均采用火星坐標);1-百度坐標 goodsHeight#貨物高度,單位為cm,精確到小數點后兩位(如果小數點后位數多于兩位,則四舍五入保留兩位小數),范圍為(0-45] goodsLength#貨物長度,單位為cm,精確到小數點后兩位(如果小數點后位數多于兩位,則四舍五入保留兩位小數),范圍為(0-65] goodsWidth#貨物寬度,單位為cm,精確到小數點后兩位(如果小數點后位數多于兩位,則四舍五入保留兩位小數),范圍為(0-50] goodsDetailArr=[]#貨物詳情,最長不超過10240個字符,多個['good_count'=>$good_count,//貨物數量'good_name'=>$good_name,//貨品名稱'good_price'=>$good_price,//否,貨品單價,精確到小數點后兩位(如果小數點后位數多于兩位,則四舍五入保留兩位小數)'good_unit'=>$good_unit,//否,貨品單位,最長不超過20個字符]用,連接 goodsPickupInfo#貨物取貨信息,用于騎手到店取貨,最長不超過100個字符 goodsDeliveryInfo#貨物交付信息,最長不超過100個字符 deliveryServiceCode#配送服務代碼,不同配送公司自定義,順豐和達達不填 orderType=0#訂單類型:0-即時單;1-預約單,如預約單,需要設置expectedDeliveryTime或expectedFinishTime或expectedPickTime expectedDeliveryTime=0#期望派單時間(美團、達達支持,美團表示商家發單時間,達達表示系統調度時間,到那個時間才會有狀態更新的回調通知) expectedFinishTime=0#期望送達時間(順豐同城急送支持) expectedPickTime=0#期望取件時間(閃送、順豐同城急送支持,閃送需要設置兩個小時后的時間,順豐同城急送只需傳expectedFinishTime或expectedPickTime其中之一即可,同時都傳則以expectedFinishTime為準) poiSeq#門店訂單流水號,建議提供,方便騎手門店取貨,最長不超過32個字符 note#備注,最長不超過200個字符 orderTime#用戶下單付款時間 isInsured=0#是否保價:0-非保價;1-保價 declaredValue#保價金額,單位為元,精確到分 tips#小費,單位為元,下單一般不加小費 isDirectDelivery=0#是否選擇直拿直送(0-不需要；1-需要.選擇直拿直送后,同一時間騎手只能配送此訂單至完成,配送費用也相應高一些,閃送必須選1,達達可選0或1,其余配送公司不支持直拿直送) cashOnDelivery#騎手應付金額,單位為元,精確到分 cashOnPickup#騎手應收金額,單位為元,精確到分 riderPickMethod#物流流向,1:從門店取件送至用戶；2:從用戶取件送至門店 isFinishCodeNeeded=0#收貨碼(0-不需要；1-需要.收貨碼的作用是:騎手必須輸入收貨碼才能完成訂單妥投) isPickupCodeNeeded=0#取貨碼(0-不需要；1-需要.取貨碼的作用是:騎手必須輸入取貨碼才能從商家取貨) wxaAppid#若結算方式為:第三方向配送公司統一結算,商戶后續和第三方結算,則該參數必填；在該結算模式下,第三方用自己的開發小程序替授權商戶發起下單,并將授權小程序的appid給平臺,后續配送通知中可回流授權商戶小程序 subBizId#子商戶id,區分小程序內部多個子商戶 <<< success { 'status':1, 'message':'ok', 'data':{ "resultcode": 0, //運力返回的錯誤碼 "resultmsg": "ok", //運力返回的錯誤描述 "fee": 10, //實際運費(單位：元)，運費減去優惠券費用 "deliverfee": 10, //運費(單位：元) "couponfee": 0, //優惠券費用(單位：元) "tips": 0, //小費(單位：元) "insurancfee": 0, //保價費(單位：元) "distance": 1000, //配送距離(單位：米) "waybill_id": "123456789", //配送單號 "order_status": 101, //配送狀態.101:配送公司接單階段,等待分配騎手,即初始狀態; 102:配送公司接單階段,分配騎手成功; 103:配送公司接單階段,商家取消訂單,訂單結束; 201:騎手取貨階段,騎手到店開始取貨; 202:騎手取貨階段,取貨成功; 203:騎手取貨階段,取貨失敗,商家取消訂單,訂單結束; 204:騎手取貨階段,取貨失敗,騎手因自身原因取消訂單,訂單結束 205:騎手取貨階段,取貨失敗,騎手因商家原因取消訂單,訂單結束; 301:騎手配送階段,配送中; 302:騎手配送階段,配送成功,訂單結束; 303:騎手配送階段,商家取消訂單,配送物品開始返還商家; 304:騎手配送階段——無法聯系收貨人,配送物品開始返還商家; 305:騎手配送階段,收貨人拒收,配送物品開始返還商家; 401:騎手返回配送貨品階段,貨品返還商戶成功,訂單結束; 501:因運力系統原因取消,訂單結束; 502:因不可抗拒因素(天氣,道路管制等原因)取消,訂單結束 "finish_code": 1024, //收貨碼 "pickup_code": 2048, //取貨碼 "dispatch_duration": 300 //預計騎手接單時間，單位秒，比如5分鐘，就填300, 無法預計填0 } } <<< error { 'status':2, 'message':'收件人信息不正確', 'data':{ "resultcode": 1010, "resultmsg": "收件人信息不正確" } } ~~~