taobao.trade.get (获取单笔交易的部分信息(性能高))

获取单笔交易的部分信息
点击查看更多交易API说明

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
fields String 必须 tid,type,status,payment,orders 需要返回的字段列表,多个字段用半角逗号分隔,可选值为返回示例中能看到的所有字段。
tid Number 必须 123456789 交易编号

响应参数

名称 类型 示例值 描述
trade Trade 搜索到的交易信息列表,返回的Trade和Order中包含的具体信息为入参fields请求的字段信息
  • └ seller_nick
  • String
  • 我在测试
  • 卖家昵称
  • └ buyer_nick
  • String
  • 我在测试
  • 买家昵称
  • └ title
  • String
  • 麦包包
  • 交易标题,以店铺名作为此标题的值。注:taobao.trades.get接口返回的Trade中的title是商品名称
  • └ type
  • String
  • fixed(一口价)
  • 交易类型列表,同时查询多种交易类型可用逗号分隔。默认同时查询guarantee_trade, auto_delivery, ec, cod的4种交易类型的数据 可选值 fixed(一口价) auction(拍卖) guarantee_trade(一口价、拍卖) auto_delivery(自动发货) independent_simple_trade(旺店入门版交易) independent_shop_trade(旺店标准版交易) ec(直冲) cod(货到付款) fenxiao(分销) game_equipment(游戏装备) shopex_trade(ShopEX交易) netcn_trade(万网交易) external_trade(统一外部交易)o2o_offlinetrade(O2O交易)step (万人团)nopaid(无付款订单)pre_auth_type(预授权0元购机交易)
  • └ created
  • Date
  • 2000-01-01 00:00:00
  • 交易创建时间。格式:yyyy-MM-dd HH:mm:ss
  • └ sid
  • String
  • NP1021246146
  • 物流运单号
  • └ tid
  • Number
  • 2231958349
  • 交易编号 (父订单的交易编号)
  • └ seller_rate
  • Boolean
  • true
  • 卖家是否已评价。可选值:true(已评价),false(未评价)
  • └ buyer_rate
  • Boolean
  • true
  • 买家是否已评价。可选值:true(已评价),false(未评价)。如买家只评价未打分,此字段仍返回false
  • └ status
  • String
  • TRADE_NO_CREATE_PAY
  • 交易状态。可选值: * TRADE_NO_CREATE_PAY(没有创建支付宝交易) * WAIT_BUYER_PAY(等待买家付款) * SELLER_CONSIGNED_PART(卖家部分发货) * WAIT_SELLER_SEND_GOODS(等待卖家发货,即:买家已付款) * WAIT_BUYER_CONFIRM_GOODS(等待买家确认收货,即:卖家已发货) * TRADE_BUYER_SIGNED(买家已签收,货到付款专用) * TRADE_FINISHED(交易成功) * TRADE_CLOSED(付款以后用户退款成功,交易自动关闭) * TRADE_CLOSED_BY_TAOBAO(付款以前,卖家或买家主动关闭交易) * PAY_PENDING(国际信用卡支付付款确认中) * WAIT_PRE_AUTH_CONFIRM(0元购合约中) * PAID_FORBID_CONSIGN(拼团中订单或者发货强管控的订单,已付款但禁止发货)
  • └ payment
  • String
  • 200.07
  • 实付金额。精确到2位小数;单位:元。如:200.07,表示:200元7分
  • └ discount_fee
  • String
  • 200.07
  • 建议使用trade.promotion_details查询系统优惠系统优惠金额(如打折,VIP,满就送等),精确到2位小数,单位:元。如:200.07,表示:200元7分
  • └ adjust_fee
  • String
  • 200.07
  • 卖家手工调整金额,精确到2位小数,单位:元。如:200.07,表示:200元7分。来源于订单价格修改,如果有多笔子订单的时候,这个为0,单笔的话则跟[order].adjust_fee一样
  • └ post_fee
  • String
  • 200.07
  • 邮费。精确到2位小数;单位:元。如:200.07,表示:200元7分
  • └ total_fee
  • String
  • 200.07
  • 商品金额(商品价格乘以数量的总金额)。精确到2位小数;单位:元。如:200.07,表示:200元7分
  • └ 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
  • └ modified
  • Date
  • 2000-01-01 00:00:00
  • 交易修改时间(用户对订单的任何修改都会更新此字段)。格式:yyyy-MM-dd HH:mm:ss
  • └ consign_time
  • Date
  • 2000-01-01 00:00:00
  • 卖家发货时间。格式:yyyy-MM-dd HH:mm:ss
  • └ received_payment
  • String
  • 200.07
  • 卖家实际收到的支付宝打款金额(由于子订单可以部分确认收货,这个金额会随着子订单的确认收货而不断增加,交易成功后等于买家实付款减去退款金额)。精确到2位小数;单位:元。如:200.07,表示:200元7分
  • └ commission_fee
  • String
  • 200.07
  • 交易佣金。精确到2位小数;单位:元。如:200.07,表示:200元7分
  • └ buyer_memo
  • String
  • 上衣要大一号
  • 买家备注(与淘宝网上订单的买家备注对应,只有买家才能查看该字段)
  • └ seller_memo
  • String
  • 好的
  • 卖家备注(与淘宝网上订单的卖家备注对应,只有卖家才能查看该字段)
  • └ alipay_no
  • String
  • 2009112081173831
  • 支付宝交易号,如:2009112081173831
  • └ buyer_message
  • String
  • 要送的礼物的,不要忘记的哦
  • 买家留言
  • └ pic_path
  • String
  • http://img08.taobao.net/bao/uploaded/i8/T1jVXXXePbXXaoPB6a_091917.jpg
  • 商品图片绝对途径
  • └ num_iid
  • Number
  • 3424234
  • 商品数字编号
  • └ price
  • String
  • 200.07
  • 商品价格。精确到2位小数;单位:元。如:200.07,表示:200元7分
  • └ cod_fee
  • String
  • 12.07
  • 货到付款服务费。精确到2位小数;单位:元。如:12.07,表示:12元7分。
  • └ cod_status
  • String
  • EW_CREATED(订单已创建)
  • 货到付款物流状态。初始状态 NEW_CREATED,接单成功 ACCEPTED_BY_COMPANY,接单失败 REJECTED_BY_COMPANY,接单超时 RECIEVE_TIMEOUT,揽收成功 TAKEN_IN_SUCCESS,揽收失败 TAKEN_IN_FAILED,揽收超时 TAKEN_TIMEOUT,签收成功 SIGN_IN,签收失败 REJECTED_BY_OTHER_SIDE,订单等待发送给物流公司 WAITING_TO_BE_SENT,用户取消物流订单 CANCELED
  • └ shipping_type
  • String
  • free
  • 创建交易时的物流方式(交易完成前,物流方式有可能改变,但系统里的这个字段一直不变)。可选值:free(卖家包邮),post(平邮),express(快递),ems(EMS),virtual(虚拟发货),25(次日必达),26(预约配送)。
  • └ num
  • Number
  • 1
  • 商品购买数量。取值范围:大于零的整数,对于一个trade对应多个order的时候(一笔主订单,对应多笔子订单),num=0,num是一个跟商品关联的属性,一笔订单对应多比子订单的时候,主订单上的num无意义。
  • └ point_fee
  • Number
  • 0
  • 买家使用积分,下单时生成,且一直不变。格式:100;单位:个.
  • └ real_point_fee
  • Number
  • 0
  • 买家实际使用积分(扣除部分退款使用的积分),交易完成后生成(交易成功或关闭),交易未完成时该字段值为0。格式:100;单位:个
  • └ buyer_obtain_point_fee
  • Number
  • 0
  • 买家获得积分,返点的积分。格式:100;单位:个。返点的积分要交易成功之后才能获得。
  • └ is_daixiao
  • Boolean
  • true
  • 表示订单交易是否含有对应的代销采购单。如果该订单中存在一个对应的代销采购单,那么该值为true;反之,该值为false。
  • └ is_wt
  • Boolean
  • true
  • 表示订单交易是否网厅订单。 如果该订单是网厅订单,那么该值为true;反之,该值为false。
  • └ arrive_interval
  • Number
  • 1
  • 物流到货时效,单位天
  • └ arrive_cut_time
  • String
  • 16:00
  • 物流到货时效截单时间,格式 HH:mm
  • └ consign_interval
  • Number
  • 48
  • 物流发货时效,单位小时
  • service_tags
  • LogisticsTag []
  • 物流标签
  • └ order_id
  • String
  • 123456
  • 主订单或子订单的订单号
  • logistic_service_tag_list
  • LogisticServiceTag []
  • 服务标签
  • └ service_tag
  • String
  • comFee=1211;comTim=1;companyCode=SF;
  • 物流服务下的标签属性,多个标签之间有";"分隔
  • └ service_type
  • String
  • FAST
  • 消费者选快递请直接判断service_tag是否包含companyCode。而不要判断service_type
  • └ o2o
  • String
  • crm
  • 导购宝=crm
  • └ o2o_guide_id
  • String
  • 123456
  • 导购员id
  • └ o2o_guide_name
  • String
  • 西湖门店导购员1
  • 导购员名称
  • └ o2o_shop_id
  • String
  • 123456
  • 导购员门店id
  • └ o2o_shop_name
  • String
  • 西湖门店
  • 导购门店名称
  • └ o2o_delivery
  • String
  • inshop
  • 导购宝提货方式,inshop:店内提货,online:线上发货
  • └ o2o_out_trade_id
  • String
  • 123456
  • 外部订单号
  • orders
  • Order []
  • 订单列表
  • └ title
  • String
  • 山寨版测试机器
  • 商品标题
  • └ pic_path
  • String
  • http://img08.taobao.net/bao/uploaded/i8/T1jVXXXePbXXaoPB6a_091917.jpg
  • 商品图片的绝对路径
  • └ price
  • String
  • 200.07
  • 商品价格。精确到2位小数;单位:元。如:200.07,表示:200元7分
  • └ num_iid
  • Number
  • 2342344
  • 商品数字ID
  • └ sku_id
  • String
  • 5937146
  • 商品的最小库存单位Sku的id.可以通过taobao.item.sku.get获取详细的Sku信息
  • └ refund_status
  • String
  • SUCCESS(退款成功)
  • 退款状态。退款状态。可选值 WAIT_SELLER_AGREE(买家已经申请退款,等待卖家同意) WAIT_BUYER_RETURN_GOODS(卖家已经同意退款,等待买家退货) WAIT_SELLER_CONFIRM_GOODS(买家已经退货,等待卖家确认收货) SELLER_REFUSE_BUYER(卖家拒绝退款) CLOSED(退款关闭) SUCCESS(退款成功)
  • └ status
  • String
  • TRADE_NO_CREATE_PAY
  • 订单状态(请关注此状态,如果为TRADE_CLOSED_BY_TAOBAO状态,则不要对此订单进行发货,切记啊!)。可选值:
    • TRADE_NO_CREATE_PAY(没有创建支付宝交易)
    • WAIT_BUYER_PAY(等待买家付款)
    • WAIT_SELLER_SEND_GOODS(等待卖家发货,即:买家已付款)
    • WAIT_BUYER_CONFIRM_GOODS(等待买家确认收货,即:卖家已发货)
    • TRADE_BUYER_SIGNED(买家已签收,货到付款专用)
    • TRADE_FINISHED(交易成功)
    • TRADE_CLOSED(付款以后用户退款成功,交易自动关闭)
    • TRADE_CLOSED_BY_TAOBAO(付款以前,卖家或买家主动关闭交易)
    • PAY_PENDING(国际信用卡支付付款确认中)
  • └ oid
  • Number
  • 2231958349
  • 子订单编号
  • └ total_fee
  • String
  • 200.07
  • 应付金额(商品价格 * 商品数量 + 手工调整金额 - 子订单级订单优惠金额)。精确到2位小数;单位:元。如:200.07,表示:200元7分
  • └ payment
  • String
  • 200.07
  • 子订单实付金额。精确到2位小数,单位:元。如:200.07,表示:200元7分。对于多子订单的交易,计算公式如下:payment = price * num + adjust_fee - discount_fee ;单子订单交易,payment与主订单的payment一致,对于退款成功的子订单,由于主订单的优惠分摊金额,会造成该字段可能不为0.00元。建议使用退款前的实付金额减去退款单中的实际退款金额计算。
  • └ discount_fee
  • String
  • 200.07
  • 子订单级订单优惠金额。精确到2位小数;单位:元。如:200.07,表示:200元7分
  • └ adjust_fee
  • String
  • 1.01
  • 手工调整金额.格式为:1.01;单位:元;精确到小数点后两位.
  • └ divide_order_fee
  • String
  • 21.00
  • 分摊之后的实付金额
  • └ part_mjz_discount
  • String
  • 21.00
  • 优惠分摊
  • └ sku_properties_name
  • String
  • 颜色:桔色;尺码:M
  • SKU的值。如:机身颜色:黑色;手机套餐:官方标配
  • └ item_meal_name
  • String
  • M8原装电池:便携支架:M8专用座充:莫凡保护袋
  • 套餐的值。如:M8原装电池:便携支架:M8专用座充:莫凡保护袋
  • └ num
  • Number
  • 1
  • 购买数量。取值范围:大于零的整数
  • └ outer_sku_id
  • String
  • 81893848
  • 外部网店自己定义的Sku编号
  • └ outer_iid
  • String
  • 152e442aefe88dd41cb0879232c0dcb0
  • 商家外部编码(可与商家外部系统对接)。外部商家自己定义的商品Item的id,可以通过taobao.items.custom.get获取商品的Item的信息
  • └ buyer_rate
  • Boolean
  • true
  • 买家是否已评价。可选值:true(已评价),false(未评价)
  • └ seller_rate
  • Boolean
  • true
  • 卖家是否已评价。可选值:true(已评价),false(未评价)
  • └ seller_type
  • String
  • B(商城商家)
  • 卖家类型,可选值为:B(商城商家),C(普通卖家)
  • └ is_daixiao
  • Boolean
  • true
  • 表示订单交易是否含有对应的代销采购单。如果该订单中存在一个对应的代销采购单,那么该值为true;反之,该值为false。
  • └ ticket_outer_id
  • String
  • 123456abcd
  • 对应门票有效期的外部id
  • └ ticket_expdate_key
  • String
  • 100FFFFFF02374020000002001020304000A
  • 门票有效期的key
  • └ is_www
  • Boolean
  • true
  • 子订单是否是www订单
  • └ store_code
  • String
  • 南京QDHEWL-0004
  • 发货的仓库编码
  • └ tmser_spu_code
  • String
  • 家装干支装服务
  • 支持家装类物流的类型
  • └ et_ser_time
  • String
  • 2015-04-15 13:00
  • 天猫汽车服务预约时间
  • └ et_shop_name
  • String
  • 测试预约门店地址
  • 电子凭证预约门店地址
  • └ et_verified_shop_name
  • String
  • 测试核销门店地址
  • 电子凭证核销门店地址
  • └ et_plate_number
  • String
  • 浙A11111
  • 车牌号码
  • └ sub_order_tax_fee
  • String
  • 0
  • 天猫国际子订单关税税费
  • └ sub_order_tax_rate
  • String
  • 0
  • 天猫国际子订单关税税率
  • └ zhengji_status
  • String
  • 1
  • 征集预售订单征集状态:1(征集中),2(征集成功),3(征集失败)
  • └ sub_order_tax_promotion_fee
  • String
  • 0
  • 天猫国际子订单计税优惠金额
  • └ tax_free
  • Boolean
  • true
  • 天猫国际子订单是否包税
  • └ tax_coupon_discount
  • String
  • 0
  • 天猫国际子订单包税金额
  • └ special_refund_type
  • String
  • priceProtect
  • 特殊退款状态
  • └ is_devalue_fee
  • Boolean
  • true
  • 子订单是否优惠贬值
  • └ et_ser_time
  • String
  • 2015-04-15 13:00
  • 天猫汽车服务预约时间
  • └ et_shop_name
  • String
  • 接口测试新增门店_0304055043555
  • 电子凭证预约门店地址
  • └ et_verified_shop_name
  • String
  • 测试核销门店地址
  • 电子凭证核销门店地址
  • └ et_plate_number
  • String
  • 浙A11111
  • 车牌号码
  • └ order_tax_fee
  • String
  • 0
  • 天猫国际官网直供主订单关税税费
  • └ eticket_service_addr
  • String
  • 杭州市卖鱼桥小学
  • 电子凭证服务上门服务的安装地址
  • └ o2o_et_order_id
  • String
  • 193753681999224
  • 分阶段交易的特权定金订单ID
  • └ order_tax_promotion_fee
  • String
  • 0
  • 天猫国际计税优惠金额
  • └ pmtp
  • String
  • GAP_MCARD^1001|
  • 透出前置营销工具
  • └ buyer_open_uid
  • String
  • AAHk5d-EAAeGwJedwSFu0XXX
  • 买家OpenUid

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TradeGetRequest req = new TradeGetRequest();
req.setFields("tid,type,status,payment,orders");
req.setTid(123456789L);
TradeGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<trade_get_response>
    <trade>
        <seller_nick>我在测试</seller_nick>
        <buyer_nick>我在测试</buyer_nick>
        <title>麦包包</title>
        <type>fixed(一口价)</type>
        <created>2000-01-01 00:00:00</created>
        <sid>NP1021246146</sid>
        <tid>2231958349</tid>
        <seller_rate>true</seller_rate>
        <buyer_rate>true</buyer_rate>
        <status>TRADE_NO_CREATE_PAY</status>
        <payment>200.07</payment>
        <discount_fee>200.07</discount_fee>
        <adjust_fee>200.07</adjust_fee>
        <post_fee>200.07</post_fee>
        <total_fee>200.07</total_fee>
        <pay_time>2000-01-01 00:00:00</pay_time>
        <end_time>2000-01-01 00:00:00</end_time>
        <modified>2000-01-01 00:00:00</modified>
        <consign_time>2000-01-01 00:00:00</consign_time>
        <received_payment>200.07</received_payment>
        <commission_fee>200.07</commission_fee>
        <buyer_memo>上衣要大一号</buyer_memo>
        <seller_memo>好的</seller_memo>
        <alipay_no>2009112081173831</alipay_no>
        <buyer_message>要送的礼物的,不要忘记的哦</buyer_message>
        <pic_path>http://img08.taobao.net/bao/uploaded/i8/T1jVXXXePbXXaoPB6a_091917.jpg</pic_path>
        <num_iid>3424234</num_iid>
        <price>200.07</price>
        <cod_fee>12.07</cod_fee>
        <cod_status>EW_CREATED(订单已创建)</cod_status>
        <shipping_type>free</shipping_type>
        <num>1</num>
        <point_fee>0</point_fee>
        <real_point_fee>0</real_point_fee>
        <buyer_obtain_point_fee>0</buyer_obtain_point_fee>
        <is_daixiao>true</is_daixiao>
        <is_wt>true</is_wt>
        <arrive_interval>1</arrive_interval>
        <arrive_cut_time>16:00</arrive_cut_time>
        <consign_interval>48</consign_interval>
        <service_tags>
            <logistics_tag>
                <order_id>123456</order_id>
                <logistic_service_tag_list>
                    <logistic_service_tag>
                        <service_tag>comFee=1211;comTim=1;companyCode=SF;</service_tag>
                        <service_type>FAST</service_type>
                    </logistic_service_tag>
                </logistic_service_tag_list>
            </logistics_tag>
        </service_tags>
        <o2o>crm</o2o>
        <o2o_guide_id>123456</o2o_guide_id>
        <o2o_guide_name>西湖门店导购员1</o2o_guide_name>
        <o2o_shop_id>123456</o2o_shop_id>
        <o2o_shop_name>西湖门店</o2o_shop_name>
        <o2o_delivery>inshop</o2o_delivery>
        <o2o_out_trade_id>123456</o2o_out_trade_id>
        <orders>
            <order>
                <title>山寨版测试机器</title>
                <pic_path>http://img08.taobao.net/bao/uploaded/i8/T1jVXXXePbXXaoPB6a_091917.jpg</pic_path>
                <price>200.07</price>
                <num_iid>2342344</num_iid>
                <sku_id>5937146</sku_id>
                <refund_status>SUCCESS(退款成功)</refund_status>
                <status>TRADE_NO_CREATE_PAY</status>
                <oid>2231958349</oid>
                <total_fee>200.07</total_fee>
                <payment>200.07</payment>
                <discount_fee>200.07</discount_fee>
                <adjust_fee>1.01</adjust_fee>
                <divide_order_fee>21.00</divide_order_fee>
                <part_mjz_discount>21.00</part_mjz_discount>
                <sku_properties_name>颜色:桔色;尺码:M</sku_properties_name>
                <item_meal_name>M8原装电池:便携支架:M8专用座充:莫凡保护袋</item_meal_name>
                <num>1</num>
                <outer_sku_id>81893848</outer_sku_id>
                <outer_iid>152e442aefe88dd41cb0879232c0dcb0</outer_iid>
                <buyer_rate>true</buyer_rate>
                <seller_rate>true</seller_rate>
                <seller_type>B(商城商家)</seller_type>
                <is_daixiao>true</is_daixiao>
                <ticket_outer_id>123456abcd</ticket_outer_id>
                <ticket_expdate_key>100FFFFFF02374020000002001020304000A</ticket_expdate_key>
                <is_www>true</is_www>
                <store_code>南京QDHEWL-0004</store_code>
                <tmser_spu_code>家装干支装服务</tmser_spu_code>
                <et_ser_time>2015-04-15 13:00</et_ser_time>
                <et_shop_name>测试预约门店地址</et_shop_name>
                <et_verified_shop_name>测试核销门店地址</et_verified_shop_name>
                <et_plate_number>浙A11111</et_plate_number>
                <sub_order_tax_fee>0</sub_order_tax_fee>
                <sub_order_tax_rate>0</sub_order_tax_rate>
                <zhengji_status>1</zhengji_status>
                <sub_order_tax_promotion_fee>0</sub_order_tax_promotion_fee>
                <tax_free>true</tax_free>
                <tax_coupon_discount>0</tax_coupon_discount>
                <special_refund_type>priceProtect</special_refund_type>
                <is_devalue_fee>true</is_devalue_fee>
            </order>
        </orders>
        <et_ser_time>2015-04-15 13:00</et_ser_time>
        <et_shop_name>接口测试新增门店_0304055043555</et_shop_name>
        <et_verified_shop_name>测试核销门店地址</et_verified_shop_name>
        <et_plate_number>浙A11111</et_plate_number>
        <order_tax_fee>0</order_tax_fee>
        <eticket_service_addr>杭州市卖鱼桥小学</eticket_service_addr>
        <o2o_et_order_id>193753681999224</o2o_et_order_id>
        <order_tax_promotion_fee>0</order_tax_promotion_fee>
        <pmtp>GAP_MCARD^1001|</pmtp>
        <buyer_open_uid>AAHk5d-EAAeGwJedwSFu0XXX</buyer_open_uid>
    </trade>
</trade_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>

错误码解释

错误码 错误描述 解决方案
isv.invalid-parameter:tid 参数:tid无效,格式不对、非法值、越界等
isv.trade-not-exist 交易不存在 订单已进入历史库,出现错误清除本地数据库该订单,不要重试
isv.invalid-permission 必须是此交易的买家或卖家才能获取交易详细信息 查看是否程序出问题导致取到别的卖家的交易ID而无法查看,出现错误不要重试
isp.trade-service-failed 交易服务不可用 联系淘宝技术支持
isp.call-limited 接口调用限制,流控 联系淘宝技术支持

API工具

如何获得此API

FAQ

返回
顶部