Erreurs de Portugal SAF-T (PT) File Checks dans Odoo

Comment lire un message de Portugal SAF-T (PT) File Checks

Chaque message comporte un texte qui se termine souvent par %s ou contient %d au milieu. Cet emplacement est celui où le module insère la donnée précise : le détail de l'échec, la valeur que vous avez enregistrée, une adresse ou le nombre de tentatives. Quand vous voyez deux-points suivis d'un texte, c'est cette partie qui vous dit ce qui s'est passé dans votre cas.

Dans le tableau ci-dessous, les messages apparaissent tels que le module les écrit, avec %s et %d à leur place. À l'écran, vous verrez la donnée réelle à la place de ces marqueurs.

Tableau des erreurs : message, quand il apparaît et que faire

Message	Quand il apparaît	Que faire
`SAF-T generation failed: %s`	La génération du fichier SAF-T échoue.	Lisez le détail après les deux-points et corrigez ce qu'il indique avant de relancer la génération.
`No SAF-T file generated. Run generation first.`	Aucun fichier SAF-T n'a encore été généré.	Générez d'abord le fichier, comme le demande le message.
`SAF-T validation failed. Check validation log for details.`	Le fichier SAF-T ne passe pas la validation.	Ouvrez le journal de validation (`validation log`) et consultez le détail.
`SAF-T validation failed: %s`	La validation échoue et le message en donne la raison.	Lisez la raison après les deux-points.
`Failed to fetch SAF-T schema from %s: %s`	Impossible de récupérer le schéma SAF-T depuis une adresse.	Le message affiche l'adresse et le détail : vérifiez les deux.
`SAF-T file must be an XML file`	Le fichier SAF-T n'est pas un XML.	Utilisez un fichier XML.
`Period start must be before period end`	Le début de la période n'est pas antérieur à la fin.	Corrigez les dates pour que le début précède la fin.
`XML export failed: %s`	L'export XML échoue.	Lisez le détail après les deux-points.
`CSV export failed: %s`	L'export CSV échoue.	Lisez le détail après les deux-points.
`Annual statistics generation failed: %s`	La génération des statistiques annuelles échoue.	Lisez le détail après les deux-points.
`NIF must be exactly 9 digits. Current value: %s`	Le NIF ne compte pas exactement 9 chiffres.	Le message affiche la valeur actuelle : ramenez-la à exactement 9 chiffres.
`Invalid ATCUD endpoint URL format`	Le format de l'URL du endpoint ATCUD n'est pas valide.	Vérifiez la façon dont l'URL du endpoint est écrite.
`ATCUD certificate and key must be configured in SAF-T settings`	Le certificat et la clé ATCUD ne sont pas configurés.	Configurez-les dans les paramètres SAF-T.
`ATCUD rejected the submission. Check error log for details.`	ATCUD rejette l'envoi.	Consultez le journal des erreurs (`error log`).
`Failed to contact ATCUD after %d attempts. Try again later.`	ATCUD reste injoignable après plusieurs tentatives ; le message indique combien.	Réessayez plus tard.
`ATCUD submission failed. Please try again later.`	L'envoi à ATCUD échoue.	Réessayez plus tard.
`Submission can only be retried from error state`	Vous tentez de relancer un envoi qui n'est pas en état d'erreur.	Ne relancez que les envois en état d'erreur.
`No submissions found for this company`	Aucun envoi n'existe pour cette société.	Vérifiez qu'il s'agit bien de la société que vous vouliez consulter.
`No email configured for company`	La société n'a pas d'e-mail configuré.	Configurez l'e-mail de la société.
`Email test failed: %s`	Le test d'e-mail échoue.	Lisez le détail après les deux-points.
`Several contacts match "%s": enter the email or the tax ID of the data subject.`	Plusieurs contacts correspondent à ce que vous avez saisi.	Saisissez l'e-mail ou l'identifiant fiscal (`tax ID`) de la personne concernée.
`DSAR processing failed: %s`	Le traitement DSAR échoue.	Lisez le détail après les deux-points.

NIF, URL, e-mail et certificat : les messages liés aux données

Un groupe de messages concerne des données que vous saisissez vous-même. Celui du NIF est le plus direct : il exige exactement 9 chiffres et affiche ce qui est enregistré (Current value: %s), ce qui vous permet de voir d'un coup d'œil ce qui est en trop ou ce qui manque. Celui de l'URL (Invalid ATCUD endpoint URL format) dit seulement que le format n'est pas valide : il faut donc vérifier la façon dont cette adresse est écrite.

Pour envoyer à ATCUD, le module demande un certificat et une clé dans les paramètres SAF-T : s'ils manquent, vous obtenez ATCUD certificate and key must be configured in SAF-T settings. Même logique pour l'e-mail : No email configured for company signifie que la société n'a pas d'e-mail, et Email test failed: %s apparaît quand le test d'e-mail échoue, avec le détail à la fin.

Nouveau formulaire de configuration ATCUD avec les sections société, ATCUD, e-mail et notifications, et envoi — Formulaire de configuration ATCUD dans Facturation, encore sans données enregistrées : seule l'URL du endpoint est renseignée et le bas du formulaire est coupé.

Ceux qui vous renvoient au journal ou vous demandent d'attendre

Deux messages ne contiennent pas le détail et vous renvoient ailleurs : SAF-T validation failed. Check validation log for details. vous envoie au journal de validation, et ATCUD rejected the submission. Check error log for details. au journal des erreurs. Dans ces cas, la cause ne se trouve pas dans la fenêtre du message, mais dans le journal qu'il cite.

Deux autres demandent simplement de la patience : Failed to contact ATCUD after %d attempts. Try again later. et ATCUD submission failed. Please try again later. Le premier indique combien de tentatives le module a effectuées. Dans les deux cas, le texte vous invite à réessayer plus tard.

Liste SAF-T Error Logs avec cinq enregistrements et les colonnes date, type d'erreur, gravité, message et résolu — `Invoicing › SAF-T Error Logs` : cinq enregistrements avec date, type, gravité et message, et l'indicateur résolu non coché.

Générer, valider et relancer : l'ordre imposé par les messages

Certains messages vous indiquent dans quel ordre travailler. No SAF-T file generated. Run generation first. précise qu'il faut d'abord générer le fichier SAF-T. Submission can only be retried from error state signale qu'un envoi ne peut être relancé que depuis l'état d'erreur. Et Period start must be before period end impose que le début de la période précède sa fin.

Si c'est le fichier lui-même qui pose problème, regardez SAF-T file must be an XML file et les messages d'export (XML export failed: %s, CSV export failed: %s), qui donnent le détail à la fin. Pour les paramètres et les états que parcourt chaque enregistrement, consultez la mise en route du module, et pour les menus et les tâches, son fonctionnement interne.

Liste Generate SAF-T Files avec six enregistrements indiquant société, période et état — `Invoicing › SAF-T Accounting › Generate SAF-T Files` : six enregistrements en `Draft`, `Generated`, `Validated`, `Validation Failed` et `Submitted`, avec taille de fichier et transactions à zéro.

Parcours des listes de statistiques annuelles SAF-T, SAF-T Error Logs et Generate SAF-T Files — Des statistiques annuelles (société, année, total des documents, valeur totale et état `Draft` ou `Exported`) à la liste des erreurs puis à celle des fichiers SAF-T générés.

Comment FlexigoTech peut vous aider

Si un message vous bloque ou si vous souhaitez faire vérifier votre configuration avant l'envoi, FlexigoTech déploie Odoo 17, 18, 19 et 20 et développe des connecteurs et intégrations sur mesure. Le module coûte 9 € par version d'Odoo sur Odoo Apps, paiement unique HT, pour 17, 18, 19 et 20 (fiche sur Odoo Apps) ; le service local FlexigoTech Cloud coûte 29 €/mois ou 290 €/an HT. Vous trouverez tous les détails sur la page du module.

Sources

Code du module : flexigo_portugal_saf_t_accounting_atcud_submission_tool 20.0 (6935c20f): models/saft_annual_statistics.py
Code du module : flexigo_portugal_saf_t_accounting_atcud_submission_tool 20.0 (6935c20f): models/saft_config.py
Code du module : flexigo_portugal_saf_t_accounting_atcud_submission_tool 20.0 (6935c20f): models/saft_dsar_request.py
Code du module : flexigo_portugal_saf_t_accounting_atcud_submission_tool 20.0 (6935c20f): models/saft_exporter.py
Code du module : flexigo_portugal_saf_t_accounting_atcud_submission_tool 20.0 (6935c20f): models/saft_submission.py
apps.odoo.com/apps/modules/20.0/flexigo_portugal_saf_t_accounting_atcud_submission_tool
apps.odoo.com/apps/modules/17.0/flexigo_portugal_saf_t_accounting_atcud_submission_tool
apps.odoo.com/apps/modules/18.0/flexigo_portugal_saf_t_accounting_atcud_submission_tool
apps.odoo.com/apps/modules/19.0/flexigo_portugal_saf_t_accounting_atcud_submission_tool
flexigotech.com/en/services.html
flexigotech.com/precios.html

Erreurs de Portugal SAF-T (PT) File Checks : quand chaque message apparaît et que faire