API voor magazijnetiketten voor WMS- en ERP-printprocessen
Genereer PDF-etiketten voor pallets, dozen, bakken, voorraad en magazijnoperaties vanuit WMS- of ERP-data, met deterministische reprints.
/api/v1/pdf/render Render magazijnetiketten vanuit WMS- of ERP-data voor pallets, dozen, bakken, assets, locaties en voorraadbewegingen, terwijl voorraadstatus, pickregels en magazijnoperaties in het aanroepende systeem blijven.
Wanneer deze API past
- U pallet-, doos-, bak-, locatie-, voorraad- of assetetiketten als PDF nodig hebt.
- Uw WMS of ERP al SKU-, lot-, locatie-, SSCC- en voorraaddata beheert.
- U deterministische reprints nodig hebt wanneer een etiket beschadigd raakt of een station een taak opnieuw probeert.
- U goedgekeurde etiketlayouts wilt hergebruiken via Template Render.
Wat dit niet vervangt
- U wilt dat gPdf voorraad beheert, locaties toewijst of magazijnprocessen uitvoert.
- U een scannerapp, printstationagent of etiketroutingsysteem van gPdf nodig hebt.
- U GS1-certificering nodig hebt in plaats van barcoderendering.
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
POST /api/v1/pdf/render - palletetiket met SSCC-barcodedata.
{
"pages": [
{
"size": "label_4_6_in",
"elements": [
{
"type": "text",
"x": 6,
"y": 8,
"content": "PALLET LAX-01-2026-00042",
"style": { "font_size": 12, "font_family": "NotoSans-Regular" }
},
{
"type": "barcode",
"format": "sscc-18",
"content": "012345678901234567",
"x": 6,
"y": 30,
"width": 88,
"height": 26,
"barcode_text": { "enabled": true, "position": "bottom" }
},
{
"type": "text",
"x": 6,
"y": 70,
"content": "SKU: CASE-001\nQTY: 48\nLOCATION: A-14-02",
"style": { "font_size": 10, "font_family": "NotoSans-Regular" }
}
]
}
]
}
Wat gPdf afhandelt
- PDF-etiketten voor magazijnprintprocessen.
- Vectorbarcodes, tekst, kaders, etiketpaginaformaten en template-binding.
- Deterministische output voor reprint- en auditprocessen.
- JSON Render voor maatwerklayouts en Template Render voor goedgekeurde etiketcontracten.
Wat uw systeem beheert
- Voorraadstatus, SKU-data, lot-/seriedata, SSCC-waarden en locatiesemantiek.
- Printerroutering, stationconfiguratie, scannervalidatie en magazijnprocesregels.
- Templateselectie, retries en opslag van gerenderde PDF's of brondata.
Productiechecklist
- Valideer etiketafmetingen tegen de echte printer en het echte etiketmateriaal.
- Scan elk barcodeformaat dat het magazijnproces gebruikt.
- Houd WMS/ERP-status leidend en stuur alleen definitieve etiketdata naar gPdf.
- Gebruik Template Render voor etiketten die meerdere systemen of stations printen.
- Log brondocument-ID's en request-ID's voor traceerbare reprints.
Grenzen van de claim
- gPdf rendert PDF's voor magazijnetiketten; het beheert geen voorraad of magazijnstatus.
- Het aanroepende systeem beheert barcodepayloadsemantiek en scanneracceptatie.
- Template Render kan etiketlayouts stabiliseren, maar vervangt geen WMS-regels.
Magazijnetiketten zijn operationele records
Magazijnetiketten identificeren pallets, dozen, bakken, assets, voorraadbewegingen en locaties. Ze zijn verbonden met operationele status in uw WMS of ERP. gPdf hoort de definitieve etiketdata te ontvangen en te renderen; het hoort niet te bepalen wat voorraad of magazijnprocesstatus betekent.
Template Render houdt printstations eenvoudig
Voor etiketten die meerdere stations gebruiken, publiceert u de goedgekeurde
layout als template. Printservices kunnen dan template_id plus WMS-data
sturen in plaats van in elk aanroepend systeem opnieuw coördinaten op te
bouwen.
Deterministische reprints
Magazijnen printen etiketten opnieuw. Een beschadigd etiket, een vastgelopen printer of een stationretry mag geen iets ander document opleveren. Houd brondata van het etiket gekoppeld aan het magazijnrecord en gebruik deterministische renderinvoer voor reprints.
FAQ
- Beheert gPdf magazijnvoorraad?
- Nee. Uw WMS of ERP beheert voorraadstatus, locaties, SKU's, lots en procesregels. gPdf rendert de etiket-PDF vanuit definitieve data.
- Kunnen magazijnetiketten GS1- of SSCC-barcodes gebruiken?
- Ja, gPdf kan ondersteunde barcodeformaten in PDF-output renderen. Uw systeem beheert de barcodepayload en scanneracceptatie.
- Moeten herhaalde magazijnetiketten templates gebruiken?
- Meestal wel. Template Render geeft printstations een stabiel template_id en datacontract nadat de etiketlayout is goedgekeurd.
- Hoe horen reprints te werken?
- Bewaar brondata van het etiket of de gegenereerde PDF bij uw magazijnrecord, en render of haal hetzelfde etiket vervolgens op met de oorspronkelijke operationele ID's.