免費(fèi)AI編程助手
注冊(cè)成功
X
W3Cschool
恭喜您成為首批注冊(cè)用戶(hù)
獲得88經(jīng)驗(yàn)值獎(jiǎng)勵(lì)
微信小程序 運(yùn)力方使用·onOrderPreAdd
2020-07-31 14:06 更新
immediateDelivery.onOrderPreAdd
本文檔描述服務(wù)器端接收的消息或事件，詳細(xì)說(shuō)明參見(jiàn)消息推送。
并非真正發(fā)單，用來(lái)驗(yàn)證是否配送公司是否可以接單，并在成功時(shí)返回時(shí)效、計(jì)價(jià)等信息，也可用來(lái)驗(yàn)證地址以及時(shí)間是否在配送范圍內(nèi)。注意：預(yù)下單和下單時(shí)候由于時(shí)間差或者配送公司策略問(wèn)題，返回的運(yùn)費(fèi)可能不一致，如果配送公司返回delivery_token，商家真正下單時(shí)候帶上delivery_token，配送公司需保證在這一段時(shí)間內(nèi)運(yùn)費(fèi)不變
消息參數(shù)
Object
| 屬性 | 類(lèi)型 | 說(shuō)明 |
|---|---|---|
| ToUserName | string | 快遞公司小程序 UserName |
| FromUserName | string | 微信團(tuán)隊(duì)的 OpenID （固定值） |
| CreateTime | number | 事件時(shí)間，Unix時(shí)間戳 |
| MsgType | string | 消息類(lèi)型，固定為 event |
| Event | string | 事件類(lèi)型，固定為 transport_precreate_order，不區(qū)分大小寫(xiě) |
| shopid | string | 商家id， 由配送公司分配的appkey |
| shop_no | string | 商家門(mén)店編號(hào)， 在配送公司側(cè)登記 |
| shop_order_id | string | 唯一標(biāo)識(shí)訂單的 ID，由商戶(hù)生成 |
| delivery_sign | string | 用配送公司側(cè)提供的appSecret加密的校驗(yàn)串 |
| sender | Object | 發(fā)件人信息，如果配送公司能從shopid+shop_no對(duì)應(yīng)到門(mén)店地址，則不需要填寫(xiě)，否則需填寫(xiě) |
| receiver | Object | 收件人信息 |
| cargo | Object | 貨物信息 |
| order_info | Object | 訂單信息 |
sender 的結(jié)構(gòu)
| 屬性 | 類(lèi)型 | 說(shuō)明 |
|---|---|---|
| name | string | 姓名，最長(zhǎng)不超過(guò)256個(gè)字符 |
| city | string | 城市名稱(chēng)，如廣州市 |
| address | string | 地址(街道、小區(qū)、大廈等，用于定位) |
| address_detail | string | 地址詳情(樓號(hào)、單元號(hào)、層號(hào)) |
| phone | string | 電話(huà)/手機(jī)號(hào)，最長(zhǎng)不超過(guò)64個(gè)字符 |
| lng | number | 經(jīng)度（火星坐標(biāo)或百度坐標(biāo)，和 coordinate_type 字段配合使用，確到小數(shù)點(diǎn)后6位 |
| lat | number | 緯度（火星坐標(biāo)或百度坐標(biāo)，和 coordinate_type 字段配合使用，精確到小數(shù)點(diǎn)后6位） |
| coordinate_type | number | 坐標(biāo)類(lèi)型，0：火星坐標(biāo)（高德，騰訊地圖均采用火星坐標(biāo)） 1：百度坐標(biāo) |
receiver 的結(jié)構(gòu)
| 屬性 | 類(lèi)型 | 說(shuō)明 |
|---|---|---|
| name | string | 姓名，最長(zhǎng)不超過(guò)256個(gè)字符 |
| city | string | 城市名稱(chēng)，如廣州市 |
| address | string | 地址(街道、小區(qū)、大廈等，用于定位) |
| address_detail | string | 地址詳情(樓號(hào)、單元號(hào)、層號(hào)) |
| phone | string | 電話(huà)/手機(jī)號(hào)，最長(zhǎng)不超過(guò)64個(gè)字符 |
| lng | number | 經(jīng)度（火星坐標(biāo)或百度坐標(biāo)，和 coordinate_type 字段配合使用，確到小數(shù)點(diǎn)后6位 |
| lat | number | 緯度（火星坐標(biāo)或百度坐標(biāo)，和 coordinate_type 字段配合使用，精確到小數(shù)點(diǎn)后6位） |
| coordinate_type | number | 坐標(biāo)類(lèi)型，0：火星坐標(biāo)（高德，騰訊地圖均采用火星坐標(biāo)） 1：百度坐標(biāo) |
cargo 的結(jié)構(gòu)
| 屬性 | 類(lèi)型 | 說(shuō)明 |
|---|---|---|
| goods_value | number | 貨物價(jià)格，單位為元，精確到小數(shù)點(diǎn)后兩位（如果小數(shù)點(diǎn)后位數(shù)多于兩位，則四舍五入保留兩位小數(shù)），范圍為(0-5000] |
| goods_height | number | 貨物高度，單位為cm，精確到小數(shù)點(diǎn)后兩位（如果小數(shù)點(diǎn)后位數(shù)多于兩位，則四舍五入保留兩位小數(shù)），范圍為(0-45] |
| goods_length | number | 貨物長(zhǎng)度，單位為cm，精確到小數(shù)點(diǎn)后兩位（如果小數(shù)點(diǎn)后位數(shù)多于兩位，則四舍五入保留兩位小數(shù)），范圍為(0-65] |
| goods_width | number | 貨物寬度，單位為cm，精確到小數(shù)點(diǎn)后兩位（如果小數(shù)點(diǎn)后位數(shù)多于兩位，則四舍五入保留兩位小數(shù)），范圍為(0-50] |
| goods_weight | number | 貨物重量，單位為kg，精確到小數(shù)點(diǎn)后兩位（如果小數(shù)點(diǎn)后位數(shù)多于兩位，則四舍五入保留兩位小數(shù)），范圍為(0-50] |
| goods_detail | Object | 貨物詳情，最長(zhǎng)不超過(guò)10240個(gè)字符 |
| goods_pickup_info | string | 貨物取貨信息，用于騎手到店取貨，最長(zhǎng)不超過(guò)100個(gè)字符 |
| goods_delivery_info | string | 貨物交付信息，最長(zhǎng)不超過(guò)100個(gè)字符 |
| cargo_first_class | string | 品類(lèi)一級(jí)類(lèi)目, 詳見(jiàn)品類(lèi)表 |
| cargo_second_class | string | 品類(lèi)二級(jí)類(lèi)目 |
goods_detail 的結(jié)構(gòu)
| 屬性 | 類(lèi)型 | 說(shuō)明 |
|---|---|---|
| goods | Array.<Object> | 貨物列表 |
goods 的結(jié)構(gòu)
| 屬性 | 類(lèi)型 | 說(shuō)明 |
|---|---|---|
| good_count | number | 貨物數(shù)量 |
| good_name | string | 貨品名稱(chēng) |
| good_price | number | 貨品單價(jià)，精確到小數(shù)點(diǎn)后兩位（如果小數(shù)點(diǎn)后位數(shù)多于兩位，則四舍五入保留兩位小數(shù)） |
| good_unit | string | 貨品單位，最長(zhǎng)不超過(guò)20個(gè)字符 |
order_info 的結(jié)構(gòu)
| 屬性 | 類(lèi)型 | 說(shuō)明 |
|---|---|---|
| delivery_service_code | string | 配送服務(wù)代碼 不同配送公司自定義, 順豐和達(dá)達(dá)不填 |
| order_type | number | 訂單類(lèi)型, 0: 即時(shí)單 1 預(yù)約單，如預(yù)約單，需要設(shè)置expected_delivery_time或expected_finish_time或expected_pick_time |
| expected_delivery_time | number | 期望派單時(shí)間(美團(tuán)、達(dá)達(dá)支持，美團(tuán)表示商家發(fā)單時(shí)間，達(dá)達(dá)表示系統(tǒng)調(diào)度時(shí)間, 到那個(gè)時(shí)間才會(huì)有狀態(tài)更新的回調(diào)通知)，unix-timestamp, 比如1586342180 |
| expected_finish_time | number | 期望送達(dá)時(shí)間(順豐同城急送支持），unix-timestamp, 比如1586342180 |
| expected_pick_time | number | 期望取件時(shí)間（閃送、順豐同城急送支持，閃送需要設(shè)置兩個(gè)小時(shí)后的時(shí)間，順豐同城急送只需傳expected_finish_time或expected_pick_time其中之一即可，同時(shí)都傳則以expected_finish_time為準(zhǔn)），unix-timestamp, 比如1586342180 |
| poi_seq | string | 門(mén)店訂單流水號(hào)，建議提供，方便騎手門(mén)店取貨，最長(zhǎng)不超過(guò)32個(gè)字符 |
| note | string | 備注，最長(zhǎng)不超過(guò)200個(gè)字符 |
| order_time | number | 用戶(hù)下單付款時(shí)間, 比如1555220757 |
| is_insured | number | 是否保價(jià)，0，非保價(jià)，1.保價(jià) |
| declared_value | number | 保價(jià)金額，單位為元，精確到分 |
| tips | number | 小費(fèi)，單位為元, 下單一般不加小費(fèi) |
| is_direct_delivery | number | 是否選擇直拿直送（0：不需要；1：需要。選擇直拿直送后，同一時(shí)間騎手只能配送此訂單至完成，配送費(fèi)用也相應(yīng)高一些，閃送必須選1，達(dá)達(dá)可選0或1，其余配送公司不支持直拿直送） |
| cash_on_delivery | number | 騎手應(yīng)付金額，單位為元，精確到分 |
| cash_on_pickup | number | 騎手應(yīng)收金額，單位為元，精確到分 |
| rider_pick_method | number | 物流流向，1：從門(mén)店取件送至用戶(hù)；2：從用戶(hù)取件送至門(mén)店 |
| is_finish_code_needed | number | 收貨碼（0：不需要；1：需要。收貨碼的作用是：騎手必須輸入收貨碼才能完成訂單妥投） |
| is_pickup_code_needed | number | 取貨碼（0：不需要；1：需要。取貨碼的作用是：騎手必須輸入取貨碼才能從商家取貨） |
消息返回
| 屬性 | 類(lèi)型 | 默認(rèn)值 | 必填 | 說(shuō)明 |
|---|---|---|---|---|
| ToUserName | string | 是 | 原樣返回請(qǐng)求中的 FromUserName | |
| FromUserName | string | 是 | 快遞公司小程序 UserName | |
| CreateTime | number | 是 | 事件時(shí)間，Unix時(shí)間戳 | |
| MsgType | string | 是 | 消息類(lèi)型，固定為 event | |
| Event | string | 是 | 事件類(lèi)型，固定為 transport_precreate_order，不區(qū)分大小寫(xiě) | |
| resultcode | number | 是 | 錯(cuò)誤碼 | |
| resultmsg | string | 是 | 錯(cuò)誤描述 | |
| fee | number | 是 | 實(shí)際運(yùn)費(fèi)(單位：元)，運(yùn)費(fèi)減去優(yōu)惠券費(fèi)用 | |
| deliverfee | number | 是 | 運(yùn)費(fèi)(單位：元) | |
| couponfee | number | 是 | 優(yōu)惠券費(fèi)用(單位：元) | |
| tips | number | 是 | 小費(fèi)(單位：元) | |
| insurancefee | number | 是 | 保價(jià)費(fèi)(單位：元) | |
| distance | number | 否 | 配送距離(單位：米) | |
| dispatch_duration | number | 否 | 預(yù)計(jì)騎手接單時(shí)間，單位秒，比如5分鐘，就填300, 無(wú)法預(yù)計(jì)填0 | |
| delivery_token | string | 否 | 配送公司可以返回此字段，當(dāng)用戶(hù)下單時(shí)候帶上這個(gè)字段，配送公司可保證在一段時(shí)間內(nèi)運(yùn)費(fèi)不變 |
以上內(nèi)容是否對(duì)您有幫助：
在文檔使用的過(guò)程中是否遇到以下問(wèn)題：
- 內(nèi)容錯(cuò)誤
- 更新不及時(shí)
- 鏈接錯(cuò)誤
- 缺少代碼/圖片示列
- 太簡(jiǎn)單/步驟待完善
- 其他
推薦文章
推薦教程
精選筆記
Copyright©2021 w3cschool編程獅|閩ICP備15016281號(hào)-3|閩公網(wǎng)安備35020302033924號(hào)
違法和不良信息舉報(bào)電話(huà)：173-0602-2364|舉報(bào)郵箱：jubao@eeedong.com
更多建議：