Saltar para o conteúdo principal
Portugal SAF-T (PT) File Checks

Portugal SAF-T (PT) File Checks: o que cobre, o que precisa antes e em que versão do Odoo

O Portugal SAF-T (PT) File Checks adequa-se se tem no Odoo a contabilidade de uma empresa portuguesa e quer gerar a partir daí o ficheiro SAF-T v1.03, validá-lo contra o esquema XSD da autoridade tributária portuguesa e enviá-lo para o portal ATCUD. Antes de o instalar precisa de um servidor de e-mail de saída, do NIF da empresa, do URL e das credenciais do endpoint ATCUD e, se o ATCUD o pedir, de um certificado digital. Está publicado no Odoo Apps para Odoo 17.0, 18.0, 19.0 e 20.0.

FlexigoTech · Responsável: Víctor Gómez · Atualizado em 4 de novembro de 2026

O essencial

Versões
Odoo 17, 18, 19 e 20
Verificado
no código do módulo, versão 20.0 · nas fontes indicadas no fim
Leitura
6 min

O que o módulo cobre segundo o README

O README organiza as funcionalidades em requisitos numerados (FR) e em secções com letra. O núcleo são estes requisitos:

  • Geração do XML SAF-T v1.03 (FR-001): cria os ficheiros a partir dos dados contabilísticos do Odoo.
  • Validação contra o esquema XSD (FR-002): o módulo verifica o ficheiro contra o esquema da autoridade tributária portuguesa.
  • Envio direto para o portal ATCUD (FR-003): com lógica de nova tentativa automática.
  • Erros e exceções (FR-004): registo detalhado de erros e mensagens pensadas para o utilizador.
  • Interface de configuração (FR-005): gestão de credenciais, e-mail e definições de envio.

À volta desse núcleo, o README descreve estas outras peças:

  • Multiempresa: acompanhamento dos envios por empresa, com registos de auditoria separados.
  • RGPD (secção C): menciona 10-year mandatory retention override e um fluxo DSAR com modelos de resposta legal.
  • Notificações por e-mail (secção D): orientações sobre DKIM/SPF/DMARC e confirmações de envio.
  • Estatísticas anuais (secção E): exportação e envio do relatório anual.
  • Observabilidade (secção F): logs em JSON, métricas do Prometheus e integração com o Sentry.
  • Proteção contra abusos (secção G): limitação de pedidos, campos armadilha (honeypot) e CAPTCHA em formulários públicos.
  • Ficheiros grandes (secção H): carregamento por partes com análise antivírus.
  • Chatter (secção I): conversação nos envios, com confidencialidade.
  • Desempenho (secção J): acompanhamento do SLO p99.
  • DSAR (secção K): acompanhamento da base legal e automatização de respostas.
  • Idiomas (secção L): interfaces multilingues.
Lista Generate SAF-T Files com registos por empresa, período e estado
A lista de geração de ficheiros SAF-T com seis registos nos estados Draft, Generated, Validated, Validation Failed e Submitted; tamanho de ficheiro e transações a zero.

O que faz o módulo e o que tem de pôr da sua parte

Para decidir, separe o que o README atribui ao módulo daquilo que tem de fornecer. Esta tabela junta as duas coisas com base na documentação.

NecessidadeFeito pelo módulo (README)Preparado por si (README)
Gerar o ficheiro SAF-TGera XML SAF-T v1.03 com os dados contabilísticos do OdooEscolher empresa e período em Generate SAF-T Files
Validar o ficheiroValida contra o esquema XSD da autoridade tributária portuguesaClicar em Generate SAF-T; depois o sistema valida
Enviar para o ATCUDEnvio direto para o portal com nova tentativa automáticaURL do endpoint ATCUD, credenciais e certificado digital se o ATCUD o pedir
Saber o que falhouRegisto detalhado de erros e mensagens para o utilizadorRever os erros registados
Confirmações por e-mailConfirmações de envio e orientações DKIM/SPF/DMARCOutgoing Mail Server com credenciais SMTP, remetente e endereço para confirmações
Várias empresasAcompanhamento por empresa com registos de auditoria separadosCredenciais de envio ATCUD nas definições da empresa
Relatório anualExportação e envio de estatísticas anuaisO README não detalha
Formulários públicosLimitação de pedidos, honeypot e CAPTCHAConfigurar a limitação de pedidos e a prevenção de abusos

A coluna da direita é a que lhe diz se pode arrancar já. O URL e as credenciais do endpoint ATCUD e o servidor de e-mail de saída fazem parte dos passos de configuração que o README descreve. Se lhe faltar algum, trate disso antes de instalar.

Lista SAF-T Error Logs com data, tipo de erro, gravidade e mensagem
O registo de erros SAF-T com cinco entradas: data, tipo de erro, gravidade, mensagem e indicador de resolvido por assinalar.

Se isto lhe acontece, compensa

  • Tem a contabilidade de uma empresa portuguesa no Odoo e quer tirar o SAF-T daí: o módulo cobre gerar, validar e enviar o ficheiro (FR-001 a FR-003).
  • Tem várias sociedades na mesma base de dados: o README fala de suporte multiempresa com registos de auditoria separados por empresa.
  • Ainda não tem acesso ao ATCUD: peça antes o URL do endpoint e as credenciais, porque as definições do módulo pedem-nos, tal como o certificado digital se o ATCUD o exigir.
  • A sua equipa técnica quer monitorizar o serviço: o README menciona logs em JSON, métricas do Prometheus, Sentry e acompanhamento do SLO p99.
  • Trabalham em vários idiomas: o README inclui interfaces multilingues (secção L).
  • Precisa de algo que não aparece na lista de funcionalidades: não o dê como certo. Pergunte antes de comprar ou pondere um desenvolvimento à medida.

Se quiser ver que menus acrescenta e como um registo percorre os seus estados, explicamos isso em como funciona o Portugal SAF-T (PT) File Checks por dentro.

Lista Annual SAF-T Statistics com empresa, ano, documentos, valor e estado
As estatísticas anuais SAF-T com cinco linhas por empresa e ano, total de documentos, valor total e estado Rascunho ou Exportado.

O que ter pronto antes de o instalar

No servidor

  • Odoo instalado: os passos de instalação do README começam por Ensure you have Odoo 19 installed, enquanto no Odoo Apps o módulo está publicado para 17.0, 18.0, 19.0 e 20.0. Consulte a ficha da versão que usa.
  • Pacotes Python: o README tem um passo Install required Python packages. Reveja a lista no README do módulo antes de instalar.
  • Diretório de addons: copiar o módulo para o diretório de addons do Odoo.
  • Instalação: no Odoo, Apps, procurar Portugal SAF-T e clicar em Install.

No Odoo

  • E-mail: em Settings → General Settings, secção Emails, configurar o Outgoing Mail Server com as suas credenciais SMTP e o endereço do remetente.
  • Definições SAF-T: em Accounting → Configuration → SAF-T Accounting → Settings, o NIF (Número de Identificação Fiscal), o URL do endpoint ATCUD com as respetivas credenciais e o certificado digital se o ATCUD o pedir.
  • Definições da empresa: credenciais de envio ATCUD, endereço de e-mail para as confirmações de envio e a limitação de pedidos e prevenção de abusos.

Nas capturas, as listas do módulo aparecem em Invoicing, enquanto o README escreve os caminhos com Accounting. Se não encontrar um menu, procure nos dois.

O percurso completo de definições e campos está em a configuração do Portugal SAF-T (PT) File Checks.

Versões do Odoo e preço

No Odoo Apps custa 9 € por versão do Odoo, pagamento único, sem IVA, para 17.0, 18.0, 19.0 e 20.0. É um módulo com serviço local da FlexigoTech Cloud, que custa 29 €/mês ou 290 €/ano sem IVA (Pro: 58 €/mês ou 580 €/ano).

Com a subscrição, o módulo para as novas versões do Odoo está incluído se o comprou em flexigotech.com; na Odoo App Store, cada versão do Odoo compra-se lá. Sem subscrição, ou com o serviço suspenso, para o que a subscrição fornece e os dados ficam no seu Odoo.

Como testá-lo com um período antes de decidir

O README descreve assim a geração de um ficheiro; pode segui-lo com um período para o ver a funcionar com os seus dados:

  1. Vá a Accounting → SAF-T Accounting → Generate SAF-T Files.
  2. Clique em Create para começar uma nova geração.
  3. Escolha a empresa e o período.
  4. Clique no botão Generate SAF-T.
  5. O sistema valida o ficheiro contra o esquema XSD.

Se a validação ou o envio falharem, em as mensagens de erro do Portugal SAF-T (PT) File Checks tem quando aparece cada uma e o que fazer.

Onde a FlexigoTech o ajuda

Implementamos Odoo 17, 18, 19 e 20 e desenvolvemos conectores e integrações à medida. Se o módulo cobre quase tudo o que precisa mas lhe falta uma peça, ou quer ajuda para deixar prontos o e-mail, o NIF e o acesso ao ATCUD, fale connosco através da página do módulo. Também pode consultar a ficha no Odoo Apps da sua versão.

Continue a ler

Como funciona o Portugal SAF-T (PT) File Checks no Odoo por dentroQue menus o Portugal SAF-T (PT) File Checks acrescenta à Faturação, que modelos tem por trás, que estados vê nas listas e que parte usa um serviço externo.Erros do Portugal SAF-T (PT) File Checks: quando aparece cada mensagem e o que fazerCada mensagem de erro do Portugal SAF-T (PT) File Checks com o texto literal: quando aparece, o que significa e o que fazer no Odoo, da geração ao envio ATCUD.Arranque do Portugal SAF-T (PT) File Checks no Odoo, contado através de um casoArranque do Portugal SAF-T (PT) File Checks no Odoo com um caso inventado: configuração ATCUD, campos-chave, estados e o que rever na primeira semana.
Verificado no código do módulo (versão 20.0) e nas fontes indicadas

Fontes