获取增量订单列表

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

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

一次请求只能查询时间跨度为一天的增量交易记录，即end_modified - start_modified <= 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	可空，代表不同的应用，具体请咨询客服

二、请求示例代码

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(); //获取结束时间

    }

三、返回结果

{
    "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字段包含订单列表的数据。

四、增量同步的优势

比如，在同步订单时候，已经把早上的5：00到12：00的订单都同步到本地的，如果用户在12：01回头对早上8：30有个订单进行修改了（比如插旗了，或是订单状态改变了），此时，获取订单的时候不需要重新从早上5：00开始同步了，只要从12：00以后开始获取，也能获取到早上那笔被修改订单。因此对于只需要记住最后一次同步时间即可，作为作为下次拉单的开始时间。