获取订单列表

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

1.请求参数:

请求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)

2. 请求示例代码(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);

    }

3. 返回结果

返回结果如下

{
    "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会包含失败原因。 返回的字段说明见文档

文档更新时间: 2025-11-14 11:09   作者:admin