开发者文档
查询提货地址

1.接口说明

卖家网站ISP单步下单,选择提货类型后,查询卖家可提货地址

2.使用场景

卖家网站ISP单步下单,选择提货类型后,查询卖家可提货地址

 

3.请求说明

URL

http://openapi.winit.com.cn/openapi/service

接口测试

http://openapi.sandbox.winit.com.cn/openapi/service


请求方法

action:ums.address.getByPickupService

验证方式

Token,md5

格式

json

http请求方式

http,post

请求数限制

默认每分钟300,有需要可以申请加大

 

4.请求入参

名称

类型

必填

说明

示例

winitProductCode

String(100)

Y

产品Code


dispatchType

String(1)

Y

发货方式(C:中邮 ;P:提货;S:自发物流)


 

5、返回出参

名称

类型

说明

示例

id

long(20)

地址ID

7357

addressServiceId

long(20)

地址服务ID


code

String(50)

地址code


countryCode

String(100)

国家Code


countryName

String(100)

国家名称


cityCode

String(100)

城市code


cityName

String(100)

城市


state

String(100)

州编码


stateName

String(100)

州(省)


districtCode

String(100)

区code


districtName

String(100)

区名称


detailCn

String(100)

中文地址


detailEn

String(100)

英文地址


doorplate

String(100)

门牌号


detail1

String(100)

街道1


detail2

String(100)

街道2


postCode

String(100)

邮编


contactPerson

String(100)

联系人中文名称


contactPersonEn

String(100)

联系人英文名


contactNumber

String(100)

联系电话


email

String(100)

邮箱


isdefault

String(1)

是否默认:

N-否;Y-是


userId

String(20)

用户ID


charge

String(1)

是否收费:1是,0否


serviceCode

String(32)

Winit服务Code


serviceName

String(50)

Winit服务名


vendorCode

String(32)

供应商Code


vendorServiceCode

String(32)

供应商服务Code


vendorServiceName

String(50)

供应商服务名称


status

String(10)

审核状态:

APP-审核通过,

NAP-审核不通过,

WFC-未审核


receiveWarehouseCode

String(64)

揽收仓代码


receiveWarehouseName

String(64)

揽收仓名称


winitProductLineName

String

WINIT产品线名称,多个产品线名称之间用逗号连接

ISP出口, 国际送仓

6、请求示例

{
    "action":"ums.address.getByPickupService",
    "app_key":"rebecca",
    "data":{
        "dispatchType":"C",
        "winitProductCode":"USCN00001"
    }
,
    "format":"json",
    "language":"zh_CN",
    "platform":"SELLERERP",
    "sign":"00000000000000000000000000000000",
    "sign_method":"md5",
    "timestamp":"2015-06-16 00:09:09",
    "version":"1.0"
}

返回结果示例

{
    "code":"0",
    "data":{
        "list":[
            {
                "addressServiceId":0,
                "cityCode":"SZ",
                "cityName":"深圳",
                "code":"13",
                "contactNumber":"8888",
                "contactPerson":"88888",
                "countryCode":"CN",
                "countryName":"China",
                "detail1":"",
                "detail2":"",
                "detailCn":"taba",
                "detailEn":"taba",
                "distrctCode":"NA",
                "doorplate":"",
                "email":"",
                "id":305,
                "isdefault":"Y",
                "postCode":"518000",
                "state":"GD",
                "stateName":"GuangDong",
                "userId":1000044
            }
,
            {
                "addressServiceId":0,
                "cityCode":"SZ",
                "cityName":"深圳",
                "code":"15",
                "contactNumber":"333",
                "contactPerson":"tama1",
                "countryCode":"CN",
                "countryName":"China",
                "detail1":"",
                "detail2":"",
                "detailCn":"tama1",
                "detailEn":"tama1",
                "distrctCode":"NA",
                "doorplate":"",
                "email":"",
                "id":307,
                "postCode":"518000",
                "state":"GD",
                "stateName":"GuangDong",
                "userId":1000044
            }
,
            {
                "addressServiceId":0,
                "cityCode":"SZ",
                "cityName":"深圳",
                "code":"8",
                "contactNumber":"333",
                "contactPerson":"test",
                "countryCode":"CN",
                "countryName":"China",
                "detail1":"",
                "detail2":"",
                "detailCn":"test",
                "detailEn":"test",
                "distrctCode":"NA",
                "doorplate":"",
                "email":"",
                "id":277,
                "isdefault":"N",
                "postCode":"518000",
                "state":"GD",
                "stateName":"GuangDong",
                "userId":1000044
            }

        ]

    }
,
    "msg":"操作成功"
}

 

返回参数说明

正确的返回结果:返回地址列表。

错误的返回结果:错误码,错误信息