Automatische conversie tussen factuurformaten. Van UBL naar NLCIUS, van CII naar XRechnung, van Factur-X naar BIS Billing en terug.
Plan een kennismaking
API-documentatie
De PSB van eConnect transformeert automatisch tussen alle ondersteunde e-factuurformaten. De ontvanger krijgt documenten altijd in het formaat dat in zijn configuratie is ingesteld, ongeacht het formaat dat de verzender heeft gebruikt.
Een factuur die door een Franse leverancier in Factur-X wordt aangeleverd, kan bij een Nederlandse ontvanger als NLCIUS binnenkomen en bij een Duitse als XRechnung. Je hoeft je integratie niet aan te passen wanneer een leverancier of klant in een ander formaat factureert. De transformatie vindt volledig automatisch plaats bij verzending en ontvangst.
Alle ondersteunde formaten zijn terug te voeren op hetzelfde semantische model (EN 16931), wat verliesloze conversie technisch mogelijk maakt.
Conversie tussen de twee officieel erkende syntaxbindingen van EN 16931.
Conversie tussen de Nederlandse en Duitse nationale invulling van BIS Billing V3.
Conversie van hybride PDF/XML-formaat naar structurele XML-formaten en terug.
De Transform API ondersteunt de meest gebruikte conversies tussen internationale en nationale standaarden.
Naast de automatische transformatie bij verzending en ontvangst biedt eConnect een standalone Transform API. Via POST /api/v1/generic/transform?targetFormat={URN} converteer je een document direct, zonder opslag of verzending.
De Transform API herkent het bronformaat automatisch op basis van de XML-inhoud. Als automatische detectie niet lukt, geef je het bronformaat mee via ?sourceFormat={URN}. Het geconverteerde document wordt direct als XML teruggegeven.
Toepassingen: transformaties testen vóór productiegang, handmatige conversie voor partners met specifieke vereisten, pre-processing voor systemen met een vast verwacht formaat, of vergelijking van hetzelfde document in meerdere formaten.
E-factuurformaten zijn geen losse eilanden. Ze zijn gelaagd opgebouwd:
- EN 16931 is de Europese semantische norm. Alle Europese formaten zijn hierop gebaseerd.
- UBL 2.1 en CII zijn de twee officiële syntaxbindingen.
- Peppol BIS Billing V3 is het Europese Peppol-profiel boven op UBL of CII.
- NLCIUS (Nederland), XRechnung (Duitsland) en Factur-X (DE/FR) zijn nationale invullingen.
Doordat alle formaten op hetzelfde fundament rusten, is lossless conversie technisch haalbaar. eConnect bewaakt de geldigheid van het getransformeerde document via automatische schemavalidatie na elke conversie.
De PSB herkent het bronformaat automatisch bij elke transformatie; geen handmatige parameterinstelling nodig.
Transformaties worden volledig in geheugen uitgevoerd. Geen tussentijdse opslag of externe verzending.
Alle conversies voldoen aan het Europees semantisch model EN 16931, de gemeenschappelijke basis van UBL, CII en Peppol BIS.
De PSB transformeert automatisch tussen alle ondersteunde formaten: UBL, CII, Peppol BIS Billing V3, NLCIUS, XRechnung en Factur-X/ZUGFeRD. Niet alle combinaties zijn beschikbaar; de actuele transformatietabel is op te vragen via de API. De automatische transformatie bij verzending en ontvangst is beschikbaar vanaf het 10K-pakket.
De PSB herkent het bronformaat automatisch op basis van de XML-inhoud. Je hoeft dus niet zelf op te geven welk formaat je aanlevert. Lukt automatische detectie niet, dan kun je het bronformaat meegeven via de parameter ?sourceFormat={URN} in de API-aanroep.
Ja, voor alle formaten die zijn gebaseerd op EN 16931. Omdat deze formaten hetzelfde semantische model gebruiken, gaan er bij conversie geen gegevens verloren. Formaten die buiten EN 16931 vallen (zoals FatturaPA voor Italië) vereisen routering via een lokale partner.
Ja. Via de standalone Transform API (POST /api/v1/generic/transform) converteer je documenten zonder opslag of verzending. Dat maakt het geschikt voor testen, pre-processing en vergelijking. De Validate API (POST /api/v1/generic/validate) controleert bovendien of het getransformeerde document voldoet aan de geldende validatieregels.
Ja. Transformatie converteert een document van het ene formaat naar het andere. Validatie controleert of een document voldoet aan de regels van een specifiek formaat. Bij verzending voert de PSB beide stappen uit: eerst transformeren naar het formaat van de ontvanger, dan valideren voordat het document het netwerk opgaat. Beide zijn ook afzonderlijk beschikbaar als standalone API-endpoints.
Plan een kennismaking
Maak een offerte via Cora