🔐

BCH FY2025 年賬紀錄

BCH Investments Limited · 2025 財年完整覆盤
請輸入密碼以繼續
❌ 密碼錯誤,請重試

🎉 BCH Investments Limited FY2025 年賬全紀錄

首次自行完成 IR4 申報 · 2026年3月31日深夜提交成功 · 與 AI Agent 合作完成
✅ IR4 已提交 確認號:0-590-821-384 申報期:31-Mar-2025 提交時間:23:56 NZT 申報人:Thomas

🏠 一眼看懂 — 這次年賬的結果

📤 申報狀態
✅ 已提交
確認號 0-590-821-384
💰 本年應稅損益 Current Year P/L
-304.50
虧損(正常,不影響提交)
📉 結轉虧損 Loss Carry Forward
-8,072,366.80
FY26開始用這個數字
🔖 IR4J Closing Balance
-37,906.27
FY26 IR4J Opening 用這個
🏢 Owners' Equity 股東權益
-11,701,847.34
負值正常(見說明)
📊 Total Assets 總資產
6,925,481.32
Balance Sheet 截至 31-Mar-2025

✅ 這次做對了什麼

  • Xero 三表(P&L / Balance Sheet / Trial Balance)全部匯出並核對一致
  • IRD 官方文件齊全(IR4回執、Loss carry forward notice、銀行對帳單)
  • Bank total 27.58 與 Xero GL 完全對平(差額 0.00)
  • 延續 FY2024 口徑(IR10 + IR4J),保持一致性
  • 提交截止前成功提交(23:56,幾乎壓線)

⏱️ 最耗時的點

  • Xero OAuth scope 嘗試 6+ 次才找到可用組合
  • IR10 負債欄位填負數報錯,需要重分類
  • Business income 欄位忘填,導致 Tax calculation 顯示 0
  • IR4J 入口不在獨立頁面,要在 File return 流程裡找
  • Lowest economic interest 一度不知道填多少

📊 本次流程圖(From Zero → Submitted)

📱 Xero 授權
OAuth 連接
📋 IRD 文件準備
從 myIR 下載
📊 Xero 三表匯出
P&L/BS/TB
🏦 銀行對帳
00+01 對平
📝 填 IR4 主表
myIR
📑 填 IR10
財務摘要
🔢 填 IR4J
Imputation
✅ 提交成功
23:56 NZT

🤝 這次的合作方式

Thomas 第一次自行完成公司年度申報,全程與 Claude AI Agent 合作。Agent 負責:讀取 Xero 報表、自動回填核對表、計算校驗數字、指導 myIR 每一步操作。Thomas 負責:登入 IRD/Xero、在 myIR 點擊填寫、確認每步結果。

🎉 結果:2026年3月31日深夜23:56提交成功,BCH Investments Limited FY2025年度申報完成!

📖 全程回顧 — 今晚發生了什麼

🕐 時間線(2026年3月31日 NZT)

17:26 NZT

🔗 Xero OAuth 首次連接成功

完成 auth-url → exchange → connections 流程。發現組織:BCH Investments Limited(tenantId: 973ce089...)

17:46 ~ 18:36 NZT

😤 Xero Scope 反覆除錯(花了約1小時)

嘗試6種不同的 scope 組合,多次遇到 unauthorized_client / invalid scope 報錯。最終確認當前 client_id 不支持 accounting.reports.read,改用 accounting.banktransactions 組合。

19:02 NZT

📄 生成 FY2025 報稅整合網頁

生成 FY2025_IR4_Xero授权与防审计清单.html,涵蓋授權流程與審計風險點。

19:28 ~ 21:58 NZT

📂 IRD 文件準備與核對

從 myIR 下載:IR4回執、Loss carry forward通知(FY2024+FY2025)、Return Acknowledgements、ITAX交易明細(零交易)。確認 FY2025 loss carry forward 來自 FY2025 申報後的官方通知。

22:07 ~ 22:44 NZT

📊 生成核對表 + 自動回填

生成 IRD_FY2025_Min_Checklist.xlsx(含三個工作表),解析 Xero 三表 PDF/Excel 自動回填。Revenue: 35,860.20,Expenses: 36,164.70,Net Loss: -304.50。

22:50 ~ 23:59 NZT(3月31日)

🏦 Xero 三表匯出 + myIR 填表衝刺

Thomas 從 Xero 匯出 P&L/Balance Sheet/Trial Balance(PDF+Excel)。同步填寫 myIR IR4 各頁,包括 IR10、IR4J、Lowest economic interest。Tax calculation review 核對通過:Total income -304.50,Tax payable 0.00。

23:56 NZT(3月31日)🎉

🎉 IR4 FY2025 提交成功!

確認號:0-590-821-384。Account ID:111-722-676-INC007。Submitted by:Thomas。壓線提交,在 Due date 當晚完成!

00:08 ~ 00:27 NZT(4月1日)

📥 補下載回執 + 整理文件夾

從 myIR 補下載 IR4 已提交 PDF。整理19個文件,重新命名,生成交接文件,移動到 Google Drive。

01:41 ~ 03:28 NZT(4月1日凌晨)

📋 提交後補充核對 — 銀行對帳 + 卡殼點整理

提交後回顧:Agent 解析兩份銀行對帳單,Bank 00(27.51)+ Bank 01(0.07)= 27.58,與 Xero GL 完全對平(差額 0.00)。同步整理今晚遇到的卡殼點,包括 IR4J 入口、Business income 欄漏填等問題記錄。

03:52 ~ 05:40 NZT(4月1日凌晨)

📝 提交後補充說明 — IR10 邏輯 + 罰款諮詢

提交後補充確認:Agent 解釋 IR10 Other current liabilities 負數重分類邏輯(Current loans 7,449,357.83 → 7,241,047.50)。確認逾期罰款金額(<$100k收入檔:$50)。整理 FY24 口徑對比,為 FY26 備用。

💡 總結:為什麼這次能完成

  • Xero 雖然 API 有限制,但三表手動匯出後 AI 可以解析回填
  • Agent 熟悉 IRD 表單邏輯,能逐步指導每個頁面點擊
  • 關鍵數字都有 Xero 和銀行兩個來源互相驗證
  • FY2024 的已提交 PDF 作為參照,保持口徑一致

🔑 關鍵數字 — FY2025 最終版(FY26必看)

⚠️ 重要: 以下數字是 FY2026 申報的起點。每個數字都標注了 FY26 要怎麼用。

📊 損益表 Profit & Loss(來源:Xero + 已提交 IR4)

科目FY2025 金額FY26 如何用
收入 Total Revenue35,860.20FY26 對比參照基準
費用 Total Expenses36,164.70FY26 對比參照基準
折舊 Depreciation194.13FY26 IR10 折舊欄參照
專業費 Professional Fees558.22FY26 IR10 對比基準
其他費用 Other Expenses35,412.35FY26 IR10 對比基準
稅前淨利/虧損 Net Profit/Loss before Tax-304.50FY26 IR4 Business income 對比
本年應稅損益 Current Year Taxable P/L-304.50FY26 IR4 填表直接參照

🏢 資產負債表 Balance Sheet(截至 31-Mar-2025)

科目FY2025 金額備注
應收賬款 Accounts Receivable6,654,037.87IR10 debtors 欄
現金 Cash and Deposits27.58= Bank 00 + Bank 01
其他流動資產 Other Current Assets270,205.52含負債重分類後的調整
其他固定資產 Other Fixed Assets1,210.35IR10 fixed assets
總資產 Total Assets6,925,481.32驗算用
應付賬款 Accounts Payable134,415.14IR10 creditors
流動貸款 Current Loans(重分類後)7,241,047.50⚠️ 已重分類,見卡殼點
其他流動負債 Other Current Liabilities0.00⚠️ 已重分類為0
非流動負債 Non-current Liabilities11,251,866.02IR10 non-current
總負債 Total Liabilities18,627,328.66驗算用
股東權益 Owners' Equity-11,701,847.34負值正常(累積虧損)
✅ 驗算:6,925,481.32 = 18,627,328.66 + (-11,701,847.34) → 平衡

🔑 FY26 最重要的三個數字

數字金額FY26在哪裡用
結轉虧損 Loss Carry Forward-8,072,366.80IR4 → Net loss brought forward
IR4J Closing Balance-37,906.27FY26 IR4J → Opening balance
本年損益-304.50歷史對比參照

🏦 銀行餘額(截至 31-Mar-2025)

帳戶金額
Bank Account 0027.51
Bank Account 010.07
合計27.58
Xero GL 銀行總額27.58
差額 Difference0.00 ✅

📜 FY2025 提交資料摘要(給下次對帳用)

確認號 Confirmation Number0-590-821-384
申報期 Period31-Mar-2025
提交時間 Date Received31-Mar-2026 23:56:43 NZT
帳戶 Account ID111-722-676-INC007
提交人 Submitted byThomas
FY2025 Xero Tenant ID973ce089-5910-4b1b-9b35-b1b85103c270
FY2025 Invoices6 筆(應收4筆 ACCREC + 應付2筆 ACCPAY)
FY2025 Payments51 筆,合計 158,294.78

😅 常見卡殼點 — 哪裡繞彎路,最後怎麼解決

📌 以下是這次申報中最耗時的問題。下次做年賬時,先看這頁,可以少走很多彎路。
🔴 問題一:Xero OAuth Scope 反覆嘗試,花了將近1小時
📌 為什麼卡殼:不清楚哪些 scope 當前 Xero app 支持。嘗試加入 accounting.reports.read 後一直報 unauthorized_client 或 invalid scope。
最終解決:系統性測試所有 scope,找出「可用組合」:accounting.invoices、accounting.payments、accounting.contacts、accounting.banktransactions、accounting.attachments 等。不可用的:accounting.reports.read、accounting.transactions、accounting.journals.read。

下次做法:直接用已知可用的 scope 組合(見術語表),不要試圖加 reports.read。如果需要三表,從 Xero 界面手動匯出。

💡 關鍵認知:Xero OAuth scope 受 app/client 類型限制,不是用戶管理員就能用所有 scope。
🔴 問題二:IR10 負債欄位不允許填負數,報錯 Cannot be negative value
📌 為什麼卡殼:Xero Balance Sheet 的 Other current liabilities 原始值為 -208,310.33(借方餘額),直接抄到 IR10 被系統拒絕。
最終解決(重分類法):在負債欄位內部做中性重分類:
• Other current liabilities:-208,310.33 → 0.00
• Current loans:7,449,357.83 → 7,241,047.50(差額沖減)
合計不變:7,375,462.64。總資產/總負債/Owners' equity 全部保持一致。

下次做法:只要遇到 IR10 負值報錯,用「流動負債內部重分類」法,不要試圖硬填負數。

⚠️ FY26注意:如果 Xero Balance Sheet 再次出現負的流動負債,沿用本次重分類邏輯。
🟡 問題三:Tax Calculation Review 顯示 0,以為填錯了
📌 為什麼卡殼:進入 Tax Calculation Review 頁面,Total income 顯示 0.00,以為前面步驟填錯了,很慌張。
最終解決:返回 Income 頁,發現 Business or other rental income 欄位沒有填。補填 -304.50 後,Tax Calculation 自動計算正確。

下次做法:如果 Tax Calculation 顯示 0,不要驚慌,先回 Income 頁確認 Business income 欄是否有填。

💡 myIR 的灰色欄位是系統自動計算(唯讀),使用者只需填白色欄位。
🟡 問題四:找不到 IR4J(Imputation)的入口
📌 為什麼卡殼:以為 IR4J 有獨立的 "File return" 入口,在 myIR 菜單找了很久找不到。
最終解決:IR4J 不是獨立表格,而是在 File Income Tax Return 主流程裡的一個步驟(IR4 → Imputation 步驟)。在主表流程中按 Next 就會出現。

下次做法:在 myIR → Income tax → Returns → File return → 按流程走,Imputation (IR4J) 會在 IR4 主流程中自動出現。

🟡 問題五:Lowest Economic Interest 不知道填多少
📌 為什麼卡殼:頁面顯示 0.00%,不確定是否正確,不敢填。
最終解決:翻查 FY2024 已提交的 IR4 PDF,確認去年填的是 100.00%。沿用去年口徑,填 100.00。

下次做法:翻看 02_IRD_2024_IR4_Submitted.pdf,找 "lowest economic interest" 欄的去年值,沿用即可。

🟢 問題六:Business or rental income 聯動勾選了 Residential property interest
📌 為什麼卡殼:勾選 Business income 後,系統自動聯動出現 "Interest incurred from residential property" 區塊,以為填錯了。
最終解決:這是 myIR 的系統聯動設計,不是錯誤。沒有住宅物業利息的話,這些欄位全填 0.00 即可。

下次做法:遇到自動聯動出現的欄位,按實際情況填(無則填0),不需要取消勾選。

📁 文件清單 — 19個文件,各有用途

📂 文件存放位置:G:\我的云端硬盘\公司文件\所有公司年報\BCH Investment Limited 2025FY\

📋 完整文件目錄

📊
00_FILENAME_RENAME_MAP.csv
文件名新舊對照表。記錄了哪些文件改了名字(原始名 → 統一命名)。
參考
🏆
01_IRD_2025_IR4_Submitted_Confirmation_0-590-821-384.pdf
FY2025 IR4 最重要文件:IRD 提交成功確認書,含確認號、提交時間、所有填報數字。
最重要
📄
02_IRD_2024_IR4_Submitted.pdf
FY2024 去年提交的 IR4 副本。用於核對去年口徑(IR10、IR4J、Shareholders 格式參照)。
去年參照
📄
03_IRD_2025_ITAX_Transactions_NoActivity_2026-03-31.pdf
FY2025 IRD 稅款交易明細頁面截圖(PDF)。顯示「無財務活動」,作為 Provisional/Terminal/RIT = 0.00 的依據。
証據
📜
04_IRD_2025_LossCarryForward_Notice_Issued_2025-04-02.pdf
FY2025 官方虧損結轉通知。記錄 FY2025 期末結轉虧損 -8,072,366.80。FY26申報時 "Net loss brought forward" 用這個數字。
FY26必用
📜
05_IRD_2024_LossCarryForward_Notice_To_31-Mar-2024_Issued_2024-05-27.pdf
FY2024 虧損結轉通知。作為 FY2025 IR4 填表時「期初結轉虧損 8,072,062.30」的來源依據。
歷史依據
📄
06_IRD_2024_IncomeTax_ReturnAcknowledgement_Issued_2025-04-02.pdf
FY2024 IR4 收件確認書(Return Acknowledgement)。不是已提交副本,是 IRD 確認已收到的通知。
歷史記錄
📄
07_IRD_2023_IncomeTax_ReturnAcknowledgement_Issued_2024-05-27.pdf
FY2023 Return Acknowledgement。歷史記錄,作為申報連續性的佐證。
歷史記錄
📊
08_XERO_2025_PnL_with_2024_compare.pdf / .xlsx
Xero 損益表(FY2025 含 FY2024 對比)。Revenue 35,860.20 / Expenses 36,164.70 / Net Loss -304.50 的來源。
核心帳務
📊
09_XERO_2025_BalanceSheet_asat_2025-03-31_with_2024_compare.pdf / .xlsx
Xero 資產負債表(截至 31-Mar-2025 含 FY2024 對比)。IR10 Balance Sheet 填表來源,驗算 6,925,481.32 = 18,627,328.66 - 11,701,847.34。
核心帳務
📊
10_XERO_2025_TrialBalance_asat_2025-03-31.pdf / .xlsx
Xero 試算表(截至 31-Mar-2025)。驗證總帳平衡與 P&L/Balance Sheet 口徑一致的底稿。
核對底稿
🏦
11_BANK_00_Statement_asat_2025-03-31.pdf
銀行帳戶 00 對帳單,截至 31-Mar-2025。結餘 27.51。
銀行核對
🏦
12_BANK_01_Statement_asat_2025-03-31.pdf
銀行帳戶 01 對帳單,截至 31-Mar-2025。結餘 0.07。
銀行核對
📋
13_Checklist_Template_IRD_FY2025_Min_Checklist.xlsx
空白核對表模板(三個工作表:Checklist / Evidence_Register / Beginner_Steps)。FY26 直接複製使用。
FY26用
14_Checklist_AutoFilled_IRD_FY2025_Min_Checklist.xlsx
自動回填版核對表。Agent 從三表+銀行對帳單解析後自動填入所有數字,並新增 IR4_Ready_Values 工作表。
FY25完成品
🤖
15_AGENT_HANDOVER_XERO_Copy_2026-04-01.md
Agent 全程操作日誌副本。記錄了每一步命令和結果,今晚所有操作的完整記錄。
Agent接手
📝
16_FY2025_Tax_Handover_Report_for_AI_and_Accountant.md
人類可讀的交接報告。含關鍵調整、負數解釋、風險評估、FY26接手SOP。
首先看這個
🗂️
17_FILE_CATALOG_AND_PICKUP_GUIDE.md
文件目錄與接手指南。說明每個文件的用途和接手最短路徑。
指引
🌐
18_FY2025_Tax_Pickup_Portal.html
本地版接手入口網頁(較簡版)。包含可點擊文件連結(本地路徑),適合在同一文件夾下打開使用。
本地網頁

⚠️ 稅務審計風險 — 如何避免 IRD 自動關注

🚨 重要說明: IRD 有自動化系統篩選異常申報。以下是這次申報的風險評估和如何保持低風險。

📊 本次申報風險評估

FY2025 申報數字
數字前後一致 ✅
低到中等風險 ✅
風險點本次情況狀態
IR4 與 Xero 三表一致性完全一致(數字同源)✅ 低風險
Loss carry forward 與官方通知一致8,072,062.30(FY24通知)→ 加本年 -304.50 = 8,072,366.80✅ 低風險
IR4J Opening/Closing 連續性Opening -37,906.27(FY24 closing),無增減 → Closing -37,906.27✅ 低風險
銀行餘額與 Xero GL 一致27.58 = 27.58(差額 0.00)✅ 低風險
IR10 欄位格式合規負債重分類後無負值✅ 低風險
Owners' equity 為負-11,701,847.34(連年虧損/股東往來大,可解釋)⚠️ 中等風險
IR4J Closing 為負-37,906.27(ICA debit balance,機制上可成立)⚠️ 中等風險
連年虧損FY2025 虧損雖小(-304.50),但歷年累積虧損大⚠️ 中等風險
📋 總體評估:低到中等常規風險。數據前後一致性佳,有完整證據鏈支撐。不能保證零審查,但已盡可能降低觸發因素。

🚨 IRD 最容易關注的紅線

  • IR4 數字與 Xero 三表不一致
  • Loss carry forward 與官方通知不匹配
  • IR4J Opening ≠ 上年 IR4J Closing
  • IR10 欄位有格式錯誤(如負數)
  • 銀行餘額與賬面不一致
  • 無 supporting documents 但有顯著異常

✅ 這次如何保護自己

  • 所有數字有 Xero 三表來源可追溯
  • 有 19 個文件組成完整證據鏈
  • 延續 FY2024 口徑(IR10+IR4J)
  • 核對表(Checklist)有自動驗算
  • 負數有合理解釋(見邏輯圖)

🔍 為什麼負數不是錯誤?

① Owners' Equity 股東權益 為負數 (-11,701,847.34)

公司連年虧損
累積大量虧損
+
股東往來/借款
計入負債
負債 > 資產
Equity = 負
不是違規
常見情況

② IR4J Closing Balance 為負數 (-37,906.27)

ICA (Imputation Credit Account)
支出多於收入
ICA Debit Balance
Closing = 負
機制上可成立
IRD 認可

📌 萬一 IRD 來查詢,如何回應

  1. 提供 01_IRD_2025_IR4_Submitted_Confirmation_0-590-821-384.pdf(已提交確認)
  2. 提供 08/09/10 Xero 三表(數字來源說明)
  3. 提供 11/12 銀行對帳單(銀行餘額核對)
  4. 提供 04 Loss Carry Forward 官方通知(結轉虧損依據)
  5. 說明 IR10 重分類原因(負數重分類說明在 16_FY2025_Tax_Handover_Report)

🔧 Xero 接入 — API 能做什麼,不能做什麼

🎯 這次 Xero 接入的作用

AI Agent 通過 Xero OAuth API 連接了 BCH Investments Limited 的 Xero 賬,能讀取發票、付款、聯絡人等數據。但是,三表(P&L/Balance Sheet/Trial Balance)需要從 Xero 界面手動匯出,Agent 不能直接用 API 拉取。

💡 最有效的用法:手動從 Xero 匯出三表 Excel/PDF → 提供給 Agent → Agent 自動解析回填核對表

✅ API 可以做到的(已測試)

  • 讀取組織資訊(公司名稱、財年)
  • 列出所有發票(Invoices)
  • 列出所有付款記錄(Payments)
  • 讀取聯絡人(Contacts)
  • 讀取銀行交易(Bank Transactions)
  • 讀取系統設定(Settings)

❌ API 做不到的(scope 限制)

  • 直接拉取 P&L 報表(accounting.reports.read 不支持)
  • 直接拉取 Balance Sheet
  • 讀取交易明細(accounting.transactions 不支持)
  • 讀取總帳 Journal(accounting.journals.read 不支持)
  • 直接提交年度稅表(Xero Tax 需要專業會計版)

🔑 已確認可用的最大 Scope 組合(直接複製用)

openid profile email offline_access
accounting.invoices accounting.payments
accounting.contacts accounting.contacts.read
accounting.settings accounting.settings.read
accounting.attachments accounting.attachments.read
accounting.banktransactions accounting.budgets.read
assets projects files
⚠️ 不要加這些(會導致 unauthorized_client 錯誤):accounting.reports.read、accounting.transactions、accounting.journals.read

⚡ 快速接入步驟(下次用)

1

生成授權鏈接

在 D:\Backup\Downloads 執行:
python GitHub_Copilot\skills\skills\xero_oauth_setup.py auth-url

2

瀏覽器授權

點擊授權鏈接 → 登入 Xero → 同意授權。瀏覽器會跳轉到 localhost(顯示拒絕連接是正常的,複製網址欄 URL 中的 code= 和 state= 參數)。

3

交換 Token

python xero_oauth_setup.py exchange --code "CODE" --state "STATE"

4

驗證連接

python xero_oauth_setup.py connections
應看到:tenantName: BCH Investments Limited

🔐 密鑰從 GCP Secret Manager 讀取(project: nvda-strategy),不存本地明文。

🚀 FY26 建議:擴大 Xero 能力的方法

  • 在 Xero Developer Portal 申請新的 App(選擇 Accounting scope),可能獲得更多 scope 支持
  • 考慮使用 Xero Tax(會計師專業版),可直接從 Xero 提交年度稅表
  • 即使 API 有限,三表手動匯出 + Agent 解析回填的方式已非常有效

📋 交接包 — 給明年 Agent 和會計師

✅ 給明年接手者的第一句話

BCH Investments Limited FY2025 IR4 已於 2026年3月31日 23:56 NZT 提交成功,確認號 0-590-821-384。數字完全來自 Xero,已核對,無重大調整(除 IR10 負數重分類)。這個網頁和文件夾裡的19個文件是完整的證據鏈。

🤖 給新 Agent 的接手說明

1

先讀文件夾

文件在:G:\我的云端硬盘\公司文件\所有公司年報\BCH Investment Limited 2025FY\
優先讀:16_FY2025_Tax_Handover_Report(人類可讀)和 15_AGENT_HANDOVER_XERO_Copy(完整日誌)

2

確認關鍵數字

FY26 起點:Loss carry forward -8,072,366.80 / IR4J Opening -37,906.27 / P&L Net Loss -304.50

3

接 Xero

用 D:\Backup\Downloads\GitHub_Copilot\skills\skills\xero_oauth_setup.py
Xero Tenant ID:973ce089-5910-4b1b-9b35-b1b85103c270
密鑰在 GCP Secret Manager(project: nvda-strategy)

4

FY26 年賬開始時

複製 13_Checklist_Template 作 FY26 新版。更新 Xero 三表和銀行對帳。先填 Loss carry forward 和 IR4J,再填 IR4 主表。

👨‍💼 給會計師的說明

項目說明
申報狀態✅ FY2025 IR4 已提交,確認號 0-590-821-384
帳務來源Xero(BCH Investments Limited,財年 31-Mar)
三表一致性P&L / Balance Sheet / Trial Balance 已互相核對,與 IR4 一致
銀行核對Bank 00+01 合計 27.58 = Xero GL 27.58,差額 0
調整說明IR10 Other current liabilities 重分類(-208,310.33 → 0,調入 Current loans)
IR4JOpening -37,906.27 / Closing -37,906.27(本年無 imputation 增減)
結轉虧損期初 8,072,062.30 + 本年 -304.50 = 8,072,366.80(FY26用)
所有文件見 Google Drive:公司文件/所有公司年報/BCH Investment Limited 2025FY/

⚡ Xero 接入技術資訊(給技術 Agent)

OAuth 腳本d:\Backup\Downloads\GitHub_Copilot\skills\skills\xero_oauth_setup.py
GCP Projectnvda-strategy
Secret Namesxero-client-id / xero-client-secret / xero-oauth-config
Tenant ID973ce089-5910-4b1b-9b35-b1b85103c270
Xero OrganisationBCH Investments Limited
Financial Year End31-Mar
可用 Scopeaccounting.invoices / payments / contacts / banktransactions / attachments / budgets / assets / projects / files
不可用 Scopeaccounting.reports.read / transactions / journals.read

📅 FY26 準備 — 明年怎麼做,不從0開始

✅ 有了這次的基礎,FY26 估計可以節省 60-70% 的時間。以下是完整的 SOP。

📋 FY26 年賬準備 SOP(標準流程)

1

複製文件夾模板

複製 BCH Investment Limited 2025FY 整個文件夾,改名為 BCH Investment Limited 2026FY,刪掉今年的實際文件,保留空白模板(13_Checklist_Template)。

2

從 myIR 下載 FY26 文件

下載:IR4 回執(若已提交)、Loss carry forward 通知、ITAX 交易頁(截圖PDF)、銀行對帳單(截至31-Mar-2026)。

3

從 Xero 匯出三表

P&L(FY2026,含 FY2025 對比)、Balance Sheet(截至31-Mar-2026)、Trial Balance(截至31-Mar-2026),格式:PDF + Excel。

4

確認 FY26 起始數字

• Net loss brought forward = -8,072,366.80(來自 04_IRD_2025_LossCarryForward_Notice)
• IR4J Opening balance = -37,906.27(來自今年 IR4J Closing)

5

接 Xero API(可選)

用 xero_oauth_setup.py auth-url → exchange → connections 驗證連接。可以用 API 拉取 Invoices/Payments/BankTransactions 供核對。三表仍從 Xero 界面手動匯出。

6

填 IR4 主表

myIR → Income tax → Returns → File return
① Income 頁:填 Business or other rental income(= Xero P&L 淨損益)
② IR10:填財務摘要(注意負數重分類!)
③ IR4J:填 Opening = -37,906.27,確認 Closing
④ Lowest economic interest:填 100.00%

7

提交前核對清單

☑ IR4 數字 = Xero 三表 ☑ Loss carry forward = 官方通知 ☑ IR4J opening = 上年 closing ☑ 銀行對平 ☑ IR10 無負數 ☑ 無空白必填欄

8

提交 + 立即下載回執

提交後立即下載 IR4 Submitted PDF(不要等!去年就是提交後才想到要補下載)。

🔑 FY26 必用的 FY25 數字

Loss brought forward8,072,366.80
IR4J Opening balance-37,906.27
FY25 Net Profit/Loss(對比用)-304.50
FY25 Revenue(對比用)35,860.20
FY25 Expenses(對比用)36,164.70

⚠️ FY26 提前要注意的坑

  • IR10 負債欄位如有負數,沿用重分類方案
  • Xero scope 不要加 reports.read(會報錯)
  • IR4J 不在獨立入口,在主流程裡
  • Business income 一定要填,否則 Tax Calc 顯示0
  • 提交後立即下載 PDF

📖 術語表 — 小白看這裡,中英對照

🏢 公司稅務基本概念

IR4
公司所得稅申報表
Income Tax Return for Companies。紐西蘭公司向 IRD 提交的年度所得稅申報表。每年在財年結束後一定期限內提交(BCH 財年 31-Mar,即4月之後提交)。
IR10
財務摘要
Financial Statement Summary。隨 IR4 一起提交的財務摘要表,包含損益和資產負債的關鍵數字。可選但建議提交(保持與 Xero 一致)。
IR4J
股息抵免年報
Annual Imputation Return。記錄公司 Imputation Credit Account (ICA) 全年增減情況的報表,隨 IR4 一起完成。BCH 本年無增減,故 Opening = Closing = -37,906.27。
ICA
股息抵免帳戶
Imputation Credit Account。公司繳稅後產生的可分配給股東的稅收抵免記錄帳戶。BCH 長期 Debit balance(借方),因為歷史上 ICA 支出多於收入。
Loss Carry Forward
虧損結轉
當年虧損可結轉至以後年度,抵扣未來盈利,從而減少未來應稅收入。BCH 積累了 8,072,366.80 的結轉虧損,未來盈利可用此抵扣。
myIR
IRD 線上申報系統
Inland Revenue Department 的在線服務平台(my.ird.govt.nz)。用於提交稅表、查看通知、下載歷史文件。是實際填報 IR4 的地方。
Xero
會計軟件
紐西蘭/澳大利亞流行的雲端會計軟件。BCH 的帳務記錄都在 Xero 裡,包括發票、費用、資產負債等。需從 Xero 匯出三表用於報稅。

📊 三表說明

P&L
損益表
Profit & Loss Statement。顯示公司一個財年內的收入和費用。BCH FY2025:收入 35,860.20,費用 36,164.70,淨虧損 -304.50。用於填 IR4 Business income 和 IR10 Income 部分。
Balance Sheet
資產負債表
Balance Sheet / Statement of Financial Position。顯示公司在某個時點(31-Mar-2025)的資產、負債和股東權益。用於填 IR10 Balance Sheet 部分。驗算:Total Assets = Total Liabilities + Owners' Equity。
Trial Balance
試算表
所有賬戶借方/貸方餘額的匯總,用於驗證賬務是否平衡。不直接填入 IRD,但作為底稿驗算 P&L 和 Balance Sheet 的口徑一致性。

💻 技術術語

OAuth
授權協議
Open Authorization。一種讓第三方應用(如 AI Agent)在不獲取你密碼的情況下,代表你訪問 Xero 數據的授權機制。需要用戶手動點擊"同意"一次。
Scope
API 權限範圍
OAuth Scope。控制 API 可以訪問哪些數據的權限聲明。BCH Xero App 的可用 scope 有限,不能用 accounting.reports.read 拉三表,但可以讀發票、付款、銀行交易等。
GCP Secret Manager
密鑰管理
Google Cloud Platform Secret Manager。所有 Xero API 密鑰(client_id / client_secret)都存在這裡,不存在本地明文。Project:nvda-strategy。
Tenant ID
Xero 組織ID
每個 Xero 組織(公司)的唯一識別碼。BCH Investments Limited 的 Tenant ID:973ce089-5910-4b1b-9b35-b1b85103c270。Agent 每次連接 Xero 都需要這個 ID。
文件預覽
下載