Veelgemaakte Factur-X / ZUGFeRD-fouten: probleemoplossingsgids
De 10 meest voorkomende fouten in Factur-X en ZUGFeRD-facturen en hoe ze te corrigeren. Niet-conform PDF, ongeldige XML, onvoldoend profiel.
Waarom genereren Factur-X-facturen fouten?
Factur-X en ZUGFeRD zijn complexe hybride formaten die een voor de mens leesbare PDF combineren met een gestructureerde XML conform ISO 19005-3 (PDF/A-3). Deze dubbele aard genereert twee categorieën fouten: PDF-gerelateerde fouten en XML-gerelateerde fouten.
PDF/A-3-naleving is vaak de eerste hindernis: niet alle PDF's kunnen zonder specifieke verwerking worden geconverteerd naar PDF/A-3. Factureringssoftware moet native PDF/A-3 genereren.
PDF-gerelateerde fouten
De 5 meest voorkomende PDF-fouten in Factur-X-facturen:
PDF niet conform PDF/A-3
Het PDF-bestand is niet conform de PDF/A-3-standaard (ISO 19005-3). Frequente oorzaken: niet-ingebedde lettertypen, JavaScript-gebruik, onafgevlakte transparanties.
XML niet correct bijgevoegd
De Factur-X XML moet worden bijgevoegd als PDF-bijlage met de exacte naam 'factur-x.xml' en de 'AF'-relatie gedefinieerd in de metadata.
Onjuiste XMP-metadata
De PDF moet specifieke XMP-metadata bevatten die het Factur-X-profiel en de versie aangeven.
Factur-X-versie niet gedeclareerd
De Factur-X-versie moet worden gedeclareerd in de XMP-metadata. Een inconsistentie tussen de gedeclareerde versie en de werkelijke XML-versie veroorzaakt validatiefouten.
PDF beschadigd tijdens samenvoeging
PDF + XML samenvoegen kan het bestand beschadigen als het gebruikte tool PDF/A-3 niet correct ondersteunt.
XML / CII-gerelateerde fouten
Deze fouten treden op in de ingebedde XML, ongeacht de geldigheid van de PDF-container:
Ontbrekend btw-nummer van de verkoper
EN 16931 vereist het btw-identificatienummer van de verkoper (SellerTradeParty/SpecifiedTaxRegistration/ID met schemeID='VA'). Een ontbrekend btw-nummer veroorzaakt het falen van regel BR-CO-09 en afwijzing door belastingautoriteitsplatforms.
Afrondingsafwijking btw-bedrag
Het berekende belastingbedrag (taxBasisAmount × taxRate / 100) moet overeenkomen met het gedeclareerde TaxTotalAmount binnen 0,01€. Afrondingsfouten in ERP-systemen — met name bij meerdere regels met verschillende tarieven — zijn de meest voorkomende oorzaak van EN 16931-regelfouten (BR-CO-15).
Eindtotaal klopt niet
GrandTotalAmount moet gelijk zijn aan LineTotalAmount − AllowanceTotalAmount + ChargeTotalAmount + TaxTotalAmount. Elke afwijking, zelfs van 0,01€, veroorzaakt het falen van EN 16931-regel BR-CO-16. Controleer of alle tussenliggende bedragen correct zijn opgeteld.
Onjuiste profielidentificator in GuidelineSpecifiedDocumentContextParameter
Het profiel moet worden gedeclareerd in de XML-header. Gangbare correcte waarden: urn:cen.eu:en16931:2017 (EN 16931 COMFORT), urn:factur-x.eu:1p0:minimum, urn:factur-x.eu:1p0:basicwl, enz. Een verschil tussen het gedeclareerde profiel en de aanwezige gegevens veroorzaakt validatiefouten.
Ontbrekende factuurregel bedragen of eenheidsprijs
EN 16931 vereist minimaal: artikelomschrijving, hoeveelheid, meeteenheid, eenheidsprijs en regelbedrag voor elke factuurregel. Veel MINIMUM-profielfacturen laten regeldetails weg, wat alleen geldig is voor dat profielniveau — overstappen naar EN 16931-profiel zonder regeldetailgegevens toe te voegen veroorzaakt regelfouten.
Hoe deze fouten te corrigeren en te voorkomen
Preventie begint met de keuze van gecertificeerde Factur-X-factureringssoftware. Gecertificeerde software garandeert het genereren van conforme bestanden.
Factur-X-validator openenVeelgestelde vragen
Wat is het verschil tussen Factur-X en ZUGFeRD?
Factur-X is de Franse/Europese versie, ZUGFeRD de Duitse versie. Beide zijn technisch identiek since ZUGFeRD 2.0 en interoperabel.
Welke Factur-X-profielen zijn beschikbaar?
De Factur-X-profielen zijn: Minimum, Basic WL (zonder regels), Basic (vereenvoudigde regels), EN 16931 (volledige naleving), Extended (aanvullende gegevens).
Mijn Factur-X PDF wordt afgewezen — hoe diagnosticeer ik het probleem?
Gebruik ValidateFin om de XML te extraheren en de naleving te verifiëren. Voor het PDF-gedeelte kan een PDF/A-validator zoals VeraPDF (gratis, open source) PDF/A-3-niet-nalevingen diagnosticeren.
Is Factur-X verplicht in Nederland?
Voor facturen aan overheidsinstanties (B2G), ja. Voor B2B-facturen worden Factur-X en UBL opgelegd door de Europese e-factureringshervorming.
Kan ik Factur-X genereren vanuit Excel of Word?
Niet natively. Een speciale software of add-in is vereist die PDF/A-3 kan genereren met ingebedde CII XML.
Moet de btw in de XML overeenkomen met die in de PDF?
Ja, verplicht. Bij discrepantie tussen de leesbare PDF en de gestructureerde XML is de XML juridisch bindend.
Extraheert ValidateFin automatisch de XML uit de PDF?
Ja, ValidateFin extraheert automatisch de ingebedde CII XML uit Factur-X/ZUGFeRD PDF's en valideert vervolgens de EN 16931-naleving.
Welke software beveelt u aan voor het genereren van Factur-X?
Wij geven geen commerciële aanbevelingen. Voor ontwikkelaars zijn open source bibliotheken beschikbaar in Python (factur-x), Java en PHP.
Kan een Factur-X-bestand meerdere facturen bevatten?
Nee, volgens de Factur-X-norm mag elk PDF-bestand slechts één factuur bevatten.
Welke Factur-X-versie gebruiken voor 2026?
Factur-X 1.0 (gebaseerd op CII D16B) met EN 16931 of Extended-profiel is aanbevolen. Controleer met uw Access Point en factureringssoftware.