API voor pakbon-PDFs in productiesystemen
Genereer pakbon-PDFs vanuit gestructureerde backenddata, zonder browser, met een duidelijke grens tussen gPdf-rendering en je eigen bedrijfsregels.
/api/v1/template-render pakbon-PDFs 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 pakbon-PDFs 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 - pakbon-PDFs
{
"template_id": "packing_list",
"data": [
{
"shipment": {
"number": "PL-2026-1001",
"date": "2026-05-29"
},
"shipper": {
"name": "Acme Warehouse",
"address": "1200 Logistics Pkwy"
},
"consignee": {
"name": "Receiver Inc.",
"address": "123 Main St"
},
"items": [
{
"item_no": "1",
"description": "Replacement filter",
"quantity": "2",
"unit": "pcs",
"gross_weight": "1.2 kg",
"net_weight": "1.0 kg"
}
]
}
]
}
Wat gPdf afhandelt
- PDF-rendering van pakbon-PDFs 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 pakbon-PDFs, 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 operationele PDFs; het is geen officiële marketplace connector of OMS.
- Je systeem beheert orders, fulfillment, marketplace-calls en klantregels.
API-vorm
API voor pakbon-PDFs 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 pakbon-PDFs 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 pakbon-PDFs 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.