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

taobao.trade.postage.update (修改交易邮费价格)

修改订单邮费接口,通过传入订单编号和邮费价格,修改订单的邮费,返回修改时间modified,邮费post_fee,总费用total_fee。
API取消加邮费功能通知:http://open.taobao.com/support/announcement_detail.htm?tid=24750

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
tid Number 必须 83120291689524 主订单编号
post_fee String 必须 5.53 邮费价格(邮费单位是元)

响应参数

名称 类型 示例值 描述
trade Trade 返回trade类型,其中包含修改时间modified,修改邮费post_fee,修改后的总费用total_fee和买家实付款payment
  • └ modified
  • Date
  • 2000-01-01 00:00:00
  • 交易修改时间(用户对订单的任何修改都会更新此字段)。格式:yyyy-MM-dd HH:mm:ss
  • └ post_fee
  • String
  • 200.07
  • 邮费。精确到2位小数;单位:元。如:200.07,表示:200元7分
  • └ total_fee
  • String
  • 200.07
  • 商品金额(商品价格乘以数量的总金额)。精确到2位小数;单位:元。如:200.07,表示:200元7分
  • └ payment
  • String
  • 200.07
  • 实付金额。精确到2位小数;单位:元。如:200.07,表示:200元7分

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TradePostageUpdateRequest req = new TradePostageUpdateRequest();
req.setTid(83120291689524L);
req.setPostFee("5.53");
TradePostageUpdateResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<trade_postage_update_response>
    <trade>
        <modified>2000-01-01 00:00:00</modified>
        <post_fee>200.07</post_fee>
        <total_fee>200.07</total_fee>
        <payment>200.07</payment>
    </trade>
</trade_postage_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:status_not_match 订单状态不匹配(修改交易订单邮费需要在买家未付款状态) 输入订单状态匹配的订单号
isv.invalid-parameter:tid 不是卖家的订单 检查调用接口时的入参 sessionkey 和 tid ,两者必须属于同一个卖家
isv.trade-service-error 调用修改订单费用服务异常 调用修改订单费用服务异常,稍后重试

API工具

如何获得此API

FAQ

返回
顶部