Saltar al contenido principal
VeriFactu

Errores de VeriFactu con clientes extranjeros: el 1239 y los códigos de IDOtro

Cuando el cliente no tiene NIF español, la factura lo identifica en el bloque IDOtro con tres datos: país, tipo de documento y número. La AEAT tiene más de una docena de códigos para cuando esa combinación no cuadra, y el más genérico, el 1239, solo dice que hay un error en el bloque Destinatario. Aquí están todos, con lo que Odoo manda en cada caso.

FlexigoTech · Responsable: Víctor Gómez · Actualizado el 4 de noviembre de 2026

Lo esencial

Módulo
VeriFactu
Versiones
Odoo 17, 18, 19 y 20
Comprobado
en el código del módulo, versión 20.0 · en las fuentes enlazadas al final
Lectura
5 min

Cómo identifica Odoo a un cliente extranjero

El módulo decide el tipo de identificador al publicar la factura, con dos campos del contacto: el país y el NIF.

Cliente con país España o sin país
Va en el campo NIF. Si el número empieza por X, Y o Z, se trata como NIE.
Cliente de otro país de la UE
Va en IDOtro con IDType 02 (NIF-IVA) y sin CodigoPais.
Cliente de fuera de la UE
Va en IDOtro con el CodigoPais de su país e IDType 04, o con IDType 03 (pasaporte) si el número tiene más de 20 caracteres o ninguno alfanumérico.

El número viaja con 20 caracteres como máximo. Con esto delante, casi todos los códigos de abajo se explican mirando el país y el NIF del contacto.

Tarjeta de los errores de IDOtro de VeriFactu
El 1239 y los trece códigos del bloque Destinatario que reúne esta página, todos del apartado que rechaza el registro.

Los códigos, uno a uno

CódigoLo que dice la AEATQué mirar
1239Error en el bloque Destinatario.El bloque entero: país, NIF y nombre del contacto.
1101El valor del campo CodigoPais es incorrecto.El país del contacto.
1102El valor del campo IDType es incorrecto.El tipo de documento que se dedujo.
1103El valor del campo ID es incorrecto.El número del contacto.
1111El campo CodigoPais es obligatorio cuando IDType es distinto de NIF-IVA (02).Un cliente sin país en Odoo.
1122El campo CodigoPais indicado no coincide con los dos primeros dígitos del identificador.Un número con el prefijo de otro país.
1126El valor del CodigoPais solo puede ser ES cuando el IDType sea Pasaporte (03) o No Censado (07)…Un cliente español enviado por 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).El tipo 07, que el módulo no usa.
1222El valor del campo ID del bloque IDOtro es incorrecto.El número de un cliente de fuera.
1232, 1233 y 1234IDOtro con CodigoPais ES exige IDType 03, 07 o uno de los dos.El país España en un cliente con pasaporte.
1254 y 1255NIF-IVA de Reino Unido: XI no se admite antes de 01/01/2021 y GB no se admite desde 01/02/2021.La fecha de la operación y el prefijo.

Para el IDType 02 la AEAT comprueba además que el número tenga la estructura de NIF-IVA del Estado miembro y que esté en mayúsculas. En la práctica, el NIF de un cliente europeo tiene que ir en Odoo con su prefijo de país, tal como lo valida el VIES.

Qué pasa en Odoo cuando la AEAT lo rechaza

Estos códigos rechazan el registro, no el envío: las demás facturas de la misma petición entran. La cola deja el rechazado en Retrying y lo vuelve a mandar con esperas cada vez más largas, de 2 minutos a 12 horas; al sexto intento lo pasa a Dead Letter y el registro queda como «Error permanente».

Errores AEAT en Odoo con un 1239 en Dead Letter
Un 1239 tras seis intentos, en Dead Letter, junto a dos envíos en 4134. Captura de Odoo 20 con datos de demostración y respuestas de la AEAT simuladas.

Reintentar no cambia nada si el dato está mal, porque el envío sale del registro que se creó al publicar la factura, no del contacto. Por eso el arreglo tiene dos partes:

  1. Corrige el país o el NIF del contacto, para que las siguientes facturas salgan bien.
  2. Para la factura ya rechazada, la AEAT prevé un alta por rechazo, con Subsanacion S y RechazoPrevio X. El módulo publicado no genera ese registro por sí solo: escríbenos a comercial@flexigobe.com con el número de la factura y lo resolvemos contigo.

Los códigos de esta página, con el texto de la AEAT

Cada código con su texto literal, tal como lo da la lista de errores de la AEAT:

CódigoTexto de la 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 el código que ves no está en esta tabla, el catálogo completo está en Envío a AEAT › Catálogo de Errores AEAT, con el texto literal de la AEAT.

Sigue leyendo

Errores de VeriFactu con el NIF del cliente: censo, formato y nombreLos errores de VeriFactu del NIF del cliente: censo (1109, 1110, 1121, 1193, 1154), formato (1123, 1290) y nombre (1283). Qué los causa y qué revisa Odoo antes de enviar.Errores 1189, 1190, 1191 y 1192 de VeriFactu: tipo de factura y destinatario tienen que casarLos errores de VeriFactu que cruzan el tipo de factura con el destinatario (1189, 1190, 1191, 1192, 1106 y 1156): la regla de la AEAT y lo que decide Odoo al publicar.Error 2001 de VeriFactu: el NIF de tu cliente no está en el censo de la AEATEl error 2001 de VeriFactu: el NIF del destinatario no está en el censo de la AEAT. Por qué la factura entra igual, qué pide la AEAT y qué hacer en Odoo 17 a 20.
Comprobado en el código del módulo (versión 20.0) y en las fuentes enlazadas

Fuentes