掃二維碼與項目經(jīng)理溝通
我們在微信上24小時期待你的聲音
解答本文疑問/技術咨詢/運營咨詢/技術建議/互聯(lián)網(wǎng)交流
本文檔描述服務器端接收的消息或事件，詳細說明參見 消息推送。
成都創(chuàng)新互聯(lián)公司主營進賢網(wǎng)站建設的網(wǎng)絡公司,主營網(wǎng)站建設方案,成都App制作,進賢h5成都小程序開發(fā)搭建,進賢網(wǎng)站營銷推廣歡迎進賢等地區(qū)企業(yè)咨詢
并非真正發(fā)單，用來驗證是否配送公司是否可以接單，并在成功時返回時效、計價等信息，也可用來驗證地址以及時間是否在配送范圍內(nèi)。注意：預下單和下單時候由于時間差或者配送公司策略問題，返回的運費可能不一致，如果配送公司返回delivery_token，商家真正下單時候帶上delivery_token，配送公司需保證在這一段時間內(nèi)運費不變
| 屬性 | 類型 | 說明 |
|---|---|---|
| ToUserName | string | 快遞公司小程序 UserName |
| FromUserName | string | 微信團隊的 OpenID （固定值） |
| CreateTime | number | 事件時間，Unix時間戳 |
| MsgType | string | 消息類型，固定為 event |
| Event | string | 事件類型，固定為 transport_precreate_order，不區(qū)分大小寫 |
| shopid | string | 商家id， 由配送公司分配的appkey |
| shop_no | string | 商家門店編號， 在配送公司側(cè)登記 |
| shop_order_id | string | 唯一標識訂單的 ID，由商戶生成 |
| delivery_sign | string | 用配送公司側(cè)提供的appSecret加密的校驗串 |
| sender | Object | 發(fā)件人信息，如果配送公司能從shopid+shop_no對應到門店地址，則不需要填寫，否則需填寫 |
| receiver | Object | 收件人信息 |
| cargo | Object | 貨物信息 |
| order_info | Object | 訂單信息 |
sender 的結(jié)構
| 屬性 | 類型 | 說明 |
|---|---|---|
| name | string | 姓名，最長不超過256個字符 |
| city | string | 城市名稱，如廣州市 |
| address | string | 地址(街道、小區(qū)、大廈等，用于定位) |
| address_detail | string | 地址詳情(樓號、單元號、層號) |
| phone | string | 電話/手機號，最長不超過64個字符 |
| lng | number | 經(jīng)度（火星坐標或百度坐標，和 coordinate_type 字段配合使用，確到小數(shù)點后6位 |
| lat | number | 緯度（火星坐標或百度坐標，和 coordinate_type 字段配合使用，精確到小數(shù)點后6位） |
| coordinate_type | number | 坐標類型，0：火星坐標（高德，騰訊地圖均采用火星坐標） 1：百度坐標 |
receiver 的結(jié)構
| 屬性 | 類型 | 說明 |
|---|---|---|
| name | string | 姓名，最長不超過256個字符 |
| city | string | 城市名稱，如廣州市 |
| address | string | 地址(街道、小區(qū)、大廈等，用于定位) |
| address_detail | string | 地址詳情(樓號、單元號、層號) |
| phone | string | 電話/手機號，最長不超過64個字符 |
| lng | number | 經(jīng)度（火星坐標或百度坐標，和 coordinate_type 字段配合使用，確到小數(shù)點后6位 |
| lat | number | 緯度（火星坐標或百度坐標，和 coordinate_type 字段配合使用，精確到小數(shù)點后6位） |
| coordinate_type | number | 坐標類型，0：火星坐標（高德，騰訊地圖均采用火星坐標） 1：百度坐標 |
cargo 的結(jié)構
| 屬性 | 類型 | 說明 |
|---|---|---|
| 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é)構
| 屬性 | 類型 | 說明 |
|---|---|---|
| goods | Array. | 貨物列表 |
goods 的結(jié)構
| 屬性 | 類型 | 說明 |
|---|---|---|
| good_count | number | 貨物數(shù)量 |
| good_name | string | 貨品名稱 |
| good_price | number | 貨品單價，精確到小數(shù)點后兩位（如果小數(shù)點后位數(shù)多于兩位，則四舍五入保留兩位小數(shù)） |
| good_unit | string | 貨品單位，最長不超過20個字符 |
order_info 的結(jié)構
| 屬性 | 類型 | 說明 |
|---|---|---|
| delivery_service_code | string | 配送服務代碼 不同配送公司自定義, 順豐和達達不填 |
| order_type | number | 訂單類型, 0: 即時單 1 預約單，如預約單，需要設置expected_delivery_time或expected_finish_time或expected_pick_time |
| expected_delivery_time | number | 期望派單時間(美團、達達支持，美團表示商家發(fā)單時間，達達表示系統(tǒng)調(diào)度時間, 到那個時間才會有狀態(tài)更新的回調(diào)通知)，unix-timestamp, 比如1586342180 |
| expected_finish_time | number | 期望送達時間(順豐同城急送支持），unix-timestamp, 比如1586342180 |
| expected_pick_time | number | 期望取件時間（閃送、順豐同城急送支持，閃送需要設置兩個小時后的時間，順豐同城急送只需傳expected_finish_time或expected_pick_time其中之一即可，同時都傳則以expected_finish_time為準），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：需要。選擇直拿直送后，同一時間騎手只能配送此訂單至完成，配送費用也相應高一些，閃送必須選1，達達可選0或1，其余配送公司不支持直拿直送） |
| cash_on_delivery | number | 騎手應付金額，單位為元，精確到分 |
| cash_on_pickup | number | 騎手應收金額，單位為元，精確到分 |
| 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_precreate_order，不區(qū)分大小寫 | |
| resultcode | number | 是 | 錯誤碼 | |
| resultmsg | string | 是 | 錯誤描述 | |
| fee | number | 是 | 實際運費(單位：元)，運費減去優(yōu)惠券費用 | |
| deliverfee | number | 是 | 運費(單位：元) | |
| couponfee | number | 是 | 優(yōu)惠券費用(單位：元) | |
| tips | number | 是 | 小費(單位：元) | |
| insurancefee | number | 是 | 保價費(單位：元) | |
| distance | number | 否 | 配送距離(單位：米) | |
| dispatch_duration | number | 否 | 預計騎手接單時間，單位秒，比如5分鐘，就填300, 無法預計填0 | |
| delivery_token | string | 否 | 配送公司可以返回此字段，當用戶下單時候帶上這個字段，配送公司可保證在一段時間內(nèi)運費不變 |
我們在微信上24小時期待你的聲音
解答本文疑問/技術咨詢/運營咨詢/技術建議/互聯(lián)網(wǎng)交流
微信二維碼
微信二維碼
移動版官網(wǎng)