Naar inhoud springen
Terug naar blog
FormatenGepubliceerd op 9 juli 20266 min leestijd

Eén API voor factuurformaatconversie: elk formaat erin, een conforme e-factuur eruit

Elk land wil een ander e-factuurformaat, maar uw ERP exporteert nog steeds dezelfde CSV. Zo lost één API voor factuurformaatconversie dat op.

U hebt uw ERP-export ooit gebouwd. Hij levert een CSV op, of misschien een UBL-bestand, en jarenlang was dat prima. Toen verplichtte Frankrijk Factur-X. Duitsland wil XRechnung. Italië heeft FatturaPA en zijn SdI-klaring. Polen rolt KSeF uit met het FA(3)-schema. Spanje verwacht Facturae. Noorwegen draait op EHF via Peppol. De VAE, Oman en Singapore standaardiseren op PINT.

Uw ERP is niet veranderd. De wereld eromheen wel. En nu brengt elke nieuwe klant of elk nieuw land waarmee uw bedrijf in aanraking komt een andere technische eis mee, terwijl uw financiële team vastzit aan het exporteren van exact hetzelfde bestand als altijd.

Waarom factuurformaten überhaupt versnipperd raakten

Er is een Europese norm, EN 16931, die een gemeenschappelijk semantisch model voor een elektronische factuur definieert. In theorie is iedereen het eens over wat een „nettobedrag“ of een „btw-identificatie van de koper“ betekent. In de praktijk verpakt elk land dat model in zijn eigen syntaxis, zijn eigen verplichte velden en zijn eigen validatieregels.

XRechnung en Factur-X zijn beide gebaseerd op EN 16931, maar het zijn geen uitwisselbare bestanden. FatturaPA is ouder dan de norm en gebruikt volledig zijn eigen Italiaanse schema. KSeF FA(3) is Pools-specifiek. Dus „wij ondersteunen e-facturatie“ is nooit één klus. Het is een dozijn klussen die allemaal vertrekken vanuit dezelfde brongegevens en eindigen in incompatibele bestanden. Dat is precies de kloof die een API voor factuurformaatconversie is gebouwd om te dichten: u blijft exporteren wat u al exporteert, en iets anders verzorgt de vertaling naar wat elke bestemming eist.

Wat „elk formaat erin“ werkelijk betekent

Het lastige deel is meestal de invoer, niet de uitvoer. Echte boekhoudsystemen exporteren verouderde en inconsistente gegevens: een platte CSV met 40 kolommen, een Excel-blad dat een controller met de hand bijhoudt, EDIFACT uit een oude EDI-opzet, of gestructureerd UBL en CII uit een nieuwere stack. Sommige sturen een ZUGFeRD- of Factur-X-PDF met de XML erin ingebed.

Een conversie-API die de moeite waard is leest dat allemaal. MyInvoice accepteert CSV, Excel, EDIFACT, UBL, CII en ZUGFeRD/Factur-X-PDF als invoer — en wanneer een leverancier u een hybride PDF stuurt, haalt hij de XML uit het bestand en normaliseert die naar hetzelfde schone model. Dat laatste telt zwaarder dan het klinkt: een e-factuur die u ontvangt wordt een geldige invoer, niet alleen iets om te archiveren. U kunt een binnenkomend Factur-X- of ZUGFeRD-document nemen en het opnieuw uitgeven als Peppol BIS of XRechnung zonder uw pipeline opnieuw te bouwen.

Eén API, elke conforme uitvoer

Zodra uw gegevens in het gemeenschappelijke model zijn geparseerd, is de uitvoer een keuze, geen herbouw. Dezelfde bronfactuur kan eruit komen als:

  • Peppol BIS 3.0 voor het Peppol-netwerk
  • XRechnung voor Duitse overheidskopers
  • Factur-X / ZUGFeRD voor Frankrijk en Duitsland
  • FatturaPA voor Italië
  • KSeF FA(3) voor Polen
  • EHF voor Noorwegen
  • PINT voor de VAE, Oman en Singapore

U stuurt de gegevens één keer en kiest het formaat aan het eind. Wanneer een nieuw land live gaat, wijzigt u een parameter, niet uw ERP.

Behoud uw systeem, los de laatste mijl op

Het gaat er niet om uw software te vervangen. Het gaat erom te stoppen met het bekabelen van een eenmalig formaatproject telkens als er een mandaat landt. Uw ERP blijft zijn CSV exporteren. De API verzorgt de laatste mijl, verandert die export in exact het bestand dat een land of het Peppol-netwerk zal accepteren, en valideert het resultaat voordat u het verstuurt.

Als uw team afstevent op een nieuw mandaat met hetzelfde oude exportbestand, is dat precies de kloof die dit dicht. Werp een blik op MyInvoice en probeer een van uw echte exports te converteren naar het formaat dat u werkelijk nodig hebt.

Converteer een van uw exports in de browserLees de API-documentatie