Um sistema de IA pode processar e arquivar uma declaração de imposto Self Assessment para HMRC automaticamente?

Um companheiro curto e de fácil leitura. Para obter informações completas sobre arquitetura, HMRC OAuth, exemplos de curl e limitações, leia o longo artigo. Não é aconselhamento fiscal.

A IA pode arquivar seu Self Assessment para HMRC?

Todo mês de janeiro surge a mesma pergunta: uma IA pode ler meus extratos bancários e enviar minha declaração de imposto de renda no Reino Unido? A resposta prática de um sistema que construímos para CognoAI - publicado aqui como FileMyTax - é sim, para preparação, não para arquivamento autônomo. A IA pode extrair transações de PDFs, classificá-las em categorias HMRC Self Assessment, reconciliar saldos e calcular impostos de 2025-26 de forma determinística; um humano ainda analisa, um contador ainda assina e o contribuinte ainda conclui o HMRC OAuth antes que qualquer coisa chegue à produção do MTD.

TenthMatrix desenvolveu a plataforma subjacente; CognoAI possui a propriedade intelectual. Esta postagem explica como isso acontece em seis chamadas API – sem usar nomes de produtos pertencentes a outros lugares.

Assista à demonstração

Banco de PDF por meio de classificação e cálculo para sandbox HMRC MTD — com portas de revisão na UI.

O pipeline de seis etapas

1. Carregar — POST /fastapi/api/upload envia o PDF para MinIO via nginx.
2. Extrair — pdfplumber para tabelas nativas; Claude Vision para exames.
3. Classificar — LLM mapeia linhas para categorias de despesas SA com pontuações de confiança.
4. Conciliar — verificações de saldo e acumulações de receitas/despesas.
5. Calcular — imposto de renda determinístico 2025-26 + NI Classe 4 (sem LLM em matemática).
6. Arquivo — POST /fastapi/api/file para HMRC MTD após OAuth e aprovação humana.

A autenticação JWT vem do opsapi; NINO é criptografado em repouso; Gatus na porta 8085 assiste a todos os serviços.

Quem construiu

CognoAI possui o IP do sistema e a direção do produto. TenthMatrix construiu a plataforma Dockerizada - roteamento de caminho nginx, serviços FastAPI AI, autenticação opsapi, PostgreSQL, MinIO, monitoramento Gatus e a UI de revisão Next.js. Publicamos sob o nome FileMyTax para descrever a demonstração; não usamos outros nomes de produtos CognoAI neste artigo.

Por que a IA ajuda – e onde ela para

A IA vence em velocidade e consistência em centenas de linhas bancárias, sinalização de anomalias e mapeamento de descrições confusas para categorias HMRC. Não substitui o julgamento: transferências versus rendas, capital versus receitas e pessoais versus empresariais ainda precisam de atenção. O mecanismo tributário é puro Python com campos DECIMAL – a mesma separação que insistimos para finanças regulamentadas: LLM para linguagem, código para lei.

Nos testes usamos luminárias fictícias de declarações de proprietários no estilo HSBC (apenas dados sintéticos) com cenários de alta rotatividade para extração de estresse - incluindo lições em que o pdfplumber escolheu a coluna errada (saldo versus pago). Essas falhas são a razão pela qual existem reconciliação e revisão.

Visão geral da arquitetura

Um nginx no localhost enfrenta tudo: Next.js para humanos, FastAPI para IA e arquivamento, opsapi para login e NINO criptografado. PostgreSQL armazena extratos e transações classificadas; MinIO contém PDFs. A calculadora de impostos aplica faixas do Reino Unido 2025/26 em Python - redução gradual de subsídio pessoal, imposto de renda, classe 4 NI - com campos monetários DECIMAL (18,2). Essa divisão é intencional: reguladores e contadores precisam de matemática reproduzível, e não de tokens probabilísticos.

Benefícios para equipes financeiras

• Velocidade — centenas de linhas classificadas em minutos, não em dias no Excel.
• Consistência — mesmas regras de categoria HMRC em todas as linhas.
• Anomalias — a reconciliação revela antecipadamente erros de equilíbrio e de mapeamento.
• Trilha de auditoria — status de processamento, confiança, substituições com motivos.
• Privacidade — opção de pilha local sem passar instruções por meio de um locatário SaaS.
• Hora do contador — os revisores veem um retorno preliminar, não PDFs brutos.

HMRC MTD em um parágrafo

Salve NINO via opsapi, inicie o OAuth, busque negócios e obrigações e, em seguida, arquive no sandbox até que seu contador esteja satisfeito. Os cabeçalhos de prevenção de fraude e a atualização de token são tratados no lado do servidor. Virar HMRC_ENVIRONMENT=production somente quando você está falando sério.

Isenções de responsabilidade

• Não é aconselhamento fiscal. Peça a um contador do Reino Unido para revisar antes do envio ao vivo.
• FileMyTax é o nome da demonstração neste artigo; outros nomes de produtos CognoAI são separados – não os misture.
• Dados bancários fictícios onde os acessórios de teste são mencionados.
• Nenhum arquivamento autônomo - portão humano antes POST /api/file.

O que você verá no vídeo

O passo a passo do YouTube mostra a IU do Next.js: carregue um extrato, observe o progresso da extração e classificação, inspecione as pontuações de confiança, execute o cálculo para o ano fiscal de 2025-26, conecte o HMRC no sandbox e faça uma pausa na etapa do arquivo até que um humano confirme. Essa pausa é a decisão do produto – e não um recurso que falta. A submissão totalmente autônoma seria mais rápida e juridicamente frágil.

Proprietários com múltiplas contas de aluguel e empresários individuais com linhas pessoais e comerciais mistas são o público principal. As equipes de operações financeiras que os apoiam obtêm o mesmo pipeline: menos exportações de CSV, menos noites passadas antes de 31 de janeiro, mais tempo explicando números em vez de localizá-los.

Experimente com segurança

Clone a pilha, execute ./start.sh, cole os exemplos de curl do artigo longo e permaneça na sandbox HMRC até que seu contador conclua um retorno completo. Definir HMRC_ENVIRONMENT=sandbox, crie um usuário de teste, se necessário, e trate POST /api/file como um míssil de produção - porque no modo ao vivo, é.

Se a porta 80 do nginx estiver ocupada, use NGINX_HOST_PORT=8080. Se o JWT falhar repentinamente, verifique se opsapi e FastAPI compartilham o mesmo segredo. Se a reconciliação exigir, corrija o mapeamento das colunas do PDF antes de substituir as classificações – essa ordem economiza horas.

OAuth não é opcional

A HMRC não aceitará um registro de um cron job em segundo plano com apenas um número de Seguro Nacional. O contribuinte deve autorizar sua aplicação por meio do Government Gateway, que retorna tokens que o backend armazena e atualiza. Superfícies FileMyTax que fluem nas configurações: salve um NINO criptografado, abra o URL de autorização HMRC, retorne via retorno de chamada, busque negócios e obrigações e, em seguida, arquive. Os cabeçalhos de prevenção de fraude acompanham cada chamada API – ID do dispositivo, agente do usuário e o restante do Gov-* define a plataforma encaminhada do cliente.

É por isso que "automático" em slides de marketing realmente significa preparação automática com um humano deliberado e uma porta OAuth no final. A engenharia ainda é valiosa: as seis etapas de curl são repetíveis, testáveis ​​em sandbox e observáveis ​​em Gatus.

Leia a versão longa

O artigo longo cobre atribuição, arquitetura SVG, exemplos full curl, tabela de benefícios, etapas OAuth, limitações, monitoramento Gatus, parâmetros fiscais 2025-26 e roteiro. Assistir a demonstração do YouTube e visite cognoai.uk para contexto do produto; TenthMatrix para engenharia.