建站
咨詢
售后
建站咨詢
新聞中心
這里有您想知道的互聯(lián)網(wǎng)營(yíng)銷(xiāo)解決方案
創(chuàng)新互聯(lián)小程序教程：微信小程序運(yùn)力方使用·onOrderAdd
immediateDelivery.onOrderAdd
本文檔描述服務(wù)器端接收的消息或事件，詳細(xì)說(shuō)明參見(jiàn) 消息推送。
創(chuàng)新互聯(lián)主打移動(dòng)網(wǎng)站、網(wǎng)站制作、成都網(wǎng)站建設(shè)、網(wǎng)站改版、網(wǎng)絡(luò)推廣、網(wǎng)站維護(hù)、域名注冊(cè)、等互聯(lián)網(wǎng)信息服務(wù)，為各行業(yè)提供服務(wù)。在技術(shù)實(shí)力的保障下，我們?yōu)榭蛻舫兄Z穩(wěn)定，放心的服務(wù)，根據(jù)網(wǎng)站的內(nèi)容與功能再?zèng)Q定采用什么樣的設(shè)計(jì)。最后，要實(shí)現(xiàn)符合網(wǎng)站需求的內(nèi)容、功能與設(shè)計(jì)，我們還會(huì)規(guī)劃穩(wěn)定安全的技術(shù)方案做保障。
真實(shí)發(fā)起下單任務(wù)
消息參數(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_add_order，不區(qū)分大小寫(xiě) |
| wx_token | string | 微信訂單 Token。請(qǐng)保存該Token，調(diào)用更新配送單狀態(tài)接口（updateOrder）時(shí)需要傳入 |
| delivery_token | string | 配送公司側(cè)在預(yù)下單時(shí)候返回的token，用于保證運(yùn)費(fèi)不變 |
| shopid | string | 商家id， 由配送公司分配的appkey |
| shop_no | string | 商家門(mén)店編號(hào)， 在配送公司側(cè)登記 |
| shop_order_id | string | 唯一標(biāo)識(shí)訂單的 ID，由商戶生成 |
| 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 | 城市名稱，如廣州市 |
| address | string | 地址(街道、小區(qū)、大廈等，用于定位) |
| address_detail | string | 地址詳情(樓號(hào)、單元號(hào)、層號(hào)) |
| phone | string | 電話/手機(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 | 城市名稱，如廣州市 |
| address | string | 地址(街道、小區(qū)、大廈等，用于定位) |
| address_detail | string | 地址詳情(樓號(hào)、單元號(hào)、層號(hào)) |
| phone | string | 電話/手機(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. | 貨物列表 |
goods 的結(jié)構(gòu)
| 屬性 | 類(lèi)型 | 說(shuō)明 |
|---|---|---|
| good_count | number | 貨物數(shù)量 |
| good_name | string | 貨品名稱 |
| 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í)間(達(dá)達(dá)支持，表示達(dá)達(dá)系統(tǒng)調(diào)度時(shí)間, 到那個(gè)時(shí)間才會(huì)有狀態(tài)更新的回調(diào)通知)，unix-timestamp, 比如1586342180 |
| expected_finish_time | number | 期望送達(dá)時(shí)間(美團(tuán)、順豐同城急送支持），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 | 用戶下單付款時(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)店取件送至用戶；2：從用戶取件送至門(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_add_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 | 否 | 配送距離(整數(shù)，單位：米) | |
| waybill_id | string | 否 | 配送單號(hào), 可以在API1更新配送單狀態(tài)異步返回 | |
| order_status | number | 是 | 配送單狀態(tài) | |
| finish_code | number | 否 | 收貨碼 | |
| pickup_code | number | 否 | 取貨碼 | |
| dispatch_duration | number | 否 | 預(yù)計(jì)騎手接單時(shí)間，單位秒，比如5分鐘，就填300, 無(wú)法預(yù)計(jì)填0 | |
| sender_lng | number | 否 | 發(fā)貨方經(jīng)度，火星坐標(biāo)，精確到小數(shù)點(diǎn)后6位， 用于消息通知，如果下單請(qǐng)求里有發(fā)貨人信息則不需要 | |
| sender_lat | number | 否 | 發(fā)貨方緯度，火星坐標(biāo)，精確到小數(shù)點(diǎn)后6位， 用于消息通知，如果下單請(qǐng)求里有發(fā)貨人信息則不需要 |
當(dāng)前題目：創(chuàng)新互聯(lián)小程序教程：微信小程序運(yùn)力方使用·onOrderAdd
URL標(biāo)題：http://fisionsoft.com.cn/article/dhddeoo.html
