Vai al contenuto principale
Portugal SAF-T (PT) File Checks

Portugal SAF-T (PT) File Checks: cosa copre, cosa ti serve prima e per quale versione di Odoo

Portugal SAF-T (PT) File Checks fa per te se gestisci in Odoo la contabilità di un'azienda portoghese e vuoi generare da lì il file SAF-T v1.03, validarlo rispetto allo schema XSD dell'autorità fiscale portoghese e inviarlo al portale ATCUD. Prima di installarlo ti servono un server di posta in uscita, il NIF dell'azienda, l'URL e le credenziali dell'endpoint ATCUD e, se ATCUD lo richiede, un certificato digitale. È pubblicato su Odoo Apps per Odoo 17.0, 18.0, 19.0 e 20.0.

FlexigoTech · Responsabile: Víctor Gómez · Aggiornato il 4 novembre 2026

In breve

Versioni
Odoo 17, 18, 19 e 20
Verificato
nel codice del modulo, versione 20.0 · nelle fonti collegate in fondo
Lettura
6 min

Cosa copre il modulo secondo il README

Il README organizza le funzioni in requisiti numerati (FR) e in sezioni contrassegnate da lettere. Il nucleo sono questi requisiti:

  • Generazione dell'XML SAF-T v1.03 (FR-001): crea i file a partire dai dati contabili di Odoo.
  • Validazione rispetto allo schema XSD (FR-002): il modulo controlla il file rispetto allo schema dell'autorità fiscale portoghese.
  • Invio diretto al portale ATCUD (FR-003): con logica di nuovo tentativo automatico.
  • Errori ed eccezioni (FR-004): registro dettagliato degli errori e messaggi pensati per l'utente.
  • Interfaccia di configurazione (FR-005): gestione di credenziali, e-mail e impostazioni di invio.

Attorno a questo nucleo, il README descrive questi altri elementi:

  • Multiazienda: monitoraggio degli invii per azienda, con audit trail separati.
  • GDPR (sezione C): cita 10-year mandatory retention override e un flusso DSAR con modelli di risposta legale.
  • Notifiche e-mail (sezione D): indicazioni su DKIM/SPF/DMARC e conferme di invio.
  • Statistiche annuali (sezione E): esportazione e invio del report annuale.
  • Osservabilità (sezione F): log in JSON, metriche Prometheus e integrazione con Sentry.
  • Protezione anti-abuso (sezione G): limitazione delle richieste, campi trappola (honeypot) e CAPTCHA nei moduli pubblici.
  • File di grandi dimensioni (sezione H): caricamento a blocchi con scansione antivirus.
  • Chatter (sezione I): conversazione sugli invii, con riservatezza.
  • Prestazioni (sezione J): monitoraggio dello SLO p99.
  • DSAR (sezione K): tracciamento della base giuridica e automazione delle risposte.
  • Lingue (sezione L): interfacce multilingue.
Elenco Generate SAF-T Files con record per azienda, periodo e stato
L'elenco di generazione dei file SAF-T con sei record negli stati Draft, Generated, Validated, Validation Failed e Submitted; dimensione del file e transazioni a zero.

Cosa fa il modulo e cosa metti tu

Per decidere, separa ciò che il README attribuisce al modulo da ciò che devi fornire tu. Questa tabella mette insieme le due cose secondo la documentazione.

EsigenzaLo fa il modulo (README)Lo prepari tu (README)
Generare il file SAF-TGenera l'XML SAF-T v1.03 con i dati contabili di OdooScegliere azienda e periodo in Generate SAF-T Files
Validare il fileValida rispetto allo schema XSD dell'autorità fiscale portogheseCliccare Generate SAF-T; poi il sistema valida
Inviare ad ATCUDInvio diretto al portale con nuovo tentativo automaticoURL dell'endpoint ATCUD, credenziali e certificato digitale se ATCUD lo richiede
Capire cosa non ha funzionatoRegistro dettagliato degli errori e messaggi per l'utenteControllare gli errori registrati
Conferme via e-mailConferme di invio e indicazioni DKIM/SPF/DMARCOutgoing Mail Server con credenziali SMTP, mittente e indirizzo per le conferme
Più aziendeMonitoraggio per azienda con audit trail separatiCredenziali di invio ATCUD nelle impostazioni dell'azienda
Report annualeEsportazione e invio delle statistiche annualiIl README non lo specifica
Moduli pubbliciLimitazione delle richieste, honeypot e CAPTCHAConfigurare la limitazione delle richieste e la prevenzione degli abusi

La colonna di destra ti dice se puoi partire subito. L'URL e le credenziali dell'endpoint ATCUD e il server di posta in uscita fanno parte dei passaggi di configurazione descritti nel README. Se te ne manca qualcuno, procuratelo prima di installare.

Elenco SAF-T Error Logs con data, tipo di errore, gravità e messaggio
Il registro errori SAF-T con cinque voci: data, tipo di errore, gravità, messaggio e indicatore di risolto non spuntato.

Se ti ritrovi qui, ti conviene

  • Gestisci in Odoo la contabilità di un'azienda portoghese e vuoi produrre il SAF-T da lì: il modulo copre generazione, validazione e invio del file (da FR-001 a FR-003).
  • Hai più società nello stesso database: il README parla di supporto multiazienda con audit trail separati per azienda.
  • Non hai ancora accesso ad ATCUD: procurati prima l'URL dell'endpoint e le credenziali, perché le impostazioni del modulo le richiedono, così come il certificato digitale se ATCUD lo esige.
  • Il tuo team tecnico vuole monitorare il servizio: il README cita log in JSON, metriche Prometheus, Sentry e monitoraggio dello SLO p99.
  • Lavorate in più lingue: il README include interfacce multilingue (sezione L).
  • Ti serve qualcosa che non compare nell'elenco delle funzioni: non darlo per scontato. Chiedi prima di acquistare o valuta uno sviluppo su misura.

Se vuoi vedere quali menu aggiunge e come un record attraversa i suoi stati, lo spieghiamo in come funziona Portugal SAF-T (PT) File Checks dall'interno.

Elenco Annual SAF-T Statistics con azienda, anno, documenti, valore e stato
Le statistiche annuali SAF-T con cinque righe per azienda e anno, totale documenti, valore totale e stato Bozza o Esportato.

Cosa preparare prima di installarlo

Sul server

  • Odoo installato: i passaggi di installazione del README iniziano con Ensure you have Odoo 19 installed, mentre su Odoo Apps il modulo è pubblicato per 17.0, 18.0, 19.0 e 20.0. Controlla la scheda della versione che usi.
  • Pacchetti Python: il README ha un passaggio Install required Python packages. Controlla l'elenco nel README del modulo prima di installare.
  • Directory degli addons: copiare il modulo nella directory degli addons di Odoo.
  • Installazione: in Odoo, Apps, cercare Portugal SAF-T e cliccare Install.

In Odoo

  • E-mail: in Settings → General Settings, sezione Emails, configurare Outgoing Mail Server con le tue credenziali SMTP e l'indirizzo del mittente.
  • Impostazioni SAF-T: in Accounting → Configuration → SAF-T Accounting → Settings, il NIF (Número de Identificação Fiscal), l'URL dell'endpoint ATCUD con le relative credenziali e il certificato digitale se ATCUD lo richiede.
  • Impostazioni dell'azienda: credenziali di invio ATCUD, indirizzo e-mail per le conferme di invio e limitazione delle richieste e prevenzione degli abusi.

Negli screenshot, gli elenchi del modulo compaiono sotto Invoicing, mentre il README scrive i percorsi con Accounting. Se non trovi un menu, cercalo in entrambi.

Il percorso completo di impostazioni e campi è in la messa in funzione di Portugal SAF-T (PT) File Checks.

Versioni di Odoo e prezzo

Su Odoo Apps costa 9 € per versione di Odoo, pagamento una tantum, IVA esclusa, per 17.0, 18.0, 19.0 e 20.0. È un modulo con servizio locale di FlexigoTech Cloud, che costa 29 €/mese o 290 €/anno IVA esclusa (Pro: 58 €/mese o 580 €/anno).

Con l'abbonamento, il modulo per le nuove versioni di Odoo è incluso se l'hai acquistato su flexigotech.com; sull'Odoo App Store, ogni versione di Odoo si acquista lì. Senza abbonamento, o con il servizio sospeso, si ferma ciò che l'abbonamento offre e i dati restano nel tuo Odoo.

Come provarlo con un periodo prima di decidere

Il README descrive così la generazione di un file; puoi seguirlo con un periodo per vederlo all'opera con i tuoi dati:

  1. Vai in Accounting → SAF-T Accounting → Generate SAF-T Files.
  2. Clicca Create per avviare una nuova generazione.
  3. Scegli l'azienda e il periodo.
  4. Clicca il pulsante Generate SAF-T.
  5. Il sistema valida il file rispetto allo schema XSD.

Se la validazione o l'invio non vanno a buon fine, in i messaggi di errore di Portugal SAF-T (PT) File Checks trovi quando compare ciascuno e cosa fare.

Dove ti aiuta FlexigoTech

Implementiamo Odoo 17, 18, 19 e 20 e sviluppiamo connettori e integrazioni su misura. Se il modulo copre quasi tutto ciò che ti serve ma ti manca un pezzo, o vuoi aiuto per preparare e-mail, NIF e accesso ad ATCUD, scrivici dalla pagina del modulo. Puoi anche consultare la scheda su Odoo Apps della tua versione.

Continua a leggere

Come funziona Portugal SAF-T (PT) File Checks in Odoo, dall'internoI menu che Portugal SAF-T (PT) File Checks aggiunge a Fatturazione, i modelli dietro, gli stati delle sue liste e quale parte usa un servizio esterno.Errori di Portugal SAF-T (PT) File Checks: quando compare ogni messaggio e cosa fareOgni messaggio di errore di Portugal SAF-T (PT) File Checks parola per parola: quando compare, cosa significa e cosa fare in Odoo, dalla generazione all'invio ATCUD.Avviare Portugal SAF-T (PT) File Checks in Odoo, raccontato con un caso praticoAvvio di Portugal SAF-T (PT) File Checks in Odoo con un caso inventato: configurazione ATCUD, campi chiave, stati e cosa controllare nella prima settimana.
Verificato nel codice del modulo (versione 20.0) e nelle fonti collegate

Fonti