Erreurs de UAE FTA E-Invoicing Connector (PINT AE) : un cas pratique de bout en bout

Un distributeur fictif connecte son Odoo

Exemple Cas illustratif : l'entreprise et ses chiffres sont inventés pour expliquer le flux.

Distributions Duna est une société inventée qui facture déjà avec Odoo et vient d'installer le module. Laura, la consultante chargée du déploiement, s'occupe de la configuration ; Marcos, à l'administration, travaille sur les factures. Nous suivons ce que chacun voit et ce qu'il fait de chaque message.

Si vous voulez d'abord comprendre les composants du module, consultez son fonctionnement interne ; ici, on s'en tient aux messages.

Laura configure la société et tombe sur les premiers avertissements

Aucune configuration active

La première chose que voit Laura est No active UAE e-invoicing configuration found for company %s. Le %s affiche la société concernée par l'avertissement. Il existe une variante sans société : No active UAE e-invoicing configuration. Les deux signalent qu'aucune configuration de facturation électronique EAU n'est active. Il faut la créer ou l'activer pour la société indiquée dans le message, et vérifier que vous travaillez bien dans cette société et pas dans une autre.

Le TIN et le TRN sont refusés

Laura colle le numéro fiscal avec une espace au milieu et le module répond TIN must be exactly 10 numeric digits. Plus tard, avec l'autre identifiant, elle obtient TRN must be exactly 15 numeric digits. Les deux contrôles n'acceptent que des chiffres, en nombre exact : espaces, tirets ou lettres ne passent pas. Nettoyez la valeur et enregistrez à nouveau.

Confirmation, URL de l'ASP et seuils

Quand elle enregistre sans confirmer les données, elle voit Please confirm the information is correct before saving. Il suffit de relire les informations et de confirmer qu'elles sont correctes avant d'enregistrer.

Ensuite, Laura quitte le mode sandbox et reçoit ASP Endpoint URL is required when not in sandbox mode. Deux options : renseigner l'URL du endpoint de l'ASP ou rester en mode sandbox tant qu'elle ne l'a pas.

Enfin, elle laisse les seuils à zéro et voit Alert threshold must be at least 1. et Failure threshold must be at least 1. Les deux acceptent au minimum 1.

L'identifiant de l'ASP et son certificat

Une fois la configuration enregistrée, Laura passe à l'identifiant. Tant qu'aucun n'est actif, le module affiche No active ASP credential configured.

Si elle le crée sans joindre le fichier, elle obtient No certificate uploaded. Une fois le fichier envoyé, elle peut rencontrer Certificate validation failed: %s ou Credential setup failed: %s. Dans les deux cas, l'indice se trouve dans le texte qui remplace le %s ; lisez-le en entier avant de renvoyer quoi que ce soit.

Laura veut remplacer l'identifiant par un nouveau et lance l'action avant de le préparer. Le message est No staged credential found. Upload a new credential and mark it as staged first. Le texte donne lui-même l'ordre : envoyer le nouvel identifiant et le marquer d'abord comme staged.

À l'activation, elle obtient Cannot activate credential "%s": the certificate expired on %s. Le premier emplacement correspond à l'identifiant et le second à la date d'expiration du certificat. Avec un certificat expiré, le module refuse l'activation : il lui en faut un valide.

Marcos travaille sur les factures

Relancer, synchroniser et annuler

Marcos ouvre une facture acceptée et demande à la relancer. Réponse : Only rejected or failed invoices can be retried. Seules les factures rejetées ou en échec peuvent être relancées.

Il demande ensuite à synchroniser le statut d'une facture pas encore envoyée : Status sync is only relevant for transmitted or queued invoices. La synchronisation n'a de sens que pour les factures transmises ou en file d'attente.

Puis il tente d'annuler une facture en file d'attente : Only accepted or rejected invoices can be voided. Seules les factures acceptées ou rejetées peuvent être annulées, et celle-ci ne l'est pas.

Sur une autre facture, il voit No e-invoice XML has been generated for this invoice. Le XML de facture électronique de cette facture n'a pas encore été généré.

Ce que le module interdit de supprimer

Marcos veut faire le ménage dans une ancienne facture et reçoit Invoice %s cannot be deleted: FTA retention period of %d years has not elapsed (expires %s). Le module contrôle une durée de conservation et empêche la suppression de la facture jusqu'à la date indiquée dans le message.

Il ne peut pas non plus toucher au journal d'audit : E-invoice audit logs are immutable and cannot be modified. et E-invoice audit logs are immutable and cannot be deleted. L'app conserve ces enregistrements sans permettre ni modification ni suppression.

Enfin, il demande les XML archivés d'une période et voit No e-invoice XML archives found for TRN %s in the specified date range. Vérifiez que le TRN du message est le bon et élargissez ou corrigez la plage de dates.

Ce qu'il faut retenir du cas Distributions Duna

• Lisez le message en entier, y compris ce qui apparaît dans chaque %s : c'est là que figurent la société, l'identifiant, la date ou le détail de l'échec.
• Les avertissements de configuration (No active UAE e-invoicing configuration..., No active ASP credential configured.) signalent qu'il manque une configuration ou un identifiant actif.
• Le TIN et le TRN n'acceptent que des chiffres, avec la longueur exacte indiquée dans le message.
• Pour changer d'identifiant, No staged credential found... fixe l'ordre : envoyer le nouveau et le marquer comme staged ; pour l'activer, le certificat ne doit pas être expiré.
• Relancer, synchroniser et annuler dépendent du statut de la facture ; vérifiez-le avant de cliquer.
• Le module n'autorise ni la suppression de factures pendant la durée de conservation ni la modification de l'audit.

Pour renseigner chaque paramètre sans buter sur ces avertissements, consultez la mise en route pas à pas.

Comment FlexigoTech vous aide

FlexigoTech déploie Odoo 17, 18, 19 et 20 et développe des connecteurs et intégrations sur mesure : nous pouvons revoir avec vous la configuration, l'identifiant de l'ASP ou un message précis dont vous n'arrivez pas à vous débarrasser. Le module coûte 49 € HT, paiement unique par version d'Odoo, pour 17, 18, 19 et 20 ; tous les détails sont sur la page du module.

À lire aussi

Vérifié dans le code du module (version 20.0) et dans les sources citées

Sources

• Code du module : flexigo_uae_fta_e_invoicing_connector 20.0 (bd3e6ed9): models/account_move.py
• Code du module : flexigo_uae_fta_e_invoicing_connector 20.0 (bd3e6ed9): models/flexigo_uae_einvoice_config.py
• Code du module : flexigo_uae_fta_e_invoicing_connector 20.0 (bd3e6ed9): models/flexigo_uae_einvoice_credential.py
• Code du module : flexigo_uae_fta_e_invoicing_connector 20.0 (bd3e6ed9): models/flexigo_uae_einvoice_log.py
• Code du module : flexigo_uae_fta_e_invoicing_connector 20.0 (bd3e6ed9): wizard/flexigo_uae_einvoice_dsar_wizard.py
• Code du module : flexigo_uae_fta_e_invoicing_connector 20.0 (bd3e6ed9): wizard/flexigo_uae_einvoice_setup_wizard.py
• apps.odoo.com/apps/modules/20.0/flexigo_uae_fta_e_invoicing_connector
• apps.odoo.com/apps/modules/17.0/flexigo_uae_fta_e_invoicing_connector
• apps.odoo.com/apps/modules/18.0/flexigo_uae_fta_e_invoicing_connector
• apps.odoo.com/apps/modules/19.0/flexigo_uae_fta_e_invoicing_connector
• flexigotech.com/en/services.html