---
reviewed_by:
  rd: yo
  pm:
---
# `tw.gov.nat.gcis~ref~business-scope-code` — 公司行號及有限合夥營業項目代碼表

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

---

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

資料集 slug：tw.gov.nat.gcis~ref~business-scope-code
API 端點：https://data.openfun.tw/api/v1/datasets/tw.gov.nat.gcis~ref~business-scope-code/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-code/records?per_page=20"`

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

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

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

---

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

**可以回答：**
- 「某營業項目代碼（如 `A101011`）是什麼？涵蓋哪些業務？」
- 「『種苗』相關的營業項目有哪些代碼？」（`?q[name]=種苗`）
- 「某大／中／小類底下有哪些營業項目？」（`?category_code=`／`class_code=`／`subclass_code=`）
- 「某營業項目對應主計總處哪些行業標準分類？」（看 `dgbas_code`／`dgbas_name`）

**無法回答：**
- 「某公司登記了哪些營業項目」——本表是代碼對照表，不含任何公司資料。
- 「大／中／小類的名稱」——查 [`tw.gov.nat.gcis~ref~business-scope-category`](../tw.gov.nat.gcis~ref~business-scope-category/skill.md)（本表只帶代碼）。

---

## ⭐ 核心概念：四層階層，本表是最底層「營業項目」

大類（`A`，1 字母）→ 中類（`A1`，製造業等為字母式如 `CA`）→ 小類（`A101`、`CA01`）→ **營業項目（`A101011`／`CH01061`，7 碼，本表）**。⚠️ 約四分之一代碼非純數字式，勿用固定 regex 解析、改用上層代碼欄篩選。本表每列冗餘帶 `category_code`／`class_code`／`subclass_code`，可直接篩某層底下的項目；各層**名稱**在 [`~ref~business-scope-category`](../tw.gov.nat.gcis~ref~business-scope-category/skill.md)。

---

## 欄位說明

| 欄位名稱 | 型別 | 說明 |
|---------|------|------|
| `code` | keyword（_id） | 營業項目代碼，7 碼，如 `A101011` |
| `name` | text（_name） | 營業項目名稱，如「種苗業」 |
| `content` | text | 營業項目內容說明（涵蓋業務範圍） |
| `category_code` | keyword（篩選器、ref: [business-scope-category](../tw.gov.nat.gcis~ref~business-scope-category/skill.md)） | 大類代碼（1 字母，如 `A`） |
| `class_code` | keyword（篩選器、ref: business-scope-category） | 中類代碼（如 `A1`） |
| `subclass_code` | keyword（篩選器、ref: business-scope-category） | 小類代碼（如 `A101`） |
| `dgbas_code` | keyword（多值陣列） | 對應主計總處行業標準分類代碼，可多個；13 筆無此欄；`D601011` 之元素為「代碼 名稱」未拆 |
| `dgbas_name` | text（多值陣列） | 對應行業標準分類名稱，與 `dgbas_code` 同序 |

---

## 資料長相（範例一列）

```json
{
  "code": "A101020",
  "name": "農作物栽培業",
  "content": "從事稻米、蔬菜、果樹、甘蔗及雜糧等作物栽培之行業。包括稻作栽培業、雜糧栽培業、蔬菜栽培業、果樹栽培業、甘蔗栽培業。",
  "category_code": "A",
  "class_code": "A1",
  "subclass_code": "A101",
  "dgbas_code": ["0111", "0112", "0113", "0114", "0115"],
  "dgbas_name": ["稻作栽培業", "雜糧栽培業", "特用作物栽培業", "蔬菜栽培業", "果樹栽培業"]
}
```

> `dgbas_code`／`dgbas_name` 多為同序多值陣列；**13 筆**（如 `ZZ99999`）無這兩欄；特例 `D601011` 有 `dgbas_code`（元素為「代碼 名稱」未拆）卻無 `dgbas_name`。zip 前先檢查長度與存在性。

---

## API 呼叫範例

### 範例 1：用代碼查單一營業項目

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

### 範例 2：用名稱關鍵字找營業項目

`name` 為 text 欄位，需用全文搜尋 `?q[name]=關鍵字`（非等值篩選）。

```bash
curl -H "Authorization: Bearer YOUR_TOKEN" \
"https://data.openfun.tw/api/v1/datasets/tw.gov.nat.gcis~ref~business-scope-code/records?q[name]=種苗"
# → A101011 種苗業、F101081 種苗批發業、F201061 種苗零售業、F401071 種苗輸出入業
```

### 範例 3：列出某小類底下的所有營業項目

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

---

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

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

```bash
# 各大類底下的營業項目數
curl -H "Authorization: Bearer YOUR_TOKEN" \
"https://data.openfun.tw/api/v1/datasets/tw.gov.nat.gcis~ref~business-scope-code/agg?group_by=category_code"
# → F:194、C:177、J:122、H:75 …
```

---

## 注意事項與限制

1. **`dgbas_code`／`dgbas_name` 是多值陣列、且可能不存在或不成對**：13 筆完全無對應（如 `ZZ99999`）；`D601011` 有 code 卻無 name（且其 code 元素「代碼 名稱」未拆分）。除此特例外其餘同序成對；zip 前先檢查長度與存在性。
2. **上層名稱不在本表**：`category_code`／`class_code`／`subclass_code` 只有代碼，名稱查 [`~ref~business-scope-category`](../tw.gov.nat.gcis~ref~business-scope-category/skill.md)。
3. **這是代碼對照表**：不含任何公司或其登記項目。
4. **大類僅 `A`~`J` 與 `Z` 共 11 個**。

---

## 關聯資料集

| 資料集 | 說明 | 用途 |
|--------|------|------|
| [`tw.gov.nat.gcis~ref~business-scope-category`](../tw.gov.nat.gcis~ref~business-scope-category/skill.md) | 大／中／小類階層 | `category_code`／`class_code`／`subclass_code` 對應、查層級名稱 |

---

## 快速參考

| 項目 | 說明 |
|------|------|
| Records URL | `https://data.openfun.tw/api/v1/datasets/tw.gov.nat.gcis~ref~business-scope-code/records` |
| Agg URL | `https://data.openfun.tw/api/v1/datasets/tw.gov.nat.gcis~ref~business-scope-code/agg` |
| 認證 | `Authorization: Bearer {token}` 必填 |
| 主鍵 | `code`（7 碼營業項目代碼） |
| 篩選器欄位 | `category_code`、`class_code`、`subclass_code` |
| 總筆數 | 788 個營業項目（每日更新） |
| 名稱搜尋 | `?q[name]=關鍵字`（text 欄位，非等值篩選） |
| 來源 | 經濟部商工行政資料開放平台（OGDL-1.0） |
| 用途 | 查營業項目代碼↔名稱↔內容、所屬大中小類、對應主計總處行業標準分類 |