查询卖家已卖出的增量交易数据
查询卖家已卖出的增量交易数据(根据订单修改时间)
搜索当前会话用户作为卖家已卖出的增量交易数据(只能获取到三个月以内的交易信息)
- 一次请求只能查询时间跨度为一天的增量交易记录,即end_modified - start_modified <= 1天。
- 返回的数据结果是以订单的修改时间倒序排列的,通过从后往前翻页的方式可以避免漏单问题。
- 返回的数据结果只包含了订单的部分数据,可通过《 获取订单详情》接口获取订单详情。
1.请求参数:
请求URL:
POST https://kf.fw199.com/gateway/taobao/order/increment/list
参数名 | 类型 | 说明 | 示例 |
---|---|---|---|
appid | String | 合作伙伴AppId | uwkahf@jfs92 |
timestamp | String | 当前时间戳 | |
tb_seller_nick | String | 淘宝卖家店铺登录账号,非店铺名称 | kingdo |
sign | String | 接口签名 | 如何计算生成见示例代码 |
start_modified | 必填, Date | 查询修改开始时间(修改时间跨度不能大于一天)。格式:yyyy-MM-dd HH:mm:ss | |
end_modified | 必填, Date | 查询修改结束时间,必须大于修改开始时间(修改时间跨度不能大于一天),格式:yyyy-MM-ddHH:mm:ss。建议使用30分钟以内的时间跨度,能大大提高响应速度和成功率。 | |
type | 非必填, String | 一次查询多种类型可用半角逗号分隔,默认同时查询guarantee_trade,auto_delivery,ec,cod,step这5种类型的数据。 | |
buyer_nick | 非必填, String | 买家昵称,如果不按某个买家查询,此值可传空字符串 | |
ext_type | 非必填, String | 可选值有ershou(二手市场的订单),service(商城服务子订单)mark(双十一大促活动异常订单)作为扩展类型筛选只能做单个ext_type查询,不能全部查询所有的ext_type类型 | |
tag | 非必填, String | 卖家对交易的自定义分组标签,目前可选值为:time_card(点卡软件代充),fee_card(话费软件代充) | |
status | 非必填, String | 可选, 交易状态 ,默认查询所有交易状态的数据, 除了默认值外每次只能查询一种状态。WAIT_BUYER_PAY:等待买家付款 WAIT_SELLER_SEND_GOODS:等待卖家发货 、 SELLER_CONSIGNED_PART:卖家部分发货 WAIT_BUYER_CONFIRM_GOODS:等待买家确认收货 TRADE_BUYER_SIGNED:买家已签收(货到付款专用) TRADE_FINISHED:交易成功 TRADE_CLOSED:交易关闭 | |
page_no | 必填, int | 可选, 当前页,默认1 | |
page_size | 必填,int | 可选, 每页大小, 最大30 | |
use_has_next | 必填 bool | 是否启用has_next的分页方式,如果指定true,则返回的结果中不包含总记录数,但是会新增一个是否存在下一页的的字段,通过此种方式获取增量交易,接口调用成功率在原有的基础上有所提升。 | |
include_oaid | 非必填, String | appkey未对接oaid加密,则忽略该字段。对接oaid加密情况下,(收货人+手机号+座机+收货地址+create)5个字段组合成oaid,原始订单上座机为空也满足条件。传true,代表必须返回oaid,生成不了就报isv.oaid-field-miss错误;默认或者传false,满足生成条件则返回oaid,否则为空 | |
sysid | String | 可空, 代表不同的应用,具体请咨询客服 |
2. 请求示例代码(Java)
@Test
public void getIncrementTradeList() throws Exception {
String tb_seller_nick = Config.TBSellerNick; //要查询的淘宝商家
//业务参数
Map<String, String> data = new HashMap<String, String>();
data.put("appid", Config.AppId);
// data.put("sysid", "103"); // 代表不同的应用,具体请咨询客服
data.put("tb_seller_nick", tb_seller_nick);
Long timestamp = System.currentTimeMillis() / 1000;
data.put("timestamp", timestamp.toString());
// 订单修改的开始时间和结束时间不要超过24小时
data.put("start_modified", "2021-04-14 08:35:00");
data.put("end_modified", "2021-04-14 11:55:00");
data.put("status", "WAIT_SELLER_SEND_GOODS");
data.put("page_no", "1");
data.put("page_size","20");
data.put("use_has_next","true");
data.put("sign", Utils.Sign(data,Config.AppSecret));
// 调用服务API
long startTime = System.currentTimeMillis(); //获取开始时间
doHttpRequest(Config.TaoBaoTradeIncrementListUrl ,data);
long endTime = System.currentTimeMillis(); //获取结束时间
}
3. 返回结果如下:
{
"code": 0,
"message": "ok",
"data": {
"request_id": "16j1lcw71r4s3",
"total_results": 0,
"has_next": false,
"trades": {
"trade": [{
"adjust_fee": "0.00",
"buyer_nick": "supercode",
"buyer_rate": false,
"created": "2021-04-06 16:53:17",
"discount_fee": "0.00",
"modified": "2021-04-14 10:33:50",
"num": 1,
"num_iid": 544876335798,
"orders": {
"order": [{
"adjust_fee": "0.00",
"buyer_rate": false,
"cid": 50015766,
"discount_fee": "0.00",
"divide_order_fee": "1.50",
"part_mjz_discount": "",
"is_daixiao": false,
"num": 1,
"num_iid": 544876335798,
"oid": "1703612053256565830",
"outer_iid": "lianhua007",
"outer_sku_id": "white35",
"payment": "6.50",
"pic_path": "https://img.alicdn.com/bao/uploaded/i2/661153176/TB23bWverBmpuFjSZFuXXaG_XXa_!!661153176.jpg",
"price": "1.50",
"refund_status": "NO_REFUND",
"seller_rate": false,
"seller_type": "C",
"sku_id": "3977338583166",
"sku_properties_name": "尺码:35;颜色:white",
"status": "WAIT_SELLER_SEND_GOODS",
"title": "联华超市提取货券xx",
"total_fee": "1.50"
}]
},
"pay_time": "2021-04-06 16:53:22",
"payment": "6.50",
"pic_path": "https://img.alicdn.com/bao/uploaded/i2/661153176/TB23bWverBmpuFjSZFuXXaG_XXa_!!661153176.jpg",
"post_fee": "5.00",
"price": "1.50",
"received_payment": "0.00",
"receiver_address": "世纪大道200号", // 收货人的详细地址
"receiver_city": "上海市", // 城市
"receiver_town":"XX镇", //收件人镇
"receiver_district": "浦东新区", // 区
"receiver_mobile": "13816121231", //收货人手机
"receiver_phone": "",
"receiver_name": "陈先生", //收货人姓名
"receiver_state": "上海", // 收货人省份
"receiver_zip": "200120", //收货人邮编
"seller_flag": 4,
"has_buyer_message":true, //是否有买家留言 ,如果是的话,可通过订单详情接口获取具体的买家留言。
"seller_nick": "百鞋馆",
"seller_rate": false,
"shipping_type": "post",
"status": "WAIT_SELLER_SEND_GOODS",
"tid": "1703612053256565830",
"title": "d[s64535320]",
"total_fee": "1.50",
"type": "fixed",
"oaid": "1h12M4LqkhUkt1ibEk6VyZv2gRsECYSQayzH33CwBP1s3CmkVyx1m4SItNJ6ZhgUibyzr9RA",
"buyer_open_uid":"AAEt90gYAAjcqSrFKsJnK_Ba"
}]
}
}
}
说明: code为0表示成功,非0为失败,message会包含失败原因。 data字段包含订单列表的数据。
4. 增量同步的优势
比如,在同步订单时候, 已经把早上的5:00到12:00的订单都同步到本地的,如果用户在12:01回头对早上8:30有个订单进行修改了(比如插旗了,或是订单状态改变了),此时,获取订单的时候不需要重新从早上5:00开始同步了,只要从12:00以后开始获取,也能获取到早上那笔被修改订单。因此对于只需要记住最后一次同步时间即可,作为作为下次拉单的开始时间。
文档更新时间: 2023-10-18 16:51 作者:admin