淘宝开放平台

请求地址：

环境	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_create	Date	必须	2000-01-01 00:00:00		查询入库开始时间(修改时间跨度不能大于一天)。格式:yyyy-MM-dd HH:mm:ss
end_create	Date	必须	2000-01-02 00:00:00		查询入库结束时间，必须大于入库开始时间(修改时间跨度不能大于一天)，格式:yyyy-MM-dd HH:mm:ss。建议使用30分钟以内的时间跨度，能大大提高响应速度和成功率。
status	String	可选	TRADE_NO_CREATE_PAY		交易状态（查看可选值），默认查询所有交易状态的数据，除了默认值外每次只能查询一种状态。
type	String	可选	fixed		交易类型列表（查看可选值），一次查询多种类型可用半角逗号分隔，默认同时查询guarantee_trade,auto_delivery,ec,cod,step这5种类型的数据。
ext_type	String	可选	service		可选值有ershou(二手市场的订单）,service（商城服务子订单）mark（双十一大促活动异常订单）作为扩展类型筛选只能做单个ext_type查询，不能全部查询所有的ext_type类型
tag	String	可选	time_card		卖家对交易的自定义分组标签，目前可选值为：time_card（点卡软件代充），fee_card（话费软件代充）
page_no	Number	可选	1	默认值：1	页码。取值范围:大于零的整数;默认值:1。注：必须采用倒序的分页方式（从最后一页往回取）才能避免漏单问题。
page_size	Number	可选	40	默认值：40	每页条数。取值范围：1~100，默认值：40。建议使用40~50，可以提高成功率，减少超时数量。
use_has_next	Boolean	可选	true	默认值：false	是否启用has_next的分页方式，如果指定true,则返回的结果中不包含总记录数，但是会新增一个是否存在下一页的的字段，通过此种方式获取增量交易，效率在原有的基础上有80%的提升。

名称	类型	示例值	描述
total_results	Number	100	搜索到的交易信息总数
has_next	Boolean	true	是否存在下一页
trades	Trade []		搜索到的交易信息列表，返回的Trade和Order中包含的具体信息为入参fields请求的字段信息
└ seller_nick String 我在测试卖家昵称 └ buyer_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 └ sid String NP1021246146 物流运单号 └ tid Number 2231958349 交易编号 (父订单的交易编号) └ acookie_id String 1a11a0987628772c002ec7d0eec2a352 Acookie订单唯一ID。 └ 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 └ 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 使用信用卡支付金额数 └ 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 该订单需要延长收货时间订单出现异常问题的时候，给予用户的描述,没有异常的时候，此值为空 └ is_part_consign Boolean true 是否是多次发货的订单如果卖家对订单进行多次发货，则为true否则为false └ is_daixiao Boolean true 表示订单交易是否含有对应的代销采购单。如果该订单中存在一个对应的代销采购单，那么该值为true；反之，该值为false。 └ is_wt 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 子订单编号 └ 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 子订单的交易结束时间说明：子订单有单独的结束时间，与主订单的结束时间可能有所不同，在有退款发起的时候或者是主订单分阶段付款的时候，子订单的结束时间会早于主订单的结束时间，所以开放这个字段便于订单结束状态的判断 └ is_service_order Boolean true 是否是服务订单，是返回true，否返回false。 └ 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 发货的仓库编码 └ 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 天猫国际子订单包税金额 └ 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 服务图片地址 └ receiver_country String 中国收货人国籍 └ order_tax_fee String 0 天猫国际官网直供主订单关税税费 └ post_gate_declare Boolean true 邮关订单 └ cross_bonded_declare Boolean true 跨境订单 └ order_tax_promotion_fee String 0 天猫国际计税优惠金额 └ no_shipping Boolean false 无物流信息返回true，平台属性，业务不要依赖 └ aid String aid aid └ oaid String 2w2RYE45iahnF4aiaJ7pHKCJ3Hwnbgnq2PH3AfpQVyWZNHKS9wNgAAOUfCVt9XZMetogNHwc （收货人+手机号+座机+收货地址+create）5个字段组合成oaid，原始订单上座机为空也满足条件，否则生成不了oaid └ 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”代表是闲鱼渠道的订单

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TradesSoldIncrementvGetRequest req = new TradesSoldIncrementvGetRequest();
req.setFields("tid,type,status,payment,orders");
req.setStartCreate(StringUtils.parseDateTime("2000-01-01 00:00:00"));
req.setEndCreate(StringUtils.parseDateTime("2000-01-02 00:00:00"));
req.setStatus("TRADE_NO_CREATE_PAY");
req.setType("fixed");
req.setExtType("service");
req.setTag("time_card");
req.setPageNo(1L);
req.setPageSize(40L);
req.setUseHasNext(true);
TradesSoldIncrementvGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
TradesSoldIncrementvGetRequest req = new TradesSoldIncrementvGetRequest();
req.Fields = "tid,type,status,payment,orders";
req.StartCreate = DateTime.Parse("2000-01-01 00:00:00");
req.EndCreate = DateTime.Parse("2000-01-02 00:00:00");
req.Status = "TRADE_NO_CREATE_PAY";
req.Type = "fixed";
req.ExtType = "service";
req.Tag = "time_card";
req.PageNo = 1L;
req.PageSize = 40L;
req.UseHasNext = true;
TradesSoldIncrementvGetResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new TradesSoldIncrementvGetRequest;
$req->setFields("tid,type,status,payment,orders");
$req->setStartCreate("2000-01-01 00:00:00");
$req->setEndCreate("2000-01-02 00:00:00");
$req->setStatus("TRADE_NO_CREATE_PAY");
$req->setType("fixed");
$req->setExtType("service");
$req->setTag("time_card");
$req->setPageNo("1");
$req->setPageSize("40");
$req->setUseHasNext("true");
$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.incrementv.get' \
-d 'partner_id=apidoc' \
-d 'session=fa815b15-1c33-43ab-8139-35d8536881f1' \
-d 'sign=54ED7F458343A79EA87486909F2F88AE' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-11-04+06%3A30%3A47' \
-d 'v=2.0' \
-d 'end_create=2000-01-02+00%3A00%3A00' \
-d 'ext_type=service' \
-d 'fields=tid%2Ctype%2Cstatus%2Cpayment%2Corders' \
-d 'page_no=1' \
-d 'page_size=40' \
-d 'start_create=2000-01-01+00%3A00%3A00' \
-d 'status=TRADE_NO_CREATE_PAY' \
-d 'tag=time_card' \
-d 'type=fixed' \
-d 'use_has_next=true'

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

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

req.fields="tid,type,status,payment,orders"
req.start_create="2000-01-01 00:00:00"
req.end_create="2000-01-02 00:00:00"
req.status="TRADE_NO_CREATE_PAY"
req.type="fixed"
req.ext_type="service"
req.tag="time_card"
req.page_no=1
req.page_size=40
req.use_has_next=true
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.incrementv.get");
add_param(pRequest,"fields","tid,type,status,payment,orders");
add_param(pRequest,"start_create","2000-01-01 00:00:00");
add_param(pRequest,"end_create","2000-01-02 00:00:00");
add_param(pRequest,"status","TRADE_NO_CREATE_PAY");
add_param(pRequest,"type","fixed");
add_param(pRequest,"ext_type","service");
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");
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.incrementv.get', {
	'fields':'tid,type,status,payment,orders',
	'start_create':'2000-01-01 00:00:00',
	'end_create':'2000-01-02 00:00:00',
	'status':'TRADE_NO_CREATE_PAY',
	'type':'fixed',
	'ext_type':'service',
	'tag':'time_card',
	'page_no':'1',
	'page_size':'40',
	'use_has_next':'true'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<trades_sold_incrementv_get_response>
    <total_results>100</total_results>
    <has_next>true</has_next>
    <trades>
        <trade>
            <seller_nick>我在测试</seller_nick>
            <buyer_nick>我在测试</buyer_nick>
            <buyer_open_uid>AAHk5d-EAAeGwJedwSFu0XXX</buyer_open_uid>
            <title>麦包包</title>
            <type>fixed(一口价)</type>
            <created>2000-01-01 00:00:00</created>
            <sid>NP1021246146</sid>
            <tid>2231958349</tid>
            <acookie_id>1a11a0987628772c002ec7d0eec2a352</acookie_id>
            <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>
            <step_trade_status>FRONT_NOPAID_FINAL_NOPAID</step_trade_status>
            <step_paid_fee>525.70</step_paid_fee>
            <mark_desc>该订单需要延长收货时间</mark_desc>
            <is_part_consign>true</is_part_consign>
            <is_daixiao>true</is_daixiao>
            <is_wt>true</is_wt>
            <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>
                    <is_service_order>true</is_service_order>
                    <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>
                    <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>
                    <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>
                </service_order>
            </service_orders>
            <receiver_country>中国</receiver_country>
            <order_tax_fee>0</order_tax_fee>
            <post_gate_declare>true</post_gate_declare>
            <cross_bonded_declare>true</cross_bonded_declare>
            <order_tax_promotion_fee>0</order_tax_promotion_fee>
            <oaid>2w2RYE45iahnF4aiaJ7pHKCJ3Hwnbgnq2PH3AfpQVyWZNHKS9wNgAAOUfCVt9XZMetogNHwc</oaid>
            <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>
</trades_sold_incrementv_get_response>

{
    "trades_sold_incrementv_get_response":{
        "total_results":100,
        "has_next":true,
        "trades":{
            "trade":[
                {
                    "seller_nick":"我在测试",
                    "buyer_nick":"我在测试",
                    "buyer_open_uid":"AAHk5d-EAAeGwJedwSFu0XXX",
                    "title":"麦包包",
                    "type":"fixed(一口价)",
                    "created":"2000-01-01 00:00:00",
                    "sid":"NP1021246146",
                    "tid":2231958349,
                    "acookie_id":"1a11a0987628772c002ec7d0eec2a352",
                    "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",
                    "step_trade_status":"FRONT_NOPAID_FINAL_NOPAID",
                    "step_paid_fee":"525.70",
                    "mark_desc":"该订单需要延长收货时间",
                    "is_part_consign":true,
                    "is_daixiao":true,
                    "is_wt":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,
                                "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",
                                "is_service_order":true,
                                "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",
                                "sub_order_tax_fee":"0",
                                "sub_order_tax_rate":"0",
                                "zhengji_status":"1",
                                "sub_order_tax_promotion_fee":"0",
                                "tax_free":true,
                                "tax_coupon_discount":"0",
                                "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"
                            }
                        ]
                    },
                    "receiver_country":"中国",
                    "order_tax_fee":"0",
                    "post_gate_declare":true,
                    "cross_bonded_declare":true,
                    "order_tax_promotion_fee":"0",
                    "oaid":"2w2RYE45iahnF4aiaJ7pHKCJ3Hwnbgnq2PH3AfpQVyWZNHKS9wNgAAOUfCVt9XZMetogNHwc",
                    "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"
                }
            ]
        }
    }
}

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.r2-security-authorize-invalid	没有权限获取买家收货地址信息字段	提高应用安全等级，如果应用等级已达到要求，则让用户重新授权，以延长R2数据获取的授权时长。
isv.invalid-parameter:start_modified-and-end_modified	开始时间和结束时间范围不符合要求	开始时间与结束时间的范围必须小于一天

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

淘宝交易API

taobao.trades.sold.incrementv.get (查询卖家已卖出的增量交易数据（根据入库时间）)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ