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

Errori di Portugal SAF-T (PT) File Checks: quando compare ogni messaggio e cosa fare

I messaggi di Portugal SAF-T (PT) File Checks sono in inglese e quasi tutti dicono già cosa non è andato e, spesso, il passo successivo: generare prima di validare, controllare il log, configurare certificato e chiave ATCUD o riprovare più tardi. Qui trovi ogni messaggio letterale, quando compare secondo il suo stesso testo e cosa fare, senza supporre nulla che il messaggio non dica.

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

Come leggere un messaggio di Portugal SAF-T (PT) File Checks

Ogni avviso ha un testo che in molti casi termina con %s o contiene %d nel mezzo. Quello spazio è dove il modulo inserisce il dato concreto: il dettaglio dell'errore, il valore che hai salvato, un indirizzo o il numero di tentativi. Quando vedi i due punti seguiti da un testo, quella parte ti dice cosa è successo nel tuo caso.

Nella tabella qui sotto i messaggi compaiono esattamente come li scrive il modulo, con %s e %d al loro posto. Sul tuo schermo vedrai il dato reale al posto di questi segnaposto.

Tabella degli errori: messaggio, quando compare e cosa fare

MessaggioQuando compareCosa fare
SAF-T generation failed: %sLa generazione del file SAF-T non riesce.Leggi il dettaglio dopo i due punti e correggi ciò che indica prima di generare di nuovo.
No SAF-T file generated. Run generation first.Non c'è ancora nessun file SAF-T generato.Genera prima il file, come chiede il messaggio.
SAF-T validation failed. Check validation log for details.La validazione del file SAF-T non passa.Apri il registro di validazione (validation log) e controlla il dettaglio.
SAF-T validation failed: %sLa validazione non riesce e il messaggio riporta il motivo.Leggi il motivo dopo i due punti.
Failed to fetch SAF-T schema from %s: %sNon è possibile ottenere lo schema SAF-T da un indirizzo.Il messaggio mostra l'indirizzo e il dettaglio: controllali entrambi.
SAF-T file must be an XML fileIl file SAF-T non è un XML.Usa un file XML.
Period start must be before period endL'inizio del periodo non è precedente alla fine.Correggi le date in modo che l'inizio venga prima della fine.
XML export failed: %sL'esportazione in XML non riesce.Leggi il dettaglio dopo i due punti.
CSV export failed: %sL'esportazione in CSV non riesce.Leggi il dettaglio dopo i due punti.
Annual statistics generation failed: %sLa generazione delle statistiche annuali non riesce.Leggi il dettaglio dopo i due punti.
NIF must be exactly 9 digits. Current value: %sIl NIF non ha esattamente 9 cifre.Il messaggio mostra il valore attuale: lascialo con esattamente 9 cifre.
Invalid ATCUD endpoint URL formatIl formato dell'URL dell'endpoint ATCUD non è valido.Controlla come è scritto l'URL dell'endpoint.
ATCUD certificate and key must be configured in SAF-T settingsIl certificato e la chiave ATCUD non sono configurati.Configurali nelle impostazioni SAF-T.
ATCUD rejected the submission. Check error log for details.ATCUD rifiuta l'invio.Controlla il registro degli errori (error log).
Failed to contact ATCUD after %d attempts. Try again later.Non si riesce a contattare ATCUD dopo vari tentativi; il messaggio dice quanti.Riprova più tardi.
ATCUD submission failed. Please try again later.L'invio ad ATCUD non riesce.Riprova più tardi.
Submission can only be retried from error stateProvi a ripetere un invio che non è in stato di errore.Ripeti solo gli invii in stato di errore.
No submissions found for this companyNon ci sono invii per quell'azienda.Verifica che sia l'azienda che volevi consultare.
No email configured for companyL'azienda non ha un'e-mail configurata.Configura l'e-mail dell'azienda.
Email test failed: %sIl test e-mail non riesce.Leggi il dettaglio dopo i due punti.
Several contacts match "%s": enter the email or the tax ID of the data subject.Più contatti corrispondono a quanto hai indicato.Inserisci l'e-mail o l'identificativo fiscale (tax ID) dell'interessato.
DSAR processing failed: %sL'elaborazione DSAR non riesce.Leggi il dettaglio dopo i due punti.

NIF, URL, e-mail e certificato: gli avvisi sui dati

Un gruppo di messaggi riguarda dati che compili tu. Quello del NIF è il più diretto: chiede esattamente 9 cifre e ti mostra cosa è salvato (Current value: %s), così vedi a colpo d'occhio cosa c'è in più o cosa manca. Quello dell'URL (Invalid ATCUD endpoint URL format) dice solo che il formato non è valido, quindi devi controllare come è scritto quell'indirizzo.

Per inviare ad ATCUD, il modulo richiede certificato e chiave nelle impostazioni SAF-T: se mancano, compare ATCUD certificate and key must be configured in SAF-T settings. Con l'e-mail succede qualcosa di simile: No email configured for company indica che l'azienda non ha un'e-mail, e Email test failed: %s compare quando il test e-mail non va a buon fine, con il dettaglio alla fine.

Nuovo modulo di configurazione ATCUD con sezioni azienda, ATCUD, e-mail e notifiche e caricamento
Modulo di configurazione ATCUD in Fatturazione, ancora senza dati salvati: è compilato solo l'URL dell'endpoint e la parte inferiore è tagliata.

Quelli che ti mandano al log o ti chiedono di aspettare

Due messaggi non contengono il dettaglio e ti rimandano altrove: SAF-T validation failed. Check validation log for details. ti manda al registro di validazione, e ATCUD rejected the submission. Check error log for details. al registro degli errori. In questi casi la causa non è nella finestra dell'avviso, ma nel log che il messaggio nomina.

Altri due chiedono solo pazienza: Failed to contact ATCUD after %d attempts. Try again later. e ATCUD submission failed. Please try again later. Il primo ti dice quanti tentativi ha fatto il modulo. In entrambi, il testo indica di riprovare più tardi.

Elenco SAF-T Error Logs con cinque record e colonne data, tipo di errore, gravità, messaggio e risolto
Invoicing › SAF-T Error Logs: cinque record con data, tipo, gravità e messaggio, e l'indicatore di risolto non spuntato.

Generare, validare e riprovare: l'ordine indicato dai messaggi

Alcuni avvisi ti dicono in che ordine lavorare. No SAF-T file generated. Run generation first. chiarisce che prima bisogna generare il file SAF-T. Submission can only be retried from error state indica che un invio si può ripetere solo dallo stato di errore. E Period start must be before period end richiede che l'inizio del periodo sia precedente alla fine.

Se il problema è il file stesso, guarda SAF-T file must be an XML file e i messaggi di esportazione (XML export failed: %s, CSV export failed: %s), che riportano il dettaglio alla fine. Per le impostazioni e gli stati che attraversa ogni record, c'è la messa in funzione del modulo, e per menu e attività, come funziona dentro.

Elenco Generate SAF-T Files con sei record di azienda, periodo e stato
Invoicing › SAF-T Accounting › Generate SAF-T Files: sei record in Draft, Generated, Validated, Validation Failed e Submitted, con dimensione file e transazioni a zero.
Panoramica degli elenchi statistiche annuali SAF-T, SAF-T Error Logs e Generate SAF-T Files
Dalle statistiche annuali (azienda, anno, totale documenti, valore totale e stato Draft o Exported) all'elenco degli errori e a quello dei file SAF-T generati.

Come ti aiuta FlexigoTech

Se un messaggio ti blocca o vuoi far controllare la configurazione prima di inviare, in FlexigoTech implementiamo Odoo 17, 18, 19 e 20 e sviluppiamo connettori e integrazioni su misura. Il modulo costa 9 € per versione di Odoo su Odoo Apps, pagamento unico IVA esclusa, per 17, 18, 19 e 20 (scheda su Odoo Apps); il servizio locale di FlexigoTech Cloud costa 29 €/mese o 290 €/anno IVA esclusa. Trovi tutti i dettagli nella pagina del modulo.

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.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.Portugal SAF-T (PT) File Checks: cosa copre, cosa ti serve prima e per quale versione di OdooCosa copre Portugal SAF-T (PT) File Checks secondo il README, cosa ti serve prima di installarlo (NIF, ATCUD, e-mail) e per quali versioni di Odoo esiste.
Verificato nel codice del modulo (versione 20.0) e nelle fonti collegate

Fonti