人工智慧系統可以自動處理並向英國稅務海關總署提交自我評估納稅申報表嗎？

這是長篇深入探討。如需更快的同伴，請參閱 部落格文章. 不是稅務建議。 在向英國稅務海關總署 (HMRC) 實時提交之前，務必先進行英國會計師審查。

1.簡介：AI可以自動進行自我評估嗎？

誠實的答案是 大多數情況下是用於準備，否用於無人值守提交。人工智慧系統可以提取 PDF 銀行對賬單，提取數百筆交易，將其分類為 HMRC 自我評估費用類別，調節餘額，計算 2025-26 納稅年度的所得稅和國民保險，並呼叫 HMRC 稅務數字化 (MTD) API 進行歸檔，但前提是在人員（或會計師）審查了分類、對賬和計算的回報之後，並且只有在納稅人使用其政府閘道器憑證完成 HMRC OAuth 後。

這篇文章記錄了 檔案我的稅，開發的示範管道 工作站 為了 認知人工智慧，擁有底層系統智慧財產權，並獲准釋出其工作原理。 FileMyTax 是此處使用的出版物名稱；它與其他 CognoAI 產品的產品名稱不同。工作站搭建並記錄實施情況； CognoAI 擁有該 IP。

我們將介紹六種 API 管道、人工智慧幫助財務分析的架構、必須接管確定性程式碼、HMRC OAuth 和 MTD 歸檔、從房東銀行對賬單測試中瞭解到的限制，以及為什麼不建議完全無人值守的歸檔。

2. 誰建造了這個以及為什麼

認知人工智慧 委託底層平臺來減輕業主、個體經營者和財務團隊在英國自我評估中陷入 PDF 銀行對賬單和電子表格膠水的痛苦。我們的目標不是取代會計師，而是將繁瑣的 90% 工作（提取、分類、對賬、計算草稿）自動化，因此專業審查側重於判斷，而不是資料輸入。

工作站 設計了堆疊：Dockerized nginx 路由、Next.js 前端、用於 AI 密集型操作的 FastAPI、用於身份驗證和稅務 CRUD 的 opsapi (Lua Lapis)、PostgreSQL、MinIO 物件儲存和 Gatus 執行狀況監控。本文解釋了 FileMyTax 演示名稱下的架構以及 CognoAI 的歸屬。

3. 問題：PDF、電子表格和 MTD

房東和個體工商戶經常收到銀行 PDF 的年度包——多個賬戶、混合的個人和商業業務、抵押貸款利息、維修費、代理費和難以大規模分類的轉賬。在開發過程中，我們對管道進行了壓力測試 虛構的滙豐風格的房東宣告固定裝置 （僅合成資料，不是真實的客戶記錄），營業額場景約為 50 萬英鎊和 70 萬英鎊，以驗證負載下的提取。現實世界的包很混亂：掃描的頁面、表格佈局（其中餘額列被誤認為已付款金額）以及需要上下文的描述，例如“RENT REC”旁邊的“TRANSFER”。

電子表格一直有效，直到它們不起作用為止：公式漂移、沒有審計跟蹤、沒有直接 MTD 提交、沒有與 HMRC 費用類別（商品成本、營業場所執行成本、專業費用等）的一致對映。打包的 SaaS 可以提供幫助，但具有定製資料駐留需求或笨拙的語句格式的團隊仍然可以從他們控制的管道中受益。

4.FileMyTax 概述

簡單來說，FileMyTax 執行以下操作：

1. 您上傳 PDF 銀行對帳單。
2. AI 和 pdfplumber 提取結構化交易。
3. 法學碩士將每一行分類為帶有置信度分數的自我評估類別。
4. 系統調節借項、貸項和執行餘額。
5. 確定性稅務引擎計算所選納稅年度的回報。
6. 經過人工批准和 HMRC OAuth 後，平臺可以透過 MTD 進行歸檔。

一切都在本地主機（或用於移動測試的 LAN IP）上的單個 nginx 入口點後面執行。 JWT 身份驗證在 FastAPI 和 opsapi 之間共享。諸如國民保險號碼之類的敏感欄位會在靜態時進行加密。

5. 六步API管道

完整的演示管道是六個經過身份驗證的 API 呼叫（示例使用 nginx http://localhost;調整埠，如果 NGINX_HOST_PORT 已設定）。透過獲取 JWT POST /opsapi/auth/login 首先。

每一步都會更新 ProcessingStatus 和 ValidationStatus 行，以便 UI 和 Gatus 相鄰的操作工具可以檢視語句是否陷入提取狀態或準備好計算。在單獨閱讀curl示例時，該狀態機很容易被忽視，但這就是並行上傳安全的原因：語句ID是獨立的，並且始終計算單個鍵 statement_id 加上明確的 tax_year 查詢引數（例如 2025-26).

Swagger for FastAPI 位於 http://localhost/fastapi/docs; opsapi 暴露 http://localhost/opsapi/swagger。當nginx埠80被佔用時（Rancher Desktop或Apache常見），設定 NGINX_HOST_PORT=8080 在 .env 並重新執行 ./start.sh - 所有示例都使用 localhost:8080 相反。

5.1 上傳PDF宣告

curl -F "file=@bank_statement.pdf" \
  -H "Authorization: Bearer $TOKEN" \
  http://localhost/fastapi/api/upload

5.2 提取交易

curl -X POST http://localhost/fastapi/api/extract \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"statement_id": 1}'

原生 PDF 使用 pdfplumber；掃描的 PDF 會回退到 Claude Vision OCR。分類器提供者由以下方式選擇 LLM_PROVIDER （OpenAI 或 Anthropic）啟動時 — 失敗時不會自動跨提供商回退；分類失敗返回未分類 confidence: 0.0.

5.3 交易分類

curl -X POST http://localhost/fastapi/api/classify \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"statement_id": 1}'

5.4 協調宣告

curl -X POST http://localhost/fastapi/api/reconcile \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"statement_id": 1}'

5.5 計算納稅申報表

curl -H "Authorization: Bearer $TOKEN" \
  http://localhost/fastapi/api/calculate/1?tax_year=2025-26

稅收計算器適用 2025/26 年規則：個人免稅額為 12,570 英鎊，逐步超過 10 萬英鎊，所得稅稅率為 20%、40%、45%，4 級 NI 稅率為 8% 和 2%。這一步是 確定性Python — 沒有算術法學碩士。

5.6 向英國稅務海關總署 (HMRC) 提交檔案

curl -X POST http://localhost/fastapi/api/file \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "statement_id": 1,
    "nino": "AB123456C",
    "access_token": "your_hmrc_token",
    "tax_year": "2025-26"
  }'

請勿將此端點稱為無人值守。 將其視為稽核和會計師簽字後的最後一道關口。

6. 建築

透過 nginx 的流量： / 到 Next.js， /fastapi/* 到 FastAPI， /opsapi/* 到opsapi。 PostgreSQL 儲存報表、交易、納稅申報表和處理狀態。 MinIO 儲存上傳的 PDF。埠 8085 上的 Gatus 每 10-30 秒輪詢一次執行狀況端點。存在直接除錯埠（FastAPI 8847，前端 3847），但生產式測試僅使用 nginx 路徑。

7. 工作流程圖

泳道將關注點分開：客戶審查、攝取、AI 提取和分類、確定性稅務引擎、HMRC OAuth 和歸檔以及審計（JWT、加密 NINO、日誌）。該決策矩陣將 FileMyTax 人工智慧輔助流程與手動電子表格和僅由會計師準備的流程在時間、準確性、審計跟蹤、成本、HMRC 合規性和人工監督方面進行了比較。

8. 人工智慧財務分析——好處

8b.堆疊和服務（技術細節）

FileMyTax 背後是由以下人員編排的 Docker Compose 堆疊 ./start.sh，它可以在本地、LAN、測試、登臺或生產模式下執行。後端在 PostgreSQL 上使用 FastAPI 和 SQLModel；上傳的 PDF 登陸 MinIO，API 容器中的本地磁碟儲存為零。前端是 Next.js NEXT_PUBLIC_* 在構建時從根烘焙的變數 .env.

身份驗證是故意分開的。 奧薩皮 (Lua Lapis) 頒發 JWT 訪問令牌和不透明重新整理令牌（適用於 Web 的 HttpOnly 安全 cookie，適用於移動裝置的 JSON 主體）。 FastAPI驗證相同 JWT_SECRET_KEY。服務包括 StorageService、PDFProcessorService、LLMService、ClassificationService、ReconciliationService、TaxCalculatorService 和 HMRCClient，每個服務都有一個狹窄的邊界，因此人工智慧故障不會破壞稅務計算。

支援的銀行解析器針對常見的英國佈局（HSBC、Barclays、Lloyds、Santander 和類似的表格 PDF）。解析器靈活地檢測日期、描述、借方/貸方或金額以及餘額列——這在選擇錯誤的列之前非常強大；請參閱下面的限制。

9. 英國稅務海關總署 (HMRC) 實現稅務數字化

MTD 自我評估需要使用者授權的 OAuth——僅 NINO 是不夠的。典型流程：

1. 拯救尼諾 — POST /opsapi/api/v2/tax/profile/nino （靜態時加密，響應時隱藏）。
2. 連線英國稅務海關總署 — GET /opsapi/auth/hmrc/initiate 回報 auth_url;使用者透過政府閘道器登入；回撥交換伺服器端儲存的令牌的程式碼。
3. 獲取商家 — POST /fastapi/api/hmrc/businesses/fetch 快取交易名稱和 ID。
4. 獲取義務 — POST /fastapi/api/hmrc/obligations/fetch 對於季度期間和截止日期。
5. 檔案 — POST /fastapi/api/file 審查後。

套裝 HMRC_ENVIRONMENT=sandbox 為了發展；切換到 production 準備好後無需更改程式碼。後端傳送強制防欺詐標頭；客戶應提供穩定的 X-Device-ID 和準確的 User-Agent 價值觀。可以透過以下方式建立沙箱測試使用者 POST /fastapi/api/hmrc/sandbox/create-test-user 當沙盒模式啟用時。

HMRC 訪問令牌在大約四個小時後過期；後端管理重新整理 - 移動和 Web 客戶端使用 opsapi 儲存的令牌，而不是在 OAuth 重定向之外的瀏覽器中嵌入機密。

9.1 儲存 NINO 並檢查配置檔案

curl -X POST http://localhost/opsapi/api/v2/tax/profile/nino \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "nino": "QQ123456C" }'

curl -H "Authorization: Bearer $TOKEN" \
  http://localhost/opsapi/api/v2/tax/profile

反應掩蓋了 NINO (****456C）同時確認 hmrc_connected OAuth 後令牌過期。

9.2 OAuth發起

curl -H "Authorization: Bearer $TOKEN" \
  "http://localhost/opsapi/auth/hmrc/initiate?source=settings"

開啟 auth_url 在系統瀏覽器或 ASWebAuthenticationSession 中——而不是憑證填充的 WebView。移動應用程式應將深層連結或通用連結註冊為 HMRC_REDIRECT_URI.

9.3 業務和義務

curl -X POST http://localhost/fastapi/api/hmrc/businesses/fetch \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

curl -X POST http://localhost/fastapi/api/hmrc/obligations/fetch \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "business_id": "XAIS12345678910" }'

之後快取讀取避免在每次頁面載入時命中 HMRC： GET /fastapi/api/hmrc/businesses 和 GET /fastapi/api/hmrc/obligations?tax_year=2024-25.

9.4 斷開連線和狀態

curl -X DELETE http://localhost/opsapi/auth/hmrc/disconnect \
  -H "Authorization: Bearer $TOKEN"

curl -H "Authorization: Bearer $TOKEN" \
  http://localhost/fastapi/api/hmrc/status

8c.人工智慧財務分析——更深入的視角

除了彙總表之外，對於評估構建與購買的 FinOps 團隊來說，三種模式也很重要。

首先，吞吐量。 一個在兩個租賃賬戶上有 12 個月交易的個體商人可能會花一天時間在 Excel 資料透視表上； FileMyTax 管道在煮咖啡的時間內完成提取 + 分類 + 協調，從而將人類的時間用於判斷。這種轉變將會計經濟學從資料輸入轉向諮詢——無論如何，計費價值是會計師所偏愛的。

第二，可解釋性。 每個分類都帶有一個置信度分數，並且可以用與交易一起儲存的原因來覆蓋。這比完整的思想鏈審計日誌弱，但比黑盒 SaaS 匯出強，在黑盒 SaaS 匯出中您看不到為什麼第 417 行是“修復”。

第三，成本曲線。 在本地執行，每次回報的邊際成本是用於分類的 API 代幣加上電力，而不是隨實體數量縮放的每個席位 SaaS 費用。對於擁有許多報表的投資組合業主或財務運營團隊來說，這條曲線很重要。前期工程成本是真實的； CognoAI 透過工作站交付吸收了這一點，而不是每年將電子表格工作推給每個使用者。

對隱私敏感的組織還關心 PDF 和 Postgres 行在 HMRC 備案之前保留在其 Docker 網路中 - 演示架構中沒有多租戶雲攝取步驟。生產強化仍然需要備份、訪問控制和 DPIA 文件；本文並未假裝 GDPR 合規性是自動的，因為堆疊是本地的。

10. 演示影片

端到端 FileMyTax 演示：透過分類和計算將 PDF 存入 HMRC MTD 沙箱歸檔，並在 UI 中顯示稽核門。

11. 人在迴圈中

人工智慧可能會誤讀掃描的列，將轉賬與收入混淆，或者在描述模糊時分配錯誤的費用類別。 UI 專為稽核而設計：接受、覆蓋或拆分交易並捕獲原因。稅收計算是確定性的且可測試的；法學碩士從不計算應繳稅款。

會計簽字 在強制向 HMRC 提交任何實時報告之前。這篇文章是 不是稅務建議。 FileMyTax 展示了 CognoAI 的工程能力；您的情況在津貼、財產收入分割、合夥關係和其他 SA 計劃方面可能有所不同。

11b.使用 Gatus 進行監控

隨附的 Gatus 儀表板 (http://localhost:8085 預設情況下）透過 nginx、FastAPI 輪詢前端 /fastapi/health、opsapi /opsapi/health?detailed=true、Swagger 可訪問性以及用於旁路診斷的直接容器埠。每次檢查間隔為 10-30 秒。新增服務意味著編輯 monitoring/gatus/config.yaml 並重新啟動 Gatus 容器——在您信任真實財務資料的管道之前，這是一個小但重要的操作習慣。

健康檢查並不能替代端到端測試：該儲存庫還支援 Playwright E2E 針對正在執行的堆疊和後端的 pytest。綠色的 Gatus 板加上失敗的協調仍然是失敗的一天。

12. 限制

• PDF提取： pdfplumber 採用表格佈局；滙豐銀行風格的報表教會我們明確地驗證餘額與付費列——錯誤的列對映會默默地破壞對帳。
• 光學字元識別： 掃描的陳述取決於 Claude Vision；較差的掃描需要人工校正。
• 法學碩士護欄： 低置信度分類不得自動歸檔；提供商失敗時預設未分類，而不是猜測。
• 確定性分離： 稅階和 NI 稅率位於 tax_calculator.py 具有 DECIMAL 精度 - 絕不是即時設計的。
• 合規範圍： GDPR、2018 年資料保護法和 HMRC 規則適用；生產需要備份、機密管理和超出開發 Docker 組合的監控。
• JWT 對齊： FastAPI 和 opsapi 必須共享 JWT_SECRET_KEY;不匹配表現為不透明的 401 簽名錯誤 - 如果身份驗證在重新部署後突然中斷，請檢查兩個容器。
• 啟動時提供商鎖定： LLM_PROVIDER 是 openai 或 anthropic，無需交叉故障轉移；如果提供商出現中斷，請計劃維護時段。

在測試房東場景時，請將調節增量視為一流訊號，而不是滋擾。 1.2 萬英鎊的不匹配通常意味著列對映錯誤，而不是頑皮的租戶。修復提取規則並重新執行冪等管道比手動覆蓋數百行要便宜。

12b.與打包稅務軟體相比如何

FreeAgent、Xero Tax 和類似工具是大多數使用者的正確預設工具：經過認證的 MTD 聯結器、支援臺和經過培訓的會計師。當您需要自定義分類規則、本地或 VPC 部署、與現有 opsapi 身份平面整合或釋出垂直工作流程（如 CognoAI 對於 AI 輔助會計所做的那樣）時，FileMyTax 式平臺很有意義。工作流 SVG 中的決策矩陣是故意誠實的：電子表格速度慢且容易出錯；僅會計師是安全的，但重複準備費用昂貴；只有當您投資工程並仍然支付專業簽字費用時，人工智慧輔助的本地管道才能在可稽核性和邊際成本方面獲勝。

13. FileMyTax / CognoAI 的下一步是什麼

平臺文件中可見的路線圖專案包括更深入的 MTD ITSA 預覽計算往返、來自會計更正的擴充套件 RAG 式訓練資料、用於 SaaS 部署的多租戶身份驗證 cookie 域以及更嚴格的移動 OAuth 流程。 Workstation 代表 CognoAI 繼續進行工程設計；產品方向和 IP 仍由 CognoAI 負責。

工程讀者應該觀看上游儲存庫中的三個整合文件：HMRC MTD 整合（用於預覽計算的 A-D 階段）、共享身份驗證（JWT + 重新整理輪換）和 AI 訓練資料管道（pgvector 嵌入加上會計師更正的 MinIO markdown 匯出）。它們共同展示了當今的演示流程如何成為一個學習系統——當專業人員修復錯誤時分類會得到改善，而無需重新培訓稅務計算器。

對於運營商來說，生產部署意味著 ENVIRONMENT=production、HTTPS 終止在 nginx 前面、資料庫備份、平面之外的機密 .env 檔案，並在 Gatus 綠燈之外發出警報。這些都沒有削弱核心故事：人工智慧消除了電子表格的摩擦；確定性程式碼包含稅法；人類保留責任。

13b.常見問題

FileMyTax 會取代我的會計師嗎？ 不會。它減少了準備工作；會計師仍然會驗證銀行 PDF 上沒有的待遇、救濟和其他收入來源。

我可以在手機上執行這個嗎？ LAN 模式將 CORS 和 API URL 重寫為您的 Wi-Fi IP，以便您可以在同一網路上的手機上測試 Next.js UI - 對於演示很有用，但不能替代強化的移動釋出工程。

如果LLM掛了怎麼辦？ 分類以零置信度返回未分類的行；管道不會默默地切換提供商。您修復提供商配置或等待——人工稽核存在的另一個原因。

這裡有提到DIY TAX RETURN嗎？ 不。該名稱指的是單獨的 CognoAI 產品品牌。本文僅根據釋出規則使用 FileMyTax。

13c. 2025-26 計算快照

對於根據 HMRC 指南驗證確定性引擎的讀者，計算器中包含的 2025/26 年引數包括： 個人免稅額 12,570 英鎊，收入每超過 100,000 英鎊，每 2 英鎊減少 1 英鎊； 12,571 英鎊至 50,270 英鎊之間基本費率為 20%；利率提高 40%，最高可達 125,140 英鎊；在此之上加收45%； 4 級 NI，利潤在 12,571 英鎊至 50,270 英鎊之間，稅率為 8%，以上稅率為 2%。費用類別與 HMRC 自營職業框一致 - 商品成本、經營場所執行成本、旅行成本、專業費用以及平臺自述檔案中列出的其餘部分。發動機消耗分類總量；它不會重新解釋自然語言描述。這個邊界使得自動歸檔變得站得住腳：法學碩士提出了標籤；計算器適用法規。

14. 結論

人工智慧系統可以自動處理並向 HMRC 提交英國自我評估報告嗎？ 它可以自動化幾乎所有準備工作並公開一鍵式檔案 API，但負責任的使用需要人工稽核、會計師簽字、沙箱測試和納稅人 OAuth。 FileMyTax 展示了實踐中的情況：六個 API、清晰的架構、模式識別獲勝的人工智慧以及法律要求精確性的確定性程式碼。

觀看 YouTube 上的演示, 訪問 認知人工智慧 對於產品上下文，以及 聯絡工作站 如果您的堆疊上需要此類 FinOps 工程。

本文的 SEO 快照

• 搜尋引擎最佳化標題： AI 可以向 HMRC 提交自我評估嗎？ |檔案我的稅
• 元描述： FileMyTax 演示：AI 提取銀行 PDF、對 SA 交易進行分類、計算 2025-26 稅、透過 HMRC MTD 歸檔 — 並進行人工稽核。由 CognoAI 工作站構建。
• 主要關鍵詞： AI自我評估、FileMyTax、HMRC MTD、自動報稅、銀行對賬單AI、CognoAI、Workstation
• Twitter / X（280 個字元以下）： AI 可以向 HMRC 提交英國自我評估嗎？ FileMyTax 演示：銀行 PDF → 分類 → 計算 → MTD，首先是人門 + 沙箱。由 Workstation 為 @CognoAI 構建。影片 + 4k 字的文章。不是稅務建議。 #HMRC #MTD #AI #FileMyTax
• 領英帖子： 我們釋出了由 Workstation for CognoAI 開發的 FileMyTax 如何透過 AI 提取、HMRC 類別分類、確定性 2025-26 稅收計算和 MTD 歸檔，在提交前使用加密的 NINO 儲存、OAuth 和嚴格的人工審批門來獲取房東或個體工商戶銀行 PDF。這篇長文章涵蓋了六種 API 管道、架構 SVG、欺詐預防標頭和誠實限制（pdfplumber 列陷阱、LLM 信心護欄）。觀看新的演示影片；在任何實時檔案之前讓會計師簽字。不是稅務建議。

免責宣告：所引用的銀行資料均為虛構； FileMyTax 是一個演示名稱；不是稅務建議；在向 HMRC 實時提交之前需要進行會計師審查。