ircloud-assistant/skills/irun-yidianhuo/product.md

商品查询接口

1. 商品列表（SKU）

GET https://openapi.77ircloud.com/product-aggregation/products/sku?pageNum=1&pageSize=10

Header: access_token: {token}

Query 参数：

• pageNum: 页码
• pageSize: 每页数量（建议不超过100）
• keyword: 可选，按商品名称模糊搜索
• categoryId: 可选，按分类ID筛选

返回：

{
  "code": 200,
  "data": {
    "totalCount": 1024,
    "currentPage": 1,
    "pageSize": 10,
    "items": [
      {
        "skuId": 2116792188293408,
        "spuId": 2116792188162336,
        "code": "101-030-0008",
        "name": "霜火果子（柿子+花生）",
        "categoryId": 2116766652419584,
        "categoryName": "水产生品类",
        "brandId": 2116767991238144,
        "brandName": "其他品牌",
        "unitId": 2116753910024416,
        "unitName": "个",
        "status": 23,
        "price": 9.3
      }
    ]
  }
}

关键字段：

• skuId: 商品SKU ID，用于库存查询
• status: 商品状态

---

2. 商品授权方案列表

GET https://openapi.77ircloud.com/product-aggregation/authorizations

Header: access_token: {token}

返回：

{
  "code": 200,
  "data": {
    "totalCount": 4,
    "items": [
      {"id": 2116753910171872, "name": "默认授权方案"},
      {"id": 2117317654711808, "name": "南宁分公司无商品"}
    ]
  }
}

---

3. skuId 增量更新列表（注意：调用报400参数错误，暂时跳过）

GET https://openapi.77ircloud.com/product-aggregation/sku/pull?pageNum=1&pageSize=10

Header: access_token: {token}

⚠️ 状态：调用返回 illegal parameters!，参数格式待进一步排查。当前可跳过此接口，用商品列表代替。

---

4. 价格等级列表

见 basics.md — /product-aggregation/level-prices