Aller au contenu principal
VeriFactu

Erreurs VeriFactu avec les clients étrangers : le 1239 et les codes IDOtro

Lorsque le client n'a pas de NIF espagnol, la facture l'identifie dans le bloc IDOtro à l'aide de trois données : pays, type de document et numéro. L'AEAT, l'administration fiscale espagnole, dispose de plus d'une douzaine de codes pour les cas où cette combinaison ne correspond pas, et le plus générique, le 1239, indique seulement qu'il y a une erreur dans le bloc Destinataire. Vous trouverez ici tous ces codes, avec ce qu'Odoo envoie dans chaque cas.

FlexigoTech · Responsable : Víctor Gómez · Mis à jour le 4 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
5 min

Comment Odoo identifie un client étranger

Le module détermine le type d'identifiant au moment de valider la facture, à partir de deux champs du contact : le pays et le NIF.

Client dont le pays est l'Espagne ou sans pays
Envoyé dans le champ NIF. Si le numéro commence par X, Y ou Z, il est traité comme un NIE, l'identifiant des résidents étrangers.
Client d'un autre pays de l'UE
Envoyé dans IDOtro avec IDType 02 (numéro de TVA intracommunautaire) et sans CodigoPais.
Client hors UE
Envoyé dans IDOtro avec le CodigoPais de son pays et IDType 04, ou avec IDType 03 (passeport) si le numéro compte plus de 20 caractères ou aucun caractère alphanumérique.

Le numéro est transmis avec 20 caractères au maximum. Dans ce contexte, presque tous les codes ci-dessous s'expliquent en regardant le pays et le NIF du contact.

Fiche des erreurs IDOtro de VeriFactu
L'erreur 1239 et les treize codes du bloc Destinataire couverts par cette page, tous issus de la section qui rejette l'enregistrement.

Les codes un par un

CodeCe que dit l'AEATCe qu'il faut vérifier
1239Error en el bloque Destinatario.Le bloc entier : pays, NIF et nom du contact.
1101El valor del campo CodigoPais es incorrecto.Le pays du contact.
1102El valor del campo IDType es incorrecto.Le type de document déduit.
1103El valor del campo ID es incorrecto.Le numéro du contact.
1111El campo CodigoPais es obligatorio cuando IDType es distinto de NIF-IVA (02).Un client sans pays dans Odoo.
1122El campo CodigoPais indicado no coincide con los dos primeros dígitos del identificador.Un numéro portant le préfixe d'un autre pays.
1126El valor del CodigoPais solo puede ser ES cuando el IDType sea Pasaporte (03) o No Censado (07)…Un client espagnol envoyé par IDOtro.
1131El valor del campo ID ha de ser el NIF de una persona física cuando el campo IDType tiene valor No Censado (07).Le type 07, que le module n'utilise pas.
1222El valor del campo ID del bloque IDOtro es incorrecto.Le numéro d'un client étranger.
1232, 1233 et 1234IDOtro avec CodigoPais ES exige IDType 03, 07 ou l'un des deux.Le pays Espagne pour un client titulaire d'un passeport.
1254 et 1255NIF-IVA du Royaume-Uni : XI n'est pas admis avant le 01/01/2021 et GB n'est pas admis à partir du 01/02/2021.La date de l'opération et le préfixe.

Pour l'IDType 02, l'AEAT vérifie en outre que le numéro respecte la structure de TVA intracommunautaire de l'État membre et qu'il est en majuscules. En pratique, le numéro de TVA d'un client européen doit être saisi dans Odoo avec son préfixe pays, tel que le valide le VIES.

Ce qui se passe dans Odoo lorsque l'AEAT le rejette

Ces codes rejettent l'enregistrement, pas l'envoi : les autres factures de la même requête passent. La file place le rejet en Retrying et le renvoie avec des délais de plus en plus longs, de 2 minutes à 12 heures ; à la sixième tentative, il passe en Dead Letter et l'enregistrement affiche « Error permanente ».

Erreurs AEAT dans Odoo avec un 1239 en Dead Letter
Un 1239 après six tentatives, en Dead Letter, à côté de deux envois en 4134. Capture d'Odoo 20 avec des données de démonstration et des réponses de l'AEAT simulées.

Relancer ne change rien si la donnée est erronée, car l'envoi est généré à partir de l'enregistrement créé lors de la validation de la facture, et non à partir du contact. La correction comporte donc deux volets :

  1. Corrigez le pays ou le NIF du contact, afin que les factures suivantes partent correctement.
  2. Pour la facture déjà rejetée, l'AEAT prévoit un enregistrement après rejet, avec Subsanacion S et RechazoPrevio X. Le module publié ne génère pas cet enregistrement de lui-même : écrivez à comercial@flexigobe.com avec le numéro de la facture et nous le résoudrons avec vous.

Les codes de cette page, avec le texte de l'AEAT

Chaque code avec son texte littéral, tel que le donne la liste des erreurs de l'AEAT :

CodeTexte de l'AEAT
1239Error en el bloque Destinatario.
1101El valor del campo CodigoPais es incorrecto.
1102El valor del campo IDType es incorrecto.
1103El valor del campo ID es incorrecto.
1111El campo CodigoPais es obligatorio cuando IDType es distinto de NIF-IVA (02).
1122El campo CodigoPais indicado no coincide con los dos primeros dígitos del identificador.
1126El valor del CodigoPais solo puede ser ES cuando el IDType sea Pasaporte (03) o No Censado (07). Si IDType es No Censado (07) el CodigoPais debe ser ES (España).
1131El valor del campo ID ha de ser el NIF de una persona física cuando el campo IDType tiene valor No Censado (07).
1222El valor del campo ID del bloque IDOtro es incorrecto.
1232Si se identifica a través de la agrupación IDOtro y CodigoPais tiene valor ES (España), el campo IDType debe valer Pasaporte (03).
1233Si se identifica a través de la agrupación IDOtro y CodigoPais tiene valor ES (España), el campo IDType debe valer No Censado (07).
1234Si se identifica a través de la agrupación IDOtro y CodigoPais tiene valor ES (España), el campo IDType debe valer Pasaporte (03) o No Censado (07).
1254Si FechaOperacion (FechaExpedicionFactura si no se informa FechaOperacion) es anterior a 01/01/2021 no se permite el valor 'XI' para Identificaciones NIF-IVA
1255Si FechaOperacion (FechaExpedicionFactura si no se informa FechaOperacion) es mayor o igual que 01/02/2021 no se permite el valor 'GB' para Identificaciones NIF-IVA

Si le code que vous voyez ne figure pas dans ce tableau, le catalogue complet se trouve dans Envoi à l'AEAT › Catalogue des erreurs AEAT, avec le texte littéral de l'AEAT.

À lire aussi

Erreurs VeriFactu avec le NIF du client : registre, format et nomErreurs VeriFactu liées au NIF du client : registre (1109, 1110, 1121, 1193, 1154), format (1123, 1290) et nom (1283). Causes et contrôles d'Odoo avant envoi.Erreurs 1189, 1190, 1191 et 1192 de VeriFactu : type de facture et destinataire doivent correspondreLes erreurs VeriFactu qui croisent type de facture et destinataire (1189, 1190, 1191, 1192, 1106, 1156) : règle de l'AEAT et ce qu'Odoo décide à la validation.Erreur 2001 de VeriFactu : le NIF de votre client ne figure pas dans le registre de l'AEATL'erreur 2001 de VeriFactu : le NIF du destinataire ne figure pas dans le registre de l'AEAT. Pourquoi la facture passe quand même et que faire dans Odoo 17 à 20.
Vérifié dans le code du module (version 20.0) et dans les sources citées

Sources