Saltar para o conteúdo principal
VeriFactu

Erros de VeriFactu com clientes estrangeiros: o 1239 e os códigos de IDOtro

Quando o cliente não tem NIF espanhol, a fatura identifica-o no bloco IDOtro com três dados: país, tipo de documento e número. A AEAT tem mais de uma dúzia de códigos para quando essa combinação não bate certo, e o mais genérico, o 1239, apenas indica que há um erro no bloco Destinatário. Aqui estão todos, com o que o Odoo envia em cada caso.

FlexigoTech · Responsável: Víctor Gómez · Atualizado em 4 de novembro de 2026

O essencial

Módulo
VeriFactu
Versões
Odoo 17, 18, 19 e 20
Verificado
no código do módulo, versão 20.0 · nas fontes indicadas no fim
Leitura
5 min

Como é que o Odoo identifica um cliente estrangeiro

O módulo decide o tipo de identificador ao validar a fatura, com dois campos do contacto: o país e o NIF.

Cliente com país Espanha ou sem país
Vai no campo NIF. Se o número começar por X, Y ou Z, é tratado como NIE.
Cliente de outro país da UE
Vai em IDOtro com IDType 02 (NIF-IVA) e sem CodigoPais.
Cliente de fora da UE
Vai em IDOtro com o CodigoPais do seu país e IDType 04, ou com IDType 03 (passaporte) se o número tiver mais de 20 caracteres ou nenhum alfanumérico.

O número segue com 20 caracteres no máximo. Com isto em mente, quase todos os códigos abaixo explicam-se olhando para o país e o NIF do contacto.

Cartão dos erros de IDOtro do VeriFactu
O 1239 e os treze códigos do bloco Destinatário reunidos nesta página, todos da secção que rejeita o registo.

Os códigos, um a um

CódigoO que diz a AEATO que verificar
1239Error en el bloque Destinatario.O bloco inteiro: país, NIF e nome do contacto.
1101El valor del campo CodigoPais es incorrecto.O país do contacto.
1102El valor del campo IDType es incorrecto.O tipo de documento que foi deduzido.
1103El valor del campo ID es incorrecto.O número do contacto.
1111El campo CodigoPais es obligatorio cuando IDType es distinto de NIF-IVA (02).Um cliente sem país no Odoo.
1122El campo CodigoPais indicado no coincide con los dos primeros dígitos del identificador.Um número com o prefixo de outro país.
1126El valor del CodigoPais solo puede ser ES cuando el IDType sea Pasaporte (03) o No Censado (07)…Um cliente espanhol 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).O tipo 07, que o módulo não usa.
1222El valor del campo ID del bloque IDOtro es incorrecto.O número de um cliente de fora.
1232, 1233 e 1234IDOtro com CodigoPais ES exige IDType 03, 07 ou um dos dois.O país Espanha num cliente com passaporte.
1254 e 1255NIF-IVA do Reino Unido: XI não é aceite antes de 01/01/2021 e GB não é aceite desde 01/02/2021.A data da operação e o prefixo.

Para o IDType 02 a AEAT verifica ainda que o número tem a estrutura de NIF-IVA do Estado-membro e que está em maiúsculas. Na prática, o NIF de um cliente europeu tem de ir no Odoo com o prefixo do seu país, tal como o VIES o valida.

O que acontece no Odoo quando a AEAT o rejeita

Estes códigos rejeitam o registo, não o envio: as restantes faturas do mesmo pedido entram. A fila deixa o rejeitado em Retrying e volta a enviá-lo com esperas cada vez mais longas, de 2 minutos a 12 horas; à sexta tentativa passa-o para Dead Letter e o registo fica como «Error permanente».

Erros da AEAT no Odoo com um 1239 em Dead Letter
Um 1239 após seis tentativas, em Dead Letter, junto a dois envios em 4134. Captura do Odoo 20 com dados de demonstração e respostas da AEAT simuladas.

Voltar a tentar não muda nada se o dado estiver errado, porque o envio sai do registo criado ao validar a fatura, não do contacto. Por isso a correção tem duas partes:

  1. Corrija o país ou o NIF do contacto, para que as faturas seguintes saiam bem.
  2. Para a fatura já rejeitada, a AEAT prevê um registo de alta por rejeição, com Subsanacion S e RechazoPrevio X. O módulo publicado não gera esse registo por si só: escreva para comercial@flexigobe.com com o número da fatura e resolvemo-lo consigo.

Os códigos desta página, com o texto da AEAT

Cada código com o seu texto literal, tal como o dá a lista de erros da AEAT:

CódigoTexto da 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 o código que vê não estiver nesta tabela, o catálogo completo está em Envio à AEAT › Catálogo de Erros AEAT, com o texto literal da AEAT.

Continue a ler

Erros de VeriFactu com o NIF do cliente: censo, formato e nomeErros de VeriFactu do NIF do cliente: censo (1109, 1110, 1121, 1193, 1154), formato (1123, 1290) e nome (1283). Causas e verificações do Odoo.Erros 1189, 1190, 1191 e 1192 de VeriFactu: tipo de fatura e destinatário têm de coincidirOs erros de VeriFactu que cruzam o tipo de fatura com o destinatário (1189, 1190, 1191, 1192, 1106 e 1156): a regra da AEAT e o que decide o Odoo ao publicar.Erro 2001 do VeriFactu: o NIF do seu cliente não consta do censo da AEATO erro 2001 do VeriFactu: o NIF do destinatário não consta do censo da AEAT. Porque é que a fatura entra na mesma, o que a AEAT pede e o que fazer no Odoo 17 a 20.
Verificado no código do módulo (versão 20.0) e nas fontes indicadas

Fontes