微信小程序 運(yùn)力方使用·onOrderAdd

2020-07-31 14:06 更新

immediateDelivery.onOrderAdd

本文檔描述服務(wù)器端接收的消息或事件，詳細(xì)說明參見消息推送。

真實(shí)發(fā)起下單任務(wù)

消息參數(shù)

Object

屬性類型說明
ToUserNamestring快遞公司小程序 UserName
FromUserNamestring微信團(tuán)隊(duì)的 OpenID （固定值）
CreateTimenumber事件時(shí)間，Unix時(shí)間戳
MsgTypestring消息類型，固定為 event
Eventstring事件類型，固定為 transport_add_order，不區(qū)分大小寫
wx_tokenstring微信訂單 Token。請保存該Token，調(diào)用更新配送單狀態(tài)接口（updateOrder）時(shí)需要傳入
delivery_tokenstring配送公司側(cè)在預(yù)下單時(shí)候返回的token，用于保證運(yùn)費(fèi)不變
shopidstring商家id， 由配送公司分配的appkey
shop_nostring商家門店編號(hào)， 在配送公司側(cè)登記
shop_order_idstring唯一標(biāo)識(shí)訂單的 ID，由商戶生成
delivery_signstring用配送公司側(cè)提供的appSecret加密的校驗(yàn)串
senderObject發(fā)件人信息，如果配送公司能從shopid+shop_no對應(yīng)到門店地址，則不需要填寫，否則需填寫
receiverObject收件人信息
cargoObject貨物信息
order_infoObject訂單信息

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

屬性類型說明
namestring姓名，最長不超過256個(gè)字符
citystring城市名稱，如廣州市
addressstring地址(街道、小區(qū)、大廈等，用于定位)
address_detailstring地址詳情(樓號(hào)、單元號(hào)、層號(hào))
phonestring電話/手機(jī)號(hào)，最長不超過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_typenumber坐標(biāo)類型，0：火星坐標(biāo)（高德，騰訊地圖均采用火星坐標(biāo)） 1：百度坐標(biāo)

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

屬性類型說明
namestring姓名，最長不超過256個(gè)字符
citystring城市名稱，如廣州市
addressstring地址(街道、小區(qū)、大廈等，用于定位)
address_detailstring地址詳情(樓號(hào)、單元號(hào)、層號(hào))
phonestring電話/手機(jī)號(hào)，最長不超過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_typenumber坐標(biāo)類型，0：火星坐標(biāo)（高德，騰訊地圖均采用火星坐標(biāo)） 1：百度坐標(biāo)

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

屬性類型說明
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貨物長度，單位為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貨物詳情，最長不超過10240個(gè)字符
goods_pickup_infostring貨物取貨信息，用于騎手到店取貨，最長不超過100個(gè)字符
goods_delivery_infostring貨物交付信息，最長不超過100個(gè)字符
cargo_first_classstring品類一級(jí)類目, 詳見品類表
cargo_second_classstring品類二級(jí)類目

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

屬性類型說明
goodsArray.<Object>貨物列表

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

屬性類型說明
good_countnumber貨物數(shù)量
good_namestring貨品名稱
good_pricenumber貨品單價(jià)，精確到小數(shù)點(diǎn)后兩位（如果小數(shù)點(diǎn)后位數(shù)多于兩位，則四舍五入保留兩位小數(shù)）
good_unitstring貨品單位，最長不超過20個(gè)字符

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

屬性類型說明
delivery_service_codestring配送服務(wù)代碼 不同配送公司自定義, 順豐和達(dá)達(dá)不填
order_typenumber訂單類型, 0: 即時(shí)單 1 預(yù)約單，如預(yù)約單，需要設(shè)置expected_delivery_time或expected_finish_time或expected_pick_time
expected_delivery_timenumber期望派單時(shí)間(達(dá)達(dá)支持，表示達(dá)達(dá)系統(tǒng)調(diào)度時(shí)間, 到那個(gè)時(shí)間才會(huì)有狀態(tài)更新的回調(diào)通知)，unix-timestamp, 比如1586342180
expected_finish_timenumber期望送達(dá)時(shí)間(美團(tuán)、順豐同城急送支持），unix-timestamp, 比如1586342180
expected_pick_timenumber期望取件時(shí)間（閃送、順豐同城急送支持，閃送需要設(shè)置兩個(gè)小時(shí)后的時(shí)間，順豐同城急送只需傳expected_finish_time或expected_pick_time其中之一即可，同時(shí)都傳則以expected_finish_time為準(zhǔn)），unix-timestamp, 比如1586342180
poi_seqstring門店訂單流水號(hào)，建議提供，方便騎手門店取貨，最長不超過32個(gè)字符
notestring備注，最長不超過200個(gè)字符
order_timenumber用戶下單付款時(shí)間, 順豐必填, 比如1555220757
is_insurednumber是否保價(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：需要。取貨碼的作用是：騎手必須輸入取貨碼才能從商家取貨）

消息返回

屬性類型默認(rèn)值必填說明
ToUserNamestring是原樣返回請求中的 FromUserName
FromUserNamestring是快遞公司小程序 UserName
CreateTimenumber是事件時(shí)間，Unix時(shí)間戳
MsgTypestring是消息類型，固定為 event
Eventstring是事件類型，固定為 transport_add_order，不區(qū)分大小寫
resultcodenumber是錯(cuò)誤碼
resultmsgstring是錯(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), 可以在API1更新配送單狀態(tài)異步返回
order_statusnumber是配送單狀態(tài)
finish_codenumber否收貨碼
pickup_codenumber否取貨碼
dispatch_durationnumber否預(yù)計(jì)騎手接單時(shí)間，單位秒，比如5分鐘，就填300, 無法預(yù)計(jì)填0
sender_lngnumber否發(fā)貨方經(jīng)度，火星坐標(biāo)，精確到小數(shù)點(diǎn)后6位， 用于消息通知，如果下單請求里有發(fā)貨人信息則不需要
sender_latnumber否發(fā)貨方緯度，火星坐標(biāo)，精確到小數(shù)點(diǎn)后6位， 用于消息通知，如果下單請求里有發(fā)貨人信息則不需要


以上內(nèi)容是否對您有幫助：
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號(hào)
微信公眾號(hào)

編程獅公眾號(hào)