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

基础数据查询接口

1. 仓库列表

GET https://openapi.77ircloud.com/invoicing-aggregation/warehouses

Header: access_token: {token}

返回：

{
  "code": 200,
  "data": {
    "totalCount": 11,
    "currentPage": 1,
    "pageSize": 20,
    "totalPage": 1,
    "items": [
      {
        "id": 2116753909958624,
        "code": "00000001",
        "name": "总部仓库",
        "type": 1,
        "status": 1,
        "orgId": 3607084,
        "orgName": "总部"
      }
    ]
  }
}

用途： 查询仓库列表，取 items[].id 作为 warehouseId（库存查询必填）

---

2. 员工列表

POST https://openapi.77ircloud.com/organization-aggregation/employees/search

Header: access_token: {token} + Content-Type: application/json

Body：

{"pageNum": 1, "pageSize": 20}

返回：

{
  "code": 200,
  "data": {
    "items": [
      {"id": 22652291, "name": "周总", "phone": "136xxx", "role": "MANAGER"}
    ]
  }
}

---

3. 商品单位列表

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

Header: access_token: {token}

返回：

{
  "code": 200,
  "data": [
    {"id": 2116753910024416, "name": "个"},
    {"id": 2116753910040800, "name": "箱"},
    {"id": 2116753910057184, "name": "件"}
  ]
}

---

4. 商品分类列表

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

Header: access_token: {token}

返回：

{
  "code": 200,
  "data": [
    {"id": 2116753909967072, "name": "通用", "parentId": 0},
    {"id": 2116766451460320, "name": "特价活动", "parentId": 0},
    {"id": 2116766567037824, "name": "水产生品类", "parentId": 0}
  ]
}

---

5. 商品品牌列表

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

Header: access_token: {token}

返回：

{
  "code": 200,
  "data": [
    {"id": 2116767916034272, "name": "意食客"},
    {"id": 2116767991238144, "name": "其他品牌"}
  ]
}

---

6. 省市区域列表

GET https://openapi.77ircloud.com/commondata/common/data/cities?parentId=0

Header: access_token: {token}

参数：

• parentId: 父级区域ID，传 0 获取省份列表

返回：

{
  "code": 200,
  "data": [
    {"id": 1, "cityId": 110100, "provinceId": 110000, "name": "北京市"},
    {"id": 2, "cityId": 120100, "provinceId": 120000, "name": "天津市"}
  ]
}

---

7. 物流公司列表

GET https://openapi.77ircloud.com/commondata/common/data/logistics-company

Header: access_token: {token}

返回：

{
  "code": 200,
  "data": [
    {"id": 1, "name": "共速达", "code": "gongsuda", "phone": "400-111-0005"},
    {"id": 2, "name": "邮政EMS速递", "code": "ems"}
  ]
}

---

8. 价格等级列表

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

Header: access_token: {token}

返回：

{
  "code": 200,
  "data": [
    {"id": 0, "name": "基准订货价（市场价）", "levelIndex": 0},
    {"id": 2116753910947264, "name": "尊宝配送价", "levelIndex": 1}
  ]
}

---

9. 组织信息

GET https://openapi.77ircloud.com/organization-aggregation/organization/info

Header: access_token: {token}

返回： 组织基本信息