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

Como funciona o Portugal SAF-T (PT) File Checks no Odoo por dentro

O Portugal SAF-T (PT) File Checks coloca tudo em Invoicing › SAF-T Accounting, com seis entradas: Generate SAF-T, SAF-T Submissions, Settings, Error Logs, Annual Statistics e GDPR Requests. Por dentro define modelos para gerar e validar o ficheiro, para o seu envio, para o registo de erros e para as estatísticas anuais.

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
4 min

O que o módulo acrescenta à Faturação

Que menus aparecem ao instalar o Portugal SAF-T (PT) File Checks?

Tudo fica sob um único menu dentro da Faturação: Invoicing › SAF-T Accounting. Aí encontra seis entradas, com estes caminhos completos: Invoicing › SAF-T Accounting › Generate SAF-T, Invoicing › SAF-T Accounting › SAF-T Submissions, Invoicing › SAF-T Accounting › Settings, Invoicing › SAF-T Accounting › Error Logs, Invoicing › SAF-T Accounting › Annual Statistics e Invoicing › SAF-T Accounting › GDPR Requests. Os nomes estão em inglês porque é assim que o módulo os define, e é assim que os citamos aqui para que os reconheça no ecrã.

O que se vê em Annual Statistics e em Error Logs?

São duas listas que pode abrir desde o primeiro dia. A das estatísticas anuais mostra, para cada registo, a empresa, o ano, o total de documentos, o valor total e o estado. A dos erros mostra a data, o tipo de erro, a gravidade, a mensagem e um indicador de resolvido. Se o que lhe interessa é o significado de cada mensagem e o que fazer com ela, consulte as mensagens de erro e avisos do módulo.

Lista de estatísticas anuais SAF-T com estados em castelhano, botão New e pesquisa
A mesma lista com cinco linhas por empresa, ano, total de documentos, valor total e estado (Borrador ou Exportado).
Lista de SAF-T Error Logs com data, tipo de erro, gravidade, mensagem e indicador de resolvido
O registo de erros com cinco entradas, todas com o indicador de resolvido desmarcado, botão Nuevo e barra de pesquisa.

Que modelos de dados existem por trás?

O módulo define estes modelos, cada um com a sua descrição técnica: saft.config (SAF-T Configuration per Company), saft.exporter (SAF-T File Generator and Validator), saft.submission (SAF-T File Submission to ATCUD), saft.error_log (SAF-T Error Log), saft.annual_statistics (SAF-T Annual Statistics Summary), saft.dsar_request (SAF-T Data Subject Access Request (DSAR)), saft.holiday_calendar (Portuguese Holiday Calendar for SAF-T Business Day Calculations) e saft.abuse_log (SAF-T Public Form Anti-Abuse Tracking). Conhecer estes nomes é útil se trabalha com um consultor ou vai mexer em permissões de acesso, exportações ou relatórios: são os objetos que verá no modo técnico.

O percurso de um ficheiro SAF-T dentro do módulo

Por que estados passa um ficheiro?

O trabalho do ficheiro divide-se entre dois modelos: saft.exporter, descrito como gerador e validador do ficheiro SAF-T, e saft.submission, descrito como o envio do ficheiro SAF-T para a ATCUD. Na lista de ficheiros gerados que aparece no fluxo animado surgem registos nos estados Draft, Generated, Validated, Validation Failed e Submitted, cada um com a sua empresa e o seu período de início e fim. São estes os estados que vai encontrar ao rever os seus ficheiros; que definições preencher antes de gerar o primeiro e o que rever na primeira semana explicamos em a colocação em funcionamento do módulo.

Percurso pelas listas do módulo: estatísticas anuais, registo de erros e ficheiros SAF-T gerados
Da lista de estatísticas anuais (em inglês e em castelhano) ao registo de erros e à lista Generate SAF-T Files, com seis registos em Draft, Generated, Validated, Validation Failed ou Submitted e o tamanho do ficheiro e as transações a zero.

Que verificação faz ao ficheiro?

A página do módulo no Odoo Apps resume-o no seu título: os ficheiros SAF-T (PT) são verificados contra o XSD. Ou seja, o módulo confronta o ficheiro com o esquema antes de o dar como bom, e o modelo que o faz é o mesmo que o gera, saft.exporter. Na lista de ficheiros vê quais os registos em Validated e quais em Validation Failed. O que o módulo verifica é o que descreve a sua documentação; não o tome como um parecer sobre as suas obrigações fiscais.

Serviço externo, versões e ajuda

Que parte depende de um serviço externo pago?

A página avisa antes da compra que algumas funções desta app usam um serviço externo pago; no caso deste módulo é um serviço local da FlexigoTech Cloud. Esse serviço custa 29 €/mês ou 290 €/ano sem IVA (Pro: 58 €/mês ou 580 €/ano). Sem subscrição, ou com o serviço suspenso, para o que a subscrição fornece, e os dados ficam no seu Odoo. A página inclui ainda uma secção Privacy policy que convém ler antes de o ativar.

Em que versões do Odoo está disponível e quanto custa o módulo?

Está publicado no Odoo Apps para Odoo 17, 18, 19 e 20, a 9 € por versão do Odoo, pagamento único e sem IVA, segundo a página de cada versão. Com a subscrição, o módulo para as novas versões do Odoo está incluído se o comprou em flexigotech.com; se o comprar no Odoo Apps, cada versão do Odoo compra-se lá.

A FlexigoTech pode implementá-lo ou adaptá-lo à minha empresa?

Sim. Na FlexigoTech implementamos Odoo 17, 18, 19 e 20 e desenvolvemos conectores e integrações à medida, por isso podemos ajudar a instalar o módulo, configurá-lo por empresa ou integrá-lo com o resto do seu Odoo. Se ainda tem dúvidas sobre se lhe serve, comece por o que o módulo cobre e o que é preciso antes de o instalar.

Continue a ler

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.Portugal SAF-T (PT) File Checks: o que cobre, o que precisa antes e em que versão do OdooO que cobre o Portugal SAF-T (PT) File Checks segundo o README, o que precisa antes de o instalar (NIF, ATCUD, e-mail) e em que versões do Odoo está.
Verificado no código do módulo (versão 20.0) e nas fontes indicadas

Fontes