reviewed_by: rd: Ronny pm: James
人事總處機關代碼 — tw.gov.dgpa~ref~gov-org
行政院人事行政總處（DGPA）維護的政府機關代碼對照表，包含歷史裁撤機關記錄。 授權：政府資料開放授權條款（OGDL-Taiwan-1.0） 原始資料來源：行政院人事行政總處
資料概述
| 項目 | 說明 |
|---|---|
| 資料來源 | 行政院人事行政總處 |
| 總筆數 | 約 17,388 筆（含歷史裁撤機關，2026-05 查詢） |
| 現行機關數 | 機關裁撤日期為空者為現行機關（確切數量以 API 查詢為準） |
| 更新頻率 | 按需更新（機關改制時更新） |
機關代碼格式
機關代碼為 10 碼英數字，末碼為檢查碼（英文字母或數字）。
代碼規則由人事行政總處制定，無公開完整文件，但實際觀察：
- 新制（政府組織改造後）：代碼首碼為英文字母，如
A00000000A（行政院）、A13000000G（經濟部） - 舊制：首碼為數字，如
300000000A（舊行政院）、313000000G（舊經濟部）
機關層級
機關層級 欄位為數字字串，已知值：
| 層級 | 說明 |
|---|---|
1 |
院級（立法院、司法院、行政院、考試院、監察院、總統府、國家安全會議、國民大會） |
2 |
部會級（各部、署、委員會等） |
3 |
所屬機關 |
4 |
更下層機關 |
歷史機關追蹤：改制代碼的前後關係
機關改制（組織法修正、升格、裁撤）時，DGPA 保留舊記錄，並透過欄位連結新舊代碼：
| 欄位 | 說明 |
|---|---|
機關裁撤日期 |
舊代碼的裁撤日期；此欄位為空 = 現行機關 |
新機關代碼 |
舊代碼裁撤後，對應的新代碼（存在於同資料集） |
舊機關代碼 |
新代碼的前身代碼 |
機關生效日期 |
新代碼的生效日期 |
裁撤註記 |
值為 "是" 表示已裁撤 |
實際案例：經濟部
| 機關代碼 | 機關名稱 | 機關裁撤日期 | 新/舊關係 |
|---|---|---|---|
313000000G |
經濟部（舊） | 2023-09-26 | 新機關代碼 = A13000000G |
A13000000G |
經濟部（現行） | （空） | 舊機關代碼 = 313000000G，機關生效日期 = 2023-09-26 |
實際案例：行政院
| 機關代碼 | 機關名稱 | 機關裁撤日期 | 新/舊關係 |
|---|---|---|---|
300000000A |
行政院（舊） | 2012-01-01 | 新機關代碼 = A00000000A |
A00000000A |
行政院（現行） | （空） | 舊機關代碼 = 300000000A |
主管機關關係
主管機關代碼 欄位指向同一資料集的上級機關代碼，可用於建立機關樹。
注意：行政院（A00000000A）的主管機關代碼也是 A00000000A（自指）。
重要限制與特殊情況
資料集涵蓋非典型政府機關
DGPA 資料包含部分國營事業或法人機構的訓練機構，例如「榮民工程股份有限公司員工訓練中心」（代碼 332411500K，層級 4，已裁撤）。查詢時若需排除，可搭配機關名稱關鍵字過濾。
部分機關無法透過此資料集查詢下屬單位
DGPA 機關代碼原則上只到機關層級，司（局處等「單位」）通常沒有獨立機關代碼。
例如：
- 經濟部投資審議司：沒有獨立機關代碼，其代碼與上級經濟部相同（
A13000000G）。若需查單位代碼，需參考其他來源（如電子公文的單位代碼欄位）。 - 立法院公報處、議事處、國會圖書館：立法院（
400000000A）以下的所有處室均無獨立機關代碼。
新機關生效日欄位格式不一致
新機關生效日 欄位（注意：與 機關生效日期 不同）在部分記錄中儲存民國年格式（如 "1120926"），而非 ISO 日期格式。查詢時請以 機關生效日期 為主。
欄位說明
以下欄位均來自 API 實際查詢結果驗證。[來源：API 查詢 2026-05-18]
機關代碼
10 碼英數字，末碼為檢查碼（英文字母或數字），同時也是 API 記錄的 _id。為精確比對欄位（keyword）。
- 新制（政府組織改造後）：首碼為英文字母，如
A00000000A（行政院） - 舊制：首碼為數字，如
300000000A（舊行政院）
查詢方式：GET .../records/{機關代碼} 直接取得單筆記錄。
機關名稱
機關中文名稱，為全文搜尋欄位（text 型別）。支援 ?q=教育部 關鍵字搜尋。
⚠️ 搜尋結果會同時包含現行與歷史裁撤機關，需以 機關裁撤日期 判斷狀態。
機關英文名稱
機關英文名稱，為全文搜尋欄位（text 型別）。部分機關此欄位為空。
機關層級
數字字串，精確比對（keyword）。
| 值 | 說明 |
|---|---|
1 |
院級（五院、總統府、國安會等） |
2 |
部會級（各部、署、委員會等） |
3 |
所屬機關 |
4 |
更下層機關 |
查詢方式：?機關層級=2（精確比對）。
主管機關代碼
上級機關的機關代碼，指向同一資料集的另一筆記錄（keyword）。可用於查詢特定機關的直屬子機關（?主管機關代碼={代碼}）。
特殊情況：行政院（A00000000A）的主管機關代碼也是 A00000000A（自指）。
機關裁撤日期
date 型別（YYYY-MM-DD 格式）。此欄位為空（null）= 現行機關；有值 = 已裁撤。
⚠️ 無法直接用 API 篩選空值，需取回資料後在程式端判斷。
裁撤註記
keyword 型別，值為 "是" 表示已裁撤。與 機關裁撤日期 連動。
機關生效日期
此機關代碼的生效日期，ISO 格式（YYYY-MM-DD）。對現行機關而言通常是組改後新代碼啟用日。
新機關代碼
若此筆記錄為舊代碼（已裁撤），此欄位記錄改制後的新代碼（keyword，ref 到同資料集）。
舊機關代碼
若此筆記錄為新代碼（現行），此欄位記錄改制前的舊代碼（keyword，ref 到同資料集）。
新機關生效日
⚠️ 此欄位格式不一致：部分記錄為民國年格式（如 "1120926"），非 ISO 格式。請以 機關生效日期 為主，此欄位僅供參考。
機關地址、郵遞區號、機關電話、傳真
機關聯絡資料，部分記錄可能為空或過時。機關地址 為全文搜尋欄位（text），其餘為 keyword。
與其他代碼系統的對應
| 代碼系統 | 資料集 | 說明 |
|---|---|---|
| OID | tw.gov.moda~ref~oid |
可透過 OID 資料集的 OrgCode 欄位對應到本資料集的機關代碼 |
| 統一編號 | — | 目前無資料集直接對應 DGPA 代碼與統一編號 |
更新頻率與版本記錄
| 版本 | 更新日期 | 說明 |
|---|---|---|
| 初版 | 2026-05-18 | 建立知識文件，確認欄位結構、改制案例（行政院、經濟部）、特殊案例說明 |
使用範例
依名稱取得機關代碼
curl -H "Authorization: Bearer YOUR_TOKEN" \
"https://data.openfun.tw/api/v1/datasets/tw.gov.dgpa~ref~gov-org/records?q=教育部&per_page=10"取回結果後以 機關裁撤日期 === null 篩選現行機關。
直接查詢已知代碼
curl -H "Authorization: Bearer YOUR_TOKEN" \
"https://data.openfun.tw/api/v1/datasets/tw.gov.dgpa~ref~gov-org/records/A13000000G"查詢某機關的直轄子機關
# 行政院（A00000000A）底下的部會
curl -H "Authorization: Bearer YOUR_TOKEN" \
"https://data.openfun.tw/api/v1/datasets/tw.gov.dgpa~ref~gov-org/records?主管機關代碼=A00000000A&per_page=50"各層級機關數量統計
curl -H "Authorization: Bearer YOUR_TOKEN" \
"https://data.openfun.tw/api/v1/datasets/tw.gov.dgpa~ref~gov-org/agg?group_by=機關層級"AI 使用指引
AI agent 使用指引（含 Token 取得流程、欄位搜尋語法、改制追蹤流程）見 skill.md。