Naar hoofdinhoud
VeriFactu

VeriFactu-fouten bij buitenlandse klanten: de 1239 en de IDOtro-codes

Als een klant geen Spaans belastingnummer heeft, identificeert de factuur die in het blok IDOtro met drie gegevens: land, type document en nummer. De AEAT, de Spaanse belastingdienst, heeft meer dan een dozijn codes voor als die combinatie niet klopt, en de meest algemene, de 1239, zegt alleen dat er een fout zit in het blok Destinatario. Hier staan ze allemaal, met wat Odoo in elk geval verstuurt.

FlexigoTech · Verantwoordelijk: Víctor Gómez · Bijgewerkt op 4 november 2026

In het kort

Module
VeriFactu
Versies
Odoo 17, 18, 19 en 20
Gecontroleerd
in de broncode van de module, versie 20.0 · in de bronnen onderaan
Leestijd
5 min

Hoe Odoo een buitenlandse klant identificeert

De module bepaalt het type identificatie bij het boeken van de factuur, op basis van twee velden van het contact: het land en het NIF.

Klant met land Spanje of zonder land
Wordt verstuurd in het veld NIF. Begint het nummer met X, Y of Z, dan wordt het behandeld als NIE.
Klant uit een ander EU-land
Wordt verstuurd in IDOtro met IDType 02 (NIF-IVA) en zonder CodigoPais.
Klant van buiten de EU
Wordt verstuurd in IDOtro met de CodigoPais van zijn land en IDType 04, of met IDType 03 (paspoort) als het nummer meer dan 20 tekens heeft of geen enkel alfanumeriek teken.

Het nummer wordt met maximaal 20 tekens verstuurd. Met dat in gedachten zijn bijna alle onderstaande codes te verklaren door het land en het NIF van het contact.

Overzicht van de IDOtro-fouten van VeriFactu
De 1239 en de dertien codes van het blok Destinatario die deze pagina behandelt, allemaal uit het deel dat de registratie afwijst.

De codes, één voor één

CodeWat de AEAT zegtWat controleren
1239Error en el bloque Destinatario.Het hele blok: land, NIF en naam van het contact.
1101El valor del campo CodigoPais es incorrecto.Het land van het contact.
1102El valor del campo IDType es incorrecto.Het type document dat is afgeleid.
1103El valor del campo ID es incorrecto.Het nummer van het contact.
1111El campo CodigoPais es obligatorio cuando IDType es distinto de NIF-IVA (02).Een klant zonder land in Odoo.
1122El campo CodigoPais indicado no coincide con los dos primeros dígitos del identificador.Een nummer met het voorvoegsel van een ander land.
1126El valor del CodigoPais solo puede ser ES cuando el IDType sea Pasaporte (03) o No Censado (07)…Een Spaanse klant die via IDOtro wordt verstuurd.
1131El valor del campo ID ha de ser el NIF de una persona física cuando el campo IDType tiene valor No Censado (07).Type 07, dat de module niet gebruikt.
1222El valor del campo ID del bloque IDOtro es incorrecto.Het nummer van een buitenlandse klant.
1232, 1233 y 1234IDOtro met CodigoPais ES vereist IDType 03, 07 of een van beide.Spanje als land bij een klant met paspoort.
1254 en 1255Britse btw-nummers: XI wordt niet aanvaard vóór 01/01/2021 en GB niet vanaf 01/02/2021.De datum van de handeling en het voorvoegsel.

Voor IDType 02 controleert de AEAT bovendien of het nummer de btw-structuur van de lidstaat heeft en in hoofdletters staat. In de praktijk moet het belastingnummer van een Europese klant in Odoo met zijn landvoorvoegsel worden opgeslagen, zoals VIES het valideert.

Wat er in Odoo gebeurt wanneer de AEAT het afwijst

Deze codes wijzen de registratie af, niet de verzending: de andere facturen in hetzelfde verzoek gaan wel door. De wachtrij zet de afgewezen factuur op Retrying en stuurt haar opnieuw met steeds langere wachttijden, van 2 minuten tot 12 uur; bij de zesde poging gaat ze naar Dead Letter en krijgt de registratie de status «Error permanente».

AEAT-fouten in Odoo met een 1239 in Dead Letter
Een 1239 na zes pogingen, in Dead Letter, naast twee verzendingen in 4134. Schermafbeelding van Odoo 20 met demogegevens en gesimuleerde antwoorden van de AEAT.

Opnieuw proberen verandert niets als de gegevens fout zijn, omdat de verzending wordt opgebouwd uit de registratie die bij het boeken van de factuur is aangemaakt, niet uit het contact. Daarom bestaat de oplossing uit twee delen:

  1. Corrigeer het land of het NIF van het contact, zodat de volgende facturen goed gaan.
  2. Voor de factuur die al is afgewezen, voorziet de AEAT in een registratie na afwijzing, met Subsanacion S en RechazoPrevio X. De gepubliceerde module genereert die registratie niet zelf: stuur een e-mail naar comercial@flexigobe.com met het factuurnummer en we lossen het samen met jou op.

De codes van deze pagina, met de tekst van de AEAT

Elke code met zijn letterlijke tekst, zoals de foutenlijst van de AEAT die geeft:

CodeTekst van de 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

Als de code die je ziet niet in deze tabel staat, staat de volledige catalogus onder Verzending naar AEAT › Catalogus AEAT-fouten, met de letterlijke tekst van de AEAT.

Lees verder

VeriFactu-fouten met het NIF van de klant: kadaster, formaat en naamVeriFactu-fouten bij het NIF van de klant: kadaster (1109, 1110, 1121, 1193, 1154), formaat (1123, 1290) en naam (1283). Oorzaken en wat Odoo controleert.Fouten 1189, 1190, 1191 en 1192 van VeriFactu: factuurtype en ontvanger moeten kloppenVeriFactu-fouten die factuurtype en ontvanger combineren (1189, 1190, 1191, 1192, 1106 en 1156): de regel van de AEAT en wat Odoo beslist bij het boeken.VeriFactu-fout 2001: het NIF van je klant staat niet in de census van de AEATVeriFactu-fout 2001: het NIF van de ontvanger staat niet in de census van de AEAT. Waarom de factuur toch wordt geaccepteerd en wat je doet in Odoo 17 tot 20.
Gecontroleerd in de broncode van de module (versie 20.0) en in de gelinkte bronnen

Bronnen