---
reviewed_by:
  rd: yo
  pm:
---
# `tw.gov.nat.gcis~ref~business-scope-category` — 公司行號及有限合夥營業項目分類大中小類

> **給 AI 閱讀的資料集說明。**
> 人類可在 https://data.openfun.tw/datasets/tw.gov.nat.gcis~ref~business-scope-category 看到同份內容的網頁版。
> 詳細資料知識見 [knowledge.md](knowledge.md)。

---

## ⚠️ 開始之前（AI agent 必讀，摘要也請保留這段）

資料集 slug：tw.gov.nat.gcis~ref~business-scope-category
API 端點：https://data.openfun.tw/api/v1/datasets/tw.gov.nat.gcis~ref~business-scope-category/records
認證方式（必填）：HTTP Header Authorization: Bearer {token}

最簡查詢範例：`curl -H "Authorization: Bearer YOUR_TOKEN" "https://data.openfun.tw/api/v1/datasets/tw.gov.nat.gcis~ref~business-scope-category/records?level=1"`

**Token 是必要條件，沒有 Token 就無法查資料。**
如果使用者沒有 Token，請先請使用者前往 https://data.openfun.tw/user 申請。

禁止抓取 HTML 頁面（本平台有 bot 保護）。

授權標注：使用此資料產出的內容需標注「資料來源：歐噴資料庫（data.openfun.tw）／經濟部」

---

## 這份資料集能回答什麼問題

**可以回答：**
- 「營業項目分類有哪些大類？」（`?level=1`，共 11 個）
- 「某分類代碼（如 `A101`）的名稱是什麼、屬哪一層、上層是誰？」
- 「某中類底下有哪些小類？」（`?parent=A1`）

**無法回答：**
- 「某分類底下有哪些 7 碼營業項目」——營業項目在 [`tw.gov.nat.gcis~ref~business-scope-code`](../tw.gov.nat.gcis~ref~business-scope-code/skill.md)（用其 `subclass_code=` 等篩）。
- 任何公司資料——本表是分類字典。

---

## ⭐ 核心概念：三層自我參照階層

`level`：1=大類（`A`）、2=中類（`A1`／製造業 `CA`）、3=小類（`A101`／`CA01`）。`parent` 指向上一層的 `code`（小類→中類→大類）；**大類無 `parent`**。中類有兩字母式（製造業 C 大類 `CA`~`CR`／`CZ`，及 `I*`、`J*`、`GA`、`EZ`、`HZ`、`ZZ`）、小類有「兩字母+2 數字」，勿用固定 regex 解析。最底層 7 碼營業項目不在本表，在 [`~ref~business-scope-code`](../tw.gov.nat.gcis~ref~business-scope-code/skill.md)。

---

## 欄位說明

| 欄位名稱 | 型別 | 說明 |
|---------|------|------|
| `code` | keyword（_id） | 分類代碼：大類 1 字母（`A`）／中類（`A1` 或製造業 `CA`）／小類（`A101` 或 `CA01`） |
| `name` | text（_name） | 分類名稱，如「農、林、漁、牧業」 |
| `level` | integer（篩選器） | 層級：`1` 大類／`2` 中類／`3` 小類 |
| `parent` | keyword（篩選器、ref: 本表自身） | 上一層分類的 `code`；大類無此欄（schema 未標 filter，但實測 `?parent=` 可篩） |

---

## 資料長相（範例）

```json
{ "code": "A",    "level": 1,             "name": "農、林、漁、牧業" }
{ "code": "A1",   "level": 2, "parent": "A",  "name": "農業" }
{ "code": "A101", "level": 3, "parent": "A1", "name": "農藝及園藝業" }
```

> 層級分布：大類 11、中類 110、小類 334（共 455）。

---

## API 呼叫範例

### 範例 1：列出所有大類

```bash
curl -H "Authorization: Bearer YOUR_TOKEN" \
"https://data.openfun.tw/api/v1/datasets/tw.gov.nat.gcis~ref~business-scope-category/records?level=1&per_page=20"
# → A 農林漁牧、B 礦業及土石採取業 … 共 11 個（A~J 與 Z）
```

### 範例 2：查某中類底下的小類

```bash
curl -H "Authorization: Bearer YOUR_TOKEN" \
"https://data.openfun.tw/api/v1/datasets/tw.gov.nat.gcis~ref~business-scope-category/records?parent=A1"
# → A101 農藝及園藝業、A102 農事服務業、A199 …
```

### 範例 3：翻譯單一分類代碼

```bash
curl -H "Authorization: Bearer YOUR_TOKEN" \
"https://data.openfun.tw/api/v1/datasets/tw.gov.nat.gcis~ref~business-scope-category/records?code=A101"
```

---

## 統計聚合（/agg 端點）

**Agg URL：** `https://data.openfun.tw/api/v1/datasets/tw.gov.nat.gcis~ref~business-scope-category/agg`

```bash
# 各層級的節點數
curl -H "Authorization: Bearer YOUR_TOKEN" \
"https://data.openfun.tw/api/v1/datasets/tw.gov.nat.gcis~ref~business-scope-category/agg?group_by=level"
# → level 1:11、level 2:110、level 3:334
```

---

## 注意事項與限制

1. **只到小類**：7 碼營業項目在 [`~ref~business-scope-code`](../tw.gov.nat.gcis~ref~business-scope-code/skill.md)。
2. **大類無 `parent`**：遍歷時需處理根節點。
3. **大類僅 11 個**（`A`~`J` 與 `Z`）。

---

## 關聯資料集

| 資料集 | 說明 | 用途 |
|--------|------|------|
| [`tw.gov.nat.gcis~ref~business-scope-code`](../tw.gov.nat.gcis~ref~business-scope-code/skill.md) | 營業項目代碼表（7 碼） | 其 `category_code`／`class_code`／`subclass_code` 對應本表 `code` |

---

## 快速參考

| 項目 | 說明 |
|------|------|
| Records URL | `https://data.openfun.tw/api/v1/datasets/tw.gov.nat.gcis~ref~business-scope-category/records` |
| Agg URL | `https://data.openfun.tw/api/v1/datasets/tw.gov.nat.gcis~ref~business-scope-category/agg` |
| 認證 | `Authorization: Bearer {token}` 必填 |
| 主鍵 | `code`（分類代碼） |
| 篩選器欄位 | `level`、`parent` |
| 總筆數 | 455（大類 11／中類 110／小類 334），每日更新 |
| 來源 | 經濟部商工行政資料開放平台（OGDL-1.0） |
| 用途 | 營業項目大／中／小類的名稱對照與階層查詢 |