Navigation

fino data services logo

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.

  1. 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.

  2. 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.

  3. 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.

  4. 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.

  5. 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.

Ofte stillede spørgsmål

KoSITs validator kontrollerer XML-dokumenter mod skema og Schematron. Den indlæste valideringskonfiguration bestemmer, hvilke regler der gælder. KoSIT offentliggør en konfiguration for XRechnung og en for Peppol BIS Billing 3.0, der bygger på OpenPeppols valideringsfiler. Hvis I ikke selv vil vedligeholde regelsættene, kan I integrere valideringen via endpointet i InvoiceRails-API’en, der automatisk genkender profilen. Det tyske finansministerium anbefaler ikke en bestemt validator. Det vigtige er, at jeres validator bruger de aktuelt gældende versioner af regelsættene.

Validatorerne kan bruge forskellige versioner af regelsættene eller kontrollere filen mod forskellige applikationsspecifikationer. En validator, der kun kontrollerer EN 16931, melder f.eks. ikke overtrædelser af XRechnung-regler som BR-DE-15. Nogle validatorer kontrollerer desuden egne regler, der ikke står i noget officielt regelsæt. Sammenlign derfor først versionsangivelserne, den kontrollerede specifikation og oprindelsen af det meldte regel-ID.

En automatisk afvisning er ikke påkrævet. Ifølge det tyske finansministerium er en validering ikke en direkte forudsætning for den skattemæssige anerkendelse af en faktura. Beslutningen ligger hos jeres kunder. For at hjælpe kunden med at træffe den rette beslutning, bør jeres software vise dem valideringsrapporten.

Det afgørende er den profil, der står i specifikations-ID’et BT-24. Profilerne MINIMUM og BASIC-WL opfylder ifølge det tyske finansministerium ikke de momsretlige krav til en e-faktura. Jeres software bør derfor generere en højere profil til e-fakturaer.

Læs videre

Faktaark

E-fakturering i Spanien

Spanien indfører obligatorisk e-fakturering ved B2B i to trin: fra 6. oktober 2027 for virksomheder med over 8 millioner euro i omsætning det foregående år og fra 6.

Validering, afsendelse og modtagelse via én API

Vi guider til, hvordan jeres software kan validere, sende og modtage e-fakturaer via InvoiceRails for et ubegrænset antal kunder.

Se InvoiceRails