文档中心 > API类目 > 淘宝交易API

taobao.trade.shippingaddress.update (更改交易的收货地址)

只能更新一笔交易里面的买家收货地址 只能更新发货前(即买家已付款,等待卖家发货状态)的交易的买家收货地址 更新后的发货地址可以通过taobao.trade.fullinfo.get查到 参数中所说的字节为GBK编码的(英文和数字占1字节,中文占2字节)

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
tid Number 必须 123456789 交易编号。
receiver_name String 可选 马云
  • 最大长度:50
  • 收货人全名。最大长度为50个字节。
    receiver_phone String 可选 0571-12345678
  • 最大长度:30
  • 座机号码。最大长度为30个字节。传-1表示删除
    receiver_mobile String 可选 13600000000
  • 最大长度:11
  • 移动电话。最大长度为11个字节。传-1表示删除
    receiver_state String 可选 浙江
  • 最大长度:32
  • 省份。最大长度为32个字节。如:浙江
    receiver_city String 可选 杭州
  • 最大长度:32
  • 城市。最大长度为32个字节。如:杭州
    receiver_district String 可选 西湖区
  • 最大长度:32
  • 区/县。最大长度为32个字节。如:西湖区
    receiver_address String 可选 xx路xx号
  • 最大长度:228
  • 收货地址。最大长度为228个字节。
    receiver_zip String 可选 310001
  • 最大长度:6
  • 邮政编码。必须由6个数字组成。注:邮政编码根据地址信息自动填入,不可单独修改
    receiver_town String 可选 五常街道
  • 最大长度:32
  • 四级地址。最大长度为32个字节。如:五常街道

    响应参数

    名称 类型 示例值 描述
    trade Trade 23452345 交易结构
    • └ tid
    • Number
    • 2231958349
    • 交易编号 (父订单的交易编号)
    • └ modified
    • Date
    • 2000-01-01 00:00:00
    • 交易修改时间(用户对订单的任何修改都会更新此字段)。格式:yyyy-MM-dd HH:mm:ss

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    TradeShippingaddressUpdateRequest req = new TradeShippingaddressUpdateRequest();
    req.setTid(123456789L);
    req.setReceiverName("马云");
    req.setReceiverPhone("0571-12345678");
    req.setReceiverMobile("13600000000");
    req.setReceiverState("浙江");
    req.setReceiverCity("杭州");
    req.setReceiverDistrict("西湖区");
    req.setReceiverAddress("xx路xx号");
    req.setReceiverZip("310001");
    req.setReceiverTown("五常街道");
    TradeShippingaddressUpdateResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <trade_shippingaddress_update_response>
        <trade>
            <tid>2231958349</tid>
            <modified>2000-01-01 00:00:00</modified>
        </trade>
    </trade_shippingaddress_update_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.trade-not-exist 交易不存在 订单已进入历史库,出现错误清除本地数据库该订单,不要重试
    isv.invalid-parameter:tid 交易不属于当前用户:*** 查看是否程序出问导致取到别的卖家的交易而无法更新地址,出现错误不要重试
    isv.invalid-parameter:receiver_address 无效的地址 参数重新设置
    isv.invalid-parameter:receiver_zip 无效的邮编 参数重新设置
    isv.invalid-parameter:receiver_mobile 无效的手机号 参数重新设置
    isv.invalid-parameter:receiver_phone 无效的电话 参数重新设置
    isv.invalid-parameter:receiver_name 无效的收货人名称 参数重新设置
    isv.invalid-parameter:receiver_district 无效的区 参数重新设置
    isv.invalid-parameter:receiver_city 无效的市 参数重新设置
    isv.invalid-parameter:receiver_state 无效的省 参数重新设置
    isp.trade-service-failed 接口服务错误 接口服务错误,稍后重试
    isp.modify-address-failed 改地址系统更新订单错误

    API工具

    如何获得此API

    FAQ

    返回
    顶部