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

在创建入库单时,如果提货方式是WINIT上门提货,需要指定提货地址。
请先前往万邑联-个人中心申请[新增地址],审核成功后的提货地址才能被使用。

请求说明
URL https://openapi.winit.com.cn/openapi/service
接口测试 https://sandboxopenapi.winit.com.cn/openapi/service
接口名winit.ums.getPickupAddress
验证方法 Token,md5
格式 json
字符编码 UTF-8
http请求方式 http
请求数限制 默认每分钟1000,有需要可申请加大。
请求入参
名称 类型 必填 说明 示例
pageParams
pageSize Int Y 分页大小/每页数量 30
pageNo Int N 页码/第几页 1
请求示例
{
      "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) 20190611
isDefault String(10) Y 是否默认地址:Y-是;N-否 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 地址 大剧院D栋
zipCode String(50) Y 邮编 518000
houseNo String(50) Y 门牌号 304
contactPerson String(100) Y 联系人 黄先生
contactPhone String(50) Y 联系电话 15019564694
email String(100) Y Email winit@winit.com
addressline1 String(255) Y 街道1
国外地址时出现
bantian
addressline2 String(255) Y 街道2
国外地址时出现
bantian
pageParams
pageNo Int Y 页码/第几页 1
pageSize Int Y 每页记录数/分页大小 30
totalCount Int Y 总记录数 34


返回示例
{
   "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
      }
   }
}