查询卖家已卖出的增量交易数据

查询卖家已卖出的增量交易数据(根据订单修改时间)
搜索当前会话用户作为卖家已卖出的增量交易数据(只能获取到三个月以内的交易信息)

  1. 一次请求只能查询时间跨度为一天的增量交易记录,即end_modified - start_modified <= 1天。
  2. 返回的数据结果是以订单的修改时间倒序排列的,通过从后往前翻页的方式可以避免漏单问题。
  3. 返回的数据结果只包含了订单的部分数据,可通过《 获取订单详情》接口获取订单详情。

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