閱讀(3.9k) 書簽贊(0) 我要糾錯

微信小程序運力方使用·onOrderAdd

2020-07-31 14:06 更新

immediateDelivery.onOrderAdd

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

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

消息參數(shù)

Object

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

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

屬性	類型	說明
name	string	姓名，最長不超過256個字符
city	string	城市名稱，如廣州市
address	string	地址(街道、小區(qū)、大廈等，用于定位)
address_detail	string	地址詳情(樓號、單元號、層號)
phone	string	電話/手機號，最長不超過64個字符
lng	number	經(jīng)度（火星坐標(biāo)或百度坐標(biāo)，和 coordinate_type 字段配合使用，確到小數(shù)點后6位
lat	number	緯度（火星坐標(biāo)或百度坐標(biāo)，和 coordinate_type 字段配合使用，精確到小數(shù)點后6位）
coordinate_type	number	坐標(biāo)類型，0：火星坐標(biāo)（高德，騰訊地圖均采用火星坐標(biāo)） 1：百度坐標(biāo)

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

屬性	類型	說明
name	string	姓名，最長不超過256個字符
city	string	城市名稱，如廣州市
address	string	地址(街道、小區(qū)、大廈等，用于定位)
address_detail	string	地址詳情(樓號、單元號、層號)
phone	string	電話/手機號，最長不超過64個字符
lng	number	經(jīng)度（火星坐標(biāo)或百度坐標(biāo)，和 coordinate_type 字段配合使用，確到小數(shù)點后6位
lat	number	緯度（火星坐標(biāo)或百度坐標(biāo)，和 coordinate_type 字段配合使用，精確到小數(shù)點后6位）
coordinate_type	number	坐標(biāo)類型，0：火星坐標(biāo)（高德，騰訊地圖均采用火星坐標(biāo)） 1：百度坐標(biāo)

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

屬性	類型	說明
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 的結(jié)構(gòu)

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

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

屬性	類型	說明
good_count	number	貨物數(shù)量
good_name	string	貨品名稱
good_price	number	貨品單價，精確到小數(shù)點后兩位（如果小數(shù)點后位數(shù)多于兩位，則四舍五入保留兩位小數(shù)）
good_unit	string	貨品單位，最長不超過20個字符

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

屬性	類型	說明
delivery_service_code	string	配送服務(wù)代碼不同配送公司自定義, 順豐和達(dá)達(dá)不填
order_type	number	訂單類型, 0: 即時單 1 預(yù)約單，如預(yù)約單，需要設(shè)置expected_delivery_time或expected_finish_time或expected_pick_time
expected_delivery_time	number	期望派單時間(達(dá)達(dá)支持，表示達(dá)達(dá)系統(tǒng)調(diào)度時間, 到那個時間才會有狀態(tài)更新的回調(diào)通知)，unix-timestamp, 比如1586342180
expected_finish_time	number	期望送達(dá)時間(美團(tuán)、順豐同城急送支持），unix-timestamp, 比如1586342180
expected_pick_time	number	期望取件時間（閃送、順豐同城急送支持，閃送需要設(shè)置兩個小時后的時間，順豐同城急送只需傳expected_finish_time或expected_pick_time其中之一即可，同時都傳則以expected_finish_time為準(zhǔn)），unix-timestamp, 比如1586342180
poi_seq	string	門店訂單流水號，建議提供，方便騎手門店取貨，最長不超過32個字符
note	string	備注，最長不超過200個字符
order_time	number	用戶下單付款時間, 順豐必填, 比如1555220757
is_insured	number	是否保價，0，非保價，1.保價
declared_value	number	保價金額，單位為元，精確到分
tips	number	小費，單位為元, 下單一般不加小費
is_direct_delivery	number	是否選擇直拿直送（0：不需要；1：需要。選擇直拿直送后，同一時間騎手只能配送此訂單至完成，配送費用也相應(yīng)高一些，閃送必須選1，達(dá)達(dá)可選0或1，其余配送公司不支持直拿直送）
cash_on_delivery	number	騎手應(yīng)付金額，單位為元，精確到分
cash_on_pickup	number	騎手應(yīng)收金額，單位為元，精確到分
rider_pick_method	number	物流流向，1：從門店取件送至用戶；2：從用戶取件送至門店
is_finish_code_needed	number	收貨碼（0：不需要；1：需要。收貨碼的作用是：騎手必須輸入收貨碼才能完成訂單妥投）
is_pickup_code_needed	number	取貨碼（0：不需要；1：需要。取貨碼的作用是：騎手必須輸入取貨碼才能從商家取貨）

消息返回

屬性	類型	必填	說明
ToUserName	string	是	原樣返回請求中的 FromUserName
FromUserName	string	是	快遞公司小程序 UserName
CreateTime	number	是	事件時間，Unix時間戳
MsgType	string	是	消息類型，固定為 event
Event	string	是	事件類型，固定為 transport_add_order，不區(qū)分大小寫
resultcode	number	是	錯誤碼
resultmsg	string	是	錯誤描述
fee	number	是	實際運費(單位：元)，運費減去優(yōu)惠券費用
deliverfee	number	是	運費(單位：元)
couponfee	number	是	優(yōu)惠券費用(單位：元)
tips	number	是	小費(單位：元)
insurancefee	number	是	保價費(單位：元)
distance	number	否	配送距離(整數(shù)，單位：米)
waybill_id	string	否	配送單號, 可以在API1更新配送單狀態(tài)異步返回
order_status	number	是	配送單狀態(tài)
finish_code	number	否	收貨碼
pickup_code	number	否	取貨碼
dispatch_duration	number	否	預(yù)計騎手接單時間，單位秒，比如5分鐘，就填300, 無法預(yù)計填0
sender_lng	number	否	發(fā)貨方經(jīng)度，火星坐標(biāo)，精確到小數(shù)點后6位，用于消息通知，如果下單請求里有發(fā)貨人信息則不需要
sender_lat	number	否	發(fā)貨方緯度，火星坐標(biāo)，精確到小數(shù)點后6位，用于消息通知，如果下單請求里有發(fā)貨人信息則不需要

以上內(nèi)容是否對您有幫助：

← 微信小程序運力方使用·onMockUpdateOrder

微信小程序運力方使用·onOrderAddTips →

寫筆記

我要補充

微信小程序 運力方使用·onOrderAdd

immediateDelivery.onOrderAdd

消息參數(shù)

Object

消息返回

推薦文章

推薦教程

推薦課程

微信小程序運力方使用·onOrderAdd