>Trabalhei anos como freelancer em Portugal e, por muito tempo, tratei a relação com o Fisco como uma chatice mensal — abrir o portal, validar faturas à mão, cruzar recibos com a contabilidade. Até que comecei a olhar pra essas apps da Autoridade Tributária e Aduaneira (AT) com olhos de dev. Segundo o Sapo.pt, são cinco apps oficiais que simplificam a vida do contribuinte — e que, vistas de outro ângulo, escondem um ecossistema que dá pra automatizar, integrar e transformar em vantagem técnica. É isso que eu quero mostrar aqui.
e-Fatura: a porta de entrada — e o que está por baixo do capô
A app e-Fatura é a mais descarregada do conjunto, e com razão. Lê o QR Code do talão, valida a fatura no momento, classifica por setor de atividade e mostra o benefício fiscal acumulado ao longo do ano. Para o utilizador comum, é uma app deconveniência. Para o dev, é uma app deconveniência que assenta sobre um portal web com autenticação por NIF e senha — e que expõe um conjunto de serviços que dá pra puxar programaticamente.
Na minha experiência, dá pra fazer download estruturado das faturas do ano em CSV, importar pra uma base de dados local, e aplicar regras de IRS (saúde, educação, restauração, despesas gerais) muito antes do prazo de entrega. Já automatizei isto num projeto pessoal em Node.js: o script faz login no portal, descarrega o ficheiro anual, categoriza e gera um relatório com a estimativa de reembolso.
O detalhe técnico que pouca gente respeita
O portal das Finanças tem proteção anti-bots e rate limit agressivo. Se fizer requests em loop sem delay, leva com CAPTCHA ou bloqueio temporário do NIF. Aprendi isto na pele — perdi um dia de trabalho porque estourei o limite ao tentar sincronizar três anos de faturas. Respeite sempre intervalos entre requests, e guarde a sessão em memória em vez de relogar a cada chamada.
Situação Fiscal – Pagamentos: o que o Fisco sabe sobre si
Esta é a app que eu abro antes de aceitar qualquer freelance novo. Mostra, de forma consolidada, os pagamentos em cobrança voluntária, os que já estão em atraso, o estado dos reembolsos e os dados de identificação do contribuinte. Tem também integração com MB WAY para pagar impostos diretamente — coisa que, para quem vive de recibos verdes, é ouro.
O que pouca gente sabe: o extrato de pagamentos exposto nesta app é, em termos práticos, a mesma informação que a AT consulta quando decide emitir certidões de dívida ou bloquear NIF. Ou seja, é a sua “verdade oficial” com o Estado. Eu recomendo a todos os devs freelancers que olhem pra esta app como o dashboard real do vosso negócio — não o que está no vosso banco.
Comparação honesta com alternativas
Existem plataformas privadas como o Ticketline ou apps de gestão financeira que tentam agregar este tipo de informação, mas nenhum tem a autoridade da fonte oficial. Para confirmar valores, prazos e estados, a app da AT é insubstituível. Para análise e projeção, faça você mesmo o seu pipeline — fica mais barato e mais transparente.
ATGO – Gestão da Atividade: feita para devs freelancers
Se você emite recibos verdes, esta app é praticamente um mini-ERP no bolso. Permite faturação simplificada, gestão de atividades, consulta de declarações periódicas de IVA e acompanhamento de obrigações declarativas. Antes do ATGO, era preciso entrar no portal web e perder meia hora por cada declaração. Agora, faço pelo telemóvel em cinco minutos, sentado no café.
O aspeto interessante, do ponto de vista técnico, é que a app guarda tudo localmente e sincroniza com os servidores da AT quando há ligação. Isto significa que dá pra trabalhar offline — útil para quem está em zonas com rede fraca, algo que Portugal ainda tem mais do que se admite, mesmo em 2026.
IRS e AT Mobile: as apps que fecham o ciclo
A app IRS é a que entra em ação todos os anos entre abril e junho: permite entregar a declaração, simular o reembolso, anexar documentos e consultar a nota de liquidação. Já a AT Mobile funciona como agregador — dá acesso rápido aos vários serviços da AT num só sítio, com login biométrico no telemóvel.
Um truque que eu uso: ativei o login com impressão digital no AT Mobile. Combinado com o preenchimento automático que o e-Fatura faz (que envia as despesas dedutíveis pré-classificadas para o IRS), o tempo que passo com a declaração anual caiu de uma tarde inteira para menos de 30 minutos.
Na Prática: ler o QR Code de uma fatura em Python
O QR Code nas faturas portuguesas segue o formato definido pela AT: A:NIF*AM:montante*DT:data*.... Saber parsear isto permite construir ferramentas de validação offline, contabilómetros, ou simplesmente integrar a leitura com o seu sistema de gestão.
import re
from pyzbar.pyzbar import decode
from PIL import Image
def parse_pt_invoice_qr(qr_string: str) -> dict:
fields = {}
pattern = re.compile(r"([A-Z]{2,}):([^A-Z*]+)")
for match in pattern.finditer(qr_string):
fields[match.group(1)] = match.group(2).strip()
return {
"nif_emissor": fields.get("A"),
"montante": fields.get("AM"),
"data": fields.get("DT"),
"num_fatura": fields.get("DOC"),
}
# Exemplo com leitura via imagem
image = Image.open("fatura.jpg")
results = decode(image)
if results:
parsed = parse_pt_invoice_qr(results[0].data.decode("utf-8"))
print(parsed)
Com este snippet, você fotografa o talão, a lib pyzbar lê o QR, o regex separa os campos e devolve um dicionário limpo. A partir daqui, dá pra gravar numa base SQLite, despachar para o vosso sistema contabilístico, ou usar como base para validar faturas em lote antes da entrega do IRS.
Erros comuns que devs cometem com estas apps
Não adianta fugir das apps — convém usá-las bem. Pelo que vejo em fóruns e nas dúvidas que recebo, estes são os erros mais frequentes:
- Confiar só na app, esquecer o portal. A app é uma camada fina sobre o portal das Finanças. Certidões, alterações de morada, IBAN para reembolso — só dá pra fazer no portal web. Não trate a app como substituto.
- Não ativar a biometria. Em 2026, não faz sentido ter a password no autofill. Vá às definições da app e ative Face ID / impressão digital. Se perder o telemóvel, revoga primeiro pelo portal.
- Classificar faturas à pressa. O Estado usa a sua classificação para efeitos de IRS. Erros grosseiros (marcar uma despesa de saúde como restauração) podem levantar alertas e obrigar a justificação. Dedique 2 minutos por semana, não 2 horas em março.
- Esquecer a data limite de confirmação. Faturas não confirmadas até 25 de fevereiro não contam para o IRS daquele ano. Ponha alarme no calendário — eu uso cron job mensal no servidor pessoal que me manda email.
- Partilhar login entre apps e terceiros. Existem apps não-oficiais que pedem login das Finanças. Nunca ceda. A password da AT dá acesso ao seu NIF, morada, IBAN, e estado fiscal completo.
FAQ — Perguntas frequentes de devs
As apps da AT funcionam offline?
Parcialmente. O ATGO permite registar atividade offline e sincroniza depois. As outras apps precisam de ligação para autenticar e consultar dados em tempo real.
Posso integrar as apps da AT com sistemas próprios?
Não diretamente via API pública formal — a AT não tem um marketplace de APIs como a Stripe. Mas existem serviços não-oficiais (alguns abertos no GitHub) que fazem scraping controlado. Use com cuidado, em baixa frequência, e respeite o robots.txt.
Qual a app mais útil para freelancers e devs independentes?
Sem dúvida, o ATGO, seguida da Situação Fiscal – Pagamentos. Combinadas, cobrem quase 100% do fluxo de trabalho de quem emite recibos verdes.
Os dados são seguros?
As apps usam autenticação multifator e encriptação TLS. Mas o elo mais fraco é sempre o dispositivo — telemóvel sem PIN, app aberta em segundo plano, sessões partilhadas. Trate a password da AT como trata a chave do seu banco.
Existe alternativa internacional?
Não para a realidade fiscal portuguesa. Sistemas como o HMRC (Reino Unido) ou o IRS (EUA) têm apps próprias, mas não servem para o caso PT. Para faturação cruzada, o InvoiceXpress ou o Moloni complementam, mas não substituem.
Gostou? Me segue no GitHub e deixa um comentário se tiver dúvida ou quiser aprofundar algum ponto.