API voor batchgewijze PDF-generatie in productiesystemen
Genereer batchgewijze PDF-generatie vanuit gestructureerde backenddata, zonder browser, met een duidelijke grens tussen gPdf-rendering en je eigen bedrijfsregels.
/api/v1/template-render batchgewijze PDF-generatie 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 batchgewijze PDF-generatie 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/template-render
Template Render is het standaardpad voor deze workflow.
/api/v1/pdf/render
Gebruik dit wanneer de workflow een verwant API-pad, templatecontract of capability lookup nodig heeft.
Minimale request
/api/v1/template-render - batchgewijze PDF-generatie
{
"template_id": "invoice",
"data": [
{
"invoice_number": "INV-2026-101",
"date_of_issue": "2026-05-29",
"bill_to_name": "Buyer A",
"subtotal": "$50.00",
"total": "$50.00",
"amount_due": "$50.00",
"items": []
},
{
"invoice_number": "INV-2026-102",
"date_of_issue": "2026-05-29",
"bill_to_name": "Buyer B",
"subtotal": "$75.00",
"total": "$75.00",
"amount_due": "$75.00",
"items": []
}
]
}
Wat gPdf afhandelt
- PDF-rendering van batchgewijze PDF-generatie 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 batchgewijze PDF-generatie, 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 rendert PDF-output uit de request; het vervangt geen workflow, database of productvalidatie.
- Je systeem beheert databetekenis, retries, opslag en eindacceptatie.
API-vorm
API voor batchgewijze PDF-generatie 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/template-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 batchgewijze PDF-generatie 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 batchgewijze PDF-generatie koppelt de workflow aan een publieke gPdf API. De pagina laat zien welk pad je aanroept en wat de request moet bevatten.
- Kan ik templates gebruiken?
- Ja. Gebruik JSON Render zolang de layout verandert; gebruik Template Render wanneer de layout is goedgekeurd en callers alleen bedrijfsdata sturen.
- Wat moet ik valideren voor productie?
- Valideer met echte data en met printers, scanners, validators, boekhoudsystemen of marketplaces uit de workflow.