搜索当前会话用户作为卖家已卖出的增量交易数据(只能获取到三个月以内的交易信息)
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 | 限流 | 避开限流 |