Aller au contenu principal
VeriFactu

Erreurs VeriFactu dans Odoo : lire ce que dit l'AEAT et ce que votre propre système bloque avant

Une erreur VeriFactu peut venir de deux endroits : l'AEAT, l'administration fiscale espagnole, qui répond à chaque envoi avec un état et un code, ou votre propre système, qui bloque la facture avant de l'envoyer s'il manque quelque chose, comme le certificat ou un NIF valide. Les distinguer fait gagner du temps, car elles se corrigent à des endroits différents. Voici les deux groupes.

FlexigoTech · Responsable : Víctor Gómez · Mis à jour le 3 novembre 2026

L'essentiel

Module
VeriFactu
Versions
Odoo 17, 18, 19 et 20
Vérifié
dans le code du module, version 20.0 · dans les sources citées à la fin
Lecture
3 min

Ce que répond l'AEAT

Chaque envoi contient entre 1 et 1 000 enregistrements. La réponse donne un état pour l'envoi entier (Correcto, ParcialmenteCorrecto ou Incorrecto), un état par enregistrement (Correcto, AceptadoConErrores ou Incorrecto) et le temps d'attente avant l'envoi suivant.

L'AEAT publie son catalogue officiel d'erreurs, avec 247 codes, en trois familles :

FamilleCe qu'elle signifieQue faire
4xxx : envoi entier rejetéRien de cet envoi n'a été enregistré.Corrigez la cause et renvoyez l'envoi complet.
Enregistrement rejetéCet enregistrement n'est pas accepté ; le reste de l'envoi, si.Corrigez cet enregistrement et renvoyez uniquement celui-là.
2xxx : accepté avec erreursL'enregistrement est inscrit, mais quelque chose doit être corrigé.Ne le renvoyez pas comme nouveau : corrigez ce que dit le code.

Deux cas méritent d'être reconnus tout de suite. Le code 3000 signale un enregistrement en double : s'il apparaît déjà comme correct ou accepté avec erreurs, inutile de le renvoyer. Et l'empreinte, un SHA-256 chaîné à l'enregistrement précédent, est recalculée par l'AEAT : si elle ne correspond pas, l'enregistrement est accepté avec une erreur qu'il faut corriger.

Liste des erreurs renvoyées par l'AEAT dans Odoo
Les erreurs de l'AEAT, enregistrement par enregistrement et regroupées par code, dans Odoo. Capture d'écran d'Odoo avec des données de démonstration ; les réponses de l'AEAT sont simulées.

Avant d'arriver à l'AEAT : le certificat

L'AEAT identifie l'émetteur grâce au certificat présenté à la connexion. Sans certificat, son service redirige vers la page d'erreur 4033, « aucun certificat détecté ». Avec un certificat qui ne se valide pas, vers 4011. Dans Odoo, ces cas sont arrêtés plus tôt :

  • No active certificate for company … : la société n'a pas de certificat actif. Téléversez-le dans Configuration › Certificates.
  • The certificate … of company … has expired. : il a expiré. Une alerte quotidienne d'expiration est là pour que vous n'en arriviez pas là.

Ce que votre système bloque avant l'envoi

MessageCe qui manqueSolution
Company … has no NIF for Veri*Factu.La société n'a pas de NIF.Renseignez-le dans les données de la société.
Invalid NIF length: "…" (must be 9 chars)Le NIF du client ne fait pas 9 caractères.Vérifiez le NIF sur le contact.
Invalid NIF digits: "…"Le NIF contient des caractères non valides.Corrigez-le sur le contact.
Cannot post invoice: invalid counterparty identifier.L'identifiant du client n'est pas valide.Corrigez l'identifiant avant de comptabiliser.
Record … has no tax breakdown (Desglose) to declare.La facture n'a pas de ventilation des taxes.Vérifiez les taxes sur les lignes.
Record … is chained to a previous record that does not exist.La chaîne d'enregistrements est rompue.N'y touchez pas à la main : vérifiez l'état de la chaîne et écrivez-nous.
The AEAT accepts at most 1000 records per request.Un envoi avec plus d'enregistrements que permis.La file les découpe ; si vous voyez ce message, prévenez-nous.
Catalogue des erreurs de l'AEAT chargé dans Odoo
Le catalogue d'erreurs de l'AEAT dans Odoo, avec ses 247 codes, pour lire chacun sans quitter le système. Capture d'écran d'Odoo avec des données de démonstration.

Où regarder dans Odoo

La file d'envoi est traitée chaque minute et se trouve dans AEAT Submission › Submission Queue. Les erreurs renvoyées par l'AEAT ont leur propre liste dans AEAT Errors, et le catalogue complet des codes dans AEAT Error Catalogue. Ces trois écrans règlent la plupart des cas sans ouvrir le document technique de l'AEAT, même s'il est en lien plus bas au besoin.

File d'envoi vers l'AEAT dans Odoo
La file d'envoi : ce qui est en attente, ce qui a été envoyé et ce qui a échoué. Capture d'écran d'Odoo avec des données de démonstration ; les réponses de l'AEAT sont simulées.

Le module est publié pour Odoo 17, 18, 19 et 20. Si un code ne figure pas dans le catalogue, envoyez-nous le texte exact de la réponse : nous le retrouverons dans le document officiel des validations.

À lire aussi

VeriFactu : les délais de 2027, la prévision de 2028 et ce qu'il faut faire dans Odoo en attendantLe calendrier VeriFactu en novembre 2026 : délais du RDL 15/2025, prévision du ministère d'un report à octobre 2028 et ce qu'il faut préparer dans Odoo dès maintenant.VeriFactu : idées reçues et réalité pour les entreprises qui facturent avec OdooLes croyances courantes sur VeriFactu, confrontées à l'AEAT et au système lui-même : empreinte, erreurs acceptées, annulations, migrations, délais et module d'Odoo.
Vérifié dans le code du module (version 20.0) et dans les sources citées

Sources