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

taobao.trade.amount.get (交易帐务查询)

卖家查询该笔交易的资金帐务相关的数据; 1. 只供卖家使用,买家不可使用 2. 可查询所有的状态的交易,但不同状态时交易的相关数据可能会有不同

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
fields String 必须 tid,oid,alipay_no,total_fee,post_fee 订单帐务详情需要返回的字段信息,可选值如下:1. TradeAmount中可指定的fields:tid,alipay_no,created,pay_time,end_time,total_fee,payment,post_fee,cod_fee,commission_fee,buyer_obtain_point_fee2. OrderAmount中可指定的fields:order_amounts.oid,order_amounts.title,order_amounts.num_iid,order_amounts.sku_properties_name,order_amounts.sku_id,order_amounts.num,order_amounts.price,order_amounts.discount_fee,order_amounts.adjust_fee,order_amounts.payment,order_amounts.promotion_name3. order_amounts(返回OrderAmount的所有内容)4. promotion_details(指定该值会返回主订单的promotion_details中除id之外的所有字段)
tid Number 必须 123456789 交易编号

响应参数

名称 类型 示例值 描述
trade_amount TradeAmount 主订单的财务信息详情
  • └ tid
  • Number
  • 123456
  • 交易主订单编号
  • └ alipay_no
  • String
  • 2009112081173831
  • 支付宝交易号,如:2009112081173831
  • └ created
  • Date
  • 2000-01-01 00:00:00
  • 交易创建时间
  • └ pay_time
  • Date
  • 2000-01-01 00:00:00
  • 付款时间。格式:yyyy-MM-dd HH:mm:ss
  • └ end_time
  • Date
  • 2000-01-01 00:00:00
  • 交易成功时间(更新交易状态为成功的同时更新)/确认收货时间。格式:yyyy-MM-dd HH:mm:ss
  • └ total_fee
  • String
  • 200.07
  • 主订单的商品金额(各子订单中商品price * num的和,不包括任何优惠信息)。精确到2位小数;单位:元。如:200.07,表示:200元7分
  • └ post_fee
  • String
  • 200.07
  • 邮费。精确到2位小数;单位:元。如:200.07,表示:200元7分。目前只提供整笔交易的邮费,暂不提供各子订单的邮费
  • └ cod_fee
  • String
  • 12.07
  • 货到付款服务费。精确到2位小数;单位:元。如:12.07,表示:12元7分
  • └ buyer_cod_fee
  • String
  • 12.07
  • 买家货到付款服务费。精确到2位小数;单位:元。如:12.07,表示:12元7分
  • └ seller_cod_fee
  • String
  • 12.07
  • 卖家货到付款服务费。精确到2位小数;单位:元。如:12.07,表示:12元7分
  • └ express_agency_fee
  • String
  • 212.07
  • 快递代收款。精确到2位小数;单位:元。如:212.07,表示:212元7分
  • └ payment
  • String
  • 200.07
  • 主订单实付金额。精确到2位小数;单位:元。如:200.07,表示:200元7分,计算公式如下:如果主订单只有一笔子订单 payment = 子订单的实付金额 + 货到付款服务费(如果是货到付款订单) - 主订单的系统级优惠;如果主订单有多笔子订单 payment = 各子订单的实付金额之和 + 货到付款服务费(如果是货到付款订单) + 邮费 - 主订单的系统级优惠
  • └ commission_fee
  • String
  • 200.07
  • 交易佣金。精确到2位小数;单位:元。如:200.07,表示:200元7分
  • └ buyer_obtain_point_fee
  • String
  • 100
  • 买家获得积分,返点的积分。格式:100;单位:个
  • order_amounts
  • OrderAmount []
  • 子订单的帐务金额详情列表
  • └ oid
  • Number
  • 123456
  • 子交易订单编号
  • └ title
  • String
  • 山寨版测试机器
  • 商品标题
  • └ num_iid
  • Number
  • 123456
  • 子订单对应的商品数字id
  • └ sku_id
  • Number
  • 123456
  • 子订单对应的商品的sku_id
  • └ sku_properties_name
  • String
  • 颜色:桔色;尺码:M
  • SKU的值。如:机身颜色:黑色;手机套餐:官方标配
  • └ num
  • Number
  • 12
  • 子交易订单中购买商品的数量
  • └ price
  • String
  • 200.07
  • 商品价格。精确到2位小数;单位:元。如:200.07,表示:200元7分
  • └ discount_fee
  • String
  • 200.07
  • 子订单的系统优惠金额。精确到2位小数;单位:元。如:200.07,表示:200元7分
  • └ promotion_name
  • String
  • 满就减钱
  • 子订单的系统优惠的名称,对应于discount_fee的名称
  • └ adjust_fee
  • String
  • 1.01
  • 卖家手工调整的子订单的优惠金额.格式为:1.01;单位:元;精确到小数点后两位.
  • └ divide_order_fee
  • String
  • 21.00
  • 分摊之后的实付金额
  • └ part_mjz_discount
  • String
  • 21.00
  • 优惠分摊
  • └ payment
  • String
  • 200.07
  • 子订单实付金额。精确到2位小数,单位:元。如:200.07,表示:200元7分。计算公式如下:payment = price * num + adjust_fee - discount_fee + post_fee(邮费,单笔子订单时子订单实付金额包含邮费,多笔子订单时不包含邮费);对于退款成功的子订单,由于主订单的优惠分摊金额,会造成该字段可能不为0.00元。建议使用退款前的实付金额减去退款单中的实际退款金额计算。
  • promotion_details
  • PromotionDetail []
  • 主交易订单的系统级优惠详情
  • └ id
  • Number
  • 22331764490705
  • 交易的主订单或子订单号
  • └ promotion_name
  • String
  • 满就减钱
  • 优惠信息的名称
  • └ discount_fee
  • String
  • 10.00
  • 优惠金额(免运费、限时打折时为空),单位:元
  • └ gift_item_name
  • String
  • 晨光签字笔
  • 满就送商品时,所送商品的名称

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TradeAmountGetRequest req = new TradeAmountGetRequest();
req.setFields("tid,oid,alipay_no,total_fee,post_fee");
req.setTid(123456789L);
TradeAmountGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<trade_amount_get_response>
    <trade_amount>
        <tid>123456</tid>
        <alipay_no>2009112081173831</alipay_no>
        <created>2000-01-01 00:00:00</created>
        <pay_time>2000-01-01 00:00:00</pay_time>
        <end_time>2000-01-01 00:00:00</end_time>
        <total_fee>200.07</total_fee>
        <post_fee>200.07</post_fee>
        <cod_fee>12.07</cod_fee>
        <buyer_cod_fee>12.07</buyer_cod_fee>
        <seller_cod_fee>12.07</seller_cod_fee>
        <express_agency_fee>212.07</express_agency_fee>
        <payment>200.07</payment>
        <commission_fee>200.07</commission_fee>
        <buyer_obtain_point_fee>100</buyer_obtain_point_fee>
        <order_amounts>
            <order_amount>
                <oid>123456</oid>
                <title>山寨版测试机器</title>
                <num_iid>123456</num_iid>
                <sku_id>123456</sku_id>
                <sku_properties_name>颜色:桔色;尺码:M</sku_properties_name>
                <num>12</num>
                <price>200.07</price>
                <discount_fee>200.07</discount_fee>
                <promotion_name>满就减钱</promotion_name>
                <adjust_fee>1.01</adjust_fee>
                <divide_order_fee>21.00</divide_order_fee>
                <part_mjz_discount>21.00</part_mjz_discount>
                <payment>200.07</payment>
            </order_amount>
        </order_amounts>
        <promotion_details>
            <promotion_detail>
                <id>22331764490705</id>
                <promotion_name>满就减钱</promotion_name>
                <discount_fee>10.00</discount_fee>
                <gift_item_name>晨光签字笔</gift_item_name>
            </promotion_detail>
        </promotion_details>
    </trade_amount>
</trade_amount_get_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>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部