淘宝开放平台

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
target_app_key	String	否	被调用的目标AppKey，仅当被调用的API为第三方ISV提供时有效。
sign_method	String	是	签名的摘要算法，可选值为：hmac，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
partner_id	String	否	合作伙伴身份标识。
simplify	Boolean	否	是否采用精简JSON返回格式，仅当format=json时有效，默认值为：false。

名称	类型	是否必须	示例值	更多限制	描述
fields	String	必须	tid,type,status,payment,orders		需要返回的字段列表，多个字段用半角逗号分隔，可选值为返回示例中能看到的所有字段。
start_created	Date	可选	2000-01-01 00:00:00		查询交易创建时间开始。格式:yyyy-MM-dd HH:mm:ss
end_created	Date	可选	2000-01-01 23:59:59		查询交易创建时间结束。格式:yyyy-MM-dd HH:mm:ss
status	String	可选	TRADE_NO_CREATE_PAY		交易状态（查看可选值），默认查询所有交易状态的数据，除了默认值外每次只能查询一种状态。
seller_nick	String	可选	zhangsan		卖家昵称
type	String	可选	shopex_trade		交易类型列表（查看可选值），一次查询多种类型可用半角逗号分隔，默认同时查询guarantee_trade,auto_delivery,ec,cod,step这5种类型的数据。
ext_type	String	可选	service		可选值有ershou(二手市场的订单）,service（商城服务子订单）作为扩展类型筛选只能做单个ext_type查询，不能全部查询所有的ext_type类型
rate_status	String	可选	RATE_UNBUYER		交易是否评价.默认查询所有评价状态的数据，除了默认值外每次只能查询一种状态。可选值： RATE_UNBUYER(买家未评) RATE_UNSELLER(卖家未评) RATE_BUYER_UNSELLER(买家已评，卖家未评) RATE_UNBUYER_SELLER(买家未评，卖家已评)
page_no	Number	可选	1	默认值：1	页码。取值范围:大于零的整数; 默认值:1
page_size	Number	可选	40	默认值：40	每页条数。取值范围:大于零的整数; 默认值:40;最大值:100
show_deleted	Boolean	可选	false		是否显示订单回收站删除的订单，false不显示true（显示），如果不传入，默认是不显示的

名称	类型	示例值	描述
total_results	Number	123	搜索到的交易信息总数
trades	Trade []		搜索到的交易信息列表，返回的Trade和Order中包含的具体信息为入参fields请求的字段信息
└ seller_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 └ can_rate Boolean true 买家可以通过此字段查询是否当前交易可以评论，can_rate=true可以评价，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分 └ 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;单位:个。返点的积分要交易成功之后才能获得。 └ receiver_name String 东方不败收货人的姓名 └ receiver_state String 浙江省收货人的所在省份 └ receiver_city String 杭州市收货人的所在城市注：因为国家对于城市和地区的划分的有：省直辖市和省直辖县级行政区（区级别的）划分的，淘宝这边根据这个差异保存在不同字段里面比如：广东广州：广州属于一个直辖市是放在的receiver_city的字段里面；而河南济源：济源属于省直辖县级行政区划分，是区级别的，放在了receiver_district里面建议：程序依赖于城市字段做物流等判断的操作，最好加一个判断逻辑：如果返回值里面只有receiver_district参数，该参数作为城市 └ receiver_district String 西湖区收货人的所在地区注：因为国家对于城市和地区的划分的有：省直辖市和省直辖县级行政区（区级别的）划分的，淘宝这边根据这个差异保存在不同字段里面比如：广东广州：广州属于一个直辖市是放在的receiver_city的字段里面；而河南济源：济源属于省直辖县级行政区划分，是区级别的，放在了receiver_district里面建议：程序依赖于城市字段做物流等判断的操作，最好加一个判断逻辑：如果返回值里面只有receiver_district参数，该参数作为城市 └ receiver_address String 淘宝城911号收货人的详细地址 └ receiver_zip String 223700 收货人的邮编 └ receiver_mobile String 13512501826 收货人的手机号码 └ receiver_phone String 13819175372 收货人的电话号码 └ is_lgtype Boolean true 是否保障速递，如果为true，则为保障速递订单，使用线下联系发货接口发货，如果未false，则该订单非保障速递，根据卖家设置的订单流转规则可使用物流宝或者常规物流发货。 └ has_yfx Boolean true 订单中是否包含运费险订单，如果包含运费险订单返回true，不包含运费险订单，返回false └ yfx_fee String 0.50 订单的运费险，单位为元 └ yfx_id String 135751716473138 运费险支付号 └ yfx_type String taojinbi 运费险类型 └ send_time String 2000-01-01 订单将在此时间前发出，主要用于预售订单 └ is_part_consign Boolean true 是否是多次发货的订单如果卖家对订单进行多次发货，则为true否则为false 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信息 └ outer_iid String 152e442aefe88dd41cb0879232c0dcb0 商家外部编码(可与商家外部系统对接)。外部商家自己定义的商品Item的id，可以通过taobao.items.custom.get获取商品的Item的信息 └ outer_sku_id String 81893848 外部网店自己定义的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 子订单编号 └ cid Number 123456 交易商品对应的类目ID └ 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_id Number 2564854632 套餐ID └ item_meal_name String M8原装电池:便携支架:M8专用座充:莫凡保护袋套餐的值。如：M8原装电池:便携支架:M8专用座充:莫凡保护袋 └ num Number 1 购买数量。取值范围:大于零的整数 └ buyer_rate Boolean true 买家是否已评价。可选值：true(已评价)，false(未评价) └ seller_rate Boolean true 卖家是否已评价。可选值：true(已评价)，false(未评价) └ refund_id Number 2231958349 最近退款ID └ seller_type String B（商城商家）卖家类型，可选值为：B（商城商家），C（普通卖家） └ consign_time String 2013-01-13 15:23:00 子订单发货时间，当卖家对订单进行了多次发货，子订单的发货时间和主订单的发货时间可能不一样了，那么就需要以子订单的时间为准。（没有进行多次发货的订单，主订单的发货时间和子订单的发货时间都一样） └ shipping_type String post 子订单的运送方式（卖家对订单进行多次发货之后，一个主订单下的子订单的运送方式可能不同，用order.shipping_type来区分子订单的运送方式） └ logistics_company String 顺风快递子订单发货的快递公司名称 └ invoice_no String 05432465 子订单所在包裹的运单号 └ ticket_outer_id String 123456abcd 对应门票有效期的外部id └ ticket_expdate_key String 100FFFFFF02374020000002001020304000A 门票有效期的key └ sub_order_tax_fee String 0 天猫国际官网直供子订单关税税费 └ sub_order_tax_rate String 0 天猫国际官网直供子订单关税税率 service_orders ServiceOrder [] 服务子订单列表 └ oid Number 110770592823138 虚拟服务子订单订单号 └ item_oid Number 110770592803138 服务所属的交易订单号。如果服务为一年包换，则item_oid这笔订单享受改服务的保护 └ service_id Number 2342344 服务数字id └ service_detail_url String http://wt.taobao.com/plan.htm?plan_id=planId 服务详情的URL地址 └ num Number 1 购买数量，取值范围为大于0的整数 └ price String 39.09 服务价格，精确到小数点后两位：单位:元 └ payment String 29.98 子订单实付金额。精确到2位小数，单位:元。如:200.07，表示:200元7分。 └ title String 滚筒洗衣机商品名称 └ total_fee String 39.09 服务子订单总费用 └ refund_id Number 2231958349 最近退款的id └ seller_nick String 麦包包卖家昵称 └ pic_path String http://img08.taobao.com/bao/upload/i8/T1jVXXXePb_a0908.jpg 服务图片地址 └ receiver_country String 中国收货人国籍 └ receiver_town String 三墎镇收货人街道地址 └ order_tax_fee String 0 天猫国际官网直供主订单关税税费

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TradesBoughtGetRequest req = new TradesBoughtGetRequest();
req.setFields("tid,type,status,payment,orders");
req.setStartCreated(StringUtils.parseDateTime("2000-01-01 00:00:00"));
req.setEndCreated(StringUtils.parseDateTime("2000-01-01 23:59:59"));
req.setStatus("TRADE_NO_CREATE_PAY");
req.setSellerNick("zhangsan");
req.setType("shopex_trade");
req.setExtType("service");
req.setRateStatus("RATE_UNBUYER");
req.setPageNo(1L);
req.setPageSize(40L);
req.setShowDeleted(false);
TradesBoughtGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
TradesBoughtGetRequest req = new TradesBoughtGetRequest();
req.Fields = "tid,type,status,payment,orders";
req.StartCreated = DateTime.Parse("2000-01-01 00:00:00");
req.EndCreated = DateTime.Parse("2000-01-01 23:59:59");
req.Status = "TRADE_NO_CREATE_PAY";
req.SellerNick = "zhangsan";
req.Type = "shopex_trade";
req.ExtType = "service";
req.RateStatus = "RATE_UNBUYER";
req.PageNo = 1L;
req.PageSize = 40L;
req.ShowDeleted = false;
TradesBoughtGetResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new TradesBoughtGetRequest;
$req->setFields("tid,type,status,payment,orders");
$req->setStartCreated("2000-01-01 00:00:00");
$req->setEndCreated("2000-01-01 23:59:59");
$req->setStatus("TRADE_NO_CREATE_PAY");
$req->setSellerNick("zhangsan");
$req->setType("shopex_trade");
$req->setExtType("service");
$req->setRateStatus("RATE_UNBUYER");
$req->setPageNo("1");
$req->setPageSize("40");
$req->setShowDeleted("false");
$resp = $c->execute($req, $sessionKey);

curl -X POST 'http://gw.api.taobao.com/router/rest' \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'app_key=12129701' \
-d 'format=json' \
-d 'method=taobao.trades.bought.get' \
-d 'partner_id=apidoc' \
-d 'session=8a5040a0-233e-4ba6-8e7c-a2f4a5850f72' \
-d 'sign=C87DAC14CC0661374CC5A3BAF7857C2E' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-03-05+10%3A27%3A14' \
-d 'v=2.0' \
-d 'end_created=2000-01-01+23%3A59%3A59' \
-d 'ext_type=service' \
-d 'fields=tid%2Ctype%2Cstatus%2Cpayment%2Corders' \
-d 'page_no=1' \
-d 'page_size=40' \
-d 'rate_status=RATE_UNBUYER' \
-d 'seller_nick=zhangsan' \
-d 'show_deleted=false' \
-d 'start_created=2000-01-01+00%3A00%3A00' \
-d 'status=TRADE_NO_CREATE_PAY' \
-d 'type=shopex_trade'

# -*- coding: utf-8 -*-
import top.api

req=top.api.TradesBoughtGetRequest(url,port)
req.set_app_info(top.appinfo(appkey,secret))

req.fields="tid,type,status,payment,orders"
req.start_created="2000-01-01 00:00:00"
req.end_created="2000-01-01 23:59:59"
req.status="TRADE_NO_CREATE_PAY"
req.seller_nick="zhangsan"
req.type="shopex_trade"
req.ext_type="service"
req.rate_status="RATE_UNBUYER"
req.page_no=1
req.page_size=40
req.show_deleted=false
try:
	resp= req.getResponse(sessionkey)
	print(resp)
except Exception,e:
	print(e)

pTopRequest pRequest = alloc_top_request();
pTopResponse pResponse = NULL;
pTaobaoClient pClient = alloc_taobao_client(url, appkey, appsecret);
set_api_name(pRequest,"taobao.trades.bought.get");
add_param(pRequest,"fields","tid,type,status,payment,orders");
add_param(pRequest,"start_created","2000-01-01 00:00:00");
add_param(pRequest,"end_created","2000-01-01 23:59:59");
add_param(pRequest,"status","TRADE_NO_CREATE_PAY");
add_param(pRequest,"seller_nick","zhangsan");
add_param(pRequest,"type","shopex_trade");
add_param(pRequest,"ext_type","service");
add_param(pRequest,"rate_status","RATE_UNBUYER");
add_param(pRequest,"page_no","1");
add_param(pRequest,"page_size","40");
add_param(pRequest,"show_deleted","false");
pResponse = top_execute(pClient,pRequest,sessionKey);
printf("ret code:%d\n",pResponse->code);
if(pResponse->code == 0){
	pTopResponseIterator ite = init_response_iterator(pResponse);
	pResultItem pResultItem = alloc_result_item();
	while(parseNext(ite, pResultItem) == 0){
		printf("%s:%s\n",pResultItem->key,pResultItem->value);
	}
	destroy_response_iterator(ite);
	destroy_result_item(pResultItem);
}
destroy_top_request(pRequest);
destroy_top_response(pResponse);
destroy_taobao_client(pClient);

TopClient = require('./topClient').TopClient;
var client = new TopClient({
	'appkey': 'appkey',
	'appsecret': 'secret',
	'REST_URL': 'http://gw.api.taobao.com/router/rest'
});

client.execute('taobao.trades.bought.get', {
	'fields':'tid,type,status,payment,orders',
	'start_created':'2000-01-01 00:00:00',
	'end_created':'2000-01-01 23:59:59',
	'status':'TRADE_NO_CREATE_PAY',
	'seller_nick':'zhangsan',
	'type':'shopex_trade',
	'ext_type':'service',
	'rate_status':'RATE_UNBUYER',
	'page_no':'1',
	'page_size':'40',
	'show_deleted':'false'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<trades_bought_get_response>
    <total_results>123</total_results>
    <trades>
        <trade>
            <seller_nick>我在测试</seller_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>
            <can_rate>true</can_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>
            <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>
            <receiver_name>东方不败</receiver_name>
            <receiver_state>浙江省</receiver_state>
            <receiver_city>杭州市</receiver_city>
            <receiver_district>西湖区</receiver_district>
            <receiver_address>淘宝城911号</receiver_address>
            <receiver_zip>223700</receiver_zip>
            <receiver_mobile>13512501826</receiver_mobile>
            <receiver_phone>13819175372</receiver_phone>
            <is_lgtype>true</is_lgtype>
            <has_yfx>true</has_yfx>
            <yfx_fee>0.50</yfx_fee>
            <yfx_id>135751716473138</yfx_id>
            <yfx_type>taojinbi</yfx_type>
            <send_time>2000-01-01</send_time>
            <is_part_consign>true</is_part_consign>
            <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>
                    <outer_iid>152e442aefe88dd41cb0879232c0dcb0</outer_iid>
                    <outer_sku_id>81893848</outer_sku_id>
                    <refund_status>SUCCESS(退款成功)</refund_status>
                    <status>TRADE_NO_CREATE_PAY</status>
                    <oid>2231958349</oid>
                    <cid>123456</cid>
                    <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_id>2564854632</item_meal_id>
                    <item_meal_name>M8原装电池:便携支架:M8专用座充:莫凡保护袋</item_meal_name>
                    <num>1</num>
                    <buyer_rate>true</buyer_rate>
                    <seller_rate>true</seller_rate>
                    <refund_id>2231958349</refund_id>
                    <seller_type>B（商城商家）</seller_type>
                    <consign_time>2013-01-13 15:23:00</consign_time>
                    <shipping_type>post</shipping_type>
                    <logistics_company>顺风快递</logistics_company>
                    <invoice_no>05432465</invoice_no>
                    <ticket_outer_id>123456abcd</ticket_outer_id>
                    <ticket_expdate_key>100FFFFFF02374020000002001020304000A</ticket_expdate_key>
                    <sub_order_tax_fee>0</sub_order_tax_fee>
                    <sub_order_tax_rate>0</sub_order_tax_rate>
                </order>
            </orders>
            <service_orders>
                <service_order>
                    <oid>110770592823138</oid>
                    <item_oid>110770592803138</item_oid>
                    <service_id>2342344</service_id>
                    <service_detail_url>http://wt.taobao.com/plan.htm?plan_id=planId</service_detail_url>
                    <num>1</num>
                    <price>39.09</price>
                    <payment>29.98</payment>
                    <title>滚筒洗衣机</title>
                    <total_fee>39.09</total_fee>
                    <refund_id>2231958349</refund_id>
                    <seller_nick>麦包包</seller_nick>
                    <pic_path>http://img08.taobao.com/bao/upload/i8/T1jVXXXePb_a0908.jpg</pic_path>
                </service_order>
            </service_orders>
            <receiver_country>中国</receiver_country>
            <receiver_town>三墎镇</receiver_town>
            <order_tax_fee>0</order_tax_fee>
        </trade>
    </trades>
</trades_bought_get_response>

{
    "trades_bought_get_response":{
        "total_results":123,
        "trades":{
            "trade":[
                {
                    "seller_nick":"我在测试",
                    "title":"麦包包",
                    "type":"fixed(一口价)",
                    "created":"2000-01-01 00:00:00",
                    "sid":"NP1021246146",
                    "tid":2231958349,
                    "seller_rate":true,
                    "buyer_rate":true,
                    "can_rate":true,
                    "status":"TRADE_NO_CREATE_PAY",
                    "payment":"200.07",
                    "discount_fee":"200.07",
                    "adjust_fee":"200.07",
                    "post_fee":"200.07",
                    "total_fee":"200.07",
                    "pay_time":"2000-01-01 00:00:00",
                    "end_time":"2000-01-01 00:00:00",
                    "modified":"2000-01-01 00:00:00",
                    "consign_time":"2000-01-01 00:00:00",
                    "received_payment":"200.07",
                    "commission_fee":"200.07",
                    "alipay_no":"2009112081173831",
                    "buyer_message":"要送的礼物的，不要忘记的哦",
                    "pic_path":"http:\/\/img08.taobao.net\/bao\/uploaded\/i8\/T1jVXXXePbXXaoPB6a_091917.jpg",
                    "num_iid":3424234,
                    "price":"200.07",
                    "cod_fee":"12.07",
                    "cod_status":"EW_CREATED(订单已创建)",
                    "shipping_type":"free",
                    "num":1,
                    "point_fee":0,
                    "real_point_fee":0,
                    "buyer_obtain_point_fee":0,
                    "receiver_name":"东方不败",
                    "receiver_state":"浙江省",
                    "receiver_city":"杭州市",
                    "receiver_district":"西湖区",
                    "receiver_address":"淘宝城911号",
                    "receiver_zip":"223700",
                    "receiver_mobile":"13512501826",
                    "receiver_phone":"13819175372",
                    "is_lgtype":true,
                    "has_yfx":true,
                    "yfx_fee":"0.50",
                    "yfx_id":"135751716473138",
                    "yfx_type":"taojinbi",
                    "send_time":"2000-01-01",
                    "is_part_consign":true,
                    "orders":{
                        "order":[
                            {
                                "title":"山寨版测试机器",
                                "pic_path":"http:\/\/img08.taobao.net\/bao\/uploaded\/i8\/T1jVXXXePbXXaoPB6a_091917.jpg",
                                "price":"200.07",
                                "num_iid":2342344,
                                "sku_id":"5937146",
                                "outer_iid":"152e442aefe88dd41cb0879232c0dcb0",
                                "outer_sku_id":"81893848",
                                "refund_status":"SUCCESS(退款成功)",
                                "status":"TRADE_NO_CREATE_PAY",
                                "oid":2231958349,
                                "cid":123456,
                                "total_fee":"200.07",
                                "payment":"200.07",
                                "discount_fee":"200.07",
                                "adjust_fee":"1.01",
                                "divide_order_fee":"21.00",
                                "part_mjz_discount":"21.00",
                                "sku_properties_name":"颜色:桔色;尺码:M",
                                "item_meal_id":2564854632,
                                "item_meal_name":"M8原装电池:便携支架:M8专用座充:莫凡保护袋",
                                "num":1,
                                "buyer_rate":true,
                                "seller_rate":true,
                                "refund_id":2231958349,
                                "seller_type":"B（商城商家）",
                                "consign_time":"2013-01-13 15:23:00",
                                "shipping_type":"post",
                                "logistics_company":"顺风快递",
                                "invoice_no":"05432465",
                                "ticket_outer_id":"123456abcd",
                                "ticket_expdate_key":"100FFFFFF02374020000002001020304000A",
                                "sub_order_tax_fee":"0",
                                "sub_order_tax_rate":"0"
                            }
                        ]
                    },
                    "service_orders":{
                        "service_order":[
                            {
                                "oid":110770592823138,
                                "item_oid":110770592803138,
                                "service_id":2342344,
                                "service_detail_url":"http:\/\/wt.taobao.com\/plan.htm?plan_id=planId",
                                "num":1,
                                "price":"39.09",
                                "payment":"29.98",
                                "title":"滚筒洗衣机",
                                "total_fee":"39.09",
                                "refund_id":2231958349,
                                "seller_nick":"麦包包",
                                "pic_path":"http:\/\/img08.taobao.com\/bao\/upload\/i8\/T1jVXXXePb_a0908.jpg"
                            }
                        ]
                    },
                    "receiver_country":"中国",
                    "receiver_town":"三墎镇",
                    "order_tax_fee":"0"
                }
            ]
        }
    }
}

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>

{
	"error_response":{
		"msg":"Remote service error",
		"code":50,
		"sub_msg":"非法参数",
		"sub_code":"isv.invalid-parameter"
	}
}

错误码	错误描述	解决方案
isv.invalid-parameter:buyer_nick	参数：buyer_nick无效，格式不对、非法值、越界等
isv.invalid-parameter:seller_nick	参数：seller_nick无效，格式不对、非法值、越界等

API测试工具错误码查询工具 SDK下载

交易API

taobao.trades.bought.get (搜索当前会话用户作为买家达成的交易记录)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ