搜索当前会话用户作为卖家已卖出的增量交易数据(只能获取到三个月以内的交易信息)
1. 一次请求只能查询时间跨度为一天的增量交易记录,即end_modified - start_modified <= 1天。
2. 返回的数据结果是以订单的修改时间倒序排列的,通过从后往前翻页的方式可以避免漏单问题。
3. 返回的数据结果只包含了订单的部分数据,可通过taobao.trade.simple.get获取订单详情。
点击查看更多交易API说明
| 名称 | 类型 | 是否必须 | 示例值 | 更多限制 | 描述 |
|---|---|---|---|---|---|
| fields | String | 必须 | tid,type,status,payment,orders,rx_audit_status | 需要返回的字段列表,多个字段用半角逗号分隔,可选值为返回示例中能看到的所有字段。rx_audit_status=0为处方药未审核状态 | |
| start_modified | Date | 必须 | 2000-01-01 00:00:00 | 查询修改开始时间(修改时间跨度不能大于一天)。格式:yyyy-MM-dd HH:mm:ss | |
| end_modified | 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类型 | |
| buyer_nick | String | 可选 | zhangsan | 买家昵称 | |
| 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。注:必须采用倒序的分页方式(从最后一页往回取)才能避免漏单问题。 |
| page_size | Number | 可选 | 40 |
|
每页条数。取值范围:1~100,默认值:40。建议使用40~50,可以提高成功率,减少超时数量。 |
| use_has_next | Boolean | 可选 | true |
|
是否启用has_next的分页方式,如果指定true,则返回的结果中不包含总记录数,但是会新增一个是否存在下一页的的字段,通过此种方式获取增量交易,效率在原有的基础上有80%的提升。 |
| buyer_open_uid | String | 可选 | AAHm5d-EAAeGwJedwSHpg8bT | 用户openId |
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| total_results | Number | 100 | 搜索到的交易信息总数 |
| has_next | Boolean | true | 是否存在下一页 |
| trades | Trade [] | 搜索到的交易信息列表,返回的Trade和Order中包含的具体信息为入参fields请求的字段信息 | |
|
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TradesSimpleSoldIncrementGetRequest req = new TradesSimpleSoldIncrementGetRequest();
req.setFields("tid,type,status,payment,orders,rx_audit_status");
req.setStartModified(StringUtils.parseDateTime("2000-01-01 00:00:00"));
req.setEndModified(StringUtils.parseDateTime("2000-01-02 00:00:00"));
req.setStatus("TRADE_NO_CREATE_PAY");
req.setType("fixed");
req.setExtType("service");
req.setBuyerNick("zhangsan");
req.setRateStatus("RATE_UNBUYER");
req.setTag("time_card");
req.setPageNo(1L);
req.setPageSize(40L);
req.setUseHasNext(true);
req.setBuyerOpenUid("AAHm5d-EAAeGwJedwSHpg8bT");
TradesSimpleSoldIncrementGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());
<trades_simple_sold_increment_get_response>
<total_results>100</total_results>
<has_next>true</has_next>
<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>
<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>
<buyer_area>浙江省杭州市</buyer_area>
<pic_path>http://img08.taobao.net/bao/uploaded/i8/T1jVXXXePbXXaoPB6a_091917.jpg</pic_path>
<num_iid>3424234</num_iid>
<price>200.07</price>
<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_state>浙江省</receiver_state>
<receiver_city>杭州市</receiver_city>
<seller_flag>1</seller_flag>
<has_buyer_message>true</has_buyer_message>
<step_trade_status>FRONT_NOPAID_FINAL_NOPAID</step_trade_status>
<step_paid_fee>525.70</step_paid_fee>
<mark_desc>该订单需要延长收货时间</mark_desc>
<trade_source>ownshop</trade_source>
<send_time>2000-01-01</send_time>
<seller_can_rate>true</seller_can_rate>
<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>
</order>
</orders>
<service_orders>
<service_orders>
<oid>110770592823138</oid>
<item_oid>110770592803138</item_oid>
<service_id>2342344</service_id>
<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>
<tmser_spu_code>家装干支装服务</tmser_spu_code>
</service_orders>
</service_orders>
<rx_audit_status>0</rx_audit_status>
<is_part_consign>false</is_part_consign>
<ouid>AAH9AfnvAAAscvMAAdIYdWLD</ouid>
<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>
</trade>
</trades>
</trades_simple_sold_increment_get_response>
<error_response>
<code>50</code>
<msg>Remote service error</msg>
<sub_code>isv.invalid-parameter</sub_code>
<sub_msg>非法参数</sub_msg>
</error_response>
| 错误码 | 错误描述 | 解决方案 |
|---|---|---|
| isv.invalid-parameter:start_modified-and-end_modified | 查询条件(修改时间)跨度不能超过一天 | 只能查询3个月内并且跨度为一天的修改过的数据 |
| isv.invalid-parameter:buyer_nick | buyer_nick无效 | 请填写正确的buyer_nick。 |
| isp.call-limited | 限流 | 避开限流 |