Zum Hauptinhalt springen
VeriFactu

VeriFactu-Fehler in Odoo: was die AEAT sagt und was Ihr eigenes System vorher stoppt

Ein VeriFactu-Fehler kann aus zwei Richtungen kommen: von der AEAT, der spanischen Steuerbehörde, die jede Übermittlung mit einem Status und einem Code beantwortet, oder von Ihrem eigenen System, das die Rechnung vor dem Senden blockiert, wenn etwas fehlt, etwa das Zertifikat oder eine gültige NIF. Beides auseinanderzuhalten spart Zeit, weil es an verschiedenen Stellen behoben wird. Hier sind beide Gruppen.

FlexigoTech · Verantwortlich: Víctor Gómez · Aktualisiert am 3. 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
3 Min.

Was die AEAT antwortet

Jede Übermittlung enthält zwischen 1 und 1.000 Datensätze. Die Antwort bringt einen Status für die ganze Übermittlung (Correcto, ParcialmenteCorrecto oder Incorrecto), einen Status pro Datensatz (Correcto, AceptadoConErrores oder Incorrecto) und die Wartezeit bis zur nächsten Übermittlung.

Die AEAT veröffentlicht ihren offiziellen Fehlerkatalog mit 247 Codes in drei Familien:

FamilieWas sie bedeutetWas zu tun ist
4xxx: ganze Übermittlung abgelehntNichts aus dieser Übermittlung wurde registriert.Beheben Sie die Ursache und senden Sie die ganze Übermittlung erneut.
Datensatz abgelehntDieser Datensatz wird nicht angenommen, der Rest der Übermittlung schon.Korrigieren Sie diesen Datensatz und senden Sie nur ihn erneut.
2xxx: angenommen mit FehlernDer Datensatz ist registriert, aber etwas muss korrigiert werden.Senden Sie ihn nicht als neu: Korrigieren Sie, was der Code sagt.

Zwei Fälle sollten Sie sofort erkennen. Code 3000 kennzeichnet einen doppelten Datensatz: Wenn er bereits als korrekt oder als mit Fehlern angenommen erscheint, müssen Sie ihn nicht erneut senden. Und den Fingerabdruck, einen SHA-256, der mit dem vorherigen Datensatz verkettet ist, berechnet die AEAT nach: Stimmt er nicht überein, wird der Datensatz mit einem Fehler angenommen, der korrigiert werden muss.

Liste der von der AEAT zurückgegebenen Fehler in Odoo
AEAT-Fehler, Datensatz für Datensatz und nach Code gruppiert, in Odoo. Screenshot aus Odoo mit Demodaten; die Antworten der AEAT sind simuliert.

Bevor es zur AEAT geht: das Zertifikat

Die AEAT erkennt den Aussteller am Zertifikat, das beim Verbinden vorgelegt wird. Ohne Zertifikat leitet ihr Dienst auf die Fehlerseite 4033 um, „kein Zertifikat erkannt“. Mit einem Zertifikat, das sich nicht validieren lässt, auf 4011. In Odoo werden diese Fälle früher abgefangen:

  • No active certificate for company …: Das Unternehmen hat kein aktives Zertifikat. Laden Sie es unter Configuration › Certificates hoch.
  • The certificate … of company … has expired.: Es ist abgelaufen. Eine tägliche Ablaufwarnung sorgt dafür, dass es nicht so weit kommt.

Was Ihr System vor dem Senden blockiert

MeldungWas fehltLösung
Company … has no NIF for Veri*Factu.Das Unternehmen hat keine NIF.Tragen Sie sie in den Unternehmensdaten ein.
Invalid NIF length: "…" (must be 9 chars)Die NIF des Kunden hat keine 9 Zeichen.Prüfen Sie die NIF im Kontakt.
Invalid NIF digits: "…"Die NIF enthält ungültige Zeichen.Korrigieren Sie sie im Kontakt.
Cannot post invoice: invalid counterparty identifier.Die Kennung des Kunden ist ungültig.Korrigieren Sie die Kennung vor dem Buchen.
Record … has no tax breakdown (Desglose) to declare.Die Rechnung hat keine Steueraufschlüsselung.Prüfen Sie die Steuern in den Positionen.
Record … is chained to a previous record that does not exist.Die Datensatzkette ist unterbrochen.Fassen Sie sie nicht von Hand an: Prüfen Sie den Status der Kette und schreiben Sie uns.
The AEAT accepts at most 1000 records per request.Eine Übermittlung mit mehr Datensätzen als erlaubt.Die Warteschlange teilt sie auf; wenn Sie das sehen, sagen Sie uns Bescheid.
AEAT-Fehlerkatalog in Odoo geladen
Der Fehlerkatalog der AEAT in Odoo, mit seinen 247 Codes, um jeden zu lesen, ohne das System zu verlassen. Screenshot aus Odoo mit Demodaten.

Wo Sie in Odoo nachsehen

Die Übermittlungswarteschlange wird jede Minute verarbeitet und liegt unter AEAT Submission › Submission Queue. Von der AEAT zurückgegebene Fehler haben eine eigene Liste unter AEAT Errors, und der vollständige Codekatalog liegt unter AEAT Error Catalogue. Mit diesen drei Bildschirmen lösen Sie die meisten Fälle, ohne das technische Dokument der AEAT zu öffnen, auch wenn es unten verlinkt ist, falls Sie es brauchen.

Übermittlungswarteschlange an die AEAT in Odoo
Die Übermittlungswarteschlange: was aussteht, was gesendet wurde und was fehlgeschlagen ist. Screenshot aus Odoo mit Demodaten; die Antworten der AEAT sind simuliert.

Das Modul ist für Odoo 17, 18, 19 und 20 veröffentlicht. Wenn ein Code nicht im Katalog steht, schicken Sie uns den genauen Text der Antwort: Wir finden ihn im offiziellen Validierungsdokument.

Weiterlesen

VeriFactu: die Fristen 2027, die Prognose für 2028 und was Sie in der Zwischenzeit in Odoo tunDer VeriFactu-Kalender im November 2026: Fristen nach RDL 15/2025, die vom Ministerium erwartete Verschiebung auf Oktober 2028 und was Sie jetzt in Odoo tun.VeriFactu: Mythen und Fakten für Unternehmen, die mit Odoo fakturierenVerbreitete Annahmen über VeriFactu, geprüft an der AEAT und am System selbst: Fingerabdruck, angenommene Fehler, Stornierungen, Migrationen, Fristen und Odoo.
Geprüft im Quellcode des Moduls (Version 20.0) und in den verlinkten Quellen

Quellen