Salta al contingut principal
Portugal SAF-T (PT) File Checks

Portugal SAF-T (PT) File Checks: què cobreix, què necessites abans i en quina versió d'Odoo

Portugal SAF-T (PT) File Checks encaixa si portes a Odoo la comptabilitat d'una empresa portuguesa i vols generar des d'allà el fitxer SAF-T v1.03, validar-lo contra l'esquema XSD de l'autoritat tributària portuguesa i enviar-lo al portal ATCUD. Abans d'instal·lar-lo necessites un servidor de correu sortint, el NIF de l'empresa, la URL i les credencials de l'endpoint ATCUD i, si ATCUD ho demana, un certificat digital. Està publicat a Odoo Apps per a Odoo 17.0, 18.0, 19.0 i 20.0.

FlexigoTech · Responsable: Víctor Gómez · Actualitzat el 4 de novembre de 2026

L'essencial

Versions
Odoo 17, 18, 19 i 20
Comprovat
al codi del mòdul, versió 20.0 · a les fonts enllaçades al final
Lectura
6 min

Què cobreix el mòdul segons el seu README

El README organitza les funcions en requisits numerats (FR) i en seccions amb lletra. El nucli són aquests requisits:

  • Generació de l'XML SAF-T v1.03 (FR-001): crea els fitxers a partir de les dades comptables d'Odoo.
  • Validació contra l'esquema XSD (FR-002): el mòdul comprova el fitxer contra l'esquema de l'autoritat tributària portuguesa.
  • Enviament directe al portal ATCUD (FR-003): amb lògica de reintent automàtic.
  • Errors i excepcions (FR-004): registre detallat d'errors i missatges pensats per a l'usuari.
  • Interfície de configuració (FR-005): gestió de credencials, correu i ajustos d'enviament.

Al voltant d'aquest nucli, el README descriu aquestes altres peces:

  • Multiempresa: seguiment dels enviaments per empresa, amb traces d'auditoria separades.
  • RGPD (secció C): esmenta 10-year mandatory retention override i un flux DSAR amb plantilles de resposta legal.
  • Notificacions per correu (secció D): guia sobre DKIM/SPF/DMARC i confirmacions d'enviament.
  • Estadístiques anuals (secció E): exportació i enviament de l'informe anual.
  • Observabilitat (secció F): logs en JSON, mètriques de Prometheus i integració amb Sentry.
  • Protecció antiabús (secció G): limitació de peticions, camps parany (honeypot) i CAPTCHA en formularis públics.
  • Fitxers grans (secció H): pujada per trossos amb anàlisi antivirus.
  • Chatter (secció I): conversa als enviaments, amb confidencialitat.
  • Rendiment (secció J): seguiment de l'SLO p99.
  • DSAR (secció K): seguiment de la base legal i automatització de respostes.
  • Idiomes (secció L): interfícies multilingües.
Llista Generate SAF-T Files amb registres per empresa, període i estat
La llista de generació de fitxers SAF-T amb sis registres en estats Draft, Generated, Validated, Validation Failed i Submitted; mida de fitxer i transaccions a zero.

Què fa el mòdul i què hi poses tu

Per decidir, separa el que el README atribueix al mòdul del que hi has d'aportar tu. Aquesta taula ajunta les dues coses amb el que diu la documentació.

NecessitatHo fa el mòdul (README)Ho prepares tu (README)
Generar el fitxer SAF-TGenera XML SAF-T v1.03 amb les dades comptables d'OdooTriar empresa i període a Generate SAF-T Files
Validar el fitxerValida contra l'esquema XSD de l'autoritat tributària portuguesaPrémer Generate SAF-T; després el sistema valida
Enviar a ATCUDEnviament directe al portal amb reintent automàticURL de l'endpoint ATCUD, credencials i certificat digital si ATCUD ho demana
Saber què ha fallatRegistre detallat d'errors i missatges per a l'usuariRevisar els errors registrats
Confirmacions per correuConfirmacions d'enviament i guia DKIM/SPF/DMARCOutgoing Mail Server amb credencials SMTP, remitent i adreça per a confirmacions
Diverses empresesSeguiment per empresa amb traces d'auditoria separadesCredencials d'enviament ATCUD als ajustos de l'empresa
Informe anualExportació i enviament d'estadístiques anualsEl README no ho detalla
Formularis públicsLimitació de peticions, honeypot i CAPTCHAConfigurar la limitació de peticions i la prevenció d'abusos

La columna de la dreta és la que et diu si pots començar ja. La URL i les credencials de l'endpoint ATCUD i el servidor de correu sortint formen part dels passos de configuració que descriu el README. Si te'n falta algun, aconsegueix-lo abans d'instal·lar.

Llista SAF-T Error Logs amb data, tipus d'error, severitat i missatge
El registre d'errors SAF-T amb cinc entrades: data, tipus d'error, severitat, missatge i indicador de resolt sense marcar.

Si et passa això, et convé

  • Portes la comptabilitat d'una empresa portuguesa a Odoo i vols treure'n el SAF-T des d'allà: el mòdul cobreix generar, validar i enviar el fitxer (FR-001 a FR-003).
  • Tens diverses societats a la mateixa base de dades: el README parla de suport multiempresa amb traces d'auditoria separades per empresa.
  • Encara no tens accés a ATCUD: demana abans la URL de l'endpoint i les credencials, perquè els ajustos del mòdul les sol·liciten, igual que el certificat digital si ATCUD l'exigeix.
  • El teu equip tècnic vol vigilar el servei: el README esmenta logs en JSON, mètriques de Prometheus, Sentry i seguiment de l'SLO p99.
  • Treballeu en diversos idiomes: el README inclou interfícies multilingües (secció L).
  • Necessites alguna cosa que no surt a la llista de funcions: no ho donis per fet. Pregunta-ho abans de comprar o valora un desenvolupament a mida.

Si vols veure quins menús afegeix i com recorre un registre els seus estats, ho expliquem a com funciona Portugal SAF-T (PT) File Checks per dins.

Llista Annual SAF-T Statistics amb empresa, any, documents, valor i estat
Les estadístiques anuals SAF-T amb cinc files per empresa i any, total de documents, valor total i estat Esborrany o Exportat.

Què has de tenir a punt abans d'instal·lar-lo

Al servidor

  • Odoo instal·lat: els passos d'instal·lació del README comencen per Ensure you have Odoo 19 installed, mentre que a Odoo Apps el mòdul està publicat per a 17.0, 18.0, 19.0 i 20.0. Mira la fitxa de la versió que fas servir.
  • Paquets de Python: el README té un pas Install required Python packages. Revisa la llista al README del mòdul abans d'instal·lar.
  • Directori d'addons: copiar el mòdul al directori d'addons d'Odoo.
  • Instal·lació: a Odoo, Apps, cercar Portugal SAF-T i prémer Install.

A Odoo

  • Correu: a Settings → General Settings, secció Emails, configurar Outgoing Mail Server amb les teves credencials SMTP i l'adreça del remitent.
  • Ajustos SAF-T: a Accounting → Configuration → SAF-T Accounting → Settings, el NIF (Número de Identificação Fiscal), la URL de l'endpoint ATCUD amb les seves credencials i el certificat digital si ATCUD el demana.
  • Ajustos de l'empresa: credencials d'enviament ATCUD, adreça de correu per a les confirmacions d'enviament i la limitació de peticions i prevenció d'abusos.

A les captures, les llistes del mòdul apareixen sota Invoicing, mentre que el README escriu les rutes amb Accounting. Si no trobes un menú, cerca'l als dos llocs.

El recorregut complet d'ajustos i camps és a la posada en marxa de Portugal SAF-T (PT) File Checks.

Versions d'Odoo i preu

A Odoo Apps costa 9 € per versió d'Odoo, pagament únic, sense IVA, per a 17.0, 18.0, 19.0 i 20.0. És un mòdul amb servei local de FlexigoTech Cloud, que costa 29 €/mes o 290 €/any sense IVA (Pro: 58 €/mes o 580 €/any).

Amb la subscripció, el mòdul per a les versions noves d'Odoo hi va inclòs si el vas comprar a flexigotech.com; a l'Odoo App Store, cada versió d'Odoo es compra allà. Sense subscripció, o amb el servei suspès, s'atura el que dona la subscripció i les dades es queden al teu Odoo.

Com provar-lo amb un període abans de decidir

El README descriu així la generació d'un fitxer; pots seguir-lo amb un període per veure'l funcionar amb les teves dades:

  1. Ves a Accounting → SAF-T Accounting → Generate SAF-T Files.
  2. Prem Create per començar una generació nova.
  3. Tria l'empresa i el període.
  4. Prem el botó Generate SAF-T.
  5. El sistema valida el fitxer contra l'esquema XSD.

Si la validació o l'enviament fallen, a els missatges d'error de Portugal SAF-T (PT) File Checks tens quan surt cadascun i què fer.

On t'ajuda FlexigoTech

Implantem Odoo 17, 18, 19 i 20 i desenvolupem connectors i integracions a mida. Si el mòdul cobreix gairebé tot el que necessites però et falta una peça, o vols ajuda per deixar a punt el correu, el NIF i l'accés a ATCUD, explica'ns-ho des de la pàgina del mòdul. També pots revisar la fitxa a Odoo Apps de la teva versió.

Continua llegint

Com funciona Portugal SAF-T (PT) File Checks a Odoo per dinsQuins menús afegeix Portugal SAF-T (PT) File Checks a Facturació, quins models té al darrere, quins estats veus a les llistes i quina part usa un servei extern.Errors de Portugal SAF-T (PT) File Checks: quan surt cada missatge i què ferCada missatge d'error de Portugal SAF-T (PT) File Checks amb el text literal: quan surt, què vol dir i què fer a Odoo, de la generació a l'enviament ATCUD.Posada en marxa de Portugal SAF-T (PT) File Checks a Odoo, explicada amb un casPosada en marxa de Portugal SAF-T (PT) File Checks a Odoo amb un cas inventat: configuració ATCUD, camps clau, estats i què revisar la primera setmana.
Comprovat al codi del mòdul (versió 20.0) i a les fonts enllaçades

Fonts