Kan een AI-systeem automatisch een Self Assessment-belastingaangifte verwerken en indienen bij HMRC?

Een korte, vlot leesbare metgezel. Voor de volledige diepgaande duik met architectuur, HMRC OAuth, curl-voorbeelden en beperkingen, lees het lange artikel. Geen belastingadvies.

Kan AI uw Self Assessment archiveren naar HMRC?

Elke januari verschijnt dezelfde vraag: kan een AI mijn bankafschriften lezen en mijn Britse belastingaangifte indienen? Het praktische antwoord van een systeem waarvoor we hebben gebouwd CognoAI - hier gepubliceerd als FileMyTax - is ja voor voorbereiding, niet voor onbewaakt archiveren. AI kan transacties uit pdf's extraheren, deze classificeren in HMRC Self Assessment-categorieën, saldi op elkaar afstemmen en de belasting voor 2025-2026 deterministisch berekenen; een mens controleert nog steeds, een accountant tekent nog steeds af en de belastingbetaler voltooit nog steeds HMRC OAuth voordat iets de productie van MTD bereikt.

Workstation ontwikkelde het onderliggende platform; CognoAI is eigenaar van het intellectuele eigendom. In dit bericht wordt uitgelegd hoe dat eruit ziet in zes API-oproepen – zonder productnamen te gebruiken die elders eigendom zijn.

Bekijk de demo

Bankeer PDF via classificatie en berekening naar HMRC MTD sandbox — met beoordelingspoorten in de gebruikersinterface.

De zesstappenpijplijn

1. Uploaden — POST /fastapi/api/upload stuurt de PDF via nginx naar MinIO.
2. Extract — pdfplumber voor native tabellen; Claude Vision voor scans.
3. Classificeren — LLM wijst lijnen toe aan SA-onkostencategorieën met betrouwbaarheidsscores.
4. Verzoenen — saldocontroles en overzichten van inkomsten en uitgaven.
5. Berekenen — deterministische inkomstenbelasting 2025-26 + klasse 4 NI (geen LLM in wiskunde).
6. Bestand — POST /fastapi/api/file naar HMRC MTD na OAuth en menselijke goedkeuring.

JWT-authenticatie komt van opsapi; NINO wordt in rust gecodeerd; Gatus op poort 8085 houdt elke dienst in de gaten.

Wie heeft het gebouwd

CognoAI is eigenaar van het systeem-IP en de productrichting. Workstation bouwde het Dockerised-platform: nginx-padroutering, FastAPI AI-services, opsapi-authenticatie, PostgreSQL, MinIO, Gatus-monitoring en de Next.js-beoordelingsinterface. Wij publiceren onder de naam FileMyTax om de demo te beschrijven; we gebruiken in dit artikel geen andere CognoAI-productnamen.

Waarom AI helpt – en waar het stopt

AI wint het op het gebied van snelheid en consistentie over honderden banklijnen, het markeren van afwijkingen en het toewijzen van rommelige beschrijvingen aan HMRC-categorieën. Het vervangt het oordeel niet: overdrachten versus huur, kapitaal versus inkomsten, en persoonlijk versus zakelijk hebben nog steeds ogen nodig. De belastingmotor is pure Python met DECIMAL-velden – dezelfde scheiding waar we op aandringen voor gereguleerde financiën: LLM voor taal, code voor wet.

Bij het testen hebben we gebruikt fictieve armaturen voor verhuurdersverklaringen in HSBC-stijl (alleen synthetische gegevens) met scenario's met hoge omzet om extractie te benadrukken - inclusief lessen waarbij pdfplumber de verkeerde kolom heeft gekozen (saldo vs. betaald). Deze mislukkingen zijn de reden waarom verzoening en herziening bestaan.

Architectuur in één oogopslag

Eén nginx op localhost regelt alles: Next.js voor mensen, FastAPI voor AI en archivering, opsapi voor inloggen en gecodeerde NINO. PostgreSQL slaat afschriften en geheime transacties op; MiniIO bevat PDF's. De belastingcalculator past UK 2025/26-banden toe in Python – afbouw van de persoonlijke aftrek, inkomstenbelasting, klasse 4 NI – met geldvelden DECIMAL(18,2). Die splitsing is opzettelijk: toezichthouders en accountants hebben reproduceerbare wiskunde nodig, geen probabilistische tokens.

Voordelen voor financiële teams

• Snelheid — honderden regels geclassificeerd in minuten, niet in dagen in Excel.
• Samenhang — dezelfde HMRC-categorieregels op elke rij.
• Afwijkingen — afstemming brengt evenwicht en kaartfouten vroegtijdig aan het licht.
• Audittrail — verwerkingsstatus, vertrouwen, overschrijvingen met redenen.
• Privacy — lokale stapeloptie zonder instructies door te geven via een SaaS-tenant.
• Accountant tijd — reviewers zien een conceptretour, geen onbewerkte pdf's.

HMRC MTD in één paragraaf

Bewaar NINO via opsapi, start OAuth, haal bedrijven en verplichtingen op en archiveer vervolgens in de sandbox totdat uw accountant tevreden is. Fraudepreventieheaders en tokenvernieuwing worden aan de serverzijde afgehandeld. Omdraaien HMRC_ENVIRONMENT=production alleen als je het meent.

Disclaimers

• Geen belastingadvies. Laat een Britse accountant het document beoordelen voordat u het live indient.
• FileMyTax is de demonstratienaam in dit artikel; andere CognoAI-productnamen zijn afzonderlijke namen; voeg ze niet samen.
• Fictieve bankgegevens waar testopstellingen worden genoemd.
• Geen onbeheerde archivering – menselijke poort ervoor POST /api/file.

Wat je in de video zult zien

De YouTube-walkthrough toont de Next.js-gebruikersinterface: upload een verklaring, bekijk de voortgang van de extractie en classificatie, inspecteer vertrouwensscores, voer berekeningen uit voor belastingjaar 2025-26, sluit HMRC aan in de sandbox en pauzeer bij de bestandsstap totdat een mens dit bevestigt. Die pauze is de productbeslissing en geen ontbrekende functie. Volledig onbeheerde indiening zou sneller en juridisch kwetsbaar zijn.

Verhuurders met meerdere huurrekeningen en eenmanszaken met gemengde persoonlijke en zakelijke lijnen vormen de primaire doelgroep. De financiële teams die hen ondersteunen, krijgen dezelfde pijplijn: minder CSV-exporten, minder nachten doorbrengen vóór 31 januari, meer tijd om cijfers uit te leggen in plaats van ze te vinden.

Probeer het veilig

Kloon de stapel, ren ./start.sh, plak de krulvoorbeelden uit het lange artikel en blijf in de HMRC-sandbox totdat uw accountant een volledige aangifte heeft doorlopen. Set HMRC_ENVIRONMENT=sandbox, maak indien nodig een testgebruiker aan en behandel POST /api/file als een productieraket – want in de live-modus is dat zo.

Als nginx-poort 80 bezet is, gebruik dan NGINX_HOST_PORT=8080. Als JWT plotseling faalt, controleer dan of opsapi en FastAPI hetzelfde geheim delen. Als afstemming schreeuwt, corrigeer dan de PDF-kolomtoewijzing voordat u classificaties overschrijft – die volgorde bespaart uren.

OAuth is niet optioneel

HMRC accepteert geen aanmeldingen van een cronjob op de achtergrond met alleen een burgerservicenummer. De belastingbetaler moet uw aanvraag autoriseren via Government Gateway, die tokens retourneert die naar de backend worden opgeslagen en vernieuwd. FileMyTax-oppervlakken met instellingen: sla een gecodeerde NINO op, open de HMRC-autorisatie-URL, keer terug via terugbellen, haal bedrijven en verplichtingen op en archiveer vervolgens. Fraudepreventieheaders worden bij elke API-oproep meegestuurd: apparaat-ID, user-agent en de rest van de overheid bepalen het platform vanaf de client.

Dat is de reden waarom 'automatisch' in marketingdia's eigenlijk betekent automatische voorbereiding met een opzettelijke menselijke en OAuth-poort aan het einde. De techniek is nog steeds waardevol: de zes curl-stappen zijn herhaalbaar, testbaar in de sandbox en waarneembaar in Gatus.

Lees de lange versie

De lang artikel omvat attributie, architectuur-SVG, volledige curl-voorbeelden, de voordelentabel, OAuth-stappen, beperkingen, Gatus-monitoring, belastingparameters voor 2025-26 en een routekaart. Horloge de YouTube-demo en bezoek cognoai.uk voor productcontext; Workstation voor techniek.