---
reviewed_by:
  rd: Ronny
  pm:
---
# 財政部稅務行業標準分類 — `tw.gov.mof~ref~industry-tax`

> **給 AI 閱讀的使用指引。**
> 人類可在 https://data.openfun.tw/datasets/tw.gov.mof~ref~industry-tax 看到同份內容的網頁版。
> 詳細資料知識見 [knowledge.md](knowledge.md)。

---

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

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

最簡查詢範例：curl -H "Authorization: Bearer YOUR_TOKEN" "https://data.openfun.tw/api/v1/datasets/tw.gov.mof~ref~industry-tax/records?per_page=20"

**Token 是必要條件，沒有 Token 就無法查資料。**
如果使用者沒有 Token，請停止並告訴使用者：「請先前往 https://data.openfun.tw/user 免費申請帳號與 API Token，取得後告訴我，我再幫您查詢。」

禁止抓取 HTML 頁面（本平台有 bot 保護，WebFetch 讀 HTML 頁面會失敗）。

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

---

## 資料來源與更新頻率

| 項目 | 說明 |
|------|------|
| 原始來源 | 財政部財政資訊中心 |
| 更新頻率 | 非定期（隨分類修訂更新，歷史上約每 4–5 年一次） |
| 現行版本 | 第 9 次修訂（民國 111 年 10 月公布，112 年 1 月 1 日起生效，適用 112–116 年度） |
| 年度內微調 | 每年約 12 月公告少量子類調整，次年度起適用（第 9 次修訂期間每年約 10–12 項） |
| 總筆數 | 2,468 筆（含全部 5 層級） |

---

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

以下問題，這份資料集**可以回答**：

- 「餐飲業的行業代碼是多少？」
- 「代碼 561113 是什麼行業？」
- 「半導體製造業有哪些細分類？」
- 「我想查台北市的便利商店，應該用哪個行業代碼？」
- 「住宿餐飲業（大類 I）下有哪些子類？」

以下問題，這份資料集**無法回答**：

- 「台北市有多少家餐廳？」（需查 tw.gov.fia.eip~ref~business-tax）
- 「這家公司的行業是什麼？」（需查 tw.gov.fia.eip~ref~business-tax 的 `行業代號` 欄位）

---

## 行業代碼的階層結構（核心知識，必須理解）

財政部稅務行業分類共有**五個層級**，代號格式如下：

| 層級（`level` 值） | 代碼格式 | 範例 |
|------------------|---------|------|
| 1：大類 | 英文字母（A–S） | `I`（住宿及餐飲業） |
| 2：中類 | 2 碼數字 | `56`（餐飲業） |
| 3：小類 | 3 碼數字 | `561`（餐廳及餐館業） |
| 4：細類 | 4 碼數字 | `5611`（餐廳） |
| 5：子類 | **6 碼數字** | `561113`（餐廳，不含提供住宿） |

**⚠️ 查詢 `tw.gov.fia.eip~ref~business-tax` 時，`行業代號` 欄位必須使用 6 碼子類（level=5）。使用 2–4 碼的上層代碼會查不到任何結果。**

---

## 欄位說明

> API 查詢時使用欄位名稱作為 query 參數名稱。

| 欄位名稱（API 參數） | 型別 | 說明 |
|---------------------|------|------|
| `id` | keyword（_id） | 代碼 |
| `name` | text（_name） | 名稱 |
| `parent` | keyword（ref: tw.gov.mof~ref~industry-tax） | 上層代碼 |
| `def` | text | 定義 |
| `sec` | keyword（篩選器） | 大類 |
| `level` | integer（篩選器） | 層級(1-大類,2-中類,3-小類,4-細類,5-子類) |
| `exl` | text（多值） | 不包含 |

### 關鍵欄位補充說明

| 欄位 | 型別 | 重要說明 |
|------|------|---------|
| `id` | keyword（_id） | 行業代號；大類=英文字母、中類=2碼、小類=3碼、細類=4碼、**子類=6碼**。帶入 business-tax 必須用 6 碼 |
| `name` | text（_name） | 行業中文名稱，全文搜尋：`?q=餐廳`（同時也搜尋 `def`，注意誤命中） |
| `level` | integer（篩選器） | 層級 1–5；`?level=5` 篩出所有可用於 business-tax 的 6 碼子類 |
| `sec` | keyword（篩選器） | 所屬大類字母（A–S）；`?sec=I` 篩出住宿餐飲業下所有層級 |
| `parent` | keyword（ref） | 上層代號；`?parent=5611` 展開細類下所有子類 |
| `def` | text | 官方定義說明；全文搜尋會一起搜尋此欄位，可能造成非預期命中 |
| `exl` | text（多值） | 不列入本類的排除項目，部分分類才有 |

---

## 標準流程：從行業名稱找到 6 碼代號，再查 tw.gov.fia.eip~ref~business-tax

### Step 1：用關鍵字搜尋，取得候選代碼

```bash
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.gov.mof~ref~industry-tax/records?q=餐廳&per_page=20"
```

回應範例（僅示意）：
```json
{
  "records": [
    {"id": "I",      "name": "住宿及餐飲業",  "level": 1},
    {"id": "56",     "name": "餐飲業",        "level": 2},
    {"id": "561",    "name": "餐廳及餐館業",  "level": 3},
    {"id": "5611",   "name": "餐廳",          "level": 4},
    {"id": "561113", "name": "餐廳（不含提供住宿）", "level": 5}
  ]
}
```

### Step 2：選擇 level=5 的 6 碼代碼

從結果中挑選 `level` 為 5 的代碼（6碼），帶入 `tw.gov.fia.eip~ref~business-tax` 查詢：

```bash
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.gov.fia.eip~ref~business-tax/records?行業代號=561113&q[營業地址]=台北市&per_page=20"
```

### Step 3：若要涵蓋整個大類（如所有餐飲業）

先列出該大類下的所有 level=5 子類代碼，再逐一查詢：

```bash
# 列出住宿及餐飲業（sec=I）下的所有子類（level=5）
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.gov.mof~ref~industry-tax/records?sec=I&level=5&per_page=100"
```

---

## API 呼叫範例

**Records URL：** `https://data.openfun.tw/api/v1/datasets/tw.gov.mof~ref~industry-tax/records`

### 查詢特定代碼的完整資訊

```bash
# 查詢 6 碼子類代碼
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.gov.mof~ref~industry-tax/records?id=561113"
```

### 列出某細類下的所有子類

```bash
# 列出細類 5611（餐廳）下的所有子類
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.gov.mof~ref~industry-tax/records?parent=5611"
```

### 只列出 level=5 子類（可直接帶入 tw.gov.fia.eip~ref~business-tax 的代碼）

```bash
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.gov.mof~ref~industry-tax/records?level=5&per_page=100"
```

### 依大類篩選所有子類

```bash
# 列出製造業（sec=C）下所有子類
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.gov.mof~ref~industry-tax/records?sec=C&level=5&per_page=100"
```

---

## 關聯資料集

| 資料集 | 說明 | 用途 |
|--------|------|------|
| [`tw.gov.fia.eip~ref~business-tax`](../tw.gov.fia.eip~ref~business-tax/skill.md) | 全國稅籍登記業者 | 取得 6 碼代碼後，帶入 `行業代號` 欄位篩選業者 |
| [`tw.gov.mof~ref~industry-tax~history`](../tw.gov.mof~ref~industry-tax~history/knowledge.md) | 歷史版本分類代碼 | 查詢特定修訂版本，或追蹤代碼跨版本的變化 |

---

## 注意事項與限制

1. **tw.gov.fia.eip~ref~business-tax 必須用 6 碼**：`tw.gov.fia.eip~ref~business-tax` 的 `行業代號` 是精確比對（keyword），帶入 2–4 碼的上層代碼（如 `56`、`561`）會查不到任何結果，必須用 6 碼子類。
2. **中類有兩個特例**：中類代碼通常是 2 碼數字，但 `45-46` 和 `47-48` 是兩個連號合併為一類，`id` 值就是 `"45-46"` 含連字號。
3. **`?q=` 同時搜尋 `name` 和 `def` 欄位**：`?q=餐廳` 會搜尋名稱（`name`）與定義說明（`def`）兩個欄位，通常需再用 `level=5` 過濾出可用的子類代碼。⚠️ 若搜尋詞出現在其他行業的 `def` 定義文字中，可能命中非預期結果（例如搜尋「釀酒」可能命中「食品飲料及菸草製作用機械設備製造業」，因其 `def` 欄位含有「釀酒機」）。**拿到結果後請先確認 `name` 欄位符合意圖**，再使用代碼。
4. **`id` 是精確比對**：`?id=561113` 只會回傳該精確代碼，不可用前綴查詢。
5. **各版本有適用年度**：第 9 次修訂適用 112–116 年度；更早年度的申報若需查歷史版本代碼，請查 [`tw.gov.mof~ref~industry-tax~history`](../tw.gov.mof~ref~industry-tax~history/skill.md)。
6. **台灣有三套行業分類體系**：財政部（本資料集）、主計總處（統計用）、經濟部商業司（公司登記用），三套獨立、互不通用，同一公司在各系統的行業分類可能不同。

---

## 快速參考

| 項目 | 說明 |
|------|------|
| Records URL | `https://data.openfun.tw/api/v1/datasets/tw.gov.mof~ref~industry-tax/records` |
| 認證 | `Authorization: Bearer {token}` 必填 |
| 取得 Token | https://data.openfun.tw/user |
| 全文搜尋 | `?q=關鍵字`（搜尋 `name`、`def` 欄位） |
| 精確篩選 | `?id=561113`、`?level=5`、`?sec=I`、`?parent=5611` |
| 分頁 | `?page=1&per_page=20` |
| 回應格式 | JSON，含 `total`、`page`、`per_page`、`records[]` |