微信小程序 小程序使用·reOrder

2020-07-31 14:06 更新

immediateDelivery.reOrder

本接口應在服務器端調用,詳細說明參見服務端API

重新下單

請求地址

POST https://api.weixin.qq.com/cgi-bin/express/local/business/order/readd?access_token=ACCESS_TOKEN

請求參數(shù)

屬性類型默認值必填說明
access_tokenstring接口調用憑證
delivery_tokenstring預下單接口返回的參數(shù),配送公司可保證在一段時間內運費不變
shopidstring商家id, 由配送公司分配的appkey
shop_order_idstring唯一標識訂單的 ID,由商戶生成, 不超過128字節(jié)
shop_nostring商家門店編號,在配送公司登記,如果只有一個門店,閃送shop_no必填,值為店鋪id
delivery_signstring用配送公司提供的appSecret加密的校驗串說明
delivery_idstring配送公司ID
openidstring下單用戶的openid
senderObject發(fā)件人信息,順豐同城急送必須填寫,美團配送、達達、閃送,若傳了shop_no的值可不填該字段
receiverObject收件人信息
cargoObject貨物信息
order_infoObject訂單信息
shopObject商品信息,會展示到物流通知消息中
sub_biz_idstring子商戶id,區(qū)分小程序內部多個子商戶

sender 的結構

屬性類型默認值必填說明
namestring姓名,最長不超過256個字符
citystring城市名稱,如廣州市
addressstring地址(街道、小區(qū)、大廈等,用于定位)
address_detailstring地址詳情(樓號、單元號、層號)
phonestring電話/手機號,最長不超過64個字符
lngnumber經度(火星坐標或百度坐標,和 coordinate_type 字段配合使用,確到小數(shù)點后6位
latnumber緯度(火星坐標或百度坐標,和 coordinate_type 字段配合使用,精確到小數(shù)點后6位)
coordinate_typenumber0坐標類型,0:火星坐標(高德,騰訊地圖均采用火星坐標) 1:百度坐標

receiver 的結構

屬性類型默認值必填說明
namestring姓名,最長不超過256個字符
citystring城市名稱,如廣州市
addressstring地址(街道、小區(qū)、大廈等,用于定位)
address_detailstring地址詳情(樓號、單元號、層號)
phonestring電話/手機號,最長不超過64個字符
lngnumber經度(火星坐標或百度坐標,和 coordinate_type 字段配合使用,確到小數(shù)點后6位
latnumber緯度(火星坐標或百度坐標,和 coordinate_type 字段配合使用,精確到小數(shù)點后6位)
coordinate_typenumber0坐標類型,0:火星坐標(高德,騰訊地圖均采用火星坐標) 1:百度坐標

cargo 的結構

屬性類型默認值必填說明
goods_valuenumber貨物價格,單位為元,精確到小數(shù)點后兩位(如果小數(shù)點后位數(shù)多于兩位,則四舍五入保留兩位小數(shù)),范圍為(0-5000]
goods_heightnumber貨物高度,單位為cm,精確到小數(shù)點后兩位(如果小數(shù)點后位數(shù)多于兩位,則四舍五入保留兩位小數(shù)),范圍為(0-45]
goods_lengthnumber貨物長度,單位為cm,精確到小數(shù)點后兩位(如果小數(shù)點后位數(shù)多于兩位,則四舍五入保留兩位小數(shù)),范圍為(0-65]
goods_widthnumber貨物寬度,單位為cm,精確到小數(shù)點后兩位(如果小數(shù)點后位數(shù)多于兩位,則四舍五入保留兩位小數(shù)),范圍為(0-50]
goods_weightnumber貨物重量,單位為kg,精確到小數(shù)點后兩位(如果小數(shù)點后位數(shù)多于兩位,則四舍五入保留兩位小數(shù)),范圍為(0-50]
goods_detailObject貨物詳情,最長不超過10240個字符
goods_pickup_infostring貨物取貨信息,用于騎手到店取貨,最長不超過100個字符
goods_delivery_infostring貨物交付信息,最長不超過100個字符
cargo_first_classstring品類一級類目, 詳見品類表
cargo_second_classstring品類二級類目

goods_detail 的結構

屬性類型默認值必填說明
goodsArray.<Object>貨物列表

goods 的結構

屬性類型默認值必填說明
good_countnumber貨物數(shù)量
good_namestring貨品名稱
good_pricenumber貨品單價,精確到小數(shù)點后兩位(如果小數(shù)點后位數(shù)多于兩位,則四舍五入保留兩位小數(shù))
good_unitstring貨品單位,最長不超過20個字符

order_info 的結構

屬性類型默認值必填說明
delivery_service_codestring配送服務代碼 不同配送公司自定義, 順豐和達達不填
order_typenumber0訂單類型, 0: 即時單 1 預約單,如預約單,需要設置expected_delivery_time或expected_finish_time或expected_pick_time
expected_delivery_timenumber0期望派單時間(美團、達達支持,美團表示商家發(fā)單時間,達達表示系統(tǒng)調度時間, 到那個時間才會有狀態(tài)更新的回調通知),unix-timestamp, 比如1586342180
expected_finish_timenumber0期望送達時間(順豐同城急送支持),unix-timestamp, 比如1586342180
expected_pick_timenumber0期望取件時間(閃送、順豐同城急送支持,閃送需要設置兩個小時后的時間,順豐同城急送只需傳expected_finish_time或expected_pick_time其中之一即可,同時都傳則以expected_finish_time為準),unix-timestamp, 比如1586342180
poi_seqstring門店訂單流水號,建議提供,方便騎手門店取貨,最長不超過32個字符
notestring備注,最長不超過200個字符
order_timenumber用戶下單付款時間, 比如1555220757
is_insurednumber0是否保價,0,非保價,1.保價
declared_valuenumber保價金額,單位為元,精確到分
tipsnumber小費,單位為元, 下單一般不加小費
is_direct_deliverynumber是否選擇直拿直送(0:不需要;1:需要。選擇直拿直送后,同一時間騎手只能配送此訂單至完成,配送費用也相應高一些,閃送必須選1,達達可選0或1,其余配送公司不支持直拿直送)
cash_on_deliverynumber騎手應付金額,單位為元,精確到分
cash_on_pickupnumber騎手應收金額,單位為元,精確到分
rider_pick_methodnumber物流流向,1:從門店取件送至用戶;2:從用戶取件送至門店
is_finish_code_needednumber收貨碼(0:不需要;1:需要。收貨碼的作用是:騎手必須輸入收貨碼才能完成訂單妥投)
is_pickup_code_needednumber取貨碼(0:不需要;1:需要。取貨碼的作用是:騎手必須輸入取貨碼才能從商家取貨)

shop 的結構

屬性類型默認值必填說明
wxa_pathstring商家小程序的路徑,建議為訂單頁面
img_urlstring商品縮略圖 url
goods_namestring商品名稱
goods_countnumber商品數(shù)量
wxa_appidstring若結算方式為:第三方向配送公司統(tǒng)一結算,商戶后續(xù)和第三方結算,則該參數(shù)必填;在該結算模式下,第三方用自己的開發(fā)小程序替授權商戶發(fā)起下單,并將授權小程序的appid給平臺,后續(xù)配送通知中可回流授權商戶小程序。

返回值

Object

屬性類型說明
errcodenumber錯誤碼, 當errcode==0或者不存在還需要看resultcode
errmsgstring錯誤描述
resultcodenumber運力返回的錯誤碼
resultmsgstring運力返回的錯誤描述
feenumber實際運費(單位:元),運費減去優(yōu)惠券費用
deliverfeenumber運費(單位:元)
couponfeenumber優(yōu)惠券費用(單位:元)
tipsnumber小費(單位:元)
insurancefeenumber保價費(單位:元)
distancenumber配送距離(單位:米)
waybill_idstring配送單號
order_statusnumber配送狀態(tài)
finish_codenumber收貨碼
pickup_codenumber取貨碼
dispatch_durationnumber預計騎手接單時間,單位秒,比如5分鐘,就填300, 無法預計填0

使用場景

在調用下配送單接口、訂單被取消、過期或者投遞異常的情況下,可調用此接口,重新下單,需要保持orderid一致。 備注:美團不支持重新下單接口,如果訂單被取消商家需要重新下單,請修改orderid之后,調用下配送單接口下單。

請求示例

{
   "cargo": {
       "cargo_first_class": "美食夜宵",
       "cargo_second_class": "零食小吃",
       "goods_detail": {
           "goods": [
               {
                   "good_count": 1,
                   "good_name": "水果",
                   "good_price": 10,
                   "good_unit": "元"
               },
               {
                   "good_count": 2,
                   "good_name": "蔬菜",
                   "good_price": 20,
                   "good_unit": "元"
               }
           ]
       },
       "goods_height": 1,
       "goods_length": 3,
       "goods_value": 5,
       "goods_weight": 1,
       "goods_width": 2
   },
   "delivery_id": "SFTC",
   "delivery_sign": "01234567890123456789",
   "openid": "oABC123456",
   "order_info": {
       "delivery_service_code": "",
       "expected_delivery_time": 0,
       "is_direct_delivery": 0,
       "is_finish_code_needed": 1,
       "is_insured": 0,
       "is_pickup_code_needed": 1,
       "note": "test_note",
       "order_time": 1555220757,
       "order_type": 0,
       "poi_seq": "1111",
       "tips": 0
   },
   "receiver": {
       "address": "xxx地鐵站",
       "address_detail": "2號樓202",
       "city": "北京市",
       "coordinate_type": 0,
       "lat": 40.1529600000,
       "lng": 116.5060300000,
       "name": "老王",
       "phone": "18512345678"
   },
   "sender": {
       "address": "xx大廈",
       "address_detail": "1號樓101",
       "city": "北京市",
       "coordinate_type": 0,
       "lat": 40.4486120000,
       "lng": 116.3830750000,
       "name": "劉一",
       "phone": "13712345678"
   },
   "shop": {
       "goods_count": 2,
       "goods_name": "寶貝",
       "img_url": "https://mmbiz.qpic.cn/mmbiz_png/xxxxxxxxx/0?wx_fmt=png",
       "wxa_path": "/page/index/index"
   },
   "shop_no": "12345678",
   "sub_biz_id": "sub_biz_id_1",
   "shop_order_id": "SFTC_001",
   "shopid": "122222222",
   "delivery_token": "xxxxxxxx"
}

返回示例

下單成功

{
  "resultcode": 0,
  "resultmsg": "ok",
  "fee": 10,
  "deliverfee": 10,
  "couponfee": 0,
  "tips": 0,
  "insurancfee": 0,
  "distance": 1000,
  "waybill_id": "123456789",
  "order_status": 101,
  "finish_code": 1024,
  "pickup_code": 2048,
  "dispatch_duration": 300
}

下單失敗

{
  "resultcode": 1010,
  "resultmsg": "收件人信息不正確"
}


以上內容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號