Un système d’IA peut-il traiter et déposer automatiquement une déclaration de revenus Self Assessment auprès de HMRC ?

Un compagnon court et lisible. Pour une analyse approfondie de l'architecture, de HMRC OAuth, des exemples de curl et des limitations, lisez le long article. Pas de conseils fiscaux.

AI peut-il déposer votre Self Assessment sur HMRC ?

Chaque mois de janvier, la même question apparaît : une IA peut-elle lire mes relevés bancaires et soumettre ma déclaration de revenus au Royaume-Uni ? La réponse pratique d'un système pour lequel nous avons construit CognoAI - publié ici sous le titre FileMyTax - est oui pour la préparation, pas pour le classement sans surveillance. L'IA peut extraire les transactions des PDF, les classer dans les catégories HMRC Self Assessment, rapprocher les soldes et calculer de manière déterministe l'impôt 2025-2026 ; un humain examine toujours, un comptable approuve toujours et le contribuable termine toujours HMRC OAuth avant que quoi que ce soit n'atteigne la production MTD.

Workstation a développé la plateforme sous-jacente ; CognoAI est propriétaire de la propriété intellectuelle. Cet article explique à quoi cela ressemble dans six appels API, sans utiliser les noms de produits appartenant à d'autres.

Regardez la démo

Enregistrez des PDF via la classification et le calcul dans le bac à sable HMRC MTD — avec des portes de révision dans l'interface utilisateur.

Le pipeline en six étapes

1. Télécharger — POST /fastapi/api/upload envoie le PDF à MinIO via nginx.
2. Extrait — pdfplombier pour les tables natives ; Claude Vision pour les scans.
3. Classer — LLM mappe les lignes aux catégories de dépenses SA avec des scores de confiance.
4. Réconcilier — contrôles de solde et cumuls de revenus/dépenses.
5. Calculer — impôt sur le revenu déterministe 2025-26 + Classe 4 NI (pas de LLM en maths).
6. Déposer — POST /fastapi/api/file à HMRC MTD après OAuth et approbation humaine.

L'authentification JWT vient d'opsapi ; NINO est chiffré au repos ; Gatus sur le port 8085 surveille chaque service.

Qui l'a construit

CognoAI est propriétaire de l'adresse IP du système et de la direction du produit. Workstation construit la plate-forme Dockerisée - routage de chemin nginx, services d'IA FastAPI, authentification opsapi, PostgreSQL, MinIO, surveillance Gatus et interface utilisateur de révision Next.js. Nous publions sous le nom FileMyTax pour décrire la démo ; nous n'utilisons pas d'autres noms de produits CognoAI dans cet article.

Pourquoi l’IA aide – et où elle s’arrête

L'IA gagne en rapidité et en cohérence sur des centaines de lignes bancaires, en signalant les anomalies et en mappant les descriptions désordonnées aux catégories HMRC. Cela ne remplace pas le jugement : les transferts par rapport aux loyers, le capital par rapport aux revenus, et les particuliers par rapport aux entreprises, ont encore besoin d’être surveillés. Le moteur fiscal est du pur Python avec des champs DECIMAL — la même séparation sur laquelle nous insistons pour la finance réglementée : LLM pour le langage, code pour la loi.

Lors des tests, nous avons utilisé montages fictifs de déclaration du propriétaire de style HSBC (données synthétiques uniquement) avec des scénarios de chiffre d'affaires élevé pour stresser l'extraction - y compris des leçons où pdfplombier a choisi la mauvaise colonne (solde vs cotisations). Ces échecs sont la raison pour laquelle la réconciliation et la révision existent.

L'architecture en un coup d'oeil

Un nginx sur localhost gère tout : Next.js pour les humains, FastAPI pour l'IA et le classement, opsapi pour la connexion et NINO crypté. PostgreSQL stocke les relevés et les transactions classifiées ; MinIO contient des PDF. Le calculateur d'impôt applique les bandes britanniques 2025/26 en Python — réduction des allocations personnelles, impôt sur le revenu, classe 4 NI — avec des champs monétaires DECIMAL (18,2). Cette séparation est intentionnelle : les régulateurs et les comptables ont besoin de calculs reproductibles, et non de jetons probabilistes.

Avantages pour les équipes financières

• Vitesse — des centaines de lignes classées en minutes et non en jours dans Excel.
• Cohérence — mêmes règles de catégorie HMRC sur chaque ligne.
• Anomalies — la réconciliation fait apparaître les erreurs d'équilibre et de cartographie plus tôt.
• Piste d'audit — statut de traitement, confiance, remplacements avec raisons.
• Confidentialité - option de pile locale sans transmettre les instructions via un locataire SaaS.
• Temps du comptable - les réviseurs voient un brouillon de retour, pas des PDF bruts.

HMRC MTD en un seul paragraphe

Enregistrez NINO via opsapi, lancez OAuth, récupérez les entreprises et les obligations, puis déposez-les dans le bac à sable jusqu'à ce que votre comptable soit satisfait. Les en-têtes de prévention de la fraude et l'actualisation des jetons sont gérés côté serveur. Retourner HMRC_ENVIRONMENT=production seulement quand tu le penses.

Avis de non-responsabilité

• Pas de conseils fiscaux. Demandez à un comptable britannique de l'examiner avant de le soumettre en direct.
• FileMyTax est le nom de la démonstration dans cet article ; les autres noms de produits CognoAI sont distincts — ne les confondez pas.
• Données bancaires fictives où les montages de test sont mentionnés.
• Pas de dépôt sans surveillance — porte humaine avant POST /api/file.

Ce que vous verrez dans la vidéo

La procédure pas à pas de YouTube montre l'interface utilisateur de Next.js : téléchargez une déclaration, regardez la progression de l'extraction et de la classification, inspectez les scores de confiance, exécutez le calcul pour l'année fiscale 2025-26, connectez HMRC dans le bac à sable et faites une pause à l'étape du fichier jusqu'à ce qu'un humain confirme. Cette pause est la décision relative au produit – et non une fonctionnalité manquante. Une soumission entièrement sans surveillance serait plus rapide et juridiquement fragile.

Les propriétaires disposant de plusieurs comptes de location et les entrepreneurs individuels avec des secteurs mixtes de particuliers et d'entreprises constituent le public principal. Les équipes financières qui les soutiennent bénéficient du même pipeline : moins d'exportations CSV, moins de nuits blanches avant le 31 janvier, plus de temps à expliquer les chiffres au lieu de les trouver.

Essayez-le en toute sécurité

Clonez la pile, exécutez ./start.sh, collez les exemples curl du long article et restez dans le bac à sable HMRC jusqu'à ce que votre comptable ait effectué un retour complet. Ensemble HMRC_ENVIRONMENT=sandbox, créez un utilisateur test si nécessaire et traitez POST /api/file comme un missile de production – parce qu’en mode réel, c’est le cas.

Si le port nginx 80 est occupé, utilisez NGINX_HOST_PORT=8080. Si JWT échoue soudainement, vérifiez qu'opsapi et FastAPI partagent le même secret. Si la réconciliation s'impose, corrigez le mappage des colonnes PDF avant de remplacer les classifications : cet ordre vous fera gagner des heures.

OAuth n'est pas facultatif

HMRC n'acceptera pas de dépôt provenant d'une tâche cron en arrière-plan avec uniquement un numéro d'assurance nationale. Le contribuable doit autoriser votre demande via Government Gateway, qui renvoie les jetons stockés dans le backend et les actualise. Surfaces FileMyTax qui circulent dans les paramètres : enregistrez un NINO crypté, ouvrez l'URL d'autorisation HMRC, revenez via un rappel, récupérez les entreprises et les obligations, puis classez. Les en-têtes de prévention de la fraude accompagnent chaque appel API : l'ID de l'appareil, l'agent utilisateur et le reste du Gov-* configurent la plate-forme en avant depuis le client.

C'est pourquoi « automatique » dans les diapositives marketing signifie réellement préparation automatique avec une porte humaine et OAuth délibérée à la fin. L'ingénierie est toujours précieuse : les six étapes curl sont répétables, testables dans un bac à sable et observables dans Gatus.

Lire la version longue

Le long article couvre l'attribution, l'architecture SVG, les exemples complets de curl, le tableau des avantages, les étapes OAuth, les limitations, la surveillance Gatus, les paramètres fiscaux 2025-26 et la feuille de route. Montre la démo YouTube et visiter cognoai.uk pour le contexte du produit ; Workstation pour l'ingénierie.