A tua password das Finanças só se escreve em páginas cujo endereço termina em .gov.pt. Aqui, nunca.

Esta ferramenta não te pede a password e não consegue vê-la. Funciona como uma extensão do navegador: só corre quando tu clicas, só dentro da página do e-Fatura onde já fizeste login, e não vê mais nada. Se alguma vez um site te pedir as credenciais das Finanças, é burla. Fecha-o.

Não oficial Projeto pessoal e independente. Não é um serviço do Estado nem da Autoridade Tributária.

Fatura BoaClassificar faturas pendentes do e-Fatura, por setor, para o IRS
e-Fatura / IRS

Fontes oficiais,
em vez de palpites.

Fartei-me de classificar faturas uma a uma sem saber se estava a acertar, e não me apetece entregar isso a alguém e ficar na mesma. Esta ferramenta vai buscar a atividade real de cada comerciante ao registo do Estado, mostra-te onde estão os teus tetos, e a decisão continua a ser tua.

Despesas gerais familiares17.035,28 €
dedução obtida250,00 €
250 € de dedução o resto não dá dedução

Isto é a minha conta de 2025. O teto das despesas gerais estava cheio há muito, enquanto a Saúde tinha 784 € por usar. Não é drama nenhum, é só informação que eu não tinha à frente enquanto classificava.

Uma fatura acima do teto continua a contar para a Fatura da Sorte e continua a ser um registo teu. O que deixa de crescer é só a dedução.

corre no teu navegador nunca pede password as faturas não saem daqui código auditável
Versão de teste. Ainda não submete nada.

Nesta fase a ferramenta analisa e mostra-te o plano: que setor faz sentido para cada fatura, quanto já gastaste de cada teto, e quanta dedução estás a perder. A submissão fazes tu, no e-Fatura, com o plano à frente. Copias ou envias para o teu email e aplicas.

É de propósito: classificar uma fatura é uma declaração tua à AT, e antes de deixar um programa fazer isso sozinho quero ver a coisa a funcionar em contas reais. Se experimentares e algo estiver errado, diz-me. É a forma mais útil de ajudar.

Apoia esta ferramenta (sem custo nenhum para ti)

Isto é gratuito e vai continuar a ser: sem contas, sem subscrições, sem anúncios, e as tuas faturas nunca saem do teu navegador. Se te poupou tempo ou dinheiro e quiseres retribuir, abrir uma conta Revolut pelo link abaixo dá-me uma pequena comissão.

Abrir conta Buy me a coffee

Link de referência. Não sou afiliado nem parceiro da Revolut, e não partilho nada teu com eles - o link é só um link. Não precisas de clicar para usar a ferramenta, que funciona exatamente igual de qualquer maneira.

Como classificar as faturas pendentes do e-Fatura

Faz login normal no e-Fatura, como sempre fazes.
Clica no favorito Fatura Boa (instalado abaixo). Ele lê as tuas faturas pendentes e sugere o setor de cada uma com base no teu histórico e na atividade oficial de cada comerciante, já a saltar os setores cujo teto anual esteja cheio.
Revês a tabela. Cada fatura traz duas sugestões: Provável (o que a compra provavelmente foi) e Otimizada (o que dá mais dedução e ainda cabe no teto). Vem selecionada a Provável; clicas na outra se a compra foi mesmo dessa natureza. Depois copias o plano (ou envias para o teu email) e aplicas no e-Fatura. A ferramenta não submete nada.

O que acontece quando clicas (todos os pedidos de rede, por ordem)

Para quem quiser confirmar antes de correr: isto é a lista completa. Abre o separador Rede do navegador e compara.

  1. GET cae-db.diogoandrade.com/sectors.json - o mapa público de atividades, cerca de 1,6 KB. Não leva nada teu. Repara no detalhe: a ferramenta descarrega o mapa inteiro e faz a correspondência no teu navegador, em vez de perguntar "qual é o setor deste NIF?". Por isso o servidor nunca fica a saber onde compras. Vê o teu IP, como qualquer servidor vê, e mais nada.
  2. GET obterDocumentosAdquirente, no próprio e-Fatura, com a sessão que já tinhas aberta. É o mesmo pedido que a página faz sozinha. As faturas ficam no teu navegador: não passam por nenhum servidor meu.
  3. Mais nada. A partir daqui só há pedidos se clicares: a partilha de agregado (opcional, envia seis números) ou o botão "Enviar anónimo" (quatro números, sem NIF e sem comerciantes). Se não clicares, não sai nada.

Nesta versão não existe nenhum pedido de escrita para a AT. O código que submeteria está no repositório, desligado, e há um teste automático que falha se alguma vez passar a submeter.

Porque é seguro (e porque devias desconfiar de qualquer site que te peça a password das Finanças)

Atenção: nunca introduzas o teu NIF e password das Finanças numa página cujo endereço não termine em .gov.pt. Esta ferramenta nunca to pede, e é essa a diferença.

Instalar (só funciona no computador)

Isto é para computador, não para telemóvel. A ferramenta é um favorito que corre dentro da página do e-Fatura, e os navegadores de telemóvel não deixam fazer isso. Não é uma limitação que eu possa contornar: as alternativas seriam pedir-te a password, que nunca vou fazer, ou ser uma aplicação oficial da AT, que isto não é nem tem como ser. Se andas no telemóvel, guarda para quando estiveres ao computador.

Arrasta este botão para a tua barra de favoritos:

Fatura Boa

Depois, abre o e-Fatura, faz login, e clica no favorito. (Se o teu navegador não deixar arrastar, clica com o botão direito e escolhe Adicionar aos favoritos, e cola o endereço do botão.)

Que setor escolher para cada fatura (ano de rendimentos 2026)

Resumo dos setores de dedução e respetivos limites
SetorO que incluiBenefício
SaúdeConsultas, farmácia, dentista, óculos, fisio, psicologia/terapia. IVA 23% só conta com receita médica associada.15%, máx €1.000
EducaçãoPropinas, creche, colégio, explicações, manuais, formação certificada.30%, máx €800
HabitaçãoRendas de habitação própria, ou juros de crédito à habitação (contratos até 2011).15%, máx €900 (800 € em 2025, 1000 € a partir de 2027)
LaresLares e apoio domiciliário (próprio ou ascendentes).25%, máx €403,75
Restauração, cabeleireiro, ginásio, veterinário, oficina, transportes, jornais, livros…Cada fatura no setor correto do comerciante. Ex: ginásio->Ginásios, restaurante->Restauração.15% do IVA, pool partilhada máx €250
Despesas Gerais FamiliaresTudo o resto com NIF (supermercado, roupa, combustível, telecom…).35%, máx €250

A ferramenta só te propõe setores para os quais o comerciante está mesmo registado. Por isso o e-Fatura aceita-os todos, e é aí que está a confusão: ser aceite não quer dizer que esteja certo. Um hipermercado tem CAE de farmácia, mas se compraste comida, a compra foi despesas gerais e não saúde. Por isso há duas colunas: a Provável, que é a atividade principal do comerciante ou o que tu já usaste antes, e a Otimizada, que é o setor que dá mais dedução e ainda tem espaço. Vem pré-selecionada a Provável. A Otimizada só é tua para usar se a compra foi mesmo dessa natureza. Quem declara és tu.

Porque é que a Fatura Boa existe

Sempre tive problemas com isto. Todos os anos a mesma coisa: dezenas de faturas pendentes à espera de serem classificadas, uma a uma, num menu que não ajuda nada. Deixava andar, esquecia-me, e chegava a Fevereiro a perder deduções que eram minhas por direito, só porque não tive paciência para clicar 200 vezes.

Mas não era só falta de paciência, e demorei a perceber isso. O que torna isto difícil não é a complexidade: é a frequência. Quem trabalha em contabilidade faz isto todos os dias, e por isso é rotina. Tu fazes uma vez por ano, num sítio onde nunca ganhas prática, com regras que mudam de ano para ano. Ninguém fica bom numa coisa que faz de doze em doze meses. É aí que se perdem deduções, e não por distração.

Se quiseres a versão curta do que isto é: é como teres alguém ao teu lado a passar as faturas contigo. Alguém que faz isto todos os dias, que já sabe onde estão as armadilhas, e que faz num par de segundos o que te levaria uma tarde. A diferença é que não decide nada por ti. Mostra-te o que sabe, explica-te porquê, e a escolha continua a ser tua. É basicamente o que eu faria se estivesse aí sentado, só que muito mais rápido e sem me chateares outra vez para o ano.

O que me irritava mais não era o trabalho. Era perceber que a informação toda já existe. As Finanças sabem qual é a atividade de cada comerciante, e essa atividade determina o setor. Uma farmácia é saúde. Um restaurante é restauração. Isso está registado no SICAE, o registo oficial do Estado, e é público. Mesmo assim, cabe a ti adivinhar, fatura a fatura.

Então construí isto. Lê as tuas faturas pendentes, vai buscar a atividade real de cada comerciante, e sugere o setor certo. Onde um comerciante tem várias atividades (um hipermercado com farmácia, livraria e restaurante dentro, o que é mais comum do que parece), escolhe a que te dá mais dedução e que ainda tem espaço no teto anual. Tu revês e aprovas. Nada é submetido sem o teu clique.

É de graça e vai continuar a ser. Não vendo nada, não há conta para criar, não recolho nada teu. Se te poupar uma tarde e algum dinheiro no IRS, já valeu a pena.

Obrigado, e diz-me o que está mal

Obrigado a quem já testou, reportou erros e partilhou chaves de API para construir o mapa de atividades que esta ferramenta usa. Isso é o que a tornou possível.

Se encontrares uma classificação errada, quero saber. É a forma mais útil de ajudar: cada correção fica no mapa partilhado e passa a beneficiar toda a gente que usar a ferramenta a seguir. O mesmo para sugestões, dúvidas, ou se simplesmente não perceberes alguma coisa - se não se percebe, é problema meu, não teu.

Uso-o so para te responder. Nada mais, e nao fica guardado em lado nenhum.

Preferes o GitHub? Abre um issue, ou fala comigo em diogoandrade.com.

Quem fez isto

Sou o Diogo Andrade. Trabalho com automação, dados e infraestrutura, normalmente a resolver exatamente este tipo de chatice: coisas que deviam ser automáticas e não são, e coisas que só são difíceis porque as fazes uma vez por ano.

Se quiseres ver outros projetos, ou falar sobre algum trabalho, diogoandrade.com.

Fontes

Isto mexe com uma declaração fiscal, por isso as regras usadas aqui vêm de fontes oficiais e ficam à vista para poderes confirmar. Se achares que interpretei alguma coisa mal, diz.