AI系統可以自動處理Self Assessment納稅申報表並將其提交到HMRC嗎?
演示 FileMyTax — 由 Workstation 為 CognoAI 構建的從銀行 PDF 到 HMRC MTD 歸檔的 AI 驅動管道
簡短易讀的伴侶。如需全面深入瞭解架構、HMRC OAuth、curl 示例和限制,請閱讀 長篇文章. 不是稅務建議。
AI可以將您的Self Assessment歸檔到HMRC嗎?
每年一月都會出現同樣的問題:人工智慧可以讀取我的銀行對賬單並提交我的英國納稅申報表嗎?我們構建的系統給出的實際答案 認知人工智慧 — 在此釋出為 FileMyTax - 是 是的,用於準備,而不是用於無人值守的歸檔。 AI可以從PDF中提取交易,將其分類為HMRC Self Assessment類別,核對餘額,並確定性地計算2025-26年稅收;在任何東西到達生產 MTD 之前,人類仍然會進行審查,會計師仍然會簽字,納稅人仍然會完成 HMRC OAuth。
Workstation開發底層平臺; CognoAI擁有智慧財產權。這篇文章解釋了六個 API 呼叫的情況 - 沒有使用其他地方擁有的產品名稱。
觀看演示
透過分類和計算將 PDF 存入 HMRC MTD 沙箱 — 在 UI 中提供稽核門。
六步管道
- 上傳 —
POST /fastapi/api/upload透過 nginx 將 PDF 傳送到 MinIO。 - 提煉 — 用於本機表的 pdfplumber;克勞德視力掃描。
- 分類 — LLM 將行對映到帶有置信度分數的 SA 費用類別。
- 調和 — 餘額檢查和收入/支出彙總。
- 計算 — 確定性 2025-26 所得稅 + 4 類 NI(數學中沒有 LLM)。
- 檔案 —
POST /fastapi/api/fileOAuth 和人工批准後更改為 HMRC MTD。
JWT auth來自opsapi; NINO 靜態加密;埠 8085 上的 Gatus 監視每項服務。
誰建造的
認知人工智慧 擁有系統IP和產品方向。 Workstation 構建了 Dockerized 平臺 — nginx 路徑路由、FastAPI AI 服務、opsapi auth、PostgreSQL、MinIO、Gatus 監控和 Next.js 稽核 UI。我們以名義釋出 FileMyTax 描述演示;我們在本文中不使用其他 CognoAI 產品名稱。
為什麼人工智慧會有所幫助——以及它的侷限性
AI 在數百條銀行線的速度和一致性、異常標記以及將混亂的描述對映到 HMRC 類別方面獲勝。它並不能取代判斷:轉移與租金、資本與收入、個人與企業仍然需要關注。稅務引擎是帶有 DECIMAL 欄位的純 Python - 我們堅持對受監管的金融進行同樣的分離: LLM 代表語言,程式碼代表法律.
在測試中我們使用了 虛構的滙豐風格的房東宣告固定裝置 (僅限合成資料)在高週轉情況下進行壓力提取 - 包括 pdfplumber 選擇錯誤列的教訓(餘額與付費)。這些失敗就是協調和審查存在的原因。
架構一覽
本地主機上的一個 nginx 負責一切:用於人類的 Next.js、用於 AI 和歸檔的 FastAPI、用於登入的 opsapi 和加密的 NINO。 PostgreSQL儲存報表和分類交易; MinIO 儲存 PDF。稅收計算器應用 Python 中的英國 2025/26 頻段 — 個人津貼錐度、所得稅、4 類 NI — 以及 DECIMAL(18,2) 貨幣欄位。這種劃分是有意為之的:監管機構和會計師需要可重複的數學,而不是機率代幣。
對財務團隊的好處
- 速度 — 在 Excel 中,只需幾分鐘(而不是幾天)即可分類數百行。
- 一致性 — 每行都有相同的 HMRC 類別規則。
- 異常現象 - 調節表儘早顯示平衡和對映錯誤。
- 審計追蹤 — 處理狀態、信心、有理由的推翻。
- 隱私 — 本地堆疊選項,無需透過 SaaS 租戶傳遞語句。
- 會計時間 — 審閱者看到的是回報草稿,而不是原始 PDF。
HMRC MTD 一段
透過 opsapi 儲存 NINO,啟動 OAuth,獲取業務和義務,然後在沙箱中歸檔,直到您的會計師滿意為止。欺詐預防標頭和令牌重新整理在伺服器端處理。翻動 HMRC_ENVIRONMENT=production 僅當您真心實意時。
免責宣告
- 不是稅務建議。 在實時提交之前請一位英國會計師進行稽核。
- FileMyTax 是本文中的演示名稱;其他 CognoAI 產品名稱是獨立的 - 不要將它們混淆。
- 虛構的銀行資料 其中提到了測試夾具。
- 沒有無人值守的歸檔 ——之前的人門
POST /api/file.
您將在影片中看到什麼
YouTube 演練顯示了 Next.js UI:上傳宣告、觀察提取和分類進度、檢查置信度分數、執行 2025-26 納稅年度計算、在沙箱中連線 HMRC,並在檔案步驟暫停直至人工確認。這種停頓是產品的決定——而不是缺失的功能。完全無人值守的提交速度會更快,而且在法律上也很脆弱。
擁有多個租賃賬戶的房東以及個人和企業混合的個體經營者是主要受眾。支援他們的財務運營團隊獲得相同的管道:更少的 CSV 匯出、更少的 1 月 31 日之前的通宵工作、更多的時間解釋數字而不是查詢數字。
安全地嘗試一下
克隆堆疊,執行 ./start.sh,貼上長文章中的curl示例,並留在HMRC沙箱中,直到您的會計師完成完整的申報。放 HMRC_ENVIRONMENT=sandbox,如果需要的話建立一個測試使用者,並對待 POST /api/file 就像生產型導彈一樣——因為在實時模式下,它就是這樣。
如果 nginx 80 埠繁忙,請使用 NGINX_HOST_PORT=8080。如果 JWT 突然失敗,請驗證 opsapi 和 FastAPI 共享相同的金鑰。如果需要協調,請在覆蓋分類之前修復 PDF 列對映 - 該順序可以節省時間。
OAuth 不是可選的
HMRC 不會接受僅包含國民保險號碼的後臺 cron 作業的提交。納稅人必須透過政府閘道器授權您的應用程式,該閘道器返回後端儲存和重新整理的令牌。 FileMyTax 的設定流程如下:儲存加密的 NINO,開啟 HMRC 授權 URL,透過回撥返回,獲取業務和義務,然後歸檔。欺詐預防標頭伴隨著每個 API 呼叫 — 裝置 ID、使用者代理和 Gov-* 的其餘部分從客戶端設定平臺轉發。
這就是為什麼營銷幻燈片中的“自動”真正意味著 最後透過人工和 OAuth 門進行自動準備。該工程仍然很有價值:六個捲曲步驟是可重複的,可在沙箱中測試,並且可在 Gatus 中觀察。
閱讀長版本
這 長文章 涵蓋歸因、架構 SVG、完整捲曲示例、收益表、OAuth 步驟、限制、Gatus 監控、2025-26 稅收引數和路線圖。手錶 YouTube 演示 並參觀 英國科格諾艾 針對產品背景; Workstation 用於工程。
在您自己的機器上執行
在本機執行報稅 AI 的機器
銀行對帳單是您持有的最敏感資料之一。本地 LLM 可擷取每筆交易,並將其歸類至 HMRC 自行申報的收入與支出類別,對帳單完全不離開您的辦公室。以下每台機器都能執行本文中的擷取、分類與對帳步驟。按鈕會將其加入購物車並附上 Trade 會員資格,隨後開啟結帳頁面——付款前您可在該處移除 Trade。
- NVIDIA
NVIDIA DGX Spark
搭載 128 GB 統一記憶體的 GB10 Grace Blackwell。可並行執行 70B 級分類器與用於掃描對帳單的視覺模型,規模適合為多位客戶報稅的事務所。
以貿易會員身分加入購物車 - Apple
Apple Mac Studio,M5 Max,36 GB
適合個人事業主或小型事務所的安靜桌機。在 Ollama 或 MLX 中執行 8B–14B 模型,對整個稅務年度的交易進行分類,並將任何不確定的項目標記供審查。
以貿易會員身分加入購物車 - AMD Ryzen
Workstation Creator AI — AMD Ryzen 9 9950X + RTX 5090
16 核心 AMD Ryzen 直立式主機,配備 32 GB GPU,出貨時已安裝 Ubuntu 與 CUDA 軟體堆疊。批次處理對帳單時,OCR 與分類速度快。
以貿易會員身分加入購物車