只能更新一笔交易里面的买家收货地址 只能更新发货前(即买家已付款,等待卖家发货状态)的交易的买家收货地址 更新后的发货地址可以通过taobao.trade.fullinfo.get查到 参数中所说的字节为GBK编码的(英文和数字占1字节,中文占2字节)
名称 | 类型 | 是否必须 | 示例值 | 更多限制 | 描述 |
---|---|---|---|---|---|
tid | Number | 必须 | 123456789 | 交易编号。 | |
receiver_name | String | 可选 | 马云 |
|
收货人全名。最大长度为50个字节。 |
receiver_phone | String | 可选 | 0571-12345678 |
|
座机号码。最大长度为30个字节。传-1表示删除 |
receiver_mobile | String | 可选 | 13600000000 |
|
移动电话。最大长度为11个字节。传-1表示删除 |
receiver_state | String | 可选 | 浙江 |
|
省份。最大长度为32个字节。如:浙江 |
receiver_city | String | 可选 | 杭州 |
|
城市。最大长度为32个字节。如:杭州 |
receiver_district | String | 可选 | 西湖区 |
|
区/县。最大长度为32个字节。如:西湖区 |
receiver_address | String | 可选 | xx路xx号 |
|
收货地址。最大长度为228个字节。 |
receiver_zip | String | 可选 | 310001 |
|
邮政编码。必须由6个数字组成。注:邮政编码根据地址信息自动填入,不可单独修改 |
receiver_town | String | 可选 | 五常街道 |
|
四级地址。最大长度为32个字节。如:五常街道 |
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
trade | Trade | 23452345 | 交易结构 |
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 | 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()); |
1 2 3 4 5 6 | < trade_shippingaddress_update_response > < trade > < tid >2231958349</ tid > < modified >2000-01-01 00:00:00</ modified > </ trade > </ trade_shippingaddress_update_response > |
1 2 3 4 5 6 | < 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 | 改地址系统更新订单错误 | 无 |