Zum Hauptinhalt springen
VeriFactu

VeriFactu-Fehler bei ausländischen Kunden: der 1239 und die IDOtro-Codes

Hat ein Kunde keine spanische Steuernummer, identifiziert ihn die Rechnung im Block IDOtro über drei Angaben: Land, Dokumenttyp und Nummer. Die AEAT, die spanische Steuerbehörde, kennt mehr als ein Dutzend Codes für den Fall, dass diese Kombination nicht stimmt. Der allgemeinste, der 1239, sagt nur, dass im Empfängerblock ein Fehler liegt. Hier stehen alle, mit dem, was Odoo in jedem Fall sendet.

FlexigoTech · Verantwortlich: Víctor Gómez · Aktualisiert am 4. November 2026

Das Wichtigste

Versionen
Odoo 17, 18, 19 und 20
Geprüft
im Quellcode des Moduls, Version 20.0 · in den Quellen am Ende
Lesezeit
4 Min.

Wie Odoo einen ausländischen Kunden identifiziert

Das Modul bestimmt den Identifikatortyp beim Buchen der Rechnung anhand von zwei Feldern des Kontakts: Land und USt-IdNr.

Kunde mit Land Spanien oder ohne Land
Wird im Feld NIF übermittelt. Beginnt die Nummer mit X, Y oder Z, wird sie als NIE behandelt.
Kunde aus einem anderen EU-Land
Wird in IDOtro mit IDType 02 (NIF-IVA) und ohne CodigoPais übermittelt.
Kunde von außerhalb der EU
Wird in IDOtro mit dem CodigoPais seines Landes und IDType 04 übermittelt, oder mit IDType 03 (Reisepass), wenn die Nummer mehr als 20 Zeichen hat oder keines alphanumerisch ist.

Die Nummer wird mit höchstens 20 Zeichen übermittelt. Vor diesem Hintergrund lassen sich fast alle folgenden Codes über Land und Steuernummer des Kontakts erklären.

Übersicht der IDOtro-Fehler von VeriFactu
Der Fehler 1239 und die dreizehn Codes des Empfängerblocks, die diese Seite behandelt, alle aus dem Abschnitt, der den Datensatz ablehnt.

Die Codes im Einzelnen

CodeWas die AEAT sagtWas zu prüfen ist
1239Error en el bloque Destinatario.Den gesamten Block: Land, Steuernummer und Name des Kontakts.
1101El valor del campo CodigoPais es incorrecto.Das Land des Kontakts.
1102El valor del campo IDType es incorrecto.Der abgeleitete Dokumenttyp.
1103El valor del campo ID es incorrecto.Die Nummer des Kontakts.
1111El campo CodigoPais es obligatorio cuando IDType es distinto de NIF-IVA (02).Ein Kunde ohne Land in Odoo.
1122El campo CodigoPais indicado no coincide con los dos primeros dígitos del identificador.Eine Nummer mit dem Präfix eines anderen Landes.
1126El valor del CodigoPais solo puede ser ES cuando el IDType sea Pasaporte (03) o No Censado (07)…Ein spanischer Kunde, der über IDOtro gesendet wird.
1131El valor del campo ID ha de ser el NIF de una persona física cuando el campo IDType tiene valor No Censado (07).Typ 07, den das Modul nicht verwendet.
1222El valor del campo ID del bloque IDOtro es incorrecto.Die Nummer eines ausländischen Kunden.
1232, 1233 und 1234IDOtro mit CodigoPais ES erfordert IDType 03, 07 oder einen der beiden.Spanien als Land bei einem Kunden mit Reisepass.
1254 und 1255NIF-IVA des Vereinigten Königreichs: XI ist vor dem 01/01/2021 nicht zulässig, GB ab dem 01/02/2021 nicht.Das Datum des Geschäftsvorfalls und das Präfix.

Bei IDType 02 prüft die AEAT außerdem, ob die Nummer der Struktur der NIF-IVA des Mitgliedstaats entspricht und in Großbuchstaben geschrieben ist. In der Praxis muss die Steuernummer eines europäischen Kunden in Odoo mit ihrem Länderpräfix gespeichert sein, so wie VIES sie prüft.

Was in Odoo passiert, wenn die AEAT ablehnt

Diese Codes lehnen den Datensatz ab, nicht die Übermittlung: Die übrigen Rechnungen derselben Anfrage gehen durch. Die Warteschlange setzt die abgelehnte Rechnung auf Retrying und sendet sie mit wachsenden Wartezeiten erneut, von 2 Minuten bis 12 Stunden; beim sechsten Versuch wechselt sie in Dead Letter, und der Datensatz erhält den Status «Error permanente».

AEAT-Fehler in Odoo mit einem 1239 in Dead Letter
Ein 1239 nach sechs Versuchen, in Dead Letter, neben zwei Übermittlungen in 4134. Screenshot aus Odoo 20 mit Demodaten und simulierten Antworten der AEAT.

Ein erneuter Versuch ändert nichts, wenn die Daten falsch sind, denn die Übermittlung entsteht aus dem Datensatz, der beim Buchen der Rechnung angelegt wurde, nicht aus dem Kontakt. Deshalb besteht die Lösung aus zwei Teilen:

  1. Korrigieren Sie Land oder Steuernummer des Kontakts, damit die nächsten Rechnungen korrekt sind.
  2. Für die bereits abgelehnte Rechnung sieht die AEAT eine Neuanmeldung nach Ablehnung vor, mit Subsanacion S und RechazoPrevio X. Das veröffentlichte Modul erzeugt diesen Datensatz nicht von selbst: Schreiben Sie an comercial@flexigobe.com mit der Rechnungsnummer, dann klären wir es gemeinsam.

Die Codes dieser Seite mit dem Text der AEAT

Jeder Code mit seinem wörtlichen Text, wie die Fehlerliste der AEAT ihn ausgibt:

CodeText der 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

Wenn der Code, den Sie sehen, nicht in dieser Tabelle steht, finden Sie den vollständigen Katalog unter Envío a AEAT › Catálogo de Errores AEAT, mit dem wörtlichen Text der AEAT.

Weiterlesen

VeriFactu-Fehler mit der Kundensteuernummer: Register, Format und NameVeriFactu-Fehler zur Kundensteuernummer: Register (1109, 1110, 1121, 1193, 1154), Format (1123, 1290) und Name (1283). Ursachen und Odoo-Prüfung vor dem Versand.VeriFactu-Fehler 1189, 1190, 1191 und 1192: Rechnungsart und Empfänger müssen zusammenpassenDie VeriFactu-Fehler, die Rechnungsart und Empfänger verbinden (1189, 1190, 1191, 1192, 1106 und 1156): die Regel der AEAT und was Odoo beim Buchen entscheidet.Fehler 2001 bei VeriFactu: Die NIF Ihres Kunden ist im Register der AEAT nicht erfasstDer VeriFactu-Fehler 2001: Die NIF des Empfängers ist im Register der AEAT nicht erfasst. Warum die Rechnung trotzdem angenommen wird und was Sie in Odoo 17 bis 20 tun.
Geprüft im Quellcode des Moduls (Version 20.0) und in den verlinkten Quellen

Quellen