E-facturatiesoftware voor ontwikkelaars: XRechnung, Factur-X, Peppol bouwen?

Een geldig EN 16931-XML-bestand genereren is het kleine deel van e-facturatie, en een goede bibliotheek doet dat binnen een week voor u. Het grote deel is alles rond het bestand: bijblijven met nationale regelsets die blijven veranderen, valideren tegen de Schematron van het land van de koper, per koper het juiste profiel en de juiste syntaxis kiezen, het document transporteren via Peppol, een erkend platform of KSeF, de factuur zoals uitgereikt bewaren gedurende de bewaartermijn, en hetzelfde in omgekeerde richting doen voor wat uw leveranciers u sturen. Bouw wanneer e-facturatie uw product is; koop — of integreer via een API — wanneer het uw verplichting is.

Wat de norm werkelijk van u vraagt

EN 16931 definieert een semantisch model van een factuur en twee XML-syntaxen die het dragen; elk nationaal formaat in West- en Midden-Europa is ofwel een ingeperkt profiel van dat model, ofwel, in het geval van Polen, een afzonderlijk schema. Om het te implementeren hebt u het model, de syntaxisbinding en de nationale regels erbovenop nodig.

De pagina van de Commissie over het verkrijgen van de norm somt de delen op: "het semantische gegevensmodel (EN 16931-1: 2017)" en "de twee verplichte syntaxen die aan de norm voldoen (CEN/TS 16931-2: 2017)" zijn kosteloos beschikbaar via de nationale normalisatie-instellingen, terwijl "kopieën van de overige delen (3-6) van de norm, bestaande uit syntaxisbindingen, richtlijnen en methodologieën, worden verkocht". De twee syntaxen zijn UBL 2.1 (deel 3-2) en UN/CEFACT CII D16B (deel 3-3). Daarbovenop:

• Duitsland — XRechnung, de nationale specificatie van KoSIT, met eigen Schematron en beperkingen op codelijsten; en ZUGFeRD, de hybride PDF/A-3 met ingesloten CII. Vanaf 2027 mogen ondernemingen met een omzet boven EUR 800.000 "geen papieren facturen meer uitreiken of ongestructureerde elektronische formaten gebruiken"; alle ondernemingen vanaf 2028.
• Frankrijk — Factur-X, "een Frans-Duitse hybride norm voor elektronische facturen (pdf voor gebruikers en XML-gegevens voor geautomatiseerde verwerking)", technisch "dezelfde norm als ZUGFeRD 2.5", plus UBL en CII, uitgewisseld via erkende platformen die het ministerie een "verplichte tussenpersoon tussen ondernemingen" noemt.
• België — Peppol BIS Billing 3.0, een CIUS van EN 16931 in UBL 2.1; "elk instantiedocument dat aan deze specificatie voldoet, voldoet aan de Europese norm (EN 16931)".
• Polen — FA(3), een nationaal XML-schema dat bij KSeF wordt ingediend, "verplicht voor alle ondernemers" vanaf 1 april 2026, behalve de kleinste, die volgen op 1 januari 2027.

De formaten worden in detail vergeleken op de formatenpagina; het model zelf op EN 16931.

Wat een bibliotheek u geeft, en wat niet

Een bibliotheek zet uw factuurobject om in XML (of een hybride pdf) en voert, bij de betere, de Schematron uit. Ze kent het land van uw koper, uw btw-oordeel, uw nummerreeks of de bewaartermijn niet, en ze levert niets ergens af.

Een beslissing om te bouwen is in werkelijkheid een beslissing om de middelste rijen van die tabel zelf te dragen. Voor een bedrijf waarvan het product facturatie is, is dat de juiste keuze. Voor een SaaS- of dienstenbedrijf dat vijftig geldige facturen per maand in drie landen moet uitreiken, is het een tweede product waar niemand om heeft gevraagd.

Validatie: de regels bewegen, en de validator van de koper wint

Een factuur is geldig wanneer de validator van de ontvanger dat zegt, en ontvangers draaien de nationale regelsets. Valideer daartegen, niet tegen "welgevormde XML", en valideer opnieuw wanneer de regelset verandert — zowel KoSIT als OpenPeppol publiceren bijgewerkte regelbundels in regelmatige releasecycli.

Het referentie-instrument voor Duitsland is de KoSIT-validator, een opensource-engine die "het werkelijke XML-formaat identificeert, het XML-bestand valideert (met schema- en Schematron-regels), een aangepast rapport genereert / aangepaste gegevens uit het XML-bestand extraheert en een aanvaardingsstatus berekent", aangestuurd door scenarioconfiguraties voor XRechnung en EN 16931. Hij draait vanaf de opdrachtregel, ingebed in Java, of als HTTP-daemon, onder de Apache 2.0-licentie — wat hem een goede CI-stap maakt, of u nu bouwt of koopt. Peppol BIS Billing 3.0 levert zijn Schematron in twee sets, "Peppol transaction business rules" en "EN 16931 transaction business rules"; beide moeten slagen. Voor hybride formaten valideert u twee keer: de ingesloten XML tegen het profiel, en de container tegen PDF/A-3.

Wat u ook kiest, houd een onafhankelijke validator in uw pijplijn. De gratis e-factuurchecker valideert een bestand tegen de regels van een land zonder het op te slaan, wat volstaat voor een steekproef; de KoSIT-validator in CI is de sterkere gewoonte. De details op ontwikkelaarsniveau — business terms, regelidentificaties, veelvoorkomende fouten — staan in de EN 16931-ontwikkelaarsgids.

Transport: drie netwerken, drie verschillende problemen

Het bestand produceren is in elk land hetzelfde probleem; het afleveren niet. Peppol is een vierhoeksnetwerk waarbij u zich via een access point aansluit; het Franse systeem routeert B2B-facturen via erkende platformen; het Poolse KSeF is een centraal overheidsplatform dat de factuur haar juridische identiteit toekent.

Peppol (België, en grensoverschrijdend)

U praat niet met de koper; uw access point praat met dat van de koper na het opzoeken van diens participant identifier. Een eigen access point bouwen betekent accreditatie bij OpenPeppol en het beheren van SMP/AS4-infrastructuur; bijna elk bedrijf sluit in plaats daarvan een contract met een access point-aanbieder en integreert met diens API. Zie Peppol en de Peppol-ontwikkelaarsgids.

Erkende platformen (Frankrijk)

Alleen een plateforme agréée mag tussen ondernemingen en naar de belastingdienst verzenden. Een softwareleverancier wordt er zelf een — een registratieprocedure bij de administratie — of integreert met een. Zie erkende platformen.

KSeF (Polen)

U authenticeert, opent een sessie, dient FA(3)-XML in en ontvangt een KSeF-nummer en een officieel ontvangstbewijs (UPO); de factuur is juridisch uitgereikt wanneer KSeF ze aanvaardt, niet wanneer u ze genereert. Het platform heeft afzonderlijke test- en productieomgevingen, en gedrag dat in de ene is bewezen, bewijst niets voor de andere. Zie KSeF.

Duitsland

Geen verplicht netwerk: e-mail, download of Peppol zijn allemaal aanvaardbare kanalen voor XRechnung en ZUGFeRD in B2B. De verplichting gaat over het formaat, niet over het transport.

Archivering: het bestand dat u hebt uitgereikt, ongewijzigd, jarenlang

De factuur die u moet bewaren, is het gestructureerde bestand zoals uitgereikt — niet een pdf-weergave ervan, en niet een opnieuw gegenereerde kopie op basis van de gegevens van vandaag. De EU-regels laten de vorm van de opslag open ("ondernemingen zijn in het algemeen vrij om facturen op te slaan waar en hoe ze willen"), maar elk land stelt een bewaartermijn en eisen voor toegang bij controle vast, en waar de factuur als gestructureerde XML is uitgereikt, is het de XML — niet een weergave ervan — die als de factuur geldt.

Voor een bouwer betekent dat: bewaar exact de bytes die u hebt verzonden, met een hash, naast het validatierapport en — voor Peppol of KSeF — het transportontvangstbewijs; genereer nooit opnieuw; maak het archief leesbaar zonder uw applicatie. Bewaartermijnen en de aanvaardbare opslaglocatie voor uw entiteit vereisen professionele bevestiging.

Hoe KRONENWERK hiermee omgaat

KRONENWERK is een boekhoudsysteem dat de e-factuur bij uitreiking genereert en valideert, met een API voor de stromen eromheen. Het is de kolom "kopen / integreren" van de tabel hierboven, met de vermelde transportbeperkingen. Ondersteund met beperkingen

• Generatie en validatie bij uitreiking. Duitsland: XRechnung en ZUGFeRD, gevalideerd met de KoSIT-Schematron-regels en gekruist gecontroleerd met de Mustang-bibliotheek. Frankrijk: Factur-X (PDF/A-3 met ingesloten CII). België: Peppol BIS Billing 3.0 UBL. Polen: FA(3)-XML voor KSeF. Het profiel en de syntaxis volgen het land van de koper; het btw-oordeel en de VIES-controle gebeuren in dezelfde stap.
• Ontvangen. Inkomende XRechnung, ZUGFeRD/Factur-X en UBL worden ingelezen als inkoopfacturen.
• Transport. Peppol verzenden en ontvangen via een geaccrediteerde access point-aanbieder (Storecove) zodra het bedrijf is gekoppeld in Instellingen → Verzending — KRONENWERK is zelf geen access point. Ondersteund met beperkingen. Franse verzending is gepland via de erkend-platformfunctionaliteit van Storecove en is nog niet productieklaar — KRONENWERK is geen plateforme agréée. Nog niet gereed. De KSeF 2.0-module (tokenauthenticatie, sessie, FA(3)-indiening, UPO-ophaling, ontvangst) is gebouwd en omgevingsafhankelijk, is niet gebruikt tegen het productie-KSeF, en KRONENWERK verkoopt momenteel geen abonnementen aan Poolse bedrijven. Nog niet gereed voor verzending.
• API. Uw applicatie maakt klanten en conceptfacturen aan op https://kronenwerk.org/api/extern/v1 (POST /customers, POST /invoices/drafts, met Idempotency-Key); het uitreiken — de stap die het nummer toekent, de e-factuur genereert en de validatie uitvoert — gebeurt in het product na validatie. Webhooks melden invoice.issued, invoice.paid en invoice.cancelled. Begin bij de snelstart; de e-facturatiekant staat op de pagina e-facturatie-API.