API voor retourlabels in productiesystemen
Genereer retourlabels vanuit gestructureerde backenddata, zonder browser, met een duidelijke grens tussen gPdf-rendering en je eigen bedrijfsregels.
/api/v1/pdf/render retourlabels 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 retourlabels 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/pdf/render
JSON Render is het standaardpad voor deze workflow.
/api/v1/template-render
Gebruik dit wanneer de workflow een verwant API-pad, templatecontract of capability lookup nodig heeft.
Minimale request
/api/v1/pdf/render - retourlabels
{
"pages": [
{
"size": "label_4_6_in",
"elements": [
{
"type": "text",
"x": 5,
"y": 8,
"content": "RETURN TO",
"style": { "font_size": 9, "font_family": "NotoSans-Regular" }
},
{
"type": "text",
"x": 5,
"y": 18,
"content": "Acme Returns\n500 Dock Door 4\nColumbus OH 43215",
"style": { "font_size": 11, "font_family": "NotoSans-Regular" }
},
{
"type": "barcode",
"format": "code128",
"content": "RMA-2026-77881",
"x": 5,
"y": 70,
"width": 88,
"height": 20,
"barcode_text": { "enabled": true, "position": "bottom" }
}
]
}
]
}
Wat gPdf afhandelt
- PDF-rendering van retourlabels 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 retourlabels, 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 de label-PDF; het koopt geen porto, maakt geen zendingen aan en certificeert geen carrier-acceptatie.
- Je systeem beheert payloads, printers, labelmateriaal, routing en scantests.
API-vorm
API voor retourlabels 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/pdf/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 retourlabels 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 retourlabels 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.