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

Errors de Portugal SAF-T (PT) File Checks: quan surt cada missatge i què fer

Els missatges de Portugal SAF-T (PT) File Checks són en anglès i gairebé tots ja diuen què ha fallat i, en molts casos, el pas següent: generar abans de validar, revisar el log, configurar el certificat i la clau d'ATCUD o tornar-ho a provar més tard. Aquí tens cada missatge literal, quan surt segons el seu propi text i què fer, sense suposar res que el missatge no digui.

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

Com llegir un missatge de Portugal SAF-T (PT) File Checks

Cada avís porta un text que en molts casos acaba en %s o porta %d al mig. Aquest buit és on el mòdul insereix la dada concreta: el detall de l'error, el valor que tens desat, una adreça o el nombre d'intents. Quan vegis els dos punts seguits d'un text, aquesta part és la que et diu què ha passat en el teu cas.

A la taula de sota els missatges apareixen tal com els escriu el mòdul, amb %s i %d al seu lloc. A la pantalla veuràs la dada real en lloc d'aquests marcadors.

Taula d'errors: missatge, quan surt i què fer

MissatgeQuan surtQuè fer
SAF-T generation failed: %sFalla la generació del fitxer SAF-T.Llegeix el detall després dels dos punts i corregeix el que indiqui abans de tornar a generar.
No SAF-T file generated. Run generation first.Encara no hi ha cap fitxer SAF-T generat.Genera primer el fitxer, com demana el missatge.
SAF-T validation failed. Check validation log for details.La validació del fitxer SAF-T no passa.Obre el registre de validació (validation log) i revisa'n el detall.
SAF-T validation failed: %sLa validació falla i el missatge porta el motiu.Llegeix el motiu després dels dos punts.
Failed to fetch SAF-T schema from %s: %sNo es pot obtenir l'esquema SAF-T des d'una adreça.El missatge mostra l'adreça i el detall: revisa'ls tots dos.
SAF-T file must be an XML fileEl fitxer SAF-T no és un XML.Fes servir un fitxer XML.
Period start must be before period endL'inici del període no és anterior al final.Corregeix les dates perquè l'inici quedi abans del final.
XML export failed: %sFalla l'exportació a XML.Llegeix el detall després dels dos punts.
CSV export failed: %sFalla l'exportació a CSV.Llegeix el detall després dels dos punts.
Annual statistics generation failed: %sFalla la generació d'estadístiques anuals.Llegeix el detall després dels dos punts.
NIF must be exactly 9 digits. Current value: %sEl NIF no té exactament 9 dígits.El missatge mostra el valor actual: deixa'l amb exactament 9 dígits.
Invalid ATCUD endpoint URL formatEl format de la URL de l'endpoint ATCUD no és vàlid.Revisa com està escrita la URL de l'endpoint.
ATCUD certificate and key must be configured in SAF-T settingsEl certificat i la clau d'ATCUD no estan configurats.Configura'ls als ajustos de SAF-T.
ATCUD rejected the submission. Check error log for details.ATCUD rebutja l'enviament.Revisa el registre d'errors (error log).
Failed to contact ATCUD after %d attempts. Try again later.No s'aconsegueix contactar amb ATCUD després de diversos intents; el missatge diu quants.Torna-ho a provar més tard.
ATCUD submission failed. Please try again later.Falla l'enviament a ATCUD.Torna-ho a provar més tard.
Submission can only be retried from error stateIntentes reintentar un enviament que no està en estat d'error.Reintenta només enviaments en estat d'error.
No submissions found for this companyNo hi ha enviaments per a aquesta empresa.Comprova que és l'empresa que volies consultar.
No email configured for companyL'empresa no té cap correu configurat.Configura el correu de l'empresa.
Email test failed: %sFalla la prova de correu.Llegeix el detall després dels dos punts.
Several contacts match "%s": enter the email or the tax ID of the data subject.Diversos contactes coincideixen amb el que has indicat.Escriu el correu o l'identificador fiscal (tax ID) de la persona interessada.
DSAR processing failed: %sFalla el processament DSAR.Llegeix el detall després dels dos punts.

NIF, URL, correu i certificat: els avisos de dades

Un grup de missatges té a veure amb dades que omples tu. El del NIF és el més directe: demana exactament 9 dígits i et mostra el que hi ha desat (Current value: %s), així veus d'un cop d'ull què sobra o què falta. El de la URL (Invalid ATCUD endpoint URL format) només diu que el format no és vàlid, així que el que toca és revisar com està escrita aquesta adreça.

Per enviar a ATCUD, el mòdul demana certificat i clau als ajustos de SAF-T: si no hi són, surt ATCUD certificate and key must be configured in SAF-T settings. Amb el correu passa una cosa semblant: No email configured for company indica que l'empresa no té correu, i Email test failed: %s apareix quan la prova de correu no surt bé, amb el detall al final.

Formulari nou de configuració ATCUD amb seccions d'empresa, ATCUD, correu i notificacions i pujada
Formulari de configuració ATCUD a Facturació, encara sense dades desades: només la URL de l'endpoint està omplerta i la part inferior queda tallada.

Els que t'envien al log o et fan esperar

Dos missatges no porten el detall a dins i t'envien a un altre lloc: SAF-T validation failed. Check validation log for details. t'envia al registre de validació, i ATCUD rejected the submission. Check error log for details. al registre d'errors. En aquests casos, la causa no és a la finestra de l'avís, sinó al log que esmenta el missatge.

Uns altres dos només demanen paciència: Failed to contact ATCUD after %d attempts. Try again later. i ATCUD submission failed. Please try again later. El primer et diu quants intents ha fet el mòdul. En tots dos, el que indica el text és tornar-ho a provar més tard.

Llista SAF-T Error Logs amb cinc registres i columnes de data, tipus d'error, gravetat, missatge i resolt
Invoicing › SAF-T Error Logs: cinc registres amb data, tipus, gravetat i missatge, i l'indicador de resolt sense marcar.

Generar, validar i reintentar: l'ordre que marquen els missatges

Alguns avisos et diuen en quin ordre treballar. No SAF-T file generated. Run generation first. deixa clar que primer cal generar el fitxer SAF-T. Submission can only be retried from error state indica que el reintent d'un enviament només val des de l'estat d'error. I Period start must be before period end t'obliga a fer que l'inici del període sigui anterior al final.

Si el que et falla és el fitxer en si, fixa't en SAF-T file must be an XML file i en els d'exportació (XML export failed: %s, CSV export failed: %s), que porten el detall al final. Per veure quins ajustos i estats recorre cada registre, tens la posada en marxa del mòdul, i per als menús i tasques, com funciona per dins.

Llista Generate SAF-T Files amb sis registres d'empresa, període i estat
Invoicing › SAF-T Accounting › Generate SAF-T Files: sis registres en Draft, Generated, Validated, Validation Failed i Submitted, amb la mida del fitxer i les transaccions a zero.
Recorregut per les llistes d'estadístiques anuals SAF-T, SAF-T Error Logs i Generate SAF-T Files
De les estadístiques anuals (empresa, any, total de documents, valor total i estat Draft o Exported) a la llista d'errors i a la de fitxers SAF-T generats.

Com t'ajuda FlexigoTech

Si un missatge et deixa encallat o vols revisar la configuració abans d'enviar, a FlexigoTech implantem Odoo 17, 18, 19 i 20 i desenvolupem connectors i integracions a mida. El mòdul costa 9 € per versió d'Odoo a Odoo Apps, pagament únic sense IVA, per a 17, 18, 19 i 20 (fitxa a Odoo Apps); el servei local de FlexigoTech Cloud són 29 €/mes o 290 €/any sense IVA. Tens tots els detalls a la pàgina del mòdul.

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.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.Portugal SAF-T (PT) File Checks: què cobreix, què necessites abans i en quina versió d'OdooQuè cobreix Portugal SAF-T (PT) File Checks segons el seu README, què necessites abans d'instal·lar-lo (NIF, ATCUD, correu) i en quines versions d'Odoo és.
Comprovat al codi del mòdul (versió 20.0) i a les fonts enllaçades

Fonts