Lageretikett-API für WMS- und ERP-Druckworkflows
Erzeugen Sie Paletten-, Karton-, Fach-, Bestands- und Lagerprozess-Etiketten als PDF aus WMS- oder ERP-Daten, mit deterministischen Nachdrucken.
/api/v1/pdf/render Lageretiketten aus WMS- oder ERP-Daten für Paletten, Kartons, Fächer, Assets, Lagerorte und Bestandsbewegungen rendern, während Bestandsstatus, Pickregeln und Lagerprozesse im aufrufenden System bleiben.
Wann diese API passt
- Sie benötigen Paletten-, Karton-, Fach-, Lagerort-, Bestands- oder Asset-Etiketten als PDFs.
- Ihr WMS oder ERP besitzt SKU-, Chargen-, Lagerort-, SSCC- und Bestandsdaten bereits.
- Sie benötigen deterministische Nachdrucke, wenn ein Etikett beschädigt ist oder eine Station einen Auftrag erneut versucht.
- Freigegebene Etikettenlayouts sollen über Template Render wiederverwendet werden.
Was sie nicht ersetzt
- Sie erwarten, dass gPdf Bestand verwaltet, Lagerorte zuweist oder Lagerworkflows ausführt.
- Sie benötigen von gPdf eine Scanner-App, einen Druckstations-Agenten oder ein Etiketten-Routing-System.
- Sie benötigen GS1-Zertifizierung statt Barcode-Rendering.
Welchen Endpoint aufrufen
/api/v1/pdf/render
JSON Render ist der Standardpfad für diesen Workflow.
/api/v1/template-render
Nutzen Sie dies, wenn der Workflow den zugehörigen API-Pfad, einen Template-Vertrag oder eine Capability-Abfrage braucht.
Minimaler Request
POST /api/v1/pdf/render - Palettenetikett mit SSCC-Barcodedaten.
{
"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" }
}
]
}
]
}
Was gPdf übernimmt
- PDF-Etiketten für Druckworkflows im Lager.
- Vektor-Barcodes, Text, Kästen, Etiketten-Seitengrößen und Template-Bindung.
- Deterministische Ausgabe für Nachdruck- und Audit-Workflows.
- JSON Render für individuelle Layouts und Template Render für freigegebene Etikettenverträge.
Was Ihr System verantwortet
- Bestandsstatus, SKU-Daten, Chargen-/Seriendaten, SSCC-Werte und Lagerortsemantik.
- Drucker-Routing, Stationskonfiguration, Scanner-Validierung und Regeln des Lagerprozesses.
- Template-Auswahl, Wiederholversuche und Speicherung gerenderter PDFs oder Quelldaten.
Produktions-Checkliste
- Validieren Sie Etikettenabmessungen gegen den tatsächlichen Drucker und das Etikettenmaterial.
- Scannen Sie jedes Barcodeformat, das im Lagerprozess verwendet wird.
- Halten Sie WMS/ERP als führende Quelle und senden Sie nur finale Etikettendaten an gPdf.
- Nutzen Sie Template Render für Etiketten, die mehrere Systeme oder Stationen drucken.
- Protokollieren Sie Quelldokument-IDs und Request-IDs für nachvollziehbare Nachdrucke.
Aussagegrenzen
- gPdf rendert Lageretikett-PDFs; es verwaltet keinen Bestand und keinen Lagerstatus.
- Der Aufrufer verantwortet Barcode-Nutzdaten und Scanner-Akzeptanz.
- Template Render kann Etikettenlayouts stabilisieren, ersetzt aber keine WMS-Regeln.
Lageretiketten sind operative Datensätze
Lageretiketten identifizieren Paletten, Kartons, Fächer, Assets, Bestandsbewegungen und Lagerorte. Sie sind an operativen Status in Ihrem WMS oder ERP gebunden. gPdf sollte die finalen Etikettendaten erhalten und rendern; es sollte keine Bestandsbedeutung und keinen Lagerprozessstatus entscheiden.
Template Render hält Druckstationen einfach
Für Etiketten, die an mehreren Stationen verwendet werden, veröffentlichen Sie
das freigegebene Layout als Vorlage. Druckservices können dann template_id plus
WMS-Daten senden, statt in jedem Aufrufer Koordinaten neu aufzubauen.
Deterministische Nachdrucke
Lager drucken Etiketten nach. Ein beschädigtes Etikett, ein Papierstau oder ein Stations-Retry sollte kein leicht anderes Dokument erzeugen. Verknüpfen Sie Quelldaten mit dem Lagerdatensatz und nutzen Sie deterministische Render-Eingaben für Nachdrucke.
FAQ
- Verwaltet gPdf Lagerbestand?
- Nein. Ihr WMS oder ERP verantwortet Bestandsstatus, Lagerorte, SKUs, Chargen und Prozessregeln. gPdf rendert das Etiketten-PDF aus finalen Daten.
- Können Lageretiketten GS1- oder SSCC-Barcodes nutzen?
- Ja, gPdf kann unterstützte Barcodeformate in der PDF-Ausgabe rendern. Ihr System verantwortet Barcode-Nutzdaten und Scanner-Akzeptanz.
- Sollten wiederkehrende Lageretiketten Templates nutzen?
- Meist ja. Template Render gibt Druckstationen eine stabile template_id und einen Datenvertrag, sobald das Etikettenlayout freigegeben ist.
- Wie sollten Nachdrucke funktionieren?
- Speichern Sie Quelldaten oder das erzeugte PDF mit Ihrem Lagerdatensatz und rendern oder laden Sie dasselbe Etikett anhand der ursprünglichen operativen IDs erneut.