NAR1 欄位指南及 JSON Schema

NAR1 的業務名稱寫上 N/A、電郵留白，以及沒有提供董事頁面，是三種不同情況。資料整理應保留原文、資料狀態和來源頁碼，讓覆核人員知道每個值從何而來。

N/A、未填寫與未提供頁面

樣本右上角印有舊公司編號 1063959，應按原文保存為字串，不應直接改名為 BRN。結算日期 2022-08-02 是該份申報表的資料日期，不是查冊日期，也不是資料提取日期。

每一行股份類別、貨幣、已發行股份、總款額及已繳款額，構成一筆明細。即使只有一行，也保留陣列。原文的合計另行保存，不可當作另一行明細重複相加；不同貨幣不可直接合計。

公開資料庫提供欄位說明、可驗證的 JSON Schema 和明確標示的虛構範例。這是一份獨立的接入參考規格，與網站現有樣本的交付格式不同，使用前需進行欄位映射；並非公司註冊處官方規格。

本指南以兩頁 NAR1 節錄中的公司資料與股本欄位為例，不涵蓋完整董事、成員及續頁。Schema 驗證只能確認格式，不能證明資料正確或公司現況。

本頁先沿用現有兩頁樣本，不把未展示的董事、成員或續頁規則加進示例。閱讀時可做一張三欄筆記：原文標籤、你看到的值、你會如何解釋它。若第三欄需要查別的文件才能回答，就把它留作待查問題，不要塞進第二欄冒充原值。

例如，第 1 頁的日期可以支持「這份申報的結算日期」；它不能單獨支持「最近一次查冊日期」。第 2 頁的股本可以支持對這份申報內容的抄錄；它不能單獨證明公司今天的財務狀況。這樣的筆記讓覆核者看到推論是在哪一步加入的。

假設同事要求補齊樣本中的業務名稱、電郵及董事姓名。先查看原文和資料狀態，不要把三項都列為「提取失敗」。業務名稱原文已填 N/A，這項抄錄可以完成；電郵欄確實留白，重跑解析也不能產生來源沒有的地址；董事明細不在節錄內，需要補頁才可繼續。

左右滑動查看完整表格；鍵盤可聚焦表格後使用方向鍵。

公開樣本同一行出現三個 10,000，分別對應已發行股份數、總款額及已繳款額。數字相同，不表示是重複欄位；第一項是股份數目，金額項目則需要連同幣種閱讀。核對時逐欄讀標題，比只看數字有沒有提取出來更可靠。

表內另有合計。可以用明細與合計作交叉檢查，但不能因兩者相同就把它們相加。若另拿一份不同文件練習，先核對它的實際行數和單位，不能照搬樣本「只有一行」的結果。

完成一份筆記後，請同事只按筆記找到三處原文：公司編號、日期及股本明細。若他需要猜你說的是哪一頁、哪一個日期或哪一行，應先補足定位資料。若他能找到原文，卻不能理解空白代表甚麼，則需要補狀態說明。這比增加更多欄位更能檢查筆記是否可用。

如使用公開 Schema 作接入參考，再核對每個目標欄位與網站樣本的實際對應。欄位名相近不等於含義完全相同，驗證通過也不能代替閱讀原文。待基本閱讀及交接方式確認後，再討論技術映射會更清楚。

JSON Schema 驗證能證明資料正確嗎？

不能。Schema 只能驗證格式；仍需對照原文、資料日期與頁面範圍，不能據此證明公司現況。

提供一份目標格式，先確認樣本與報價。

先分清空白表格、已填文件及教學節錄，並確認公司、日期與頁面範圍。相同表格名稱不代表相同年份或相同資料完整度。

這份指南會逐項說明樣本裏的資料、空白的原因，以及股本表的讀法。如果想委託我們整理，先說明你需要甚麼資料、平日用甚麼格式便可；欄位名稱如何對應，可以之後一起確認。