地盘分单服务

请求地址

环境 HTTP请求地址
正式环境 http://pac.partner.taobao.com/gateway/pac_message_receiver.do
沙箱环境 http://pacdaily.tbsandbox.com/gateway/pac_message_receiver.do

公共对象类型

ResultPAC


名称 类型 描述
address String 入参的详细地址
waybillCode String 运单号
bizAreaPACResult BizAreaPACResult 具体结果

BizAreaPACResult

名称 类型 描述
success Boolean true:返回成功;false:返回失败
errorCode String 错误码
errorMsg String 错误信息
matchType String 匹配类型
bizAreaValue String 业务值编号,例如网点编号(最重要的信息)
bizAreaId String 内部数据库编号,无实际意义
matchLog String 详细匹配信息
ruleId String 具体规则id
bizCode String 业务id
cpCode String 菜鸟合作伙伴编号

1.依据收货地址获得相对应的网点编号接口


依据收货地址,匹配某个业务线所属的某个CP的一个网点编号,地盘系统返回成功匹配的第一个结果。

公共请求参数

名称 类型 是否必须 描述
msg_type String 消息类型 DIPAN_MATCH_BIZ_AREA
msg_id String 消息ID
from_code String 调用方编码
partner_code String 合作伙伴编码
data_digest String 请求签名
logistics_interface String 请求报文内容

请求参数

名称 类型 是否必须 描述
bizCode String 业务线代码
cpCode String CP代码
divisionId String 行政区划ID
taobaoAddr String 淘宝内部格式的地址。如浙江省^^^杭州市^^^余杭区^^^五常街道^^^阿里巴巴西溪园区
matchType String 匹配类型。例如:Polygon:多边形;AddrRange:号段;PoiAddr:poi;DivCompleteCovering:整区覆盖;SubDivListCovering:子区覆盖,举例输入:Polygon表示使用多边形进行匹配
waybillCode String 运单号

响应参数

名称 类型 描述
success Boolean 调用是否成功
errorCode String 错误码
errorMsg String 错误描述
matchType String 匹配类型
bizAreaValue String 业务值编号,例如网点编号(最重要的信息)
bizAreaId String 内部数据库编号,无实际意义
matchLog String 详细匹配信息
ruleId String 具体规则id
bizCode String 业务id
cpCode String 菜鸟合作伙伴编号
waybillCode String 运单号

请求示例

XML格式

<request>
  <bizCode>cainiao_666</bizCode>
  <cpCode>WANXIANG-0001</cpCode>
  <divisionId>310109</divisionId>
  <taobaoAddr>上海^^^上海市^^^虹口区^^^^^^中山北路148号</taobaoAddr>
  <matchType></matchType>
  <waybillCode>131415926</waybillCode>
</request>

JSON格式

{
  "bizCode":"cainiao_666",
  "cpCode":"WANXIANG-0001",
  "divisionId":"310109",
  "matchType":"",
  "taobaoAddr":"上海^^^上海市^^^虹口区^^^^^^中山北路148号",
  "waybillCode":"131415926"
}

响应示例

XML格式

<response>
    <success>true</success>
  <errorCode>0</errorCode>
  <matchType>Polygon</matchType>
  <bizAreaValue>021L01</bizAreaValue>
  <bizAreaId>310109</bizAreaId>
  <matchLog>|| level=strict || type=Polygon || rule_id=34610 || codes=310109 || origin=上海上海市虹口区中山北路148号 || format=上海上海市虹口区中山北路148号 || lonlat=121.471488,31.265586 || polygon=34610_上海67</matchLog>
  <ruleId/>
  <bizCode>cainiao_666</bizCode>
  <cpCode>WANXIANG-0001</cpCode>
  <waybillCode>131415926</waybillCode>
</response>

JSON格式

{
  "bizAreaId": "310109",
  "bizAreaValue": "021L01",
  "bizCode": "cainiao_666",
  "cpCode": "WANXIANG-0001",
  "errorCode": "0",
  "matchLog": "|| level=strict || type=Polygon || rule_id=34610 || codes=310109 || origin=上海上海市虹口区中山北路148号 || format=上海上海市虹口区中山北路148号 || lonlat=121.471488,31.265586 || polygon=34610_上海67",
  "matchType": "Polygon",
  "success": true,
  "waybillCode": "131415926"
}

2.根据收货地址匹配多个网点接口


根据一个收货地址匹配多个符合规则的网点

公共请求参数

名称 类型 是否必须 描述
msg_type String 消息类型 DIPAN_MATCH_BIZ_AREA_MATCH_MULTI
msg_id String 消息ID
from_code String 调用方编码
partner_code String 合作伙伴编码
data_digest String 请求签名
logistics_interface String 请求报文内容

请求参数

名称 类型 是否必须 描述
bizCode String 业务线代码
cpCode String CP代码
divisionId String 行政区划ID
taobaoAddr String 淘宝内部格式的地址。如浙江省^^^杭州市^^^余杭区^^^五常街道^^^阿里巴巴西溪园区;淘宝外部格式的地址。如浙江省杭州市余杭区五常街道阿里巴巴西溪园区
matchType String 匹配类型。例如:Polygon:多边形;AddrRange:号段;PoiAddr:poi;DivCompleteCovering:整区覆盖;SubDivListCovering:子区覆盖,举例输入:Polygon表示使用多边形进行匹配
waybillCode String 运单号

响应参数

名称 类型 描述
success Boolean 调用是否成功
errorCode String 错误码
errorMsg String 错误描述
waybillCode String 运单号
bizAreaPACResultList List<BizAreaPACResult> 包含多个结果集

请求示例

XML格式

<request>
    <bizCode>cainiao_666</bizCode>
    <cpCode>WANXIANG-0001</cpCode>
    </divisionId>
    </matchType>
    <taobaoAddr>上海上海市松江区九亭镇九新公路21881502室</taobaoAddr>
    <waybillCode>10000000000</waybillCode>
</request>

JSON格式

{
    "bizCode":"cainiao_666",
    "cpCode":"WANXIANG-0001",
    "divisionId":"",
    "matchType":"",
    "taobaoAddr":"上海上海市松江区九亭镇九新公路218弄8号1502室",
    "waybillCode":"10000000000"
}

响应示例

XML格式

<response>
  <bizAreaPACResultList>
    <BizAreaPACResult>
      <success>true</success>
      <errorCode>0</errorCode>
      <matchType>DivCompleteCovering</matchType>
      <bizAreaValue>Z00917</bizAreaValue>
      <bizAreaId>000000</bizAreaId>
      <matchLog>|| division=310117 || level=strict || type=DivCompleteCovering || rule_id=0 || codes=310117,310117107,000000 || origin=上海上海市松江区九亭镇九新公路218弄8号1502室 || format=上海上海市松江区九亭镇九新公路218弄8号1502室 || lonlat=121.320514,31.12744 || code=310117</matchLog>
      <ruleId/>
      <bizCode>cainiao_666</bizCode>
      <cpCode>WANXIANG-0001</cpCode>
    </BizAreaPACResult>
    <BizAreaPACResult>
      <success>true</success>
      <errorCode>0</errorCode>
      <matchType>SubDivListCovering</matchType>
      <bizAreaValue>021S01</bizAreaValue>
      <bizAreaId>000000</bizAreaId>
      <matchLog>|| division=310117107 || level=strict || type=SubDivListCovering || rule_id=0 || codes=310117,310117107,000000 || origin=上海上海市松江区九亭镇九新公路218弄8号1502室 || format=上海上海市松江区九亭镇九新公路218弄8号1502室 || lonlat=121.320514,31.12744 || code=310117107</matchLog>
      <ruleId/>
      <bizCode>cainiao_666</bizCode>
      <cpCode>WANXIANG-0001</cpCode>
    </BizAreaPACResult>
    <BizAreaPACResult>
      <success>true</success>
      <errorCode>0</errorCode>
      <matchType>Polygon</matchType>
      <bizAreaValue>021S03</bizAreaValue>
      <bizAreaId>000000</bizAreaId>
      <matchLog>|| level=strict || type=Polygon || rule_id=37262 || codes=310117,310117107,000000 || origin=上海上海市松江区九亭镇九新公路218弄8号1502室 || format=上海上海市松江区九亭镇九新公路218弄8号1502室 || lonlat=121.320514,31.12744 || polygon=37262_021S03</matchLog>
      <ruleId/>
      <bizCode>cainiao_666</bizCode>
      <cpCode>WANXIANG-0001</cpCode>
    </BizAreaPACResult>
  </bizAreaPACResultList>
  <success>true</success>
  <waybillCode>10000000000</waybillCode>
</response>

JSON格式

{
  "response": {
    "bizAreaPACResultList": {
      "BizAreaPACResult": [
        {
          "success": "true",
          "errorCode": "0",
          "matchType": "DivCompleteCovering",
          "bizAreaValue": "Z00917",
          "bizAreaId": "000000",
          "matchLog": "|| division=310117 || level=strict || type=DivCompleteCovering || rule_id=0 || codes=310117,310117107,000000 || origin=上海上海市松江区九亭镇九新公路218弄8号1502室 || format=上海上海市松江区九亭镇九新公路218弄8号1502室 || lonlat=121.320514,31.12744 || code=310117",
          "bizCode": "cainiao_666",
          "cpCode": "WANXIANG-0001"
        },
        {
          "success": "true",
          "errorCode": "0",
          "matchType": "SubDivListCovering",
          "bizAreaValue": "021S01",
          "bizAreaId": "000000",
          "matchLog": "|| division=310117107 || level=strict || type=SubDivListCovering || rule_id=0 || codes=310117,310117107,000000 || origin=上海上海市松江区九亭镇九新公路218弄8号1502室 || format=上海上海市松江区九亭镇九新公路218弄8号1502室 || lonlat=121.320514,31.12744 || code=310117107",
          "bizCode": "cainiao_666",
          "cpCode": "WANXIANG-0001"
        },
        {
          "success": "true",
          "errorCode": "0",
          "matchType": "Polygon",
          "bizAreaValue": "021S03",
          "bizAreaId": "000000",
          "matchLog": "|| level=strict || type=Polygon || rule_id=37262 || codes=310117,310117107,000000 || origin=上海上海市松江区九亭镇九新公路218弄8号1502室 || format=上海上海市松江区九亭镇九新公路218弄8号1502室 || lonlat=121.320514,31.12744 || polygon=37262_021S03",
          "bizCode": "cainiao_666",
          "cpCode": "WANXIANG-0001"
        }
      ]
    },
    "success": "true",
    "waybillCode": "10000000000"
  }
}

3.根据多个收货地址匹配多组网点接口


根据多个收货地址(最多传入10个地址),返回对应组个数的网点接口(最多返回10组网点)。

公共请求参数

名称 类型 是否必须 描述
msg_type String 消息类型 DIPAN_MATCH_BIZ_AREA_MATCH_BATCH
msg_id String 消息ID
from_code String 调用方编码
partner_code String 合作伙伴编码
data_digest String 请求签名
logistics_interface String 请求报文内容

请求参数

名称 类型 是否必须 描述
bizCode String 业务线代码
cpCode String CP代码
addrMap Map<String,String> 地址集合

响应参数

名称 类型 描述
success Boolean 调用是否成功
errorCode String 错误码
errorMsg String 错误描述
resultPACList List<ResultPAC> 包含多个结果集

请求示例

XML格式

  <request>
    <bizCode>cainiao_666</bizCode>
    <cpCode>WANXIANG-0001</cpCode>
    <addrMap>100000000:上海^^^上海市^^^虹口区^^^^^^中山北路148号;200000000:上海^^^上海市^^^虹口区^^^^^^中山北路148号;400000000:美国华人街;300000000:上海^^^上海市^^^虹口区^^^^^^中山北路148号;</addrMap>
  </request>

JSON格式

{
  "request": {
    "bizCode": "cainiao_666",
    "cpCode": "WANXIANG-0001",
    "addrMap": "100000000:上海^^^上海市^^^虹口区^^^^^^中山北路148号;200000000:上海^^^上海市^^^虹口区^^^^^^中山北路148号;400000000:美国华人街;300000000:上海^^^上海市^^^虹口区^^^^^^中山北路148号;"
  }
}

响应示例

XML格式

<response>
  <resultPACList>
    <resultPAC>
      <address>上海^^^上海市^^^虹口区^^^^^^中山北路148号</address>
      <waybillCode>300000000</waybillCode>
      <BizAreaPACResult>
        <success>true</success>
        <errorCode>0</errorCode>
        <matchType>Polygon</matchType>
        <bizAreaValue>021L01</bizAreaValue>
        <matchLog>|| level=strict || type=Polygon || rule_id=34610 || codes=310108007,310108 || origin=上海上海市虹口区中山北路148号 || format=上海上海市虹口区中山北路148号 || lonlat=121.471488,31.265586 || polygon=34610_上海67</matchLog>
        <ruleId/>
        <bizCode>cainiao_666</bizCode>
        <cpCode>WANXIANG-0001</cpCode>
      </BizAreaPACResult>
    </resultPAC>
    <resultPAC>
      <address>上海^^^上海市^^^虹口区^^^^^^中山北路148号</address>
      <waybillCode>200000000</waybillCode>
      <BizAreaPACResult>
        <success>true</success>
        <errorCode>0</errorCode>
        <matchType>Polygon</matchType>
        <bizAreaValue>021L01</bizAreaValue>
        <matchLog>|| level=strict || type=Polygon || rule_id=34610 || codes=310108007,310108 || origin=上海上海市虹口区中山北路148号 || format=上海上海市虹口区中山北路148号 || lonlat=121.471488,31.265586 || polygon=34610_上海67</matchLog>
        <ruleId/>
        <bizCode>cainiao_666</bizCode>
        <cpCode>WANXIANG-0001</cpCode>
      </BizAreaPACResult>
    </resultPAC>
    <resultPAC>
      <address>美国华人街</address>
      <waybillCode>400000000</waybillCode>
      <BizAreaPACResult>
        <success>false</success>
        <errorCode>300</errorCode>
        <errorMsg>No result</errorMsg>
      </BizAreaPACResult>
    </resultPAC>
    <resultPAC>
      <address>上海^^^上海市^^^虹口区^^^^^^中山北路148号</address>
      <waybillCode>100000000</waybillCode>
      <BizAreaPACResult>
        <success>true</success>
        <errorCode>0</errorCode>
        <matchType>Polygon</matchType>
        <bizAreaValue>021L01</bizAreaValue>
        <matchLog>|| level=strict || type=Polygon || rule_id=34610 || codes=310108007,310108 || origin=上海上海市虹口区中山北路148号 || format=上海上海市虹口区中山北路148号 || lonlat=121.471488,31.265586 || polygon=34610_上海67</matchLog>
        <ruleId/>
        <bizCode>cainiao_666</bizCode>
        <cpCode>WANXIANG-0001</cpCode>
      </BizAreaPACResult>
    </resultPAC>
  </resultPACList>
  <success>true</success>
</response>

JSON格式

{
  "response": {
    "resultPACList": {
      "resultPAC": [
        {
          "address": "上海^^^上海市^^^虹口区^^^^^^中山北路148号",
          "waybillCode": "300000000",
          "BizAreaPACResult": {
            "success": "true",
            "errorCode": "0",
            "matchType": "Polygon",
            "bizAreaValue": "021L01",
            "matchLog": "|| level=strict || type=Polygon || rule_id=34610 || codes=310108007,310108 || origin=上海上海市虹口区中山北路148号 || format=上海上海市虹口区中山北路148号 || lonlat=121.471488,31.265586 || polygon=34610_上海67",
            "bizCode": "cainiao_666",
            "cpCode": "WANXIANG-0001"
          }
        },
        {
          "address": "上海^^^上海市^^^虹口区^^^^^^中山北路148号",
          "waybillCode": "200000000",
          "BizAreaPACResult": {
            "success": "true",
            "errorCode": "0",
            "matchType": "Polygon",
            "bizAreaValue": "021L01",
            "matchLog": "|| level=strict || type=Polygon || rule_id=34610 || codes=310108007,310108 || origin=上海上海市虹口区中山北路148号 || format=上海上海市虹口区中山北路148号 || lonlat=121.471488,31.265586 || polygon=34610_上海67",
            "bizCode": "cainiao_666",
            "cpCode": "WANXIANG-0001"
          }
        },
        {
          "address": "美国华人街",
          "waybillCode": "400000000",
          "BizAreaPACResult": {
            "success": "false",
            "errorCode": "300",
            "errorMsg": "No result"
          }
        },
        {
          "address": "上海^^^上海市^^^虹口区^^^^^^中山北路148号",
          "waybillCode": "100000000",
          "BizAreaPACResult": {
            "success": "true",
            "errorCode": "0",
            "matchType": "Polygon",
            "bizAreaValue": "021L01",
            "matchLog": "|| level=strict || type=Polygon || rule_id=34610 || codes=310108007,310108 || origin=上海上海市虹口区中山北路148号 || format=上海上海市虹口区中山北路148号 || lonlat=121.471488,31.265586 || polygon=34610_上海67",
            "bizCode": "cainiao_666",
            "cpCode": "WANXIANG-0001"
          }
        }
      ]
    },
    "success": "true"
  }
}