API
查询提货地址
更新时间: 2017-11-22 16:47:50 访问次数:2106
接口说明

提货地址查询,客户选择WINIT上门提货时,需要提供提货地址。

接口英文名称

winit.ums.getPickupAddress

使用场景

提货地址查询,当客户选择的海外仓入库方式(物流渠道),需要商品提货时,请先前往万邑联-个人中心申请,审批成功后的提货地址才能生效。卖家/第三方ERP在提交入库单信息时,需要根据业务需要查询提货地址。

备注

请求说明
URL http://openapi.winit.com.cn/openapi/service
接口测试 http://openapi.sandbox.winit.com.cn/openapi/service
验证方法 Token,md5
格式 json
字符编码 UTF-8
http请求方式 http
请求数限制 默认每分钟1000,有需要可申请加大。
请求入参
名称 类型 必填 说明 示例
pageParams 分页参数
-|pageSize Int Y 分页大小/每页数量
-|pageNo Int N 页码/第几页
请求示例
{
      "action": "winit.ums.getPickupAddress",
      "app_key": "rebecca",
      "client_id":"ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
      "client_sign":"72DD01D66A971198C6E6CDE0057EE067",
      "data": {
          "pageParams": {
              "pageNo": "1",
              "pageSize":"30"
          }
      },
      "format": "json",
      "language": "zh_CN",
      "platform": "OWNERERP",
      "sign": "AF99170EDFFFD64F407C930A7083C3E1",
      "sign_method": "md5",
      "timestamp": "2016-09-09 10:52:47",
      "version": "1.0"
}

                            
返回出参
名称 类型 必填 说明 示例
addressList 地址列表。如下均为地址子节点
-|addressCode String(50) Y 地址编码(Code)
-|isDefault String(10) Y 是否默认地址:Y-是;N-否
-|countryName String(50) Y 国家
-|stateName String(50) Y 州/省
-|cityName String(50) Y 城市
-|districtName String(50) Y 区域
-|street String(50) Y 街道
-|address String(255) Y 地址
-|zipCode String(50) Y 邮编
-|houseNo String(50) Y 门牌号
-|contactPerson String(100) Y 英文联系人
-|contactPhone String(50) Y 联系电话
-|email String(100) Y Email
-|addressline1 String(255) Y 街道1
国外地址时出现
-|addressline2 String(255) Y 街道2
国外地址时出现
pageParams 分页参数
-| pageNo Int Y 页码/第几页
-| pageSize Int Y 每页记录数/分页大小
-| totalCount Int Y 总记录数

返回参数说明 正确的返回结果:地址编码,城市名称。 错误的返回结果:错误码,错误信息。

返回示例
{
   "code": "0",
   "msg": "操作成功",
   "data":    {
      "addressList":       [
                  {
            "addressCode": "20190611",
            "zipCode": "518000",
            "address": "中文地址",
            "districtName": "南山区",
            "contactPerson": "先生",
            "isDefault": null,
            "cityName": "深圳市",
            "stateName": "广东省",
            "street": "",
            "houseNo": "winit",
            "addressline2": "autotest",
            "addressline1": "test",
            "countryName": "中国",
            "contactPhone": "22222222",
            "email": "winit@winit.com"
         },
                  {
            "addressCode": "20190610",
            "zipCode": "518000",
            "address": "中文地址",
            "districtName": "南山区",
            "contactPerson": "先生",
            "isDefault": null,
            "cityName": "深圳市",
            "stateName": "广东省",
            "street": "",
            "houseNo": "winit",
            "addressline2": "autotest",
            "addressline1": "test",
            "countryName": "中国",
            "contactPhone": "22222222",
            "email": "winit@winit.com"
         },
                  {
            "addressCode": "20190604",
            "zipCode": "518000",
            "address": "中文地址",
            "districtName": "南山区",
            "contactPerson": "先生",
            "isDefault": null,
            "cityName": "深圳市",
            "stateName": "广东省",
            "street": "",
            "houseNo": "winit",
            "addressline2": "autotest",
            "addressline1": "test",
            "countryName": "中国",
            "contactPhone": "22222222",
            "email": "winit@winit.com"
         },
                  {
            "addressCode": "20190603",
            "zipCode": "518000",
            "address": "中文地址",
            "districtName": "南山区",
            "contactPerson": "先生",
            "isDefault": null,
            "cityName": "深圳市",
            "stateName": "广东省",
            "street": "",
            "houseNo": "winit",
            "addressline2": "autotest",
            "addressline1": "test",
            "countryName": "中国",
            "contactPhone": "22222222",
            "email": "winit@winit.com"
         },
                  {
            "addressCode": "02",
            "zipCode": "518000",
            "address": "大剧院D栋304",
            "districtName": "罗湖区",
            "contactPerson": "黄先生",
            "isDefault": null,
            "cityName": "深圳市",
            "stateName": "广东省",
            "street": "",
            "houseNo": "",
            "addressline2": "",
            "addressline1": "",
            "countryName": "中国",
            "contactPhone": "15019564694",
            "email": ""
         },
                  {
            "addressCode": "20190513",
            "zipCode": "518000",
            "address": "中文地址",
            "districtName": "南山区",
            "contactPerson": "先生",
            "isDefault": null,
            "cityName": "深圳市",
            "stateName": "广东省",
            "street": "",
            "houseNo": "winit",
            "addressline2": "autotest",
            "addressline1": "test",
            "countryName": "中国",
            "contactPhone": "22222222",
            "email": "winit@winit.com"
         },
                  {
            "addressCode": "20190510",
            "zipCode": "518000",
            "address": "中文地址",
            "districtName": "南山区",
            "contactPerson": "先生",
            "isDefault": null,
            "cityName": "深圳市",
            "stateName": "广东省",
            "street": "",
            "houseNo": "winit",
            "addressline2": "autotest",
            "addressline1": "test",
            "countryName": "中国",
            "contactPhone": "22222222",
            "email": "winit@winit.com"
         },
                  {
            "addressCode": "yc001",
            "zipCode": "510000",
            "address": "中文地址",
            "districtName": "白云区",
            "contactPerson": "先生",
            "isDefault": "N",
            "cityName": "广州市",
            "stateName": "广东省",
            "street": "",
            "houseNo": "",
            "addressline2": "",
            "addressline1": "",
            "countryName": "中国",
            "contactPhone": "12345678",
            "email": ""
         },
                  {
            "addressCode": "testno",
            "zipCode": "100000",
            "address": "中文地址",
            "districtName": "崇文区",
            "contactPerson": "先生",
            "isDefault": "N",
            "cityName": "北京市",
            "stateName": "北京市",
            "street": "",
            "houseNo": null,
            "addressline2": "bantian",
            "addressline1": "bantian",
            "countryName": "中国",
            "contactPhone": "12345678",
            "email": null
         },
                  {
            "addressCode": "testcode",
            "zipCode": "123456",
            "address": "中文地址",
            "districtName": null,
            "contactPerson": "先生",
            "isDefault": "N",
            "cityName": null,
            "stateName": null,
            "street": "",
            "houseNo": null,
            "addressline2": "detail",
            "addressline1": "detail",
            "countryName": "中国",
            "contactPhone": "12345678",
            "email": null
         },
                  {
            "addressCode": "deng",
            "zipCode": "518000",
            "address": "中文地址",
            "districtName": "南山区",
            "contactPerson": "先生",
            "isDefault": "N",
            "cityName": "深圳市",
            "stateName": "广东省",
            "street": "",
            "houseNo": "",
            "addressline2": "",
            "addressline1": "",
            "countryName": "中国",
            "contactPhone": "12345678",
            "email": "237450162@qq.com"
         },
                  {
            "addressCode": "hz59415",
            "zipCode": "518100",
            "address": "中文地址",
            "districtName": "宝安区",
            "contactPerson": "先生",
            "isDefault": "Y",
            "cityName": "深圳市",
            "stateName": "广东省",
            "street": "",
            "houseNo": "",
            "addressline2": "",
            "addressline1": "",
            "countryName": "中国",
            "contactPhone": "12345678",
            "email": ""
         },
                  {
            "addressCode": "ceshi",
            "zipCode": "518000",
            "address": "中文地址",
            "districtName": "南山区",
            "contactPerson": "先生",
            "isDefault": "N",
            "cityName": "深圳市",
            "stateName": "广东省",
            "street": "",
            "houseNo": "",
            "addressline2": "",
            "addressline1": "",
            "countryName": "中国",
            "contactPhone": "12345678",
            "email": "ce@winit.com.cn"
         },
                  {
            "addressCode": "222",
            "zipCode": "100000",
            "address": "中文地址",
            "districtName": "崇文区",
            "contactPerson": "先生",
            "isDefault": "N",
            "cityName": "北京市",
            "stateName": "北京市",
            "street": "",
            "houseNo": "",
            "addressline2": "",
            "addressline1": "",
            "countryName": "中国",
            "contactPhone": "12345678",
            "email": ""
         },
                  {
            "addressCode": "zhangtes",
            "zipCode": "400000",
            "address": "中文地址",
            "districtName": "巴南区",
            "contactPerson": "先生",
            "isDefault": "N",
            "cityName": "重庆市",
            "stateName": "重庆市",
            "street": "",
            "houseNo": "",
            "addressline2": "",
            "addressline1": "",
            "countryName": "中国",
            "contactPhone": "12345678",
            "email": ""
         },
                  {
            "addressCode": "100011",
            "zipCode": "054500",
            "address": "中文地址",
            "districtName": "平乡县",
            "contactPerson": "先生",
            "isDefault": "N",
            "cityName": "邢台市",
            "stateName": "河北省",
            "street": "",
            "houseNo": "",
            "addressline2": "",
            "addressline1": "",
            "countryName": "中国",
            "contactPhone": "12345678",
            "email": ""
         },
                  {
            "addressCode": "zdw001",
            "zipCode": "518000",
            "address": "中文地址",
            "districtName": "南山区",
            "contactPerson": "先生",
            "isDefault": "N",
            "cityName": "深圳市",
            "stateName": "广东省",
            "street": "",
            "houseNo": "",
            "addressline2": "",
            "addressline1": "",
            "countryName": "中国",
            "contactPhone": "12345678",
            "email": ""
         },
                  {
            "addressCode": "1",
            "zipCode": "246700",
            "address": "中文地址",
            "districtName": "枞阳县",
            "contactPerson": "先生",
            "isDefault": "N",
            "cityName": "安庆市",
            "stateName": "安徽省",
            "street": "",
            "houseNo": "",
            "addressline2": "",
            "addressline1": "",
            "countryName": "中国",
            "contactPhone": "12345678",
            "email": ""
         },
                  {
            "addressCode": "11001",
            "zipCode": "528400",
            "address": "中文地址",
            "districtName": "",
            "contactPerson": "先生",
            "isDefault": "N",
            "cityName": "中山市",
            "stateName": "广东省",
            "street": "",
            "houseNo": "",
            "addressline2": "",
            "addressline1": "",
            "countryName": "中国",
            "contactPhone": "12345678",
            "email": ""
         },
                  {
            "addressCode": "1000111",
            "zipCode": "313200",
            "address": "中文地址",
            "districtName": "德清县",
            "contactPerson": "先生",
            "isDefault": "N",
            "cityName": "湖州市",
            "stateName": "浙江省",
            "street": "",
            "houseNo": "",
            "addressline2": "",
            "addressline1": "",
            "countryName": "中国",
            "contactPhone": "12345678",
            "email": ""
         },
                  {
            "addressCode": "12",
            "zipCode": "518000",
            "address": "中文地址",
            "districtName": "南山区",
            "contactPerson": "先生",
            "isDefault": "N",
            "cityName": "深圳市",
            "stateName": "广东省",
            "street": "",
            "houseNo": "",
            "addressline2": "",
            "addressline1": "",
            "countryName": "中国",
            "contactPhone": "12345678",
            "email": ""
         },
                  {
            "addressCode": "T9524",
            "zipCode": "6342",
            "address": "中文地址",
            "districtName": "",
            "contactPerson": "先生",
            "isDefault": "N",
            "cityName": "",
            "stateName": "",
            "street": "",
            "houseNo": "222",
            "addressline2": "CES",
            "addressline1": "CES",
            "countryName": "德国",
            "contactPhone": "12345678",
            "email": ""
         },
                  {
            "addressCode": "test110",
            "zipCode": "518000",
            "address": "中文地址",
            "districtName": "NanShan",
            "contactPerson": "先生",
            "isDefault": "N",
            "cityName": "深圳市",
            "stateName": "广东省",
            "street": "",
            "houseNo": "winit",
            "addressline2": "autotest",
            "addressline1": "test",
            "countryName": "中国",
            "contactPhone": "12345678",
            "email": "winit@winit.com"
         },
                  {
            "addressCode": "zdw003",
            "zipCode": "510000",
            "address": "中文地址",
            "districtName": "白云区",
            "contactPerson": "先生",
            "isDefault": "N",
            "cityName": "广州市",
            "stateName": "广东省",
            "street": "",
            "houseNo": "",
            "addressline2": "",
            "addressline1": "",
            "countryName": "中国",
            "contactPhone": "12345678",
            "email": ""
         },
                  {
            "addressCode": "ffffgdg",
            "zipCode": "246700",
            "address": "中文地址",
            "districtName": "枞阳县",
            "contactPerson": "先生",
            "isDefault": "N",
            "cityName": "安庆市",
            "stateName": "安徽省",
            "street": "",
            "houseNo": "",
            "addressline2": "",
            "addressline1": "",
            "countryName": "中国",
            "contactPhone": "12345678",
            "email": ""
         },
                  {
            "addressCode": "6666",
            "zipCode": "999077",
            "address": "中文地址",
            "districtName": "",
            "contactPerson": "先生",
            "isDefault": "N",
            "cityName": "新界",
            "stateName": "-",
            "street": "",
            "houseNo": "",
            "addressline2": "",
            "addressline1": "",
            "countryName": "香港",
            "contactPhone": "12345678",
            "email": ""
         },
                  {
            "addressCode": "TESTHK01",
            "zipCode": "999077",
            "address": "中文地址",
            "districtName": "湾仔",
            "contactPerson": "先生",
            "isDefault": "N",
            "cityName": "香港岛",
            "stateName": "-",
            "street": "",
            "houseNo": "",
            "addressline2": "",
            "addressline1": "",
            "countryName": "香港",
            "contactPhone": "12345678",
            "email": ""
         },
                  {
            "addressCode": "666",
            "zipCode": "510000",
            "address": "中文地址",
            "districtName": "白云区",
            "contactPerson": "先生",
            "isDefault": "N",
            "cityName": "广州市",
            "stateName": "广东省",
            "street": "",
            "houseNo": "",
            "addressline2": "",
            "addressline1": "",
            "countryName": "中国",
            "contactPhone": "12345678",
            "email": ""
         },
                  {
            "addressCode": "111",
            "zipCode": "518000",
            "address": "中文地址",
            "districtName": "福田区",
            "contactPerson": "先生",
            "isDefault": "N",
            "cityName": "深圳市",
            "stateName": "广东省",
            "street": "",
            "houseNo": "",
            "addressline2": "",
            "addressline1": "",
            "countryName": "中国",
            "contactPhone": "12345678",
            "email": ""
         },
                  {
            "addressCode": "22",
            "zipCode": "510000",
            "address": "中文地址",
            "districtName": "白云区",
            "contactPerson": "先生",
            "isDefault": "N",
            "cityName": "广州市",
            "stateName": "广东省",
            "street": "",
            "houseNo": "",
            "addressline2": "",
            "addressline1": "",
            "countryName": "中国",
            "contactPhone": "12345678",
            "email": ""
         }
      ],
      "pageParams":       {
         "pageNo": 1,
         "pageSize": 30,
         "totalCount": 34
      }
   }
}