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

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

---

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

資料集 slug：tw.gov.mof~ref~industry-tax~history
API 端點：https://data.openfun.tw/api/v1/datasets/tw.gov.mof~ref~industry-tax~history/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~history/records?per_page=20"

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

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

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

---

## 資料來源與更新頻率

| 項目 | 說明 |
|------|------|
| 原始來源 | 財政部財政資訊中心 |
| 更新頻率 | 非定期（隨分類修訂更新） |
| 收錄版本 | 第 6–9 次修訂（第 1–5 次未收錄） |
| 總筆數 | 約 10,505 筆（各版本合計） |

---

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

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

- 「代碼 561113 在第 8 次修訂（民國 106 年）時叫什麼名稱？」
- 「現行代碼 932414 是從哪個舊代碼演變來的？」
- 「第 7 次修訂的餐飲業有哪些子類代碼？」
- 「這個代碼是新增的，還是從舊代碼改編而來？」

以下問題，這份資料集**無法回答**（請改用其他資料集）：

- 「餐飲業現在的行業代碼是多少？」→ 請用 [`tw.gov.mof~ref~industry-tax`](../tw.gov.mof~ref~industry-tax/skill.md)（現行版本）
- 「台北市有多少家餐廳？」→ 請用 [`tw.gov.fia.eip~ref~business-tax`](../tw.gov.fia.eip~ref~business-tax/skill.md)

---

## 收錄版本

| `rev` 值 | 對應修訂 | 公布時間 |
|---------|---------|---------|
| `6` | 第 6 次修訂 | 民國 96 年 |
| `7` | 第 7 次修訂 | 民國 101 年 |
| `8` | 第 8 次修訂 | 民國 106 年 |
| `9` | 第 9 次修訂 | 民國 111 年（現行） |

> 第 1–5 次修訂目前未收錄。

---

## 欄位說明

| 欄位名稱（API 參數） | 型別 | 說明 |
|---------------------|------|------|
| `id_rev` | keyword（_id） | 代碼-修訂版本 |
| `name_rev` | text（_name） | 名稱-修訂版本 |
| `parent_rev` | keyword（ref: tw.gov.mof~ref~industry-tax~history） | 上層代碼-修訂版本 |
| `id` | keyword | 代碼 |
| `name` | text | 名稱 |
| `def` | text | 定義 |
| `sec` | keyword（篩選器） | 大類 |
| `rev` | keyword（篩選器） | 修訂版本 |
| `level` | integer（篩選器） | 層級(1-大類,2-中類,3-小類,4-細類,5-子類) |
| `map` | keyword（多值、ref: tw.gov.mof~ref~industry-tax） | 對應到上一期的編號 |
| `exl` | text（多值） | 不包含 |

### 關鍵欄位補充說明

| 欄位 | 型別 | 重要說明 |
|------|------|---------|
| `id_rev` | keyword（_id） | 主鍵，格式 `{代碼}_{rev}`，例如 `561113_9`；查詢時必須包含版本號 |
| `name_rev` | text（_name） | 格式 `{名稱}_{rev}`；全文搜尋 `?q=` 會搜尋此欄位及 `def` |
| `id` | keyword | 純行業代碼（不含版本號），格式與 `tw.gov.mof~ref~industry-tax` 的 `id` 相同 |
| `rev` | keyword（篩選器） | 修訂版本，值為 `"6"/"7"/"8"/"9"`；必須加此參數才能限定特定版本 |
| `level` | integer（篩選器） | 層級 1–5；`?level=5` 篩出所有子類 |
| `sec` | keyword（篩選器） | 所屬大類字母（A–S） |
| `parent_rev` | keyword（ref） | 同版本上層代碼（格式 `{代碼}_{rev}`）；用於同版本內展開階層 |
| `map` | keyword（多值、ref） | 對應到**上一版本**的 `id_rev`；空=新增代碼；多值=由多個舊代碼合併 |

---

## 標準流程：追蹤代碼跨版本變化

### Step 1：查詢現行代碼在第 9 次修訂的記錄

```bash
# 以 id_rev 精確查詢（格式：{代碼}_{rev}）
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.gov.mof~ref~industry-tax~history/records?id_rev=561113_9"
```

回應中的 `map` 欄位列出上一版本（第 8 次修訂）對應的 `id_rev`。

### Step 2：循 `map` 欄位往前追溯

```bash
# 若 map 回傳 ["561113_8"]，查第 8 次修訂的記錄
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.gov.mof~ref~industry-tax~history/records?id_rev=561113_8"
```

重複步驟，可追溯到第 6 次修訂。`map` 為空表示此代碼為新增，無前版對應。

---

## API 呼叫範例

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

### 查詢特定版本的所有子類

```bash
# 列出第 8 次修訂的所有子類（level=5）
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.gov.mof~ref~industry-tax~history/records?rev=8&level=5&per_page=100"
```

### 在同一版本內展開階層

```bash
# 展開第 9 次修訂中，細類 5611 的所有子類
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.gov.mof~ref~industry-tax~history/records?parent_rev=5611_9"
```

### 依代碼在各版本查詢

```bash
# 查某代碼在第 7 次修訂的記錄（直接用 id_rev）
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.gov.mof~ref~industry-tax~history/records?id_rev=561113_7"
```

### 全文搜尋特定版本中的行業名稱

```bash
# 在第 8 次修訂中搜尋「夾娃娃機」相關代碼
curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://data.openfun.tw/api/v1/datasets/tw.gov.mof~ref~industry-tax~history/records?q=夾娃娃機&rev=8&level=5&per_page=20"
```

---

## 注意事項

1. **`id_rev` 格式**：主鍵是 `{代碼}_{rev}`，查詢時請確認格式正確，例如 `932414_9`，而不是 `932414`。
2. **rev=6 代碼含連字號**：第 6 次修訂的部分代碼沿用舊格式（如 `8520-12`），第 7 次起改為純數字，跨版本比較時需注意。
3. **`map` 可為空**：`map` 為空表示此代碼是新增的，沒有對應的上一版代碼。
4. **若只需現行代碼**：直接用 [`tw.gov.mof~ref~industry-tax`](../tw.gov.mof~ref~industry-tax/skill.md)，不需要透過本資料集。

---

## 關聯資料集

| 資料集 | 說明 | 用途 |
|--------|------|------|
| [`tw.gov.mof~ref~industry-tax`](../tw.gov.mof~ref~industry-tax/skill.md) | 現行版本（第 9 次修訂） | 查詢現行代碼、搭配 tw.gov.fia.eip~ref~business-tax 使用 |
| [`tw.gov.fia.eip~ref~business-tax`](../tw.gov.fia.eip~ref~business-tax/skill.md) | 全國稅籍登記業者 | 以 6 碼子類代碼篩選業者 |

---

## 快速參考

| 項目 | 說明 |
|------|------|
| Base URL | `https://data.openfun.tw/api/v1/datasets/tw.gov.mof~ref~industry-tax~history/records` |
| 認證 | `Authorization: Bearer {token}` 必填 |
| 取得 Token | https://data.openfun.tw/user |
| 主鍵查詢 | `?id_rev=561113_9` |
| 版本篩選 | `?rev=8`（值為 "6"/"7"/"8"/"9"） |
| 層級篩選 | `?level=5`（子類）、`?level=1`（大類） |
| 全文搜尋 | `?q=關鍵字`（搜尋 name、def 欄位） |
| 階層展開 | `?parent_rev=5611_9` |
| 分頁 | `?page=1&per_page=20` |
| 回應格式 | JSON，含 `total`、`page`、`per_page`、`records[]` |