日本综合一区二区|亚洲中文天堂综合|日韩欧美自拍一区|男女精品天堂一区|欧美自拍第6页亚洲成人精品一区|亚洲黄色天堂一区二区成人|超碰91偷拍第一页|日韩av夜夜嗨中文字幕|久久蜜综合视频官网|精美人妻一区二区三区

RELATEED CONSULTING
相關(guān)咨詢
選擇下列產(chǎn)品馬上在線溝通
服務(wù)時間:8:30-17:00
你可能遇到了下面的問題
關(guān)閉右側(cè)工具欄

新聞中心

這里有您想知道的互聯(lián)網(wǎng)營銷解決方案
創(chuàng)新互聯(lián)小程序教程:微信小程序運力方使用·onAddOrder

logistics.onAddOrder

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

請求下單事件。

消息參數(shù)

Object

屬性 類型 說明
ToUserName string 快遞公司小程序 UserName
FromUserName string 微信團隊的 OpenID (固定值)
CreateTime number 事件時間,Unix時間戳
MsgType string 消息類型,固定為 event
Event string 事件類型,固定為 add_waybill,不區(qū)分大小寫
Token string 訂單 Token。請保存該 Token,調(diào)用logistics.updatePath時需要傳入
OrderID string 唯一標(biāo)識訂單的 ID,由商戶生成??爝f需要保證相同的 OrderID 生成相同的運單ID。
BizID string 商戶 ID,即商戶在快遞注冊的客戶編碼或月結(jié)賬戶名
BizPwd string BizID 對應(yīng)的密碼
ShopAppID string 商戶的小程序 AppID
WayBillID string 運單 ID,從微信號段中生成。若為 0,則表示需要快遞來生成運單 ID。
Remark string 快遞備注,會打印到面單上,比如"易碎物品"
Sender Array. 發(fā)件人信息
Receiver Array. 收件人信息
Cargo Array. 包裹信息
Insured Array. 保價信息
Service Array. 服務(wù)類型

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

屬性 類型 說明
Name string 發(fā)件人姓名
Tel string 發(fā)件人座機號碼
Mobile string 發(fā)件人手機號碼
Company string 發(fā)件人公司名
PostCode string 發(fā)件人郵編
Country string 發(fā)件人所在國家,默認(rèn)為"中國"
Province string 發(fā)件人省份,比如"廣東省"
City string 發(fā)件人地區(qū)/市,比如"廣州市"
Area string 發(fā)件人區(qū)/縣,比如"海珠區(qū)"
Address string 發(fā)件人詳細地址,比如"XX路XX號XX大廈XX"

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

屬性 類型 說明
Name string 收件人姓名
Tel string 收件人座機號碼
Mobile string 收件人手機號碼
Company string 收件人公司名
PostCode string 收件人郵編
Country string 收件人所在國家,默認(rèn)為"中國"
Province string 收件人省份,比如"廣東省"
City string 收件人地區(qū)/市,比如"廣州市"
Area string 收件人區(qū)/縣,比如"海珠區(qū)"
Address string 收件人詳細地址,比如"XX路XX號XX大廈XX"

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

屬性 類型 說明
Weight number 貨物總重量,比如1.2,單位是千克(kg)
Space_X number 貨物長度,比如20.5,單位是厘米(cm)
Space_Y number 貨物寬度,比如15.0,單位是厘米(cm)
Space_Z number 貨物高度,比如10.0,單位是厘米(cm)
Count number 貨物數(shù)量,一般為1

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

屬性 類型 說明
UseInsured number 是否保價,0 表示不保價,1 表示保價
InsuredValue number 保價金額,單位是分,比如: 10000 表示 100 元

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

屬性 類型 說明
ServiceType number 服務(wù)類型ID,詳見已經(jīng)支持的快遞公司基本信息
ServiceName string 服務(wù)名稱,詳見已經(jīng)支持的快遞公司基本信息

消息返回

屬性 類型 默認(rèn)值 必填 說明
ToUserName string 原樣返回請求中的 FromUserName
FromUserName string 快遞公司小程序 UserName
CreateTime number 事件時間,Unix 時間戳
MsgType string 消息類型,固定為 event
Event string 事件類型,固定為 add_waybill
Token string 傳入的 Token,原樣返回
OrderID string 傳入的唯一標(biāo)識訂單的 ID,由商戶生成,原樣返回
BizID string 商戶 ID,原樣返回
WayBillID string 運單 ID
ResultCode number 處理結(jié)果錯誤碼
ResultMsg string 處理結(jié)果的詳細信息
WaybillData string 集包地、三段碼、大頭筆等信息,用于生成面單信息。詳見后文返回值說明

ResultCode 的合法值

說明 最低版本
0 下單成功
-1 其他錯誤
10001 客戶編碼或者月結(jié)賬戶不存在
10002 客戶密碼不正確
20001 運單 ID 不正確(僅適用于微信生成運單 ID 的情況)
20002 發(fā)件人信息不完整(包括姓名、電話、地址等不完整)
20003 發(fā)件人地址不可達或者發(fā)貨地址不在服務(wù)范圍
20004 收件人信息不完整(包括姓名、電話、地址等不完整)
20005 收件人地址不可達或者收貨地址不在服務(wù)范圍
20006 貨物數(shù)量、重量、尺寸不正確或者不合理
20007 商戶余額不足,需要充值后再進行下單
20008 保價信息不正確(金額不合理或者快遞不支持)
20009 服務(wù)信息不正確

消息參數(shù)說明

  • 各字段均為商家提供,不保證完整,不保證正確,需要快遞側(cè)做好參數(shù)合法性和正確性檢查。
  • 當(dāng)網(wǎng)絡(luò)環(huán)境不穩(wěn)定時,下單事件可能會重復(fù)推送。對于相同的 BizID+OrderID,要返回相同的運單 ID。
  • 不支持子母單、代收貨款。

返回值說明

WaybillData 字段用于生成面單,結(jié)構(gòu)為##(key##value##)*。key可以寫到面單模板中,value是實際值。

比如樣例##ZTO_bagAddr##廣州##ZTO_mark##888-666-666##中,"ZTO_markAddr"表示中通的集包地代號,"廣州"是實際的集包地值;"ZTO_mark"表示中通三段碼代號,"888-666-666"是實際的三段碼值。

消息數(shù)據(jù)包示例

XML 格式


  
  
  1533042556
  
  
  1234ABC234523451
  
  
  
  
  
  
  
      
      
      
      
      
      
      
      
      
      
1.2 20.5 15.0 10.0 2 1 1 1 10000 0

JSON 格式

{
  "ToUserName": "gh_abcdefg",
  "FromUserName": "oABCD",
  "CreateTime": 1533042556,
  "MsgType": "event",
  "Event": "add_waybill",
  "Token": "1234ABC234523451",
  "OrderID": "012345678901234567890123456789",
  "BizID": "xyz",
  "BizPwd": "xyz123",
  "ShopAppID": "wxABCD",
  "WayBillID": "123456789",
  "Remark": "易碎物品",
  "Sender": {
    "Name": "張三",
    "Tel": "020-88888888",
    "Mobile": "18666666666",
    "Company": "公司名",
    "PostCode": "123456",
    "Country": "中國",
    "Province": "廣東省",
    "City": "廣州市",
    "Area": "海珠區(qū)",
    "Address": "XX路XX號XX大廈XX棟XX"
  },
  "Receiver": {
    "Name": "王小蒙",
    "Tel": "029-77777777",
    "Mobile": "18610000000",
    "Company": "公司名",
    "PostCode": "654321",
    "Country": "中國",
    "Province": "廣東省",
    "City": "廣州市",
    "Area": "天河區(qū)",
    "Address": "XX路XX號XX大廈XX棟XX"
  },
  "Cargo": {
    "Weight": 1.2,
    "Space_X": 20.5,
    "Space_Y": 15,
    "Space_Z": 10,
    "Count": 2,
    "DetailList": [
      {
        "Name": "一千零一夜鉆石包",
        "Count": 1
      },
      {
        "Name": "愛馬仕柏金鉆石包",
        "Count": 1
      }
    ]
  },
  "Insured": {
    "UseInsured": 1,
    "InsuredValue": 10000
  },
  "Service": {
    "ServiceType": 0,
    "ServiceName": "標(biāo)準(zhǔn)快遞"
  }
}

返回數(shù)據(jù)包示例

XML 格式


    
    
    1533042556
    
    
    1234ABC234523451
    
    
    
    0
    
    

JSON 格式

{
  "ToUserName": "oABCD",
  "FromUserName": "gh_abcdefg",
  "CreateTime": 1533042556,
  "MsgType": "event",
  "Event": "add_waybill",
  "Token": "1234ABC234523451",
  "OrderID": "012345678901234567890123456789",
  "BizID": "xyz",
  "WayBillID": "123456789",
  "ResultCode": 0,
  "ResultMsg": "success",
  "WaybillData": "##ZTO_bagAddr##廣州##ZTO_mark##888-666-666##"
}

本文標(biāo)題:創(chuàng)新互聯(lián)小程序教程:微信小程序運力方使用·onAddOrder
分享網(wǎng)址:http://www.dlmjj.cn/article/djociih.html