淘宝开放平台

请求地址：

环境	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,rx_audit_status		需要返回的字段列表，多个字段用半角逗号分隔，可选值为返回示例中能看到的所有字段。rx_audit_status=0,处方药未审核
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	可选	ALL_WAIT_PAY		交易状态（查看可选值），默认查询所有交易状态的数据，除了默认值外每次只能查询一种状态。
buyer_nick	String	可选	zhangsan		买家昵称
type	String	可选	game_equipment		交易类型列表，同时查询多种交易类型可用逗号分隔。默认同时查询guarantee_trade,auto_delivery,ec,cod,step 这5 种的交易类型的数据；查询所有交易类型的数据，需要设置下面全部可选值。可选值：fixed(一口价)auction(拍卖)guarantee_trade(一口价、拍卖)step(分阶段付款，万人团，阶梯团订单）independent_simple_trade(旺店入门版交易)independent_shop_trade(旺店标准版交易)auto_delivery(自动发货)ec(直冲)cod(货到付款)game_equipment(游戏装备)shopex_trade(ShopEX交易)netcn_trade(万网交易)external_trade(统一外部交易)instant_trade (即时到账)b2c_cod(大商家货到付款)hotel_trade(酒店类型交易)super_market_trade(商超交易)super_market_cod_trade(商超货到付款交易)taohua(淘花网交易类型）waimai(外卖交易类型）o2o_offlinetrade（O2O交易）nopaid（即时到帐/趣味猜交易类型）step (万人团) eticket(电子凭证) tmall_i18n（天猫国际）;nopaid （无付款交易）insurance_plus（保险）finance（基金）注：guarantee_trade是一个组合查询条件，并不是一种交易类型，获取批量或单个订单中不会返回此种类型的订单。pre_auth_type(预授权0元购) lazada（获取lazada订单类型）
ext_type	String	可选	service		可选值有ershou(二手市场的订单）,service（商城服务子订单）mark（双十一大促活动异常订单）作为扩展类型筛选只能做单个ext_type查询，不能全部查询所有的ext_type类型
rate_status	String	可选	RATE_UNBUYER		评价状态，默认查询所有评价状态的数据，除了默认值外每次只能查询一种状态。可选值：RATE_UNBUYER(买家未评)RATE_UNSELLER(卖家未评)RATE_BUYER_UNSELLER(买家已评，卖家未评)RATE_UNBUYER_SELLER(买家未评，卖家已评)RATE_BUYER_SELLER(买家已评,卖家已评)
tag	String	可选	time_card		卖家对交易的自定义分组标签，目前可选值为：time_card（点卡软件代充），fee_card（话费软件代充）
page_no	Number	可选	1	默认值：1	页码。默认值:1，可填整数，通过传入page_no来控制获取的页数，总页数=total_results÷page_size
page_size	Number	可选	40	默认值：40	每页条数。默认值:40;最大值:100，可填整数。通过page_no和page_size组合多次调用实现翻页获取全量数据。
use_has_next	Boolean	可选	true	默认值：false	是否启用has_next的分页方式，如果指定true,则返回的结果中不包含总记录数，但是会新增一个是否存在下一页的的字段，通过此种方式获取增量交易，接口调用成功率在原有的基础上有所提升。
buyer_open_id	String	可选	AAHm5d-EAAeGwJedwSHpg8bT		买家的openId

名称	类型	示例值	描述
total_results	Number	100	搜索到的交易信息总数
trades	Trade []		搜索到的交易信息列表，返回的Trade和Order中包含的具体信息为入参fields请求的字段信息
└ seller_nick String 我在测试卖家昵称 └ buyer_open_uid String AAHk5d-EAAeGwJedwSFu0XXX 买家OpenUid └ 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 └ tid Number 2231958349 交易编号 (父订单的交易编号) └ acookie_id String 1a11a0987628772c002ec7d0eec2a352 Acookie订单唯一ID。 └ sid String NP1021246146 物流运单号 └ 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 └ async_modified Date 2000-01-01 00:00:00 同步到卖家库的时间，taobao.trades.sold.incrementv.get接口返回此字段 └ 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 └ alipay_id Number 2011082299567459 买家的支付宝id号，在UIC中有记录，买家支付宝的唯一标示，不因为买家更换Email账号而改变。 └ buyer_area String 浙江省杭州市买家下单的地区 └ nut_feature String ;buyernick:tester;card:123;buyerArea:杭州卡易售垂直表信息，去除下单ip之后的结果 └ 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_town String 三墎镇收货人街道地址 └ receiver_address String 淘宝城收货人的详细地址(加密) └ receiver_zip String 223700 收货人的邮编 └ receiver_mobile String 1826 收货人的手机号码(加密) └ receiver_phone String *5372 收货人的电话号码(加密) └ seller_flag Number 1 卖家备注旗帜（与淘宝网上订单的卖家备注旗帜对应，只有卖家才能查看该字段）红、黄、绿、蓝、紫分别对应 1、2、3、4、5 └ is_lgtype Boolean true 是否保障速递，如果为true，则为保障速递订单，使用线下联系发货接口发货，如果未false，则该订单非保障速递，根据卖家设置的订单流转规则可使用物流宝或者常规物流发货。 └ lg_aging_type String 次日达次日达，三日达等送达类型 └ lg_aging String 2012-06-19 15:16:14 次日达订单送达时间 └ is_brand_sale Boolean true 表示是否是品牌特卖（常规特卖，不包括特卖惠和特实惠）订单，如果是返回true，如果不是返回false。当此字段与is_force_wlb均为true时，订单强制物流宝发货。 └ is_force_wlb Boolean true 订单是否强制使用物流宝发货。当此字段与is_brand_sale均为true时，订单强制物流宝发货。此字段为false时，该订单根据流转规则设置可以使用物流宝或者常规方式发货 └ has_buyer_message Boolean true 判断订单是否有买家留言，有买家留言返回true，否则返回false └ credit_card_fee String 30.5 使用信用卡支付金额数 └ trade_from String WAP,JHS 交易内部来源。WAP(手机);HITAO(嗨淘);TOP(TOP平台);TAOBAO(普通淘宝);JHS(聚划算)一笔订单可能同时有以上多个标记，则以逗号分隔 └ step_trade_status String FRONT_NOPAID_FINAL_NOPAID 分阶段付款的订单状态（例如万人团订单等），目前有三返回状态FRONT_NOPAID_FINAL_NOPAID(定金未付尾款未付)，FRONT_PAID_FINAL_NOPAID(定金已付尾款未付)，FRONT_PAID_FINAL_PAID(定金和尾款都付) └ step_paid_fee String 525.70 分阶段付款的已付金额（万人团订单已付金额） └ mark_desc String 该订单需要延长收货时间订单出现异常问题的时候，给予用户的描述,没有异常的时候，此值为空 └ has_yfx Boolean true 订单中是否包含运费险订单，如果包含运费险订单返回true，不包含运费险订单，返回false └ yfx_fee String 0.50 订单的运费险，单位为元 └ yfx_id String 135751716473138 运费险支付号 └ yfx_type String taojinbi 运费险类型 └ trade_source String ownshop 交易外部来源：ownshop(商家官网) └ send_time String 2000-01-01 订单将在此时间前发出，主要用于预售订单 └ seller_can_rate Boolean true 卖家是否可以对订单进行评价 └ is_part_consign Boolean true 是否是多次发货的订单如果卖家对订单进行多次发货，则为true否则为false └ is_wt Boolean true 表示订单交易是否网厅订单。如果该订单是网厅订单，那么该值为true；反之，该值为false。 └ is_daixiao Boolean true 表示订单交易是否含有对应的代销采购单。如果该订单中存在一个对应的代销采购单，那么该值为true；反之，该值为false。 └ 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信息 └ 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 子订单编号 └ 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 String 2231958349 最近退款ID └ seller_type String B（商城商家）卖家类型，可选值为：B（商城商家），C（普通卖家） └ cid Number 123456 交易商品对应的类目ID └ end_time Date 2012-04-07 00:00:00 子订单的交易结束时间说明：子订单有单独的结束时间，与主订单的结束时间可能有所不同，在有退款发起的时候或者是主订单分阶段付款的时候，子订单的结束时间会早于主订单的结束时间，所以开放这个字段便于订单结束状态的判断 └ consign_time String 2013-01-13 15:23:00 子订单发货时间，当卖家对订单进行了多次发货，子订单的发货时间和主订单的发货时间可能不一样了，那么就需要以子订单的时间为准。（没有进行多次发货的订单，主订单的发货时间和子订单的发货时间都一样） └ shipping_type String post 子订单的运送方式（卖家对订单进行多次发货之后，一个主订单下的子订单的运送方式可能不同，用order.shipping_type来区分子订单的运送方式） └ logistics_company String 顺风快递子订单发货的快递公司名称 └ invoice_no String 05432465 子订单所在包裹的运单号 └ bind_oid Number 23194074143138 捆绑的子订单号，表示该子订单要和捆绑的子订单一起发货，用于卖家子订单捆绑发货 └ 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 家装干支装服务支持家装类物流的类型 └ sub_order_tax_fee String 0 天猫国际官网直供子订单关税税费 └ sub_order_tax_rate String 0 天猫国际官网直供子订单关税税率 └ zhengji_status String 1 征集预售订单征集状态：1（征集中），2（征集成功），3（征集失败） └ md_qualification String true_access 免单资格 └ md_fee String 999 免单金额 └ 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 子订单是否优惠贬值 └ is_idle String 1 是否为闲鱼订单 1是0否 └ promise_collect_time String 2000-01-01 00:00:00 承诺/最晚揽收时间 └ is_force_dc Boolean true 是否自动流转到菜鸟仓发货 shp_info ShipInfo [] 发货信息，目前只记录了发货方式 └ transport_type String express,seller,instant等发货方式（小写） └ qn_distr String 1 清仓订单标；“1”代表是闲鱼渠道的订单 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 服务子订单总费用 └ buyer_nick String 小倩2005 卖家昵称 └ refund_id String 2231958349 最近退款的id └ seller_nick String 麦包包卖家昵称 └ pic_path String http://img08.taobao.com/bao/upload/i8/T1jVXXXePb_a0908.jpg 服务图片地址 └ tmser_spu_code String 家装干支装服务支持家装类物流的类型 └ zero_purchase Boolean true 在返回的trade对象上专门增加一个字段zero_purchase来区分，这个为true的就是0元购机预授权交易 └ receiver_country String 中国收货人国籍 └ order_tax_fee String 0 天猫国际官网直供主订单关税税费 └ shop_pick String 1 门店自提总店发货提货门店 └ rx_audit_status String 0 处方药未审核 └ post_gate_declare Boolean true 邮关订单 └ cross_bonded_declare Boolean true 跨境订单 └ order_tax_promotion_fee String 0 天猫国际计税优惠金额 └ service_type String timedd,jiaju serviceType └ is_o2o_passport Boolean true 是否是智慧门店订单，只有true，或者 null 两种情况 └ tmall_delivery Boolean true tmallDelivery └ threepl_timing Boolean true threeplTiming └ cn_service String 84_50 天猫直送服务 └ cutoff_minutes String 660 截单时间 └ es_time String 4 时效：天 └ delivery_time String 2018-06-09 12:13:14 发货时间 └ collect_time String 2018-06-09 12:13:14 揽收时间 └ dispatch_time String 2018-06-09 12:13:14 派送时间 └ sign_time String 2018-06-09 12:13:14 签收时间 └ delivery_cps String STO 派送CP └ es_range String 09:00-12:00 预计送达时间段 └ es_date String 2018-06-09 预计送达日期 └ os_range String 09:00-12:00 预约送达时间段 └ os_date String 2018-06-09 预约送达日期 └ no_shipping Boolean false 无物流信息返回true，平台属性，业务不要依赖 └ asdp_biz_type String logistics_upgrade 业务身份 └ asdp_ads String 201 送货上门标 └ aid String aid aid └ drug_register String 1 是否疫情登记的订单。0=未登记，1=已登记 └ promise_sign_time String 2000-01-01 00:00:00 承诺/最晚送达时间 └ oaid String 2w2RYE45iahnF4aiaJ7pHKCJ3Hwnbgnq2PH3AfpQVyWZNHKS9wNgAAOUfCVt9XZMetogNHwc （收货人+手机号+座机+收货地址+create）5个字段组合成oaid，原始订单上座机为空也满足条件，否则生成不了oaid └ scenario_group String TXD_B2C_FRESH_HALFDAY 淘鲜达半日达 └ is_force_dc Boolean true 是否自动流转到菜鸟仓发货 └ buyer_nick String 我在测试买家昵称 logistics_agreement LogisticsAgreement 物流服务承诺 └ logistics_service_msg String 送货上门服务承诺/异常文案 └ asdp_biz_type String logistics_upgrade 物流服务业务身份 └ asdp_ads String 201 物流信息，多个值时用英文逗号隔开 └ sign_time String 2019-04-12 16:00:00 计划送达时间 └ promise_sign_time String 2019-04-12 16:00:00 承诺/最晚送达时间 logistics_infos LogisticsInfo [] 子单维度物流发货信息 └ biz_delivery_type Number 0 订单推荐配送类型 * 0：子单无配建议；ERP按照自己的逻辑进行择配。 * 1：子单有推荐配list，erp可按需参考。 * 2：子单有推荐配list，erp必须在推荐配list中选择配品牌。 * 3：子单有禁用配list，erp需要过滤配品牌。 └ unused_warehouse_error_msg String 当前订单在猫淘平台对消费者进行了服务承诺：当日发次日达，建议按照平台要求进行择仓，否则存在赔付风险未使用仓建议报错 └ unused_delivery_error_msg String 当前订单在猫淘平台对消费者进行了服务承诺，建议按照平台要求进行择配，否则存在赔付风险”/“平台建议当前线路您只能选择的配品牌，存在电子面单无法打印风险未使用配建议报错 └ used_black_delivery_error_msg String 平台建议当前线路不要使用您选择的配品牌，存在电子面单无法打印风险使用禁止配报错 └ promise_outbound_time String 2019-04-12 16:00:00 承诺/最晚出库时间 └ trade_id Number 1100070860172581613 主交易号 └ sub_trade_id Number 1100070860173581613 子交易号 └ promise_collect_time String 2000-01-01 00:00:00 承诺/最晚揽收时间 └ receipt_type String ITEM 补差类型，ITEM:商品补差 POSTAGE:邮费补差 OTHER：其他补差 └ receipt_rel_ids String [] 补差关联订单号列表 └ seller_flag_tag String 红色旗子插旗标签 └ seller_memo String 交易备注卖家备注内容 └ real_receiver_open_id String AAEnVKOdAOIduo9TH9hjf-zb 收件人淘宝加密openId └ real_receiver_display_nick String 这是一个昵称收件人淘宝加密昵称 └ post_fee_type String giftprepaid 邮费类型，giftprepaid代表送礼玩法预付，normal代表订单buyer付款邮费或平台包邮订单 └ real_post_fee String 11 实际邮费，单位：分，没有发生邮费退款不返回该字段 └ refund_post_fee String 8 邮费退款金额，单位：分，没有发生邮费退款不返回该字段 └ gift_post_fee_role String 0 送礼邮费支付角色，0为送礼人支付邮费，1为收礼人支付邮费，免邮场景、平台补贴邮费场景不返回该字段 └ qn_distr String 1 清仓订单标；“1”代表是闲鱼渠道的订单
has_next	Boolean	true	是否存在下一页

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TradesSoldGetRequest req = new TradesSoldGetRequest();
req.setFields("tid,type,status,payment,orders,rx_audit_status");
req.setStartCreated(StringUtils.parseDateTime("2000-01-01 00:00:00"));
req.setEndCreated(StringUtils.parseDateTime("2000-01-01 23:59:59"));
req.setStatus("ALL_WAIT_PAY");
req.setBuyerNick("zhangsan");
req.setType("game_equipment");
req.setExtType("service");
req.setRateStatus("RATE_UNBUYER");
req.setTag("time_card");
req.setPageNo(1L);
req.setPageSize(40L);
req.setUseHasNext(true);
req.setBuyerOpenId("AAHm5d-EAAeGwJedwSHpg8bT");
TradesSoldGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
TradesSoldGetRequest req = new TradesSoldGetRequest();
req.Fields = "tid,type,status,payment,orders,rx_audit_status";
req.StartCreated = DateTime.Parse("2000-01-01 00:00:00");
req.EndCreated = DateTime.Parse("2000-01-01 23:59:59");
req.Status = "ALL_WAIT_PAY";
req.BuyerNick = "zhangsan";
req.Type = "game_equipment";
req.ExtType = "service";
req.RateStatus = "RATE_UNBUYER";
req.Tag = "time_card";
req.PageNo = 1L;
req.PageSize = 40L;
req.UseHasNext = true;
req.BuyerOpenId = "AAHm5d-EAAeGwJedwSHpg8bT";
TradesSoldGetResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new TradesSoldGetRequest;
$req->setFields("tid,type,status,payment,orders,rx_audit_status");
$req->setStartCreated("2000-01-01 00:00:00");
$req->setEndCreated("2000-01-01 23:59:59");
$req->setStatus("ALL_WAIT_PAY");
$req->setBuyerNick("zhangsan");
$req->setType("game_equipment");
$req->setExtType("service");
$req->setRateStatus("RATE_UNBUYER");
$req->setTag("time_card");
$req->setPageNo("1");
$req->setPageSize("40");
$req->setUseHasNext("true");
$req->setBuyerOpenId("AAHm5d-EAAeGwJedwSHpg8bT");
$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.sold.get' \
-d 'partner_id=apidoc' \
-d 'session=333d2008-baa8-43fc-8bc2-4e54d36dbd95' \
-d 'sign=6BE6AAC429CE568DC974EF36EF98A79B' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-03-06+02%3A07%3A53' \
-d 'v=2.0' \
-d 'buyer_nick=zhangsan' \
-d 'buyer_open_id=AAHm5d-EAAeGwJedwSHpg8bT' \
-d 'end_created=2000-01-01+23%3A59%3A59' \
-d 'ext_type=service' \
-d 'fields=tid%2Ctype%2Cstatus%2Cpayment%2Corders%2Crx_audit_status' \
-d 'page_no=1' \
-d 'page_size=40' \
-d 'rate_status=RATE_UNBUYER' \
-d 'start_created=2000-01-01+00%3A00%3A00' \
-d 'status=ALL_WAIT_PAY' \
-d 'tag=time_card' \
-d 'type=game_equipment' \
-d 'use_has_next=true'

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

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

req.fields="tid,type,status,payment,orders,rx_audit_status"
req.start_created="2000-01-01 00:00:00"
req.end_created="2000-01-01 23:59:59"
req.status="ALL_WAIT_PAY"
req.buyer_nick="zhangsan"
req.type="game_equipment"
req.ext_type="service"
req.rate_status="RATE_UNBUYER"
req.tag="time_card"
req.page_no=1
req.page_size=40
req.use_has_next=true
req.buyer_open_id="AAHm5d-EAAeGwJedwSHpg8bT"
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.sold.get");
add_param(pRequest,"fields","tid,type,status,payment,orders,rx_audit_status");
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","ALL_WAIT_PAY");
add_param(pRequest,"buyer_nick","zhangsan");
add_param(pRequest,"type","game_equipment");
add_param(pRequest,"ext_type","service");
add_param(pRequest,"rate_status","RATE_UNBUYER");
add_param(pRequest,"tag","time_card");
add_param(pRequest,"page_no","1");
add_param(pRequest,"page_size","40");
add_param(pRequest,"use_has_next","true");
add_param(pRequest,"buyer_open_id","AAHm5d-EAAeGwJedwSHpg8bT");
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.sold.get', {
	'fields':'tid,type,status,payment,orders,rx_audit_status',
	'start_created':'2000-01-01 00:00:00',
	'end_created':'2000-01-01 23:59:59',
	'status':'ALL_WAIT_PAY',
	'buyer_nick':'zhangsan',
	'type':'game_equipment',
	'ext_type':'service',
	'rate_status':'RATE_UNBUYER',
	'tag':'time_card',
	'page_no':'1',
	'page_size':'40',
	'use_has_next':'true',
	'buyer_open_id':'AAHm5d-EAAeGwJedwSHpg8bT'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<trades_sold_get_response>
    <total_results>100</total_results>
    <trades>
        <trade>
            <seller_nick>我在测试</seller_nick>
            <buyer_open_uid>AAHk5d-EAAeGwJedwSFu0XXX</buyer_open_uid>
            <title>麦包包</title>
            <type>fixed(一口价)</type>
            <created>2000-01-01 00:00:00</created>
            <tid>2231958349</tid>
            <acookie_id>1a11a0987628772c002ec7d0eec2a352</acookie_id>
            <sid>NP1021246146</sid>
            <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>
            <async_modified>2000-01-01 00:00:00</async_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>
            <alipay_id>2011082299567459</alipay_id>
            <buyer_area>浙江省杭州市</buyer_area>
            <nut_feature>;buyernick:tester;card:123;buyerArea:杭州</nut_feature>
            <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_town>三墎镇</receiver_town>
            <receiver_address>****淘宝城</receiver_address>
            <receiver_zip>223700</receiver_zip>
            <receiver_mobile>****1826</receiver_mobile>
            <receiver_phone>****5372</receiver_phone>
            <seller_flag>1</seller_flag>
            <is_lgtype>true</is_lgtype>
            <lg_aging_type>次日达</lg_aging_type>
            <lg_aging>2012-06-19 15:16:14</lg_aging>
            <is_brand_sale>true</is_brand_sale>
            <is_force_wlb>true</is_force_wlb>
            <has_buyer_message>true</has_buyer_message>
            <credit_card_fee>30.5</credit_card_fee>
            <trade_from>WAP,JHS</trade_from>
            <step_trade_status>FRONT_NOPAID_FINAL_NOPAID</step_trade_status>
            <step_paid_fee>525.70</step_paid_fee>
            <mark_desc>该订单需要延长收货时间</mark_desc>
            <has_yfx>true</has_yfx>
            <yfx_fee>0.50</yfx_fee>
            <yfx_id>135751716473138</yfx_id>
            <yfx_type>taojinbi</yfx_type>
            <trade_source>ownshop</trade_source>
            <send_time>2000-01-01</send_time>
            <seller_can_rate>true</seller_can_rate>
            <is_part_consign>true</is_part_consign>
            <is_wt>true</is_wt>
            <is_daixiao>true</is_daixiao>
            <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>
                    <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>
                    <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>
                    <cid>123456</cid>
                    <end_time>2012-04-07 00:00:00</end_time>
                    <consign_time>2013-01-13 15:23:00</consign_time>
                    <shipping_type>post</shipping_type>
                    <logistics_company>顺风快递</logistics_company>
                    <invoice_no>05432465</invoice_no>
                    <bind_oid>23194074143138</bind_oid>
                    <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>
                    <sub_order_tax_fee>0</sub_order_tax_fee>
                    <sub_order_tax_rate>0</sub_order_tax_rate>
                    <zhengji_status>1</zhengji_status>
                    <md_qualification>true_access</md_qualification>
                    <md_fee>999</md_fee>
                    <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>
                    <is_idle>1</is_idle>
                    <promise_collect_time>2000-01-01 00:00:00</promise_collect_time>
                    <is_force_dc>true</is_force_dc>
                    <shp_info>
                        <ship_info>
                            <transport_type>express,seller,instant等</transport_type>
                        </ship_info>
                    </shp_info>
                    <qn_distr>1</qn_distr>
                </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>
                    <buyer_nick>小倩2005</buyer_nick>
                    <refund_id>2231958349</refund_id>
                    <seller_nick>麦包包</seller_nick>
                    <pic_path>http://img08.taobao.com/bao/upload/i8/T1jVXXXePb_a0908.jpg</pic_path>
                    <tmser_spu_code>家装干支装服务</tmser_spu_code>
                </service_order>
            </service_orders>
            <zero_purchase>true</zero_purchase>
            <receiver_country>中国</receiver_country>
            <order_tax_fee>0</order_tax_fee>
            <shop_pick>1</shop_pick>
            <rx_audit_status>0</rx_audit_status>
            <post_gate_declare>true</post_gate_declare>
            <cross_bonded_declare>true</cross_bonded_declare>
            <order_tax_promotion_fee>0</order_tax_promotion_fee>
            <service_type>timedd,jiaju</service_type>
            <is_o2o_passport>true</is_o2o_passport>
            <tmall_delivery>true</tmall_delivery>
            <threepl_timing>true</threepl_timing>
            <cn_service>84_50</cn_service>
            <cutoff_minutes>660</cutoff_minutes>
            <es_time>4</es_time>
            <delivery_time>2018-06-09 12:13:14</delivery_time>
            <collect_time>2018-06-09 12:13:14</collect_time>
            <dispatch_time>2018-06-09 12:13:14</dispatch_time>
            <sign_time>2018-06-09 12:13:14</sign_time>
            <delivery_cps>STO</delivery_cps>
            <es_range>09:00-12:00</es_range>
            <es_date>2018-06-09</es_date>
            <os_range>09:00-12:00</os_range>
            <os_date>2018-06-09</os_date>
            <asdp_biz_type>logistics_upgrade</asdp_biz_type>
            <asdp_ads>201</asdp_ads>
            <drug_register>1</drug_register>
            <promise_sign_time>2000-01-01 00:00:00</promise_sign_time>
            <oaid>2w2RYE45iahnF4aiaJ7pHKCJ3Hwnbgnq2PH3AfpQVyWZNHKS9wNgAAOUfCVt9XZMetogNHwc</oaid>
            <scenario_group>TXD_B2C_FRESH_HALFDAY</scenario_group>
            <is_force_dc>true</is_force_dc>
            <buyer_nick>我在测试</buyer_nick>
            <logistics_agreement>
                <logistics_service_msg>送货上门</logistics_service_msg>
                <asdp_biz_type>logistics_upgrade</asdp_biz_type>
                <asdp_ads>201</asdp_ads>
                <sign_time>2019-04-12 16:00:00</sign_time>
                <promise_sign_time>2019-04-12 16:00:00</promise_sign_time>
            </logistics_agreement>
            <logistics_infos>
                <logistics_info>
                    <biz_delivery_type>0</biz_delivery_type>
                    <unused_warehouse_error_msg>当前订单在猫淘平台对消费者进行了服务承诺：当日发次日达，建议按照平台要求进行择仓，否则存在赔付风险</unused_warehouse_error_msg>
                    <unused_delivery_error_msg>当前订单在猫淘平台对消费者进行了服务承诺，建议按照平台要求进行择配，否则存在赔付风险”/“平台建议当前线路您只能选择的配品牌，存在电子面单无法打印风险</unused_delivery_error_msg>
                    <used_black_delivery_error_msg>平台建议当前线路不要使用您选择的配品牌，存在电子面单无法打印风险</used_black_delivery_error_msg>
                    <promise_outbound_time>2019-04-12 16:00:00</promise_outbound_time>
                    <trade_id>1100070860172581613</trade_id>
                    <sub_trade_id>1100070860173581613</sub_trade_id>
                    <promise_collect_time>2000-01-01 00:00:00</promise_collect_time>
                </logistics_info>
            </logistics_infos>
            <receipt_type>ITEM</receipt_type>
            <seller_flag_tag>红色旗子</seller_flag_tag>
            <seller_memo>交易备注</seller_memo>
            <real_receiver_open_id>AAEnVKOdAOIduo9TH9hjf-zb</real_receiver_open_id>
            <real_receiver_display_nick>这是一个昵称</real_receiver_display_nick>
            <post_fee_type>giftprepaid</post_fee_type>
            <real_post_fee>11</real_post_fee>
            <refund_post_fee>8</refund_post_fee>
            <gift_post_fee_role>0</gift_post_fee_role>
            <qn_distr>1</qn_distr>
        </trade>
    </trades>
    <has_next>true</has_next>
</trades_sold_get_response>

{
    "trades_sold_get_response":{
        "total_results":100,
        "trades":{
            "trade":[
                {
                    "seller_nick":"我在测试",
                    "buyer_open_uid":"AAHk5d-EAAeGwJedwSFu0XXX",
                    "title":"麦包包",
                    "type":"fixed(一口价)",
                    "created":"2000-01-01 00:00:00",
                    "tid":2231958349,
                    "acookie_id":"1a11a0987628772c002ec7d0eec2a352",
                    "sid":"NP1021246146",
                    "seller_rate":true,
                    "buyer_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",
                    "async_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",
                    "alipay_id":2011082299567459,
                    "buyer_area":"浙江省杭州市",
                    "nut_feature":";buyernick:tester;card:123;buyerArea:杭州",
                    "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_town":"三墎镇",
                    "receiver_address":"****淘宝城",
                    "receiver_zip":"223700",
                    "receiver_mobile":"****1826",
                    "receiver_phone":"****5372",
                    "seller_flag":1,
                    "is_lgtype":true,
                    "lg_aging_type":"次日达",
                    "lg_aging":"2012-06-19 15:16:14",
                    "is_brand_sale":true,
                    "is_force_wlb":true,
                    "has_buyer_message":true,
                    "credit_card_fee":"30.5",
                    "trade_from":"WAP,JHS",
                    "step_trade_status":"FRONT_NOPAID_FINAL_NOPAID",
                    "step_paid_fee":"525.70",
                    "mark_desc":"该订单需要延长收货时间",
                    "has_yfx":true,
                    "yfx_fee":"0.50",
                    "yfx_id":"135751716473138",
                    "yfx_type":"taojinbi",
                    "trade_source":"ownshop",
                    "send_time":"2000-01-01",
                    "seller_can_rate":true,
                    "is_part_consign":true,
                    "is_wt":true,
                    "is_daixiao":true,
                    "o2o":"crm",
                    "o2o_guide_id":"123456",
                    "o2o_guide_name":"西湖门店导购员1",
                    "o2o_shop_id":"123456",
                    "o2o_shop_name":"西湖门店",
                    "o2o_delivery":"inshop",
                    "o2o_out_trade_id":"123456",
                    "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,
                                "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（商城商家）",
                                "cid":123456,
                                "end_time":"2012-04-07 00:00:00",
                                "consign_time":"2013-01-13 15:23:00",
                                "shipping_type":"post",
                                "logistics_company":"顺风快递",
                                "invoice_no":"05432465",
                                "bind_oid":23194074143138,
                                "is_daixiao":true,
                                "ticket_outer_id":"123456abcd",
                                "ticket_expdate_key":"100FFFFFF02374020000002001020304000A",
                                "is_www":true,
                                "store_code":"南京QDHEWL-0004",
                                "tmser_spu_code":"家装干支装服务",
                                "sub_order_tax_fee":"0",
                                "sub_order_tax_rate":"0",
                                "zhengji_status":"1",
                                "md_qualification":"true_access",
                                "md_fee":"999",
                                "sub_order_tax_promotion_fee":"0",
                                "tax_free":true,
                                "tax_coupon_discount":"0",
                                "special_refund_type":"priceProtect",
                                "is_devalue_fee":true,
                                "is_idle":"1",
                                "promise_collect_time":"2000-01-01 00:00:00",
                                "is_force_dc":true,
                                "shp_info":{
                                    "ship_info":[
                                        {
                                            "transport_type":"express,seller,instant等"
                                        }
                                    ]
                                },
                                "qn_distr":"1"
                            }
                        ]
                    },
                    "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",
                                "buyer_nick":"小倩2005",
                                "refund_id":"2231958349",
                                "seller_nick":"麦包包",
                                "pic_path":"http:\/\/img08.taobao.com\/bao\/upload\/i8\/T1jVXXXePb_a0908.jpg",
                                "tmser_spu_code":"家装干支装服务"
                            }
                        ]
                    },
                    "zero_purchase":true,
                    "receiver_country":"中国",
                    "order_tax_fee":"0",
                    "shop_pick":"1",
                    "rx_audit_status":"0",
                    "post_gate_declare":true,
                    "cross_bonded_declare":true,
                    "order_tax_promotion_fee":"0",
                    "service_type":"timedd,jiaju",
                    "is_o2o_passport":true,
                    "tmall_delivery":true,
                    "threepl_timing":true,
                    "cn_service":"84_50",
                    "cutoff_minutes":"660",
                    "es_time":"4",
                    "delivery_time":"2018-06-09 12:13:14",
                    "collect_time":"2018-06-09 12:13:14",
                    "dispatch_time":"2018-06-09 12:13:14",
                    "sign_time":"2018-06-09 12:13:14",
                    "delivery_cps":"STO",
                    "es_range":"09:00-12:00",
                    "es_date":"2018-06-09",
                    "os_range":"09:00-12:00",
                    "os_date":"2018-06-09",
                    "asdp_biz_type":"logistics_upgrade",
                    "asdp_ads":"201",
                    "drug_register":"1",
                    "promise_sign_time":"2000-01-01 00:00:00",
                    "oaid":"2w2RYE45iahnF4aiaJ7pHKCJ3Hwnbgnq2PH3AfpQVyWZNHKS9wNgAAOUfCVt9XZMetogNHwc",
                    "scenario_group":"TXD_B2C_FRESH_HALFDAY",
                    "is_force_dc":true,
                    "buyer_nick":"我在测试",
                    "logistics_agreement":{
                        "logistics_service_msg":"送货上门",
                        "asdp_biz_type":"logistics_upgrade",
                        "asdp_ads":"201",
                        "sign_time":"2019-04-12 16:00:00",
                        "promise_sign_time":"2019-04-12 16:00:00"
                    },
                    "logistics_infos":{
                        "logistics_info":[
                            {
                                "biz_delivery_type":0,
                                "unused_warehouse_error_msg":"当前订单在猫淘平台对消费者进行了服务承诺：当日发次日达，建议按照平台要求进行择仓，否则存在赔付风险",
                                "unused_delivery_error_msg":"当前订单在猫淘平台对消费者进行了服务承诺，建议按照平台要求进行择配，否则存在赔付风险”\/“平台建议当前线路您只能选择的配品牌，存在电子面单无法打印风险",
                                "used_black_delivery_error_msg":"平台建议当前线路不要使用您选择的配品牌，存在电子面单无法打印风险",
                                "promise_outbound_time":"2019-04-12 16:00:00",
                                "trade_id":1100070860172581613,
                                "sub_trade_id":1100070860173581613,
                                "promise_collect_time":"2000-01-01 00:00:00"
                            }
                        ]
                    },
                    "receipt_type":"ITEM",
                    "seller_flag_tag":"红色旗子",
                    "seller_memo":"交易备注",
                    "real_receiver_open_id":"AAEnVKOdAOIduo9TH9hjf-zb",
                    "real_receiver_display_nick":"这是一个昵称",
                    "post_fee_type":"giftprepaid",
                    "real_post_fee":"11",
                    "refund_post_fee":"8",
                    "gift_post_fee_role":"0",
                    "qn_distr":"1"
                }
            ]
        },
        "has_next":true
    }
}

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无效，格式不对、非法值、越界等
isp.remote-service-timeout	API调用远程服务超时	1. 每次返回50条以下，时间间隔小于半个小时，这样子设置成功率就会提升。2. 目前淘宝的交易高峰期在上午9:30-11:00，下午14:00-17:00，晚上20:00-22:30，避开这个高峰可以提高成功率。3.使用增量API（taobao.increment.trades.get）可以减少甚至避免超时问题。
isv.trade-service-rejection	请求被拒绝。	可能原因为限流，请不要频繁调用，尽量避开高峰期。
isp.trade-service-readdb-overflow	数据库限流。	请求量较大，请避开高峰期。
isv.trade-service-access-frequency	服务访问频繁	请稍后重试
isv.invalid-parameter:start_created-or-end_created	不合法的参数	创建时间和结束时间不能为空
isv.invalid-parameter:seller-id	非法的参数	卖家ID非法
isp.call-limited	限流	避开限流
isv.invalid-parameter:tag	非法的参数	请检查传入参数
isv.invalid-parameter:type	非法的参数	请检查传入参数

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

淘宝交易API

taobao.trades.sold.get (查询卖家已卖出的交易数据（根据创建时间）)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ