获取订单列表

（ASCP供应链中台）订单列表查看（卖家视角）

一、请求参数

请求URL:

POST https://kf.fw199.com/gateway/1688/c2m/trade/list

参数名	类型	必须	示例值	说明
appid	String	true	uwkahf@jfs92	合作伙伴AppId
timestamp	String	true	1633618722	当前时间戳
seller_nick	String	true	kingdo	1688账号
sign	String	true	999de41d862efaa6f1084ead3b3ba480	如何计算生成见示例代码
modifyStartTime	Date	false	查询修改时间开始，不传默认只返回近1个月内更新的订单。格式:yyyy-MM-dd HH:mm:ss，比如2025-11-13 20:00:00
modifyEndTime	Date	false	查询修改时间结束。格式:yyyy-MM-dd HH:mm:ss, 比如2025-11-13 20:00:00
orderStatus	String	false	订单状态，仅支持 waitsellersend(等待卖家发货)
page	int	true	查询分页页码，从1开始
pageSize	int	true	查询的每页的数量(最高20)

二、请求示例代码

Java

@Test
    public void  GetC2MOrderList() throws Exception {
                   String seller_nick = Config.alibabaSellerNick;
                    //业务参数
                    Map<String, String> data = new HashMap<String, String>();
                    data.put("appid", Config.AppId);
                    data.put("seller_nick", seller_nick);
                    Long timestamp = System.currentTimeMillis() / 1000;
                    data.put("timestamp", timestamp.toString());
        data.put("modifyEndTime", "2024-05-28 00:00:00");
                    data.put("modifyStartTime", "2025-11-10 00:00:00");
                    data.put("modifyEndTime", "2025-11-15 00:00:00");
                    data.put("orderStatus", "waitsellersend");
                    data.put("page", "1");
                    data.put("pageSize", "20");
                    data.put("sign", Utils.Sign(data, Config.AppSecret));
                    // 调用服务API
                    String response = doHttpRequest(Config.GetC2MOrderListUrl, data);

    }

三、返回结果

返回结果如下

{
    "code": 0,
    "message": "ok",
    "data": {
        "result": [
            {
                "baseInfo": {
                    "currency": "CNY",
                    "id": "4840012476826445633",
                    "modifyTime": "20251029163218000+0800",
                    "createTime": "20251027161403000+0800",
                    "receivingTime": null,
                    "allDeliveredTime": null,
                    "completeTime": null,
                    "buyerContact": {
                        "name": "七*",
                        "mobile": "13*******27",
                        "phone": null,
                        "province": "浙江省",
                        "city": "台州市",
                        "area": "黄岩区",
                        "town": "西城街道",
                        "address": "西城街道汇江新村*幢一单元*",
                        "zip": "000000",
                        "caid": null,
                        "oaid": "2110s55ZfKvF2FRMbcc5NnQhLjzSK1wIR3YSobu794jjWmBY5Sh7ZiarQJDsJ4KAJg9La5uWrs46pxBZ6QN6bC8k1ibG8oeK0"
                    },
                    "status": "waitsellersend",
                    "refundStatus": "",
                    "remark": null,
                    "ascpSupplierId": "1000000000353948",
                    "shippingFee": "0",
                    "totalAmount": "306",
                    "ascpSupplierName": "义乌市利多邦臣包装有限公司",
                    "payTime": "20251027161408000+0800"
                },
                "productItems": [
                    {
                        "productID": 939682261797,
                        "skuID": 6002552247254,
                        "name": "【优惠价】红领巾小学生纯棉1m通用初中生大号透气1.2米成人标准小号1-3年级少先队员",
                        "quantity": "1",
                        "productImgUrl": [
                            "https://img.alicdn.com/imgextra/i2/2215813595337/O1CN011M6qHG1pIOrpULlsp_!!2215813595337-0-scmitem176000.jpg"
                        ],
                        "status": "waitsellersend",
                        "skuInfos": [
                            {
                                "name": "颜色分类",
                                "value": "【涤棉抗皱透气】1.2米/1条"
                            }
                        ],
                        "subItemID": "4840012476826445633",
                        "refundId": null,
                        "refundStatus": null,
                        "itemAmount": "306",
                        "cargoNumber": null,
                        "productCargoNumber": null,
                        "extendFields": null,
                        "productItemExtendFields": null,
                        "productItemExtendsFileds": [
                            {
                                "key": "consignTime",
                                "value": "2_2"
                            }
                        ]
                    }
                ]
            }
        ],
        "errorCode": null,
        "errorMessage": null,
        "totalRecord": 5,
        "success": true
    },
    "trace_id": "e527747a-22c5-40fb-bf77-e0d87fe27b80"
}

说明： code为0表示成功，非0为失败，message会包含失败原因。 返回的字段说明见文档