日本综合一区二区|亚洲中文天堂综合|日韩欧美自拍一区|男女精品天堂一区|欧美自拍第6页亚洲成人精品一区|亚洲黄色天堂一区二区成人|超碰91偷拍第一页|日韩av夜夜嗨中文字幕|久久蜜综合视频官网|精美人妻一区二区三区

RELATEED CONSULTING
相關(guān)咨詢
選擇下列產(chǎn)品馬上在線溝通
服務(wù)時(shí)間:8:30-17:00
你可能遇到了下面的問(wèn)題
關(guān)閉右側(cè)工具欄

新聞中心

這里有您想知道的互聯(lián)網(wǎng)營(yíng)銷解決方案
創(chuàng)新互聯(lián)小程序教程:微信小程序小程序使用·addOrder

immediateDelivery.addOrder

本接口應(yīng)在服務(wù)器端調(diào)用,詳細(xì)說(shuō)明參見 服務(wù)端API。

創(chuàng)新互聯(lián)公司主營(yíng)黃浦網(wǎng)站建設(shè)的網(wǎng)絡(luò)公司,主營(yíng)網(wǎng)站建設(shè)方案,重慶APP軟件開發(fā),黃浦h5重慶小程序開發(fā)搭建,黃浦網(wǎng)站營(yíng)銷推廣歡迎黃浦等地區(qū)企業(yè)咨詢

下配送單接口

請(qǐng)求地址

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

請(qǐng)求參數(shù)

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

sender 的結(jié)構(gòu)

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

receiver 的結(jié)構(gòu)

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

cargo 的結(jié)構(gòu)

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

goods_detail 的結(jié)構(gòu)

屬性 類型 默認(rèn)值 必填 說(shuō)明
goodsArray.貨物列表

goods 的結(jié)構(gòu)

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

order_info 的結(jié)構(gòu)

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

shop 的結(jié)構(gòu)

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

返回值

Object

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

使用場(chǎng)景

商家可調(diào)用本接口向配送公司請(qǐng)求下配送單,配送公司會(huì)返回這一單的配送單號(hào)、配送費(fèi)、預(yù)計(jì)騎手接單時(shí)間等信息。如遇下單錯(cuò)誤,請(qǐng)先確認(rèn)一下編碼方式,python建議 json.dumps(b, ensure_ascii=False),php建議 json_encode($arr, JSON_UNESCAPED_UNICODE) 可預(yù)約時(shí)間:達(dá)達(dá):72小時(shí)內(nèi),閃送2小時(shí)以后,48小時(shí)以內(nèi)

請(qǐng)求示例

{
   "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號(hào)樓202",
       "city": "北京市",
       "coordinate_type": 0,
       "lat": 40.1529600000,
       "lng": 116.5060300000,
       "name": "老王",
       "phone": "18512345678"
   },
   "sender": {
       "address": "xx大廈",
       "address_detail": "1號(hào)樓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": "收件人信息不正確"
}

網(wǎng)頁(yè)名稱:創(chuàng)新互聯(lián)小程序教程:微信小程序小程序使用·addOrder
標(biāo)題網(wǎng)址:http://www.dlmjj.cn/article/cdppjjj.html