获取订单列表v2

获取商家视角的订单列表数据。若此API调用超时，请减少筛选条件，并将orderViewStatus值设置为1后重试 建议使用《获取订单列表增强型》接口，查询条件更全，同时返回oaid（用于合单）

一、请求参数

请求URL:

POST https://kf.fw199.com/gateway/ks/order/cursor/list

公共参数

参数名称	参数类型	是否必须	示例值	参数描述
appid	String	是		合作伙伴AppId
timestamp	String	是	1657525936	当前Unix时间戳，秒
seller_nick	String	是	38173182	快手的店铺账号，对应蜂巢授权返回seller_nick字段
sign	String	是

业务参数

参数名	类型	必须	示例值	详情描述
orderViewStatus	Integer	是	1	订单状态，0未知 1 全部 2 待付款 3 待发货 4 待收货（已发货）5 已收货 6 交易成功订单 7 已关闭订单。若此API返回超时，请传入1后重试
pageSize	Integer	是	10	每页请求数量 最多一页50条
sort	Integer	否	1	1时间降序 2时间升序 默认降序
queryType	Integer	否	1	1按创建时间查找 2按更新时间查找 默认创建时间
beginTime	Long	是	1543817629000	订单生成时间的开始时间，单位毫秒， 不能小于90天前，且需要小于结束时间
endTime	Long	是	1543817629000	订单生成时间的截止时间，单位毫秒，与开始时间的时间范围不大于7天
cpsType	Integer	否	1	分销类型 0-全部 1-普通订单 2-分销订单
cursor	String	是	157356441188_2021345676543	游标内容 第一次传空串，之后传上一次的cursor返回值，若返回“nomore”则标识到底

二、请求示例代码

Java

请求示例代码

@Test
public void getOrderList() throws Exception {
    String sellerNick = Config.KSSellerNick ;
    //业务参数
    Map<String, String> data = new HashMap();
    data.put("appid",  Config.AppId);
    data.put("seller_nick", sellerNick);
    Long timestamp = System.currentTimeMillis();
    data.put("timestamp", timestamp.toString());
    data.put("orderViewStatus","1");//订单状态，0未知 1 全部 2 待付款 3 待发货 4 待收货（已发货）5 已收货 6 交易成功订单 7 已关闭订单
    data.put("pageSize","10");//每页请求数量 最多一页50条
    data.put("sort","1" );//1时间降序 2时间升序 默认降序
    data.put("queryType","2" );//1按创建时间查找 2按更新时间查找 默认创建时间
    long beginTime = System.currentTimeMillis() -  89 * 24 * 60 * 60 *60; //7天以前
    data.put("beginTime", String.valueOf(beginTime));//订单生成时间的开始时间，单位毫秒， 不能小于90天前，且需要小于结束时间
    data.put("endTime", String.valueOf(System.currentTimeMillis()));//订单生成时间的截止时间，单位毫秒，与开始时间的时间范围不大于7天
    data.put("cpsType","0");//分销类型 0-全部 1-普通订单 2-分销订单
    data.put("cursor","" );//游标内容 第一次传空串，之后传上一次的cursor返回值，若返回“nomore”则标识到底
    // 参数签名
    data.put("sign", Utils.Sign(data, Config.AppSecret));
    String result = doHttpRequest(Config.KS_OPEN_ORDER_CURSOR_LIST, data);
    System.out.println("result:"+result);
}

三、返回结果

{
    "code": 0,
    "message": "ok",
    "data": {
        "beginTime": 1687155382641,
        "cursor": "1687251104545_2307500074108220",
        "endTime": 1687616758641,
        "orderList": [
            {
                "orderAddress": {
                    "city": "济南市",
                    "cityCode": 3701,
                    "desensitiseAddress": "**街道文化北路**号城发广场北楼****",
                    "desensitiseConsignee": "张**",
                    "desensitiseMobile": "185****8838",
                    "district": "莱芜区",
                    "districtCode": 370116,
                    "encryptedAddress": "~AjbKvY9u2S0CIAjAg1ZIexIqfPKO6hgRofbOM d9DpOEeBcnFPXfcWQXxutG2+GokyVaSdOEjRx3EgvZUZmH6EtyTWYIrXI+KHHiBoSdqTI4uScWeRNhpufIaPxwnDQIiCRhRcW6NTVEjZ+fOGyRmacHH0WduADwFHw5JNjATWxnigFMAE=~1~~",
                    "encryptedConsignee": "#YM+/f/VLf/VL#Ci1tZXJjaGFudC5vcGVuLnNlY3JldC5rZXkua3M2ODk2MTM2OTY3MzMyMTA0NzASIClEZa/OIxdiE6iDweZzImdB6oub4ghKR5ja55sEThgOGhIbNd EItSgFMAE=#1##",
                    "encryptedMobile": "$hgj0WBf4KDketN0trlrGWCivd4lGiRW76Ndomhp9c4E=$Ci1tZXJjaGFudC5vcGVuLnNlY3JldC5rZXkua3M2ODk2MTM2OTY3MzMyMTA0NzASIMOQS058ASctlOTv7vZUN4 9XDc8Rpbb63S0kPwlMpFJIjtPxsHeV0SgFMAE=$1$$",
                    "province": "山东省",
                    "provinceCode": 37
                },
                "orderBaseInfo": {
                    "activityType": 1,
                    "buyerImage": "http://p5.a.yximgs.com/s1/i/def/head_f.png",
                    "buyerNick": "A张张💖会计",
                    "buyerOpenId": "f198f0846993046e14bf572410405c46",
                    "coType": 0,
                    "commentStatus": 0,
                    "cpsType": 1,
                    "createTime": 1678975518244,
                    "disableDeliveryReasonCode": [],
                    "discountFee": 0,
                    "expressFee": 0,
                    "oid": 2307500074108220,
                    "orderSellerRoleInfo": {
                        "roleId": 2589256601,
                        "roleName": "刻骨铭心的爱情",
                        "roleType": 1
                    },
                    "payChannel": "ALIPAY_HB",
                    "payTime": 1678975524473,
                    "payType": 2,
                    "preSale": 0,
                    "priorityDelivery": false,
                    "promiseTimeStampOfDelivery": 1679148324473,
                    "recvTime": 0,
                    "refundTime": 1681238763008,
                    "remark": "",
                    "remindShipmentSign": 0,
                    "remindShipmentTime": 0,
                    "riskCode": 0,
                    "sellerDelayPromiseTimeStamp": 1679148324473,
                    "sellerNick": "刻骨铭心的爱情",
                    "sellerOpenId": "f198f0846993046e14bf572443812bdb",
                    "sendTime": 0,
                    "status": 80,
                    "theDayOfDeliverGoodsTime": 120,
                    "totalFee": 10,
                    "updateTime": 1687251104545,
                    "validPromiseShipmentTimeStamp": 1679148324473
                },
                "orderDeliveryInfo": {
                    "enableAppendPackage": false,
                    "maxPackageNum": 20
                },
                "orderItemInfo": {
                    "discountFee": 0,
                    "goodsCode": "",
                    "itemExtra": {
                        "categoryInfo": {
                            "categoryName": "其他日用",
                            "itemCid": 2995
                        }
                    },
                    "itemId": 3655213008601,
                    "itemLinkUrl": "https://app.kwaixiaodian.com/merchant/shop/detail?id=3655213008601\u0026hyId=kwaishop\u0026layoutType=4",
                    "itemPicUrl": "https://u1-201.ecukwai.com/ufile/adsocial/6195808d-8969-46a5-a7e9-bb506c95e856.jpg",
                    "itemTitle": "专用的回形针",
                    "itemType": 1,
                    "num": 1,
                    "orderItemId": 66728722091220,
                    "originalPrice": 10,
                    "price": 10,
                    "relItemId": 3655213008601,
                    "relSkuId": 0,
                    "skuDesc": "白色",
                    "skuId": 4810616922601,
                    "skuNick": "",
                    "warehouseCode": ""
                },
                "orderLogisticsInfo": [],
                "orderNote": {
                    "orderNoteInfo": [
                        {
                            "createTime": 1687251104542,
                            "note": "备注"
                        },
                        {
                            "createTime": 1687251023282,
                            "note": "备注"
                        },
                        {
                            "createTime": 1687016607061,
                            "note": "11了"
                        },
                        {
                            "createTime": 1687016142697,
                            "note": "我用红"
                        },
                        {
                            "createTime": 1687015636455,
                            "note": "222222"
                        },
                        {
                            "createTime": 1687015251684,
                            "note": "222"
                        },
                        {
                            "createTime": 1687006331899,
                            "note": "vip用户"
                        }
                    ],
                    "sellerNote": [
                        "备注",
                        "备注",
                        "11了",
                        "我用红",
                        "222222",
                        "222",
                        "vip用户"
                    ]
                },
                "orderRefundList": [
                    {
                        "refundId": 2310200046841220,
                        "refundStatus": 60
                    }
                ]
            }
        ],
        "pageSize": 1
    }
}
result: {
    "code": 0,
    "message": "ok",
    "data": {
        "beginTime": 1687155382641,
        "cursor": "1687251104545_2307500074108220",
        "endTime": 1687616758641,
        "orderList": [
            {
                "orderAddress": {
                    "city": "济南市",
                    "cityCode": 3701,
                    "desensitiseAddress": "**街道文化北路**号城发广场北楼****",
                    "desensitiseConsignee": "张**",
                    "desensitiseMobile": "185****8838",
                    "district": "莱芜区",
                    "districtCode": 370116,
                    "encryptedAddress": "~AjbKvY9u2S0CIAjAg1ZIexIqfPKO6hgRo wnDQIiCRhRcW6NTVEjZ+fOGyRmacHH0WduADwFHw5JNjATWxnigFMAE=~1~~",
                    "encryptedConsignee": "#YM+/f/VLf/VL#Ci1tZXJjaGFudC5vcGVuL hDBEItSgFMAE=#1##",
                    "encryptedMobile": "$hgj0WBf4KDketN0trlrGWCivd4lGiRW7 tt5isQYOM9XDc8Rpbb63S0kPwlMpFJIjtPxsHeV0SgFMAE=$1$$",
                    "province": "山东省",
                    "provinceCode": 37
                },
                "orderBaseInfo": {
                    "activityType": 1,
                    "buyerImage": "http://p5.a.yximgs.com/s1/i/def/head_f.png",
                    "buyerNick": "A张张💖会计",
                    "buyerOpenId": "f198f0846993046e14bf572410405c46",
                    "coType": 0,
                    "commentStatus": 0,
                    "cpsType": 1,
                    "createTime": 1678975518244,
                    "disableDeliveryReasonCode": [],
                    "discountFee": 0,
                    "expressFee": 0,
                    "oid": 2307500074108220,
                    "orderSellerRoleInfo": {
                        "roleId": 2589256601,
                        "roleName": "刻骨铭心的爱情",
                        "roleType": 1
                    },
                    "payChannel": "ALIPAY_HB",
                    "payTime": 1678975524473,
                    "payType": 2,
                    "preSale": 0,
                    "priorityDelivery": false,
                    "promiseTimeStampOfDelivery": 1679148324473,
                    "recvTime": 0,
                    "refundTime": 1681238763008,
                    "remark": "",
                    "remindShipmentSign": 0,
                    "remindShipmentTime": 0,
                    "riskCode": 0,
                    "sellerDelayPromiseTimeStamp": 1679148324473,
                    "sellerNick": "刻骨铭心的爱情",
                    "sellerOpenId": "f198f0846993046e14bf572443812bdb",
                    "sendTime": 0,
                    "status": 80,
                    "theDayOfDeliverGoodsTime": 120,
                    "totalFee": 10,
                    "updateTime": 1687251104545,
                    "validPromiseShipmentTimeStamp": 1679148324473
                },
                "orderDeliveryInfo": {
                    "enableAppendPackage": false,
                    "maxPackageNum": 20
                },
                "orderItemInfo": {
                    "discountFee": 0,
                    "goodsCode": "",
                    "itemExtra": {
                        "categoryInfo": {
                            "categoryName": "其他日用",
                            "itemCid": 2995
                        }
                    },
                    "itemId": 3655213008601,
                    "itemLinkUrl": "https://app.kwaixiaodian.com/merchant/shop/detail?id=3655213008601\u0026hyId=kwaishop\u0026layoutType=4",
                    "itemPicUrl": "https://u1-201.ecukwai.com/ufile/adsocial/6195808d-8969-46a5-a7e9-bb506c95e856.jpg",
                    "itemTitle": "专用的回形针",
                    "itemType": 1,
                    "num": 1,
                    "orderItemId": 66728722091220,
                    "originalPrice": 10,
                    "price": 10,
                    "relItemId": 3655213008601,
                    "relSkuId": 0,
                    "skuDesc": "白色",
                    "skuId": 4810616922601,
                    "skuNick": "",
                    "warehouseCode": ""
                },
                "orderLogisticsInfo": [],
                "orderNote": {
                    "orderNoteInfo": [
                        {
                            "createTime": 1687251104542,
                            "note": "备注"
                        },
                        {
                            "createTime": 1687006331899,
                            "note": "vip用户"
                        }
                    ],
                    "sellerNote": [
                        "备注",
                        "vip用户"
                    ]
                },
                "orderRefundList": [
                    {
                        "refundId": 2310200046841220,
                        "refundStatus": 60
                    }
                ]
            }
        ],
        "pageSize": 1
    }
}

四、返回字段说明

返回字段说明见官方文档： https://open.kwaixiaodian.com/docs/api?categoryId=43&apiName=open.order.cursor.list&version=1