Erstellt gPdf die Rücksendung?

Nein. Ihr Carrier oder Ihre Retourenplattform erstellt Sendung und Nutzdaten. gPdf rendert diese Daten als PDF.

Können Retourenlabels aus Templates erzeugt werden?

Ja. Nutzen Sie Template Render, sobald Retourenlabel oder Rücksendeanleitung freigegeben sind.

Kann das PDF Rücksendeanleitungen enthalten?

Ja. Derselbe Render-Request kann je nach Layout eine Label-Seite, eine Anleitungsseite oder beides erzeugen.

Ersetzt gPdf Carrier-Zertifizierung?

Nein. Carrier-Akzeptanz, Scanner-Tests und Nutzdatenregeln bleiben Ihre Verantwortung.

Logistik und Etiketten

Retourenlabel-API für Reverse Logistics im E-Commerce

Erzeugen Sie Retourenlabels und Rücksendeanleitungen als PDF aus E-Commerce- oder Supportdaten, mit etikettengroßen Seiten, Barcodes und Template-Nachdrucken.

PRIMÄRE API JSON Render

ENDPOINT /api/v1/pdf/render

SYSTEME E-Commerce-Backend / Retourenportal / OMS / 3PL-Backend

Im Playground testen Dokumentation lesen

Aufgabe im Workflow

Retourenlabel-PDFs oder Rücksendeanleitungen aus RMA-, Kunden-, Artikel-, Ziel- und Barcodedaten rendern, damit ein Retourenportal dem Kunden ein deterministisches Dokument bereitstellen kann.

Wann diese API passt

Ihr System hat RMA und Rücksendeautorisierung bereits erstellt.
Ein Carrier- oder Retourensystem hat Label-Nutzdaten oder Trackingdaten bereits geliefert.
Sie benötigen ein PDF-Label oder eine Anleitung, die heruntergeladen, per E-Mail versendet oder nachgedruckt werden kann.
Dasselbe Retourenlabel-Layout soll über Template Render wiederverwendet werden.

Was sie nicht ersetzt

Sie erwarten, dass gPdf die Retoure genehmigt, Porto kauft oder eine Carrier-Sendung erstellt.
Sie benötigen direkte Carrier-API-Orchestrierung.
Sie benötigen Druckerbefehl-Ausgabe wie ZPL.

Welchen Endpoint aufrufen

PRIMÄR

/api/v1/pdf/render

JSON Render ist der Standardpfad für diesen Workflow.

SEKUNDÄR 1

/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 - Retourenlabel mit RMA-Barcode.

{
  "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" }
        }
      ]
    }
  ]
}

Was gPdf übernimmt

PDF-Rendering für etikettengroße Retourenlabels und Anleitungsseiten.
Barcode-, Text-, Adress-, RMA- und Serviceblöcke.
Template-Bindung für freigegebene Retourenlabel- oder Anweisungslayouts.
Deterministische Ausgabe für erneute Kundendownloads und Support-Nachdrucke.

Was Ihr System verantwortet

Retourenberechtigung, RMA-Status, Carrier-Konto, Porto, Trackingnummer und Kundenkommunikation.
Korrekte Barcode-Nutzdaten, Zieladresse, Artikelreferenzen und Regeln zum Rücksendefenster.
E-Mail-Zustellung, Portaldownload und Support-Audit-Trail.

Produktions-Checkliste

Validieren Sie die Retouren-Nutzdaten vor dem Rendering mit dem Carrier oder Retourenanbieter.
Drucken und scannen Sie Labels auf dem Material, das Kunden oder Filialen tatsächlich nutzen.
Setzen Sie einen X-Request-Id und speichern Sie die RMA-zu-PDF-Spur in Ihren Support-Logs.
Machen Sie wiederholte Downloads aus Kundensicht idempotent.
Trennen Sie Label-Rendering von Rückerstattungsfreigabe.

Aussagegrenzen

gPdf rendert Retourenlabel-PDFs; es autorisiert keine Retouren und kauft kein Porto.
Carrier-Akzeptanz und korrekte Barcode-Nutzdaten bleiben Ihre Aufgabe.
Die öffentliche API gibt PDF aus, nicht ZPL oder direkte Druckerbefehle.

Reverse Logistics braucht klare Verantwortung

Retourenlabels verbinden Kundenerlebnis und Carrier-Regeln. gPdf verantwortet das PDF-Rendering. Ihr Retourensystem verantwortet Berechtigung, RMA-Status, Tracking, Carrier-Nutzdaten und Kundenkommunikation.

Halten Sie diese Grenze in der Integration sichtbar. Treffen Sie zuerst die Retourenentscheidung und rendern Sie dann das Dokument aus den finalisierten Daten.

FAQ

Erstellt gPdf die Rücksendung?: Nein. Ihr Carrier oder Ihre Retourenplattform erstellt Sendung und Nutzdaten. gPdf rendert diese Daten als PDF.
Können Retourenlabels aus Templates erzeugt werden?: Ja. Nutzen Sie Template Render, sobald Retourenlabel oder Rücksendeanleitung freigegeben sind.
Kann das PDF Rücksendeanleitungen enthalten?: Ja. Derselbe Render-Request kann je nach Layout eine Label-Seite, eine Anleitungsseite oder beides erzeugen.
Ersetzt gPdf Carrier-Zertifizierung?: Nein. Carrier-Akzeptanz, Scanner-Tests und Nutzdatenregeln bleiben Ihre Verantwortung.