從原件到可匯入資料的四步
確認公司、表格種類、日期及頁面完整性；提取原文與欄位；核對編號、日期、股本及缺失狀態；最後按系統要求映射欄位。結構化輸出保留來源文件及頁碼，方便同事回到原文覆核。
用真實樣本核對欄位與原文
本站兩頁歷史 NAR1 樣本屬 ARCH MARKETING LIMITED，結算日期為 2022-08-02。它只展示公司及股本資料，不包含董事或成員名單；不能用來識別這家公司的股東或最終受益所有人。
按使用方式選擇交付格式
JSON 適合保留巢狀欄位及股份類別陣列，XML 可按既有結構映射，Excel 便於同事篩選和對照清單。標準資料版交付 JSON 或 XML；Excel、自訂欄位、角色代碼及批量格式需先提供範本另行報價。
真實樣本：原文如何對應到你的欄位
以下對照本站可下載的標準 JSON。左欄是歷史樣本的原文資料，中間是現有輸出路徑，右欄是可供你調整的試算表映射建議，不代表每個客戶的固定交付格式。
左右滑動查看完整表格；鍵盤可聚焦表格後使用方向鍵。
| 原文及頁碼 | 標準 JSON 路徑 | 試算表欄位與型別 | 匯入前檢查 |
|---|---|---|---|
| 1063959／第 1 頁 | legacy_company_number | 舊公司編號／文字 | 沿用舊編號標籤；不改成 BRN |
| 2022-08-02／第 1 頁 | return_date | 結算日期／ISO 日期 | 不要以檔案下載日期覆蓋 |
| 業務名稱 N/A／第 1 頁 | business_name.value / status / raw | 值、狀態、原文／分開三欄 | 保留 null、not_applicable、N/A 的分別 |
| Ordinary、HKD、10,000／第 2 頁 | share_capital[0] | 股本明細／每個股份類別一行 | 合計另存；不要把合計再加一次 |
| 電郵欄留白／第 2 頁 | email_address.value / status / raw | 值、狀態、原文／分開三欄 | null、blank、空字串；不與 N/A 混合 |
| 兩頁節錄未包含成員頁 | unavailable.members | 成員資料狀態／文字 | outside_excerpt；不是空名單或零持有人 |
先定義資料表的粒度，再談 PDF 轉 Excel
同一份 NAR1 可以包含公司層級的欄位，以及多筆股份類別或人員紀錄。如果把它們全部壓成「一家公司一行」，就必須說清楚多筆資料如何保存；直接把第二位持有人塞進第一位的欄位，會讓結果看起來完整但無法可靠匯入。先決定每張表的一行代表公司、文件，還是一筆明細。
一種可調整的工作表設計，是把文件總表與股本明細分開：總表保留公司識別、資料日期和來源參考；明細表用同一個文件參考連回總表，每個股份類別各一行。這是資料建模建議，不是本站每次交付的固定版式。需要現有 Excel 範本時，可把欄位和範例先交來核對。
主鍵也要反映資料範圍。同一公司兩個年度不能因公司名稱相同就覆蓋彼此；同一天取得兩種文件，也不能只用下載日期去重。可先建立內部文件參考，再保留公司編號原標籤、表格種類、資料日期與原件檔名，讓後續的合併和更新規則有依據。
下表示範文件總表的一行：只有 DOC-001 是自行設計的內部參考，其他三個值均來自本站真實歷史樣本。DOC-001 不是原文編號，也不是標準 JSON 新增欄位；它只是展示接收端如何連接主表和明細表。
左右滑動查看完整表格；鍵盤可聚焦表格後使用方向鍵。
| 文件參考（自訂示例） | 公司英文名 | 舊公司編號／文字 | 結算日期 |
|---|---|---|---|
| DOC-001 | ARCH MARKETING LIMITED | 1063959 | 2022-08-02 |
用真實樣本走一次匯入前檢查
先從樣本頁下載標準 JSON，關閉自訂映射後對照本頁六行表。1063959 是字串形式的舊公司編號；2022-08-02 是文件的結算日期。建立試算表欄位時，編號設為文字，日期採用明確的年月日規則，避免開啟 CSV 時被軟件自動改成不同日期或數字格式。
接着檢查三種不能混合的情況：業務名稱是 N/A，電郵欄原文留白，成員頁未在節錄內。三者都可能沒有可用的值，但原因不同。建議接收系統同時保存 value、status 和 raw，或把它們展開成三欄；不要只剩一個空格，讓同事無法判斷需要補文件還是原文確實未填。
最後檢查股本明細和合計的關係。樣本只有一行 Ordinary、HKD、10,000 已發行股份；合計另有自己的輸出。匯出 Excel 時若把明細和合計當兩筆相加，就會重複計數。用這一行小樣本先確認匯入規則，比等整批資料累加後才發現總數不對，更容易定位錯誤。
這一行明細以相同 DOC-001 連回上方文件總表，股數、金額和貨幣分欄。若遇到另一份文件有兩個股份類別，接收端應能容納兩行，不因同一文件參考重複而覆蓋第一行；合計仍另存。這是接收表設計的測試條件，不代表真實樣本還有第二類股份。
左右滑動查看完整表格；鍵盤可聚焦表格後使用方向鍵。
| 文件參考（自訂示例） | 股份類別 | 貨幣 | 已發行股數 | 股本總額 | 原文頁碼 |
|---|---|---|---|---|---|
| DOC-001 | Ordinary | HKD | 10000 | 10000 | 2 |
接收端驗收：檔案能打開，還要能正確使用
把驗收分成三層：格式能否讀取、資料是否對上原文、結果是否符合接收端規則。JSON 語法正確只通過第一層；XML 元素齊全也不能證明值正確。反過來，原文值提取正確，若把陣列攤平時丟掉第二筆，仍不能算可用交付。驗收表應把失敗層級寫明。
用一份清晰文件和一份有缺失狀態的文件測試。確認中文名稱與標點能保留，零值不會變空白，未知值不會變零，資料型別與日期格式一致，重跑匯入不會多出重複紀錄。這些是針對你自己的接收表格或系統的測試項目，不是保證所有軟件都以同一方式處理。
若驗收失敗，把來源頁碼、輸出路徑、實際值與預期處理方式放在同一張問題表。先區分原文難辨、提取錯誤、欄位映射不符，還是接收端轉型造成問題，再決定重做哪一步。每次調整保留樣本版本和變更說明，避免為修一個欄位而讓其他資料悄悄改變。
常見問題
空白欄位可以全部填成 null 嗎？
應保留原因：原文空白、N/A、未提供頁面與無法辨識不同。樣本以狀態和原文一起記錄，避免下游系統誤解。