taobao.logistics.address.add (卖家地址库新增接口)

通过此接口新增卖家地址库,卖家最多可添加5条地址库,新增第一条卖家地址,将会自动设为默认地址库

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
contact_name String 必须 姓名 联系人姓名 长度不可超过20个字节
province String 必须 浙江省 所在省
city String 必须 杭州市 所在市
country String 可选 西湖区 区、县
如果所在地区是海外的可以为空,否则为必参
addr String 必须 华星路xx号 详细街道地址,不需要重复填写省/市/区
zip_code String 可选 315040 地区邮政编码
如果所在地区是海外的可以为空,否则为必参
phone String 可选 ****-********-**** 电话号码,手机与电话必需有一个
mobile_phone String 可选 136******** 手机号码,手机与电话必需有一个
手机号码不能超过20位
seller_company String 可选 公司名称
  • 最大长度:20
  • 公司名称,
    公司名称长能不能超过20字节
    memo String 可选 备注
  • 最大长度:256
  • 备注,
    备注不能超过256字节
    get_def Boolean 可选 true 默认取货地址。
    选择此项(true),将当前地址设为默认取货地址,撤消原默认取货地址
    cancel_def Boolean 可选 true 默认退货地址。
    选择此项(true),将当前地址设为默认退货地址,撤消原默认退货地址

    响应参数

    名称 类型 示例值 描述
    address_result AddressResult 只返回修改日期modify_date
    • └ modify_date
    • Date
    • 2000-01-01 00:00:00
    • 修改日期时间

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    LogisticsAddressAddRequest req = new LogisticsAddressAddRequest();
    req.setContactName("姓名");
    req.setProvince("浙江省");
    req.setCity("杭州市");
    req.setCountry("西湖区");
    req.setAddr("华星路xx号");
    req.setZipCode("315040");
    req.setPhone("****-********-****");
    req.setMobilePhone("136********");
    req.setSellerCompany("公司名称");
    req.setMemo("备注");
    req.setSendDef(true);
    req.setGetDef(true);
    req.setCancelDef(true);
    LogisticsAddressAddResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <logistics_address_add_response>
        <address_result>
            <modify_date>2000-01-01 00:00:00</modify_date>
        </address_result>
    </logistics_address_add_response>

    异常示例

    • XML示例
    • JSON示例
    <error_response>
        <code>50</code>
        <msg>Remote service error</msg>
        <sub_code>isv.invalid-parameter</sub_code>
        <sub_msg>非法参数</sub_msg>
    </error_response>

    错误码解释

    错误码 错误描述 解决方案
    isv.logistics-address-service-error:P01 参数为空或格式不正确 对照参数表
    isv.logistics-address-service-error:P03 没有用户ID 检查用户是否登录,或session过期
    isv.logistics-address-service-error:P11 参数不符合约定 请对照参数表
    isv.logistics-address-service-error:B104 已存在相同的地址 检查地址库,通过taobao.logistics.address.search接口查询
    isp.logistics-address-service-error:S01 系统异常 系统异常,联系小二

    API工具

    如何获得此API

    FAQ

    返回
    顶部