XRechnung-validatie: de 10 meest voorkomende fouten en hoe u ze oplost

Wie voor het eerst een XRechnung aanmaakt en valideert, zal vrijwel zeker cryptische foutmeldingen tegenkomen. Codes als BR-DE-15, BR-CO-17 of BR-S-08 spreken niet voor zich. Toch hebben de meeste van deze fouten eenvoudige oorzaken die snel kunnen worden verholpen. In dit artikel leggen we de tien meest voorkomende validatiefouten in begrijpelijke taal uit en laten we zien hoe u ze oplost.

Waarom validatie essentieel is

XRechnung is gebaseerd op de Europese norm EN 16931. Deze norm definieert niet alleen het formaat maar ook bindende bedrijfsregels. Elke regel heeft een unieke code die begint met BR (Business Rule). Aanvullende Duits-specifieke regels dragen het voorvoegsel BR-DE. Een factuur wordt pas als conform beschouwd wanneer aan alle regels is voldaan. Ontvangende systemen — met name die van overheidsinstanties — wijzen niet-conforme facturen automatisch af.

De 10 meest voorkomende fouten

1. BR-DE-15: ontbrekende koperreferentie (Leitweg-ID)

Dit is de meest voorkomende fout. XRechnung vereist een koperreferentie in het BuyerReference-veld. Voor facturen aan publieke opdrachtgevers is dit de Leitweg-ID. Bij B2B-transacties kan elke overeengekomen referentiewaarde worden gebruikt, maar het veld mag nooit leeg zijn.

Oplossing: Vul de Leitweg-ID van de ontvanger of een overeengekomen referentienummer in.

2. BR-CO-17: onjuiste btw-berekening

BR-CO-17 controleert of het belastingbedrag per belastingcategorie (BT-117) correct is berekend: belastingbedrag = belastbare grondslag (BT-116) x belastingtarief (BT-119) / 100, afgerond op twee decimalen. Zelfs minimale afrondingsverschillen activeren deze fout.

Oplossing: Bereken de btw apart voor elke belastingcategorie op basis van de belastbare grondslag en het tarief, en rond pas aan het einde af op twee decimalen. Vermijd tussentijds afronden op regelitemniveau.

3. BR-DE-05: ontbrekende contactnaam van de verkoper

De Duitse XRechnung-extensie vereist dat een contactnaam wordt opgegeven in de sectie "Seller Contact" (BG-6) — specifiek een contactpunt van de verkoper (BT-41). BR-DE-02 maakt de gehele contactgroep verplicht, en BR-DE-05 vereist specifiek de contactnaam.

Oplossing: Vul cac:Contact/cbc:Name in met de naam van een contactpersoon of afdeling.

4. BR-DE-06: ontbrekend telefoonnummer van de verkoper

Regel BR-DE-06 vereist dat een telefoonnummer voor de verkoper wordt opgegeven in de contactsectie (BT-42, telefoonnummer van het verkoopcontact).

Oplossing: Vul het cac:Contact/cbc:Telephone-element in.

5. BR-DE-07: ontbrekend e-mailadres van de verkoper

Regel BR-DE-07 vereist dat de verkoper een e-mailadres opgeeft in de contactsectie (BT-43, e-mailadres van het verkoopcontact).

Oplossing: Vul het cac:Contact/cbc:ElectronicMail-element in voor de verkoper.

6. BR-S-08: mismatch in belastinggrondslag

Deze fout geeft aan dat het nettototaal van een belastingcategorie niet overeenkomt met de som van de bijbehorende regelitems.

Oplossing: Zorg ervoor dat de som van alle nettobedragen van regelitems exact overeenkomt met de waarde in de belastingsamenvatting (Tax Subtotal).

7. BR-DE-16: ontbrekende belastingidentificatie van de verkoper

BR-DE-16 vereist dat ten minste een van de volgende elementen wordt opgegeven: het btw-nummer (BT-31, btw-identificatienummer van de verkoper), het belastingregistratienummer (BT-32, belastingregistratienummer van de verkoper) of een belastingvertegenwoordiger (BG-11, belastingvertegenwoordiger van de verkoper).

Oplossing: Vul ofwel uw btw-nummer in het formaat DE123456789 in bij BT-31 of uw belastingregistratienummer bij BT-32. Ten minste een van beide is verplicht.

8. BR-CL-01: ongeldig factuurtypecode

Het factuurtype moet overeenkomen met een geldige UNTDID 1001-code. Voor een standaardfactuur is de code 380; voor een creditnota is het 381. Andere veelgebruikte codes zijn 389 (zelf gefactureerd) en 384 (gecorrigeerde factuur).

Oplossing: Gebruik de juiste code uit de UNTDID 1001-codelijst.

9. BR-CO-10: inconsistente totalen

BR-CO-10 controleert of de som van de nettobedragen van regelitems (BT-106) overeenkomt met het totaal van de individuele nettobedragen (BT-131). Samen met gerelateerde regels waarborgt het dat het totaalbedrag exclusief btw (BT-109) = regelitemtotaal (BT-106) - kortingen (BT-107) + toeslagen (BT-108).

Oplossing: Controleer uw totaalberekeningen: de som van alle nettobedragen van regelitems moet exact gelijk zijn aan BT-106, en BT-106 minus kortingen plus toeslagen moet gelijk zijn aan het totale nettobedrag (BT-109).

10. BR-DE-01: ontbrekende betalingsinstructies

De Duitse XRechnung vereist dat de groep "Payment Instructions" (BG-16) wordt ingevuld. Dit omvat ten minste het specificeren van een betaalmiddeltype (BT-81), zoals overboeking (code 30 of 58). Afhankelijk van de betaalmethode moeten aanvullende gegevens zoals het IBAN (BG-17) worden opgegeven.

Oplossing: Voeg de betalingsinstructies toe in BG-16 met de juiste betaalmiddelcode en de bijbehorende gegevens (bijv. IBAN voor overschrijvingen). Optioneel kunt u ook betalingsvoorwaarden als vrije tekst opnemen in PaymentTerms/Note (BT-20).

Hoe u fouten van meet af aan voorkomt

De eenvoudigste manier om validatiefouten te voorkomen is het gebruik van een tool die de regels automatisch controleert. Met de gratis XRechnung Validator van invapi kunt u uw XML-bestanden direct in de browser valideren tegen alle EN 16931- en XRechnung-regels. Foutmeldingen worden in een duidelijk formaat gepresenteerd met specifieke aanwijzingen hoe u ze kunt verhelpen.

Als alternatief kunt u de invapi API rechtstreeks in uw factureringsworkflow integreren om facturen automatisch aan te maken, te converteren en te valideren voordat ze worden verstuurd.

Conclusie

XRechnung-validatiefouten lijken op het eerste gezicht intimiderend, maar zijn vrijwel altijd te herleiden tot ontbrekende verplichte velden of afrondingsproblemen. Kennis van de meest voorkomende fouten en het gebruik van een goede validatietool bespaart tijd en waarborgt compliance. Probeer de gratis invapi Validator en verstuur uw volgende XRechnung foutloos.