¿Puede un sistema de inteligencia artificial procesar y presentar una declaración de impuestos Self Assessment a HMRC automáticamente?

Un compañero breve y de lectura rápida. Para obtener información detallada sobre arquitectura, HMRC OAuth, ejemplos de curl y limitaciones, lea el artículo largo. No asesoramiento fiscal.

¿Puede AI presentar su Self Assessment a HMRC?

Cada enero aparece la misma pregunta: ¿puede una IA leer mis extractos bancarios y presentar mi declaración de impuestos del Reino Unido? La respuesta práctica de un sistema que construimos para CognoAI - publicado aquí como FileMyTax - es sí para preparación, no para presentación desatendida. La IA puede extraer transacciones de archivos PDF, clasificarlas en categorías HMRC Self Assessment, conciliar saldos y calcular los impuestos 2025-26 de forma determinista; un humano aún revisa, un contador aún aprueba y el contribuyente aún completa HMRC OAuth antes de que algo llegue a producción MTD.

Workstation desarrolló la plataforma subyacente; CognoAI posee la propiedad intelectual. Esta publicación explica cómo se ve eso en seis llamadas API, sin utilizar nombres de productos que pertenecen a otros lugares.

Mira la demostración

Almacene PDF mediante clasificación y cálculo en el entorno de pruebas HMRC MTD, con puertas de revisión en la interfaz de usuario.

El proceso de seis pasos

1. Subir — POST /fastapi/api/upload envía el PDF a MinIO a través de nginx.
2. Extracto — pdfplomber para mesas nativas; Claude Vision para exploraciones.
3. Clasificar — LLM asigna líneas a categorías de gastos de SA con puntuaciones de confianza.
4. Conciliar — verificaciones de saldo y acumulaciones de ingresos/gastos.
5. Calcular – impuesto sobre la renta determinista 2025-26 + Clase 4 NI (sin LLM en matemáticas).
6. Archivo — POST /fastapi/api/file a HMRC MTD después de OAuth y la aprobación humana.

La autenticación JWT proviene de opsapi; NINO está cifrado en reposo; Gatus en el puerto 8085 vigila cada servicio.

quien lo construyo

CognoAI posee la propiedad intelectual del sistema y la dirección del producto. Workstation creó la plataforma Dockerised: enrutamiento de ruta nginx, servicios de IA FastAPI, autenticación opsapi, PostgreSQL, MinIO, monitoreo Gatus y la interfaz de usuario de revisión Next.js. Publicamos bajo el nombre. FileMyTax describir la demostración; No utilizamos otros nombres de productos CognoAI en este artículo.

Por qué ayuda la IA y dónde termina

La IA gana en velocidad y coherencia en cientos de líneas bancarias, señalización de anomalías y asignación de descripciones confusas a categorías HMRC. No reemplaza el juicio: transferencias versus alquileres, capital versus ingresos, y personal versus negocios todavía necesitan ojos. El motor de impuestos es Python puro con campos DECIMALES, la misma separación en la que insistimos para las finanzas reguladas: LLM para lenguaje, código para ley.

En las pruebas utilizamos Accesorios ficticios de declaración de propietario al estilo HSBC (solo datos sintéticos) con escenarios de alta rotación para enfatizar la extracción, incluidas lecciones en las que pdfplomber eligió la columna incorrecta (saldo versus pago). Esos fracasos son la razón por la que existen la reconciliación y la revisión.

Arquitectura de un vistazo

Un nginx en localhost está al frente de todo: Next.js para humanos, FastAPI para IA y archivado, opsapi para iniciar sesión y NINO cifrado. PostgreSQL almacena extractos y transacciones clasificadas; MinIO contiene archivos PDF. La calculadora de impuestos aplica bandas del Reino Unido 2025/26 en Python (reducción de asignación personal, impuesto sobre la renta, Clase 4 NI) con campos monetarios DECIMAL(18,2). Esa división es intencional: los reguladores y los contadores necesitan matemáticas reproducibles, no tokens probabilísticos.

Beneficios para los equipos financieros

• Velocidad — cientos de líneas clasificadas en minutos, no en días en Excel.
• Consistencia — las mismas reglas de categoría HMRC en cada fila.
• Anomalías — la conciliación saca a la luz errores de equilibrio y mapeo tempranamente.
• Pista de auditoría — estado de procesamiento, confianza, anulaciones con motivos.
• Privacidad — opción de pila local sin pasar declaraciones a través de un inquilino SaaS.
• tiempo de contador – los revisores ven un borrador de declaración, no archivos PDF sin formato.

HMRC MTD en un párrafo

Guarde NINO a través de opsapi, inicie OAuth, obtenga negocios y obligaciones, luego archive en la zona de pruebas hasta que su contador esté satisfecho. Los encabezados de prevención de fraude y la actualización de tokens se manejan en el lado del servidor. Voltear HMRC_ENVIRONMENT=production sólo cuando lo dices en serio.

Descargos de responsabilidad

• No asesoramiento fiscal. Consiga que un contador del Reino Unido lo revise antes de realizar el envío en vivo.
• FileMyTax es el nombre de la demostración en este artículo; Otros nombres de productos de CognoAI están separados; no los combine.
• Datos bancarios ficticios donde se mencionan los accesorios de prueba.
• Sin presentación desatendida - puerta humana antes POST /api/file.

Lo que verás en el vídeo.

El tutorial de YouTube muestra la interfaz de usuario de Next.js: cargue una declaración, observe el progreso de extracción y clasificación, inspeccione las puntuaciones de confianza, ejecute el cálculo para el año fiscal 2025-26, conecte HMRC en la zona de pruebas y haga una pausa en el paso del archivo hasta que un humano lo confirme. Esa pausa es la decisión sobre el producto, no una característica faltante. La presentación totalmente desatendida sería más rápida y jurídicamente frágil.

Los propietarios con múltiples cuentas de alquiler y los comerciantes individuales con líneas comerciales y personales mixtas son el público principal. Los equipos de operaciones financieras que los apoyan obtienen el mismo canal: menos exportaciones de CSV, menos noches en vela antes del 31 de enero, más tiempo para explicar las cifras en lugar de encontrarlas.

Pruébalo de forma segura

Clona la pila, ejecuta ./start.sh, pegue los ejemplos de rizos del artículo extenso y permanezca en la zona de pruebas de HMRC hasta que su contador haya revisado una declaración completa. Colocar HMRC_ENVIRONMENT=sandbox, cree un usuario de prueba si es necesario y trate POST /api/file como un misil de producción, porque en modo real lo es.

Si el puerto 80 de nginx está ocupado, utilice NGINX_HOST_PORT=8080. Si JWT falla repentinamente, verifique que opsapi y FastAPI compartan el mismo secreto. Si la conciliación lo exige, corrija la asignación de columnas del PDF antes de anular las clasificaciones: ese orden ahorra horas.

OAuth no es opcional

HMRC no aceptará una presentación de un trabajo cron en segundo plano con solo un número de seguro nacional. El contribuyente debe autorizar su solicitud a través de Government Gateway, que devuelve tokens que el backend almacena y actualiza. FileMyTax aparece en la configuración: guarde un NINO cifrado, abra la URL de autorización de HMRC, regrese mediante devolución de llamada, busque negocios y obligaciones, luego presente el archivo. Los encabezados de prevención de fraude acompañan a cada llamada API: la identificación del dispositivo, el agente de usuario y el resto del Gov-* configuran la plataforma desde el cliente.

Es por eso que "automático" en las diapositivas de marketing realmente significa preparación automática con una puerta deliberada humana y OAuth al final. La ingeniería sigue siendo valiosa: los seis pasos de curl son repetibles, comprobables en sandbox y observables en Gatus.

Lea la versión larga

El artículo largo cubre atribución, arquitectura SVG, ejemplos completos de rizos, tabla de beneficios, pasos de OAuth, limitaciones, monitoreo de Gatus, parámetros fiscales 2025-26 y hoja de ruta. Mirar la demostración de youtube y visitar cognoai.es para el contexto del producto; Workstation para ingeniería.