微信小程序 運力方使用·onAddOrder

logistics.onAddOrder

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

請求下單事件。

消息參數(shù)

Object

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

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

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

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

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

消息返回

ResultCode 的合法值

消息參數(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 格式

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

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 格式

<xml>
    <ToUserName><![CDATA[oABCD]]></ToUserName>
    <FromUserName><![CDATA[gh_abcdefg]]></FromUserName>
    <CreateTime>1533042556</CreateTime>
    <MsgType><![CDATA[event]]></MsgType>
    <Event><![CDATA[add_waybill]]></Event>
    <Token>1234ABC234523451</Token>
    <OrderID><![CDATA[012345678901234567890123456789]]></OrderID>
    <BizID><![CDATA[xyz]]></BizID>
    <WayBillID><![CDATA[123456789]]></WayBillID>
    <ResultCode>0</ResultCode>
    <ResultMsg><![CDATA[success]]></ResultMsg>
    <WaybillData><![CDATA[##ZTO_bagAddr##廣州##ZTO_mark##888-666-666##]]></WaybillData>
</xml>

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##"
}