搜索当前会话用户作为卖家已卖出的增量交易数据(只能获取到三个月以内的交易信息)
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请求的字段信息 | |
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 | 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()); |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 | < 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 > < 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 > < 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 > < 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 > |
1 2 3 4 5 6 | < 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 | 限流 | 避开限流 |