Packzettel-PDF-API für Fulfillment-Workflows
Erzeugen Sie Packzettel-PDFs aus Bestell-, Sendungs-, Karton- und Artikeldaten für E-Commerce, 3PL, OMS und Fulfillment-Workflows im Lager.
/api/v1/template-render Packzettel aus Sendungs-, Empfänger-, Artikel- und Kartondaten rendern, damit Fulfillment-Teams für jede ausgehende Bestellung ein konsistentes Dokument drucken oder beilegen können.
Wann diese API passt
- Ihr OMS oder WMS besitzt Bestellpositionen, Mengen, Empfängerdaten und Sendungskennzeichen bereits.
- Sie benötigen einen PDF-Packzettel für Lagerdruckstationen oder Paketbeilagen für Kunden.
- Ein freigegebenes Layout soll über Lager, Marken oder Vertriebskanäle hinweg wiederverwendet werden.
- Sie benötigen möglicherweise einen Barcode oder QR-Code für Bestellabfrage oder Retourenannahme.
Was sie nicht ersetzt
- Sie müssen Porto kaufen, eine Sendung bewerten oder ein Carrier-Label erstellen.
- Sie benötigen Lagerbestandsverwaltung statt Dokumenten-Rendering.
- Sie benötigen rechtliche Rechnungs- oder E-Rechnungs-Semantik.
Welchen Endpoint aufrufen
/api/v1/template-render
Template Render ist der Standardpfad für diesen Workflow.
/api/v1/pdf/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/template-render - Template packing_list mit einer Sendung.
{
"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"
}
]
}
]
}
Was gPdf übernimmt
- Template Render für veröffentlichte Packzettel-Layouts.
- JSON Render für individuelle Packzettelseiten während Design oder Einmal-Workflows.
- Tabellen, Artikelzeilen, Adressblöcke, optionale Barcodes und PDF-Ausgabe.
- Deterministische Nachdrucke, wenn dieselben Daten und dasselbe Template genutzt werden.
Was Ihr System verantwortet
- Bestelldaten, Artikelmengen, Sendungsstatus, Lager-Routing und Kundenkommunikation.
- Template-Feldmapping, Routing der Druckstationen und Nachdruck-Policy.
- Jedes Carrier-, Zoll- oder Rechnungsdokument, das mit dem Paket reisen muss.
Produktions-Checkliste
- Testen Sie die längsten SKU-, Artikelnamen- und Adresskombinationen.
- Validieren Sie Ein-Artikel-, Mehrkarton-, Rückstands- und Teilsendungsfälle.
- Nutzen Sie Template Render, nachdem das Packzettel-Layout freigegeben wurde.
- Protokollieren Sie template_id und X-Request-Id für jeden Fulfillment-Druckauftrag.
- Trennen Sie Carrier-Label-Erzeugung vom Packzettel-Rendering.
Aussagegrenzen
- gPdf rendert das Packzettel-PDF; es verwaltet keinen Bestand und keinen Fulfillment-Status.
- Ein Packzettel ist nicht automatisch eine Steuerrechnung oder ein Zolldokument.
- Carrier-Label-Kauf und Versandbewertung liegen außerhalb von gPdf.
Packzettel passen zum Template-Pfad
Packzettel haben meist eine stabile Struktur: Absender, Empfänger, Sendungsnummer, Artikelzeilen und optionale Hinweise. Das macht Template Render nach Freigabe des Layouts zur passenden Wahl.
JSON Render bleibt während des Designs wichtig. Damit kann Ihr Team Spalten,
Abstände, Barcode-Platzierung und Seitenumbrüche abstimmen, bevor der stabile
template_id-Vertrag veröffentlicht wird.
FAQ
- Ist ein Packzettel ein separater gPdf-Endpunkt?
- Nein. Nutzen Sie Template Render für ein freigegebenes Packzettel-Template oder JSON Render, wenn Ihr System das Layout direkt beschreibt.
- Können Packzettel Barcodes enthalten?
- Ja. gPdf kann Barcode-Elemente im PDF rendern. Ihr System verantwortet die codierten Bestell-, Karton- oder Retourendaten.
- Erstellt gPdf Carrier-Labels?
- Nein. Carrier-Labels sind ein eigener Workflow. gPdf rendert PDFs aus den Daten, die Ihr Carrier- oder Versandsystem liefert.
- Kann ein Request mehrere Packzettel rendern?
- Template Render akzeptiert innerhalb der dokumentierten öffentlichen API-Limits ein data-Array mit mehreren Elementen in einem Request.