W3Cschool
恭喜您成為首批注冊用戶
獲得88經驗值獎勵
本接口應在服務器端調用,詳細說明參見服務端API。
重新下單
POST https://api.weixin.qq.com/cgi-bin/express/local/business/order/readd?access_token=ACCESS_TOKEN
屬性 | 類型 | 默認值 | 必填 | 說明 |
---|---|---|---|---|
access_token | string | 是 | 接口調用憑證 | |
delivery_token | string | 否 | 預下單接口返回的參數(shù),配送公司可保證在一段時間內運費不變 | |
shopid | string | 是 | 商家id, 由配送公司分配的appkey | |
shop_order_id | string | 是 | 唯一標識訂單的 ID,由商戶生成, 不超過128字節(jié) | |
shop_no | string | 是 | 商家門店編號,在配送公司登記,如果只有一個門店,閃送shop_no必填,值為店鋪id | |
delivery_sign | string | 是 | 用配送公司提供的appSecret加密的校驗串說明 | |
delivery_id | string | 是 | 配送公司ID | |
openid | string | 是 | 下單用戶的openid | |
sender | Object | 是 | 發(fā)件人信息,順豐同城急送必須填寫,美團配送、達達、閃送,若傳了shop_no的值可不填該字段 | |
receiver | Object | 是 | 收件人信息 | |
cargo | Object | 是 | 貨物信息 | |
order_info | Object | 是 | 訂單信息 | |
shop | Object | 是 | 商品信息,會展示到物流通知消息中 | |
sub_biz_id | string | 否 | 子商戶id,區(qū)分小程序內部多個子商戶 |
sender 的結構
屬性 | 類型 | 默認值 | 必填 | 說明 |
---|---|---|---|---|
name | string | 是 | 姓名,最長不超過256個字符 | |
city | string | 是 | 城市名稱,如廣州市 | |
address | string | 是 | 地址(街道、小區(qū)、大廈等,用于定位) | |
address_detail | string | 是 | 地址詳情(樓號、單元號、層號) | |
phone | string | 是 | 電話/手機號,最長不超過64個字符 | |
lng | number | 是 | 經度(火星坐標或百度坐標,和 coordinate_type 字段配合使用,確到小數(shù)點后6位 | |
lat | number | 是 | 緯度(火星坐標或百度坐標,和 coordinate_type 字段配合使用,精確到小數(shù)點后6位) | |
coordinate_type | number | 0 | 否 | 坐標類型,0:火星坐標(高德,騰訊地圖均采用火星坐標) 1:百度坐標 |
receiver 的結構
屬性 | 類型 | 默認值 | 必填 | 說明 |
---|---|---|---|---|
name | string | 是 | 姓名,最長不超過256個字符 | |
city | string | 是 | 城市名稱,如廣州市 | |
address | string | 是 | 地址(街道、小區(qū)、大廈等,用于定位) | |
address_detail | string | 是 | 地址詳情(樓號、單元號、層號) | |
phone | string | 是 | 電話/手機號,最長不超過64個字符 | |
lng | number | 是 | 經度(火星坐標或百度坐標,和 coordinate_type 字段配合使用,確到小數(shù)點后6位 | |
lat | number | 是 | 緯度(火星坐標或百度坐標,和 coordinate_type 字段配合使用,精確到小數(shù)點后6位) | |
coordinate_type | number | 0 | 否 | 坐標類型,0:火星坐標(高德,騰訊地圖均采用火星坐標) 1:百度坐標 |
cargo 的結構
屬性 | 類型 | 默認值 | 必填 | 說明 |
---|---|---|---|---|
goods_value | number | 是 | 貨物價格,單位為元,精確到小數(shù)點后兩位(如果小數(shù)點后位數(shù)多于兩位,則四舍五入保留兩位小數(shù)),范圍為(0-5000] | |
goods_height | number | 否 | 貨物高度,單位為cm,精確到小數(shù)點后兩位(如果小數(shù)點后位數(shù)多于兩位,則四舍五入保留兩位小數(shù)),范圍為(0-45] | |
goods_length | number | 否 | 貨物長度,單位為cm,精確到小數(shù)點后兩位(如果小數(shù)點后位數(shù)多于兩位,則四舍五入保留兩位小數(shù)),范圍為(0-65] | |
goods_width | number | 否 | 貨物寬度,單位為cm,精確到小數(shù)點后兩位(如果小數(shù)點后位數(shù)多于兩位,則四舍五入保留兩位小數(shù)),范圍為(0-50] | |
goods_weight | number | 是 | 貨物重量,單位為kg,精確到小數(shù)點后兩位(如果小數(shù)點后位數(shù)多于兩位,則四舍五入保留兩位小數(shù)),范圍為(0-50] | |
goods_detail | Object | 否 | 貨物詳情,最長不超過10240個字符 | |
goods_pickup_info | string | 否 | 貨物取貨信息,用于騎手到店取貨,最長不超過100個字符 | |
goods_delivery_info | string | 否 | 貨物交付信息,最長不超過100個字符 | |
cargo_first_class | string | 是 | 品類一級類目, 詳見品類表 | |
cargo_second_class | string | 是 | 品類二級類目 |
goods_detail 的結構
屬性 | 類型 | 默認值 | 必填 | 說明 |
---|---|---|---|---|
goods | Array.<Object> | 是 | 貨物列表 |
goods 的結構
屬性 | 類型 | 默認值 | 必填 | 說明 |
---|---|---|---|---|
good_count | number | 是 | 貨物數(shù)量 | |
good_name | string | 是 | 貨品名稱 | |
good_price | number | 否 | 貨品單價,精確到小數(shù)點后兩位(如果小數(shù)點后位數(shù)多于兩位,則四舍五入保留兩位小數(shù)) | |
good_unit | string | 否 | 貨品單位,最長不超過20個字符 |
order_info 的結構
屬性 | 類型 | 默認值 | 必填 | 說明 |
---|---|---|---|---|
delivery_service_code | string | 否 | 配送服務代碼 不同配送公司自定義, 順豐和達達不填 | |
order_type | number | 0 | 否 | 訂單類型, 0: 即時單 1 預約單,如預約單,需要設置expected_delivery_time或expected_finish_time或expected_pick_time |
expected_delivery_time | number | 0 | 否 | 期望派單時間(美團、達達支持,美團表示商家發(fā)單時間,達達表示系統(tǒng)調度時間, 到那個時間才會有狀態(tài)更新的回調通知),unix-timestamp, 比如1586342180 |
expected_finish_time | number | 0 | 否 | 期望送達時間(順豐同城急送支持),unix-timestamp, 比如1586342180 |
expected_pick_time | number | 0 | 否 | 期望取件時間(閃送、順豐同城急送支持,閃送需要設置兩個小時后的時間,順豐同城急送只需傳expected_finish_time或expected_pick_time其中之一即可,同時都傳則以expected_finish_time為準),unix-timestamp, 比如1586342180 |
poi_seq | string | 否 | 門店訂單流水號,建議提供,方便騎手門店取貨,最長不超過32個字符 | |
note | string | 否 | 備注,最長不超過200個字符 | |
order_time | number | 否 | 用戶下單付款時間, 比如1555220757 | |
is_insured | number | 0 | 否 | 是否保價,0,非保價,1.保價 |
declared_value | number | 否 | 保價金額,單位為元,精確到分 | |
tips | number | 否 | 小費,單位為元, 下單一般不加小費 | |
is_direct_delivery | number | 否 | 是否選擇直拿直送(0:不需要;1:需要。選擇直拿直送后,同一時間騎手只能配送此訂單至完成,配送費用也相應高一些,閃送必須選1,達達可選0或1,其余配送公司不支持直拿直送) | |
cash_on_delivery | number | 否 | 騎手應付金額,單位為元,精確到分 | |
cash_on_pickup | number | 否 | 騎手應收金額,單位為元,精確到分 | |
rider_pick_method | number | 否 | 物流流向,1:從門店取件送至用戶;2:從用戶取件送至門店 | |
is_finish_code_needed | number | 否 | 收貨碼(0:不需要;1:需要。收貨碼的作用是:騎手必須輸入收貨碼才能完成訂單妥投) | |
is_pickup_code_needed | number | 否 | 取貨碼(0:不需要;1:需要。取貨碼的作用是:騎手必須輸入取貨碼才能從商家取貨) |
shop 的結構
屬性 | 類型 | 默認值 | 必填 | 說明 |
---|---|---|---|---|
wxa_path | string | 是 | 商家小程序的路徑,建議為訂單頁面 | |
img_url | string | 是 | 商品縮略圖 url | |
goods_name | string | 是 | 商品名稱 | |
goods_count | number | 是 | 商品數(shù)量 | |
wxa_appid | string | 否 | 若結算方式為:第三方向配送公司統(tǒng)一結算,商戶后續(xù)和第三方結算,則該參數(shù)必填;在該結算模式下,第三方用自己的開發(fā)小程序替授權商戶發(fā)起下單,并將授權小程序的appid給平臺,后續(xù)配送通知中可回流授權商戶小程序。 |
屬性 | 類型 | 說明 |
---|---|---|
errcode | number | 錯誤碼, 當errcode==0或者不存在還需要看resultcode |
errmsg | string | 錯誤描述 |
resultcode | number | 運力返回的錯誤碼 |
resultmsg | string | 運力返回的錯誤描述 |
fee | number | 實際運費(單位:元),運費減去優(yōu)惠券費用 |
deliverfee | number | 運費(單位:元) |
couponfee | number | 優(yōu)惠券費用(單位:元) |
tips | number | 小費(單位:元) |
insurancefee | number | 保價費(單位:元) |
distance | number | 配送距離(單位:米) |
waybill_id | string | 配送單號 |
order_status | number | 配送狀態(tài) |
finish_code | number | 收貨碼 |
pickup_code | number | 取貨碼 |
dispatch_duration | number | 預計騎手接單時間,單位秒,比如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": "收件人信息不正確"
}
Copyright©2021 w3cschool編程獅|閩ICP備15016281號-3|閩公網安備35020302033924號
違法和不良信息舉報電話:173-0602-2364|舉報郵箱:jubao@eeedong.com
掃描二維碼
下載編程獅App
編程獅公眾號
聯(lián)系方式:
更多建議: