taobao.trade.price.update (修改交易价格)

修改订单的交易价格,仅允许修改集市卖家订单,同时修改价格不能改到7折以下

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
tid Number 必须 92065138819124 交易订单ID(主订单号)
postage_fee String 可选 3.50 邮费,单位是元,按照小数格式3.50来写
oids String 必须 92065138819125,92065138819126 子订单编号列表,用逗号分隔开,需要与后面的adjust_fees一一对应
adjust_fees String 必须 5.25,-3.4 每笔订单所对应的修改价格,负数为减少,正数为增加,需要与oids一一对应。

响应参数

名称 类型 示例值 描述
trade Trade 修改价格后的交易(只包含交易编号和修改时间)
  • └ 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);
TradePriceUpdateRequest req = new TradePriceUpdateRequest();
req.setTid(92065138819124L);
req.setPostageFee("3.50");
req.setOids("92065138819125,92065138819126");
req.setAdjustFees("5.25,-3.4");
TradePriceUpdateResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<trade_price_update_response>
    <trade>
        <tid>2231958349</tid>
        <modified>2000-01-01 00:00:00</modified>
    </trade>
</trade_price_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.invalid-parameter:tid 交易不属于当前用户 查看是否程序出问导致取到别的卖家的交易而无法更新地址,出现错误不要重试
isp.trade-service-failed 接口服务错误,稍后重试 接口服务错误,稍后重试
isv.trade-not-exist 交易不存在 交易不存在,检查tid,传人正确的值
isv.invalid-parameter:postfee 邮费错误 参考文档输入正确的邮费
isv.invalid-parameter:adjust_fee 修改价格错误 按文档提示,传人正确的价格
isv.invalid-parameter:virtual_guarantee_trade 虚拟商品订单不允许通过接口修改价格 虚拟商品订单不允许通过接口修改价格

API工具

如何获得此API

FAQ

返回
顶部