# 基础数据查询接口

## 1. 仓库列表

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

**Header:** `access_token: {token}`

**返回：**
```json
{
  "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：**
```json
{"pageNum": 1, "pageSize": 20}
```

**返回：**
```json
{
  "code": 200,
  "data": {
    "items": [
      {"id": 22652291, "name": "周总", "phone": "136xxx", "role": "MANAGER"}
    ]
  }
}
```

---

## 3. 商品单位列表

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

**Header:** `access_token: {token}`

**返回：**
```json
{
  "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}`

**返回：**
```json
{
  "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}`

**返回：**
```json
{
  "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` 获取省份列表

**返回：**
```json
{
  "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}`

**返回：**
```json
{
  "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}`

**返回：**
```json
{
  "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}`

**返回：** 组织基本信息