Naar hoofdinhoud
VeriFactu

VeriFactu-fouten in Odoo: zo lees je wat de AEAT zegt en wat je eigen systeem vooraf tegenhoudt

Een VeriFactu-fout kan uit twee hoeken komen: van de AEAT, die op elke verzending antwoordt met een status en een code, of van je eigen systeem, dat de factuur vóór verzending blokkeert als er iets ontbreekt, zoals het certificaat of een geldig NIF. Ze uit elkaar houden scheelt tijd, want je lost ze op verschillende plekken op. Hier zijn beide groepen.

FlexigoTech · Verantwoordelijk: Víctor Gómez · Bijgewerkt op 3 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
3 min

Wat de AEAT antwoordt

Elke verzending bevat tussen 1 en 1.000 records. Het antwoord bevat een status voor de hele verzending (Correcto, ParcialmenteCorrecto of Incorrecto), een status per record (Correcto, AceptadoConErrores of Incorrecto) en de wachttijd tot de volgende verzending.

De AEAT publiceert haar officiële foutencatalogus, met 247 codes, in drie families:

FamilieWat het betekentWat je doet
4xxx: hele verzending afgewezenNiets uit die verzending is geregistreerd.Los de oorzaak op en verstuur de hele verzending opnieuw.
Record afgewezenDat record wordt niet geaccepteerd; de rest van de verzending wel.Corrigeer dat record en verstuur alleen dat record opnieuw.
2xxx: geaccepteerd met foutenHet record is geregistreerd, maar er moet iets worden gecorrigeerd.Verstuur het niet opnieuw als nieuw: corrigeer wat de code aangeeft.

Twee concrete gevallen herken je het best meteen. Code 3000 meldt een dubbel record: staat het al als correct of als geaccepteerd met fouten, dan hoef je het niet opnieuw te versturen. En de vingerafdruk, een SHA-256 die aan het vorige record is gekoppeld, wordt door de AEAT opnieuw berekend: klopt hij niet, dan wordt het record geaccepteerd met een fout die moet worden gecorrigeerd.

Lijst van fouten die de AEAT in Odoo heeft teruggegeven
AEAT-fouten, record voor record en gegroepeerd per code, in Odoo. Schermafbeelding van Odoo met demogegevens; de antwoorden van de AEAT zijn gesimuleerd.

Voordat je bij de AEAT aankomt: het certificaat

De AEAT herkent de uitgever aan het certificaat dat bij het verbinden wordt getoond. Zonder certificaat stuurt haar dienst door naar foutpagina 4033, "geen certificaat gedetecteerd". Met een certificaat dat niet valideert, naar 4011. In Odoo worden deze gevallen eerder tegengehouden:

  • No active certificate for company …: het bedrijf heeft geen actief certificaat. Upload het onder Configuration › Certificates.
  • The certificate … of company … has expired.: het is verlopen. Er is een dagelijkse vervalwaarschuwing, zodat het zover niet komt.

Wat je systeem vóór verzending blokkeert

MeldingWat er ontbreektOplossing
Company … has no NIF for Veri*Factu.Het bedrijf heeft geen NIF.Vul het in bij de bedrijfsgegevens.
Invalid NIF length: "…" (must be 9 chars)Het NIF van de klant heeft geen 9 tekens.Controleer het NIF bij het contact.
Invalid NIF digits: "…"Het NIF bevat ongeldige tekens.Corrigeer het bij het contact.
Cannot post invoice: invalid counterparty identifier.De identificatie van de klant is niet geldig.Corrigeer de identificatie voordat je boekt.
Record … has no tax breakdown (Desglose) to declare.De factuur heeft geen uitsplitsing van de belasting.Controleer de belastingen op de regels.
Record … is chained to a previous record that does not exist.De recordketen is gebroken.Raak hem niet met de hand aan: controleer de status van de keten en schrijf ons.
The AEAT accepts at most 1000 records per request.Een verzending met meer records dan toegestaan.De wachtrij splitst ze; zie je dit, laat het ons dan weten.
Foutencatalogus van de AEAT geladen in Odoo
De foutencatalogus van de AEAT in Odoo, met zijn 247 codes, zodat je elke code leest zonder het systeem te verlaten. Schermafbeelding van Odoo met demogegevens.

Waar je kijkt in Odoo

De verzendwachtrij wordt elke minuut verwerkt en staat onder AEAT Submission › Submission Queue. Fouten die de AEAT teruggeeft, hebben een eigen lijst onder AEAT Errors, en de volledige codecatalogus staat onder AEAT Error Catalogue. Met die drie schermen los je de meeste gevallen op zonder het technische document van de AEAT te openen, al staat het hieronder gelinkt voor het geval je het nodig hebt.

Verzendwachtrij naar de AEAT in Odoo
De verzendwachtrij: wat openstaat, wat is verstuurd en wat is mislukt. Schermafbeelding van Odoo met demogegevens; de antwoorden van de AEAT zijn gesimuleerd.

De module is gepubliceerd voor Odoo 17, 18, 19 en 20. Staat een code niet in de catalogus, stuur ons dan de exacte tekst van het antwoord: we zoeken hem op in het officiële document met validaties.

Lees verder

VeriFactu: de termijnen van 2027, de verwachting voor 2028 en wat je intussen in Odoo doetDe VeriFactu-kalender per november 2026: termijnen volgens RDL 15/2025, de verwachte uitstel tot oktober 2028 van het ministerie en wat je nu in Odoo voorbereidt.VeriFactu: mythes en feiten voor bedrijven die met Odoo facturerenGangbare ideeën over VeriFactu getoetst aan de AEAT en aan het systeem zelf: vingerafdruk, geaccepteerde fouten, annuleringen, migraties, termijnen en de Odoo-module.
Gecontroleerd in de broncode van de module (versie 20.0) en in de gelinkte bronnen

Bronnen