Vai al contenuto principale
VeriFactu

Errori VeriFactu con clienti esteri: il 1239 e i codici di IDOtro

Quando il cliente non ha un NIF spagnolo, la fattura lo identifica nel blocco IDOtro con tre dati: paese, tipo di documento e numero. L'AEAT, l'agenzia fiscale spagnola, ha più di una dozzina di codici per quando questa combinazione non torna, e quello più generico, il 1239, dice solo che c'è un errore nel blocco Destinatario. Qui li trovi tutti, con ciò che Odoo invia in ciascun caso.

FlexigoTech · Responsabile: Víctor Gómez · Aggiornato il 4 novembre 2026

In breve

Modulo
VeriFactu
Versioni
Odoo 17, 18, 19 e 20
Verificato
nel codice del modulo, versione 20.0 · nelle fonti collegate in fondo
Lettura
4 min

Come Odoo identifica un cliente estero

Il modulo decide il tipo di identificativo al momento della registrazione della fattura, usando due campi del contatto: il paese e il NIF.

Cliente con paese Spagna o senza paese
Va nel campo NIF. Se il numero inizia per X, Y o Z, viene trattato come NIE.
Cliente di un altro paese UE
Va in IDOtro con IDType 02 (NIF-IVA) e senza CodigoPais.
Cliente extra-UE
Va in IDOtro con il CodigoPais del suo paese e IDType 04, oppure con IDType 03 (passaporto) se il numero supera i 20 caratteri o non ha nessun carattere alfanumerico.

Il numero viaggia con un massimo di 20 caratteri. Tenendo presente questo, quasi tutti i codici qui sotto si spiegano guardando il paese e il NIF del contatto.

Scheda degli errori IDOtro di VeriFactu
L'1239 e i tredici codici del blocco Destinatario raccolti in questa pagina, tutti della sezione che respinge la registrazione.

I codici, uno per uno

CodiceCosa dice l'AEATCosa controllare
1239Error en el bloque Destinatario.L'intero blocco: paese, NIF e nome del contatto.
1101El valor del campo CodigoPais es incorrecto.Il paese del contatto.
1102El valor del campo IDType es incorrecto.Il tipo di documento dedotto.
1103El valor del campo ID es incorrecto.Il numero del contatto.
1111El campo CodigoPais es obligatorio cuando IDType es distinto de NIF-IVA (02).Un cliente senza paese in Odoo.
1122El campo CodigoPais indicado no coincide con los dos primeros dígitos del identificador.Un numero con il prefisso di un altro paese.
1126El valor del CodigoPais solo puede ser ES cuando el IDType sea Pasaporte (03) o No Censado (07)…Un cliente spagnolo inviato tramite 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).Il tipo 07, che il modulo non usa.
1222El valor del campo ID del bloque IDOtro es incorrecto.Il numero di un cliente estero.
1232, 1233 e 1234IDOtro con CodigoPais ES richiede IDType 03, 07 o uno dei due.Il paese Spagna su un cliente con passaporto.
1254 e 1255NIF-IVA del Regno Unito: XI non è ammesso prima del 01/01/2021 e GB non è ammesso dal 01/02/2021.La data dell'operazione e il prefisso.

Per l'IDType 02 l'AEAT verifica inoltre che il numero abbia la struttura della partita IVA intracomunitaria dello Stato membro e che sia in maiuscolo. In pratica, il NIF di un cliente europeo deve essere inserito in Odoo con il prefisso del paese, così come lo valida il VIES.

Cosa succede in Odoo quando l'AEAT lo respinge

Questi codici respingono la registrazione, non l'invio: le altre fatture della stessa richiesta vanno a buon fine. La coda mette quella respinta in Retrying e la reinvia con attese sempre più lunghe, da 2 minuti a 12 ore; al sesto tentativo la sposta in Dead Letter e il registro diventa «Error permanente» (errore permanente).

Errori AEAT in Odoo con un 1239 in Dead Letter
Un 1239 dopo sei tentativi, in Dead Letter, accanto a due invii in 4134. Schermata di Odoo 20 con dati dimostrativi e risposte AEAT simulate.

Riprovare non cambia nulla se il dato è sbagliato, perché l'invio parte dal registro creato alla registrazione della fattura, non dal contatto. Per questo la soluzione ha due parti:

  1. Correggi il paese o il NIF del contatto, così le fatture successive partiranno bene.
  2. Per la fattura già respinta, l'AEAT prevede una registrazione per rigetto, con Subsanacion S e RechazoPrevio X. Il modulo pubblicato non genera da solo quel record: scrivici a comercial@flexigobe.com con il numero della fattura e lo risolviamo insieme.

I codici di questa pagina, con il testo dell'AEAT

Ogni codice con il suo testo letterale, così come lo riporta l'elenco errori dell'AEAT:

CodiceTesto dell'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

Se il codice che vedi non è in questa tabella, il catalogo completo si trova in Invio ad AEAT › Catalogo errori AEAT, con il testo letterale dell'AEAT.

Continua a leggere

Errori VeriFactu con il NIF del cliente: censo, formato e nomeGli errori VeriFactu sul NIF del cliente: censo (1109, 1110, 1121, 1193, 1154), formato (1123, 1290) e nome (1283). Cause e controlli di Odoo prima dell'invio.Errori 1189, 1190, 1191 e 1192 di VeriFactu: tipo di fattura e destinatario devono coincidereGli errori VeriFactu che incrociano tipo di fattura e destinatario (1189, 1190, 1191, 1192, 1106 e 1156): la regola dell'AEAT e cosa decide Odoo alla pubblicazione.Errore 2001 di VeriFactu: il NIF del tuo cliente non risulta nel censo dell'AEATErrore 2001 di VeriFactu: il NIF del destinatario non è nel censo AEAT. Perché la fattura passa lo stesso, cosa chiede l'AEAT e cosa fare in Odoo 17-20.
Verificato nel codice del modulo (versione 20.0) e nelle fonti collegate

Fonti