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

获取单笔交易的部分信息

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
fields String [] 必须 tid,type,status,payment,orders
  • 最大列表长度:40
  • 需要返回的字段列表,多个字段用半角逗号分隔,可选值为返回示例中能看到的所有字段。
    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元购合约中)
    • └ 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(征集失败)
    • └ 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
    • 杭州市卖鱼桥小学
    • 电子凭证服务上门服务的安装地址

    请求示例

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

    响应示例

    • XML示例
    • JSON示例
    <trade_get_cuntao_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>
                </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>
        </trade>
    </trade_get_cuntao_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 交易服务不可用 联系淘宝技术支持

    API工具

    如何获得此API

    FAQ

    返回
    顶部