Logistik und Etiketten

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.

PRIMÄRE API Template Render
ENDPOINT /api/v1/template-render
SYSTEME OMS / WMS / 3PL-Backend / Shopify-App-Backend
Aufgabe im Workflow

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

PRIMÄR

/api/v1/template-render

Template Render ist der Standardpfad für diesen Workflow.

SEKUNDÄR 1

/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

  1. Testen Sie die längsten SKU-, Artikelnamen- und Adresskombinationen.
  2. Validieren Sie Ein-Artikel-, Mehrkarton-, Rückstands- und Teilsendungsfälle.
  3. Nutzen Sie Template Render, nachdem das Packzettel-Layout freigegeben wurde.
  4. Protokollieren Sie template_id und X-Request-Id für jeden Fulfillment-Druckauftrag.
  5. 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.