Viden · E-faktura
Valider e-fakturaer og læs valideringsrapporten korrekt
Når en e-faktura fra jeres software afvises, skal teamet ud fra valideringsrapporten finde ud af, hvilket felt der udløste meldingen, og hvem der kan rette det.
Vi viser, hvordan man læser en valideringsrapport korrekt, og hvor valideringen skal ligge i jeres software.
Det, der kontrolleres ved validering af en e-faktura
En validator kontrollerer en e-faktura mod tre regelsæt i rækkefølge og registrerer alle afvigelser i en valideringsrapport.
Syntaksens XML-skema
En e-faktura efter EN 16931 forekommer i en af to syntakser: UBL eller UN/CEFACT CII. Alle almindelige applikationsspecifikationer bygger på disse to syntakser, f.eks. XRechnung, ZUGFeRD og Peppol BIS Billing 3.0.
Syntaksens XML-skema fastlægger, hvilke elementer der er tilladt, deres rækkefølge og datatype.
Skema-fejl har ikke et regel-ID. XML-parseren rapporterer dem med sine egne koder, for eksempel cvc-complex-type.2.4.a for et element på et sted, hvor skemaet ikke forventer det.
I ZUGFeRD indlejres en CII-fil i en PDF, og validatoren kontrollerer XML-delen. Hvis den afviger fra den visuelle del, gælder XML-delen jf. det tyske finansministeriums skrivelse af 15. oktober 2025 (BMF-Schreiben) om indførelsen af obligatorisk e-faktura.
Forretningsreglerne i EN 16931
Forretningsreglerne kontrollerer oplysningerne i en e-faktura for logiske fejl, f.eks. om obligatoriske felter er udfyldt, og om summerne stemmer overens. Den Europæiske Standardiseringsorganisation (CEN) offentliggør disse regler som Schematron-filer på GitHub, både for UBL og for CII.
Præfikset i regel-ID’et viser, hvilken slags kontrol der er tale om. Regler med BR og et tal kontrollerer obligatoriske felter og deres antal, BR-CO kontrollerer beregninger og sammenhænge mellem felter, BR-CL kontrollerer kodelister, og BR-DEC kontrollerer decimaler i beløb. Regler som BR-S, BR-AE eller BR-IC kontrollerer oplysninger om de enkelte momskategorier.
CEN-filerne indeholder desuden syntaksspecifikke regler. Regler med præfikset UBL-CR melder f.eks. en advarsel, hvis en UBL-fil indeholder elementer, der ikke hører til datamodellen i EN 16931.
Regler i XRechnung og Peppol BIS Billing 3.0
XRechnung og Peppol BIS Billing 3.0 er applikationsspecifikationer til EN 16931, i fagsprog kaldet CIUS (Core Invoice Usage Specification). De gør flere felter obligatoriske og supplerer EN 16931 med egne regler. CIUS må ikke indføre nye datafelter.
XRechnungs regler begynder med præfikset BR-DE og stammer fra det tyske koordineringskontor for IT-standarder (Koordinierungsstelle für IT-Standards, KoSIT). Peppol BIS Billing 3.0 tilføjer regler med præfikserne PEPPOL-EN16931 og PEPPOL-COMMON samt landespecifikke regler.
Specifikations-ID’et i BT-24 fastlægger, hvilken applikationsspecifikation der gælder for filen. KoSITs validator vælger ud fra dette ID det gældende valideringsscenarie. Et forkert eller forældet ID kan derfor føre til, at filen kontrolleres mod andre regler eller afvises.
Hvad en validering ikke kontrollerer
En validator kan ikke se, om momssatsen passer til ydelsen, eller om ydelsesbeskrivelsen er tilstrækkelig.
Ifølge det tyske finansministerium skal alle momsretlige obligatoriske oplysninger stå i den strukturerede del af e-fakturaen. En henvisning til et bilag med ydelsesbeskrivelsen er ikke i sig selv nok. Et varenavn som “se bilag” i BT-153 vil alligevel bestå valideringen, fordi ingen regel vurderer indholdet i dette felt.
KoSIT og Forum elektronische Rechnung Deutschland (FeRD) har offentliggjort en tabel, der knytter de obligatoriske oplysninger i den tyske momslov til de tilsvarende BT-felter. Ud fra denne tabel kan I afgøre, hvilke obligatoriske oplysninger jeres software bør sikre med egne valideringer.
Opbygningen af en valideringsrapport
Hver post i valideringsrapporten indeholder som regel fire oplysninger.
Regel-ID
Regel-ID’et, f.eks. BR-CO-15 eller BR-DE-2, henviser til reglen i dokumentationen for det pågældende regelsæt.
Alvorlighedsgrad
En validator markerer hver meddelelse som en fejl eller som en advarsel. I Peppol-reglerne kaldes fejl for fatale. Som regel vil en advarsel ikke i sig selv føre til afvisning. Nogle validatorer udsender også bemærkninger, dvs. anbefalinger til en ren implementering, som ikke påvirker resultatet. Til sidst i rapporten anbefaler KoSIT-validatoren at acceptere eller afvise dokumentet.
Peppol indfører ofte nye regler. Først som advarsler, som i efterfølgende releases opgraderes til fejl. For eksempel blev reglerne PEPPOL-COMMON-R052 og PEPPOL-COMMON-R053 ændret fra advarsler til fejl i version 3.0.21, som det fremgår af release notes for Peppol BIS Billing 3.0.
Placering
Placeringen er et XPath-udtryk, der peger på det berørte element i XML-filen. Det samme BT-nummer ligger forskellige steder i UBL og CII. Fakturabeløb inklusive moms (BT-112) står i UBL i elementet cbc:TaxInclusiveAmount under cac:LegalMonetaryTotal og i CII i elementet ram:GrandTotalAmount under ram:SpecifiedTradeSettlementHeaderMonetarySummation.
Ved regler, der sammenligner flere felter, peger placeringen ofte på et overordnet element. Værdien, der udløser meldingen, findes via meldingsteksten.
Meldingstekst
Meldingsteksten beskriver reglen og nævner som regel de involverede BT-numre. Meldingen til BR-CO-15 siger f.eks., at fakturabeløbet inklusive moms (BT-112) skal svare til summen af fakturabeløbet eksklusive moms (BT-109) og momsbeløbet (BT-110).
Fra version 3.0.21 begynder tekster i Peppol-reglerne med regel-ID’et.
Gennemgå valideringsrapporter i den rigtige rækkefølge
En lang valideringsrapport skyldes ofte få ting.
-
Ret skemafejl
Så længe filen ikke opfylder skemaet, er forretningsreglernes resultater enten ikke tydelige eller mangler helt. Ret derfor først skemafejlene i eksporten, og valider derefter filen igen.
-
Gruppér poster efter regel-ID
En fejl i mappingen kan optræde i alle fakturalinjer. En faktura med 40 linjer tillægger dermed 40 poster den samme regel, som alle skyldes én enkelt årsag. Gennemgå derfor rapporten efter regel-ID.
-
Identificér følgefejl
Et manglende element kan overtræde flere regler på én gang. Hvis momsspecifikationen (BG-23) mangler, rapporterer validatoren f.eks. både BR-CO-18 og derudover reglerne for den berørte momskategori, såsom BR-S-01. Ret først årsagen og valider igen, før I behandler de øvrige meldinger enkeltvis.
-
Brug BT-nummeret for at tilgå jeres egen datamodel
BT-nummeret forbinder valideringsrapporten med jeres software. Vedligehold en kobling fra hvert BT-nummer til databasefeltet, formularfeltet i jeres brugerflade og ansvarshaver. Ansvarshaver afgør, om det er jeres team, der skal rette fejlen, eller kunden, f.eks. hvis der mangler stamdata.
-
Vurder og registrér advarsler
Beslut for hver advarsel, om I vil rette eller acceptere den. Registrér beslutningen, og kontrollér ved hver ny release, om en accepteret advarsel er blevet opgraderet til fejl.
Typiske fejl pr. regelgruppe
Regelgruppen viser ofte, hvor i jeres software rettelsen skal foretages.
Skemafejl uden regel-ID
Årsagen ligger i elementrækkefølgen, namespace eller en forkert datatype i eksporten. Rettelsen foretages i eksportfunktionen, én gang for alle kunder.
BR med tal
Årsagen er et obligatorisk felt, der ikke er mappet eller er tomt i stamdataene. Rettelsen foretages i mappingen eller i det obligatoriske felt i brugerfladen.
BR-CO og BR-DEC
Årsagen ligger i summer, afrunding, rabatter og tillæg på dokumentniveau. Rettelsen foretages i beregningslogikken i fakturaoprettelsen.
BR-CL
Årsagen er en forældet eller egen kode, f.eks. for måleenheder eller lande. Rettelsen foretages i kodelisterne i jeres software.
BR-S, BR-AE, BR-IC og andre kategorier
Momskategori, momssats og fritagelsesgrund passer ikke sammen. Rettelsen foretages i momslogikken og i varestamdataene.
UBL-CR
Eksporten indeholder UBL-elementer uden for datamodellen i EN 16931. Rettelsen foretages i eksportfunktionen.
BR-DE
Sælgers kontaktoplysninger, betalingsoplysninger eller køberreference mangler. Rettelsen foretages som regel i kundens stamdata.
PEPPOL-EN16931 og PEPPOL-COMMON
Den elektroniske adresse mangler, eller et ID har det forkerte format. Rettelsen foretages i stamdataene og i administrationen af Peppol-ID’er.
Manglende køberreference ved XRechnung (BR-DE-15)
Reglen BR-DE-15 melder en manglende køberreference i BT-10. Ved fakturaer til den offentlige forvaltning står myndighedens Leitweg-ID heri. For B2B-fakturaer er det ifølge det tyske finansministerium momsretligt tilstrækkeligt med en standardværdi som “-”, hvis fakturamodtageren ikke angiver sin egen identifikator. Jeres software kan derfor forudfylde feltet for B2B-fakturaer med en standardværdi, som jeres kunder kan overskrive.
Afrundingsdifferencer i momsen (BR-S-09)
Reglen BR-S-09 sammenligner momsbeløbet i kategorien standardsats med produktet af beregningsgrundlag og momssats. Hvis jeres software afrunder momsen pr. linje og lægger beløbene sammen, kan summen afvige herfra. Ved flere linjer kan afvigelsen blive større end den tolerance, som reglen tillader. Beregn derfor momsbeløbet pr. kategori ud fra beregningsgrundlag og momssats, som reglen foreskriver.
Tilføj validering til jeres software
Valideringen hører til fem steder i jeres software og udviklingsproces.
Før afsendelse
Jeres software bør validere hver e-faktura direkte efter oprettelsen og stoppe afsendelsen ved fejl. For jeres kunder er et regel-ID eller et XPath-udtryk ikke til meget nytte, og I bør derfor oversætte de regler, som jeres kunder selv kan rette, til en besked ved det berørte formularfelt. Beskeden til BR-DE-6, telefonnummeret på sælgerens kontaktperson i BT-42, kan f.eks. lyde “Angiv venligst et telefonnummer til spørgsmål”.
Fejl, der skyldes jeres mapping eller beregningslogik, kan jeres kunder ikke rette. Sådanne fejl bør vises som interne beskeder til teamet.
Ved modtagelse
Jeres software bør også validere indgående e-fakturaer og vise resultatet på dokumentet. Gem den originale fil uændret, og valideringsrapporten som et separat dokument ved siden af. Det tyske finansministerium kræver, at mindst den strukturerede del af en e-faktura bevares uændret i sin oprindelige form.
Hvis en indgående faktura indeholder fejl, kan kunden anmode afsender om en korrigeret faktura. Jeres software kan understøtte dette trin, f.eks. med en forberedt henvendelse til afsender, der indeholder valideringsrapporten.
I automatiserede tests
Opret en samling af testfakturaer, der dækker jeres fakturatyper med deres koder, f.eks. 380 for en faktura og 384 for en berigtiget faktura. Dæk desuden alle momskategorier, som jeres kunder bruger. Dertil kommer rabatter og tillæg samt enhver syntaks, jeres software genererer. Medtag også bevidst fejlbehæftede filer, og kontrollér, at validatoren afviser dem.
KoSIT-validatoren er et open source-program til kommandolinjen og kan integreres i en build-pipeline. KoSIT har desuden en testsuite med eksempler på fakturaer, der er et godt udgangspunkt for jeres egen samling.
Efter hver opdatering af regelsættene
Regelsættene ændrer sig, men ikke alle ændringer kommer med nyt versionsnummer. KoSIT offentliggør jævnligt bundles med fejlrettelser til XRechnung 3.0.2, senest i udgaven af 31. august 2026. XRechnung 3.0 forbliver gældende mindst indtil 31. juli 2027.
Forhåndsversionen af specifikationen XRechnung 4.0 udkom den 15. september 2026. Den er udtrykkeligt ikke beregnet til brug i produktionsmiljø, men giver et tidligt blik på nye og ændrede funktionaliteter. Den endelige version forventes at udkomme i foråret 2027 sammen med de tekniske komponenter.
OpenPeppol offentliggør jævnligt nye releases af Peppol BIS Billing 3.0, de seneste år hver maj og november. Version 3.0.21 blev offentliggjort den 20. maj 2026 og har været bindende siden 17. august 2026.
Planlæg for hver release en fast dato, hvor I validerer jeres testdokumenter mod de nye regler. Registrér i hver valideringsrapport, hvilken version af validator og regelsæt den er foretaget med. Så kan I også eftervise et resultat, hvis reglerne er ændret i mellemtiden. Ved skift til XRechnung 4.0 bør jeres testmiljø kunne kontrollere begge versioner parallelt.
Analysér valideringsrapporter på tværs af alle kunder
Hvis jeres software genererer e-fakturaer for mange kunder, kan det betale sig at analysere valideringsrapporterne på tværs af dem alle. Dukker det samme regel-ID pludselig op hos flere kunder, ligger årsagen sandsynligvis i mappingen eller i et nyt regelsæt. Optræder det kun hos én kunde, ligger årsagen snarere i dennes stamdata.
Validering med InvoiceRails
Trinene i denne artikel kan I selv implementere. Der er en overkommelig engangsindsats, men den løbende vedligeholdelse kræver mere: Regelsæt, kodelister og valideringskonfigurationer ændres flere gange om året, og hver eneste ændring skal indarbejdes i jeres tests, afsendelsesproces og release-planlægning.
Validering, afsendelse og vedligeholdelse af regelsættene kan derfor med fordel overlades til et certificeret Peppol-adgangspunkt som InvoiceRails.
E-faktura-validator til enkeltkontroller
Den gratis e-faktura-validator fra InvoiceRails kontrollerer XML-filer i UBL og CII samt hybride PDF-fakturaer uden login. Den genkender automatisk syntaks, version og profil, heriblandt XRechnung, Peppol BIS Billing 3.0, ZUGFeRD, Factur-X og andre profiler af EN 16931. Den validerer derefter filen mod XML-skemaet samt Schematron- og forretningsreglerne i den genkendte profil. Valideringsrapporten kan downloades som PDF og deles via et link, f.eks. hvis jeres support skal gennemgå en afvist faktura med en kunde.
InvoiceRails-API i jeres software
InvoiceRails er fino data services’ OpenPeppol-certificerede Peppol-adgangspunkt. Jeres software tilsluttes InvoiceRails via en REST-API, som den sender og modtager e-fakturaer gennem, uanset antal kunder. Kan også integreres som white label ved forespørgsel.
API’en tilbyder valideringen som et dedikeret endpoint samt automatisk profilgenkendelse. Jeres software kan bruge det til at kontrollere e-fakturaer umiddelbart efter, de er oprettet. Hver besked i svaret indeholder regel-ID, alvorlighedsgrad, meldingstekst og placering som XPath. Jeres software kan gemme validerings-ID’et sammen med fakturaen og hente resultatet igen i mindst 90 dage.
InvoiceRails validerer hver fil, som jeres software sender via Peppol, også uden denne forhåndsvalidering. Jeres software skal på forhånd kontrollere, hvilke formater en modtager understøtter.
InvoiceRails kontrollerer også indgående e-fakturaer og overfører den originale fil sammen med de udtrukne fakturadata til jeres software. En webhook melder om enhver ændring i leveringsstatus til jeres software.
Jeres software står fortsat for koblingen af felterne fra jeres datamodel, meddelelser i jeres brugerflade og plausibilitetskontroller for obligatoriske oplysninger, der ikke er dækket af nogen regler.