## 預下配送單 ### 使用場景: * 1、在用戶提交外賣訂單時,商家可調用本接口查詢配送公司是否可接單、預計多久接單、運費預估等.預估運費可作為展示給用戶的運費參考值. * 2、舉個例子:商家通過預下配送單接口返回的預估運費是8元,商家可決定前端顧客下外賣單時展示給顧客看的運費是真實的8元,還是其他商家指定的金額. * 3、說明:本接口非必須調用接口,若不需要獲取配送公司是否可接單、預計多久接單、運費預估等,也可不調用本接口,直接下配送單. * 4、順豐同城可返回配送費用、配送距離、預計騎手接單時間,不支持返回delivery_token. * 5、閃送可返回配送費用、配送距離、預計騎手接單時間,不支持返回delivery_token. * 6、美團配送返回0時表示校驗通過,不支持返回配送費用、配送距離、預計騎手接單時間和delivery_token. * 7、達達支持預下單查詢配送費用、配送距離、預計騎手接單時間和delivery_token(有效期3分鐘) ~~~[api] post:/api/customer/order/businessOrderPreAdd *string:token=默認值#顧客端登錄令牌 *storeId#系統門店id *shopNo#商家門店編號,在配送公司登記,美團、閃送必填 *deliveryId#配送公司ID *openId#下單用戶的openid *senderName#發件人信息姓名,最長不超過256個字符 *senderCity#發件人信息城市名稱,如廣州市 *senderAddress#發件人信息地址(街道、小區、大廈等,用于定位) *senderAddressDetail#發件人信息地址詳情(樓號、單元號、層號) *senderPhone#發件人信息電話/手機號,最長不超過64個字符 *senderLng#發件人信息經度(火星坐標或百度坐標,和coordinateType字段配合使用,精確到小數點后6位) *senderLat#發件人信息緯度 *receiverName#收件人姓名,最長不超過256個字符 *receiverCity#收件人城市名稱,如廣州市 *receiverAddress#收件人地址(街道、小區、大廈等,用于定位) *receiverAddressDetail#收件人地址詳情(樓號、單元號、層號) *receiverPhone#收件人電話/手機號,最長不超過64個字符 *receiverLng#收件人經度(火星坐標或百度坐標,和 coordinateType 字段配合使用,確到小數點后6位 *receiverLat#收件人緯度 *goodsValue#貨物價格,單位為元,精確到小數點后兩位(如果小數點后位數多于兩位,則四舍五入保留兩位小數),范圍為(0-5000] *goodsWeight#貨物重量,單位為kg,精確到小數點后兩位(如果小數點后位數多于兩位,則四舍五入保留兩位小數),范圍為(0-50] *cargoFirstClass#品類一級類目 *cargoSecondClass#品類二級類目 *wxaPath#商家小程序的路徑,建議為訂單頁面 *imgUrl#商品縮略圖url *goodsName#商品名稱 *goodsCount#商品數量 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, //配送距離(單位：米) "dispatch_duration": 300, //預計騎手接單時間，單位秒，比如5分鐘，就填300, 無法預計填0 "delivery_token": "1111111" //配送公司可以返回此字段，當用戶下單時候帶上這個字段，保證在一段時間內運費不變 } } <<< error ~~~