新聞中心
這里有您想知道的互聯(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


咨詢
建站咨詢

