API voor ZUGFeRD-facturen in productiesystemen
Genereer ZUGFeRD-facturen vanuit gestructureerde backenddata, zonder browser, met een duidelijke grens tussen gPdf-rendering en je eigen bedrijfsregels.
/api/v1/e-invoice/render ZUGFeRD-facturen als reproduceerbare PDF genereren vanuit gestructureerde data. Je systeem bewaakt de business rules; gPdf verzorgt de PDF-rendering.
Wanneer deze API past
- Je backend heeft de data voor ZUGFeRD-facturen al en heeft een stabiele PDF-respons nodig.
- Je wilt Chromium of HTML-to-PDF vermijden voor operationele documenten.
- Je hebt herhaalbare output nodig voor reprints, audit of batchverwerking.
Wat dit niet vervangt
- Je verwacht dat gPdf porto koopt, belasting afwikkelt, externe orders maakt of als fiscaal systeem optreedt.
- Je wilt datavalidatie, business logic of marketplace-integraties vervangen.
Welk endpoint aanroepen
/api/v1/e-invoice/render
E-Invoice Render is het standaardpad voor deze workflow.
/api/v1/e-invoice/capabilities
Gebruik dit wanneer de workflow een verwant API-pad, templatecontract of capability lookup nodig heeft.
Minimale request
/api/v1/e-invoice/render - ZUGFeRD-facturen
{
"settings": {
"profile": "pdfa-3b",
"e_invoice": {
"standard": "zugferd",
"profile": "en16931",
"document_type": "invoice",
"xml": {
"format": "cii",
"encoding": "utf8",
"content": "<rsm:CrossIndustryInvoice>...</rsm:CrossIndustryInvoice>"
}
}
},
"pages": [
{
"size": "a4",
"elements": [
{
"type": "text",
"x": 20,
"y": 24,
"content": "ZUGFeRD invoice",
"style": { "font_size": 16, "font_family": "NotoSans-Regular" }
}
]
}
]
}
Wat gPdf afhandelt
- PDF-rendering van ZUGFeRD-facturen vanuit gestructureerde requests.
- Tekst, tabellen, lijnen, barcodes, pagina’s, metadata en outputopties volgens de request.
- Deterministische output voor retries, reprints en audit.
Wat je systeem beheert
- Correcte data voor ZUGFeRD-facturen, business rules en operationele status.
- Authenticatie, opslag, externe workflows en validatie met ontvangende systemen.
Productiechecklist
- Test met echte data en met de systemen die de PDF ontvangen.
- Bewaar request IDs en bewijs voor support, audit en reprints.
- Zet de goedgekeurde layout om naar een template zodra meerdere systemen hem gebruiken.
Grenzen van de claim
- gPdf gebruikt het publieke e-invoice endpoint voor Factur-X / ZUGFeRD PDF/A-3b.
- Fiscale portals, PDP, SDI, KSeF, ZATCA, IRP, Peppol en wettelijke verplichtingen vallen buiten scope.
- Je systeem beheert buyer data, fiscale logica, routing en lokale juridische interpretatie.
API-vorm
API voor ZUGFeRD-facturen is een productieworkflow bovenop de publieke gPdf APIs. De request beschrijft data, layout, settings en de PDF-onderdelen die moeten worden gerenderd. gPdf rendert de PDF; je systeem bewaakt de betekenis van het business event.
Endpointkeuze
Voor deze workflow is /api/v1/e-invoice/render het standaardendpoint. Gebruik Template Render wanneer de layout is goedgekeurd en tussen systemen wordt hergebruikt. Gebruik E-Invoice Render alleen wanneer Factur-X / ZUGFeRD PDF/A-3b-packaging met ingebedde EN 16931 CII XML nodig is.
Validatie voor productie
Valideer ZUGFeRD-facturen met echte data en met de systemen die de output gebruiken. Bewaar request IDs, gerenderde output en bewijs voor support, audit en reprints.
FAQ
- Is dit een apart endpoint?
- API voor ZUGFeRD-facturen gebruikt het publieke e-invoice endpoint wanneer de workflow Factur-X / ZUGFeRD PDF/A-3b nodig heeft. Het is geen aparte productlijn.
- Dekt dit lokale clearance-netwerken?
- Nee. gPdf rendert en verpakt de PDF/e-invoice; fiscale portals en juridische routing blijven in je eigen systeem.
- Kan ik JSON Render blijven gebruiken?
- Ja voor gewone PDFs. Gebruik E-Invoice Render wanneer de output het gestructureerde pakket uit de publieke API moet bevatten.