SSCC Label API für GS1-Logistik-PDFs
Rendern Sie SSCC-18-Barcode-Labels als PDF für Logistik-, Paletten-, Karton- und Lager-Workflows, während Ihr System die GS1-Payload-Korrektheit verantwortet.
/api/v1/pdf/render Rendern Sie SSCC-18-Barcode-Labels als Vektor-PDF-Ausgabe für Paletten-, Karton- oder Logistikeinheiten, nachdem Ihr System den Serial Shipping Container Code vergeben und dessen GS1-Semantik geprüft hat.
Wann diese API passt
- Ihr System besitzt bereits den SSCC-Wert und alle zugehörigen Application Identifier.
- Sie benötigen ein PDF-Label mit scannbarem SSCC-Barcode und menschenlesbarem Text.
- Sie benötigen wiederholte SSCC-Label-Layouts für Lager- oder 3PL-Druckstationen.
- Sie möchten SSCC-Labels mit breiteren Paletten- oder Lagerlabel-Workflows verbinden.
Was sie nicht ersetzt
- Sie benötigen GS1-Präfixvergabe, Prüfziffererzeugung oder Compliance-Zertifizierung durch gPdf.
- Sie benötigen Bestands- oder Sendungsstatusverwaltung.
- Sie benötigen Carrier-Label-Kauf oder Rating.
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 - SSCC-18-Label-Barcode.
{
"pages": [
{
"size": "label_100_150",
"elements": [
{
"type": "text",
"x": 6,
"y": 8,
"content": "SSCC",
"style": { "font_size": 12, "font_family": "NotoSans-Regular" }
},
{
"type": "barcode",
"format": "sscc-18",
"content": "000123456789012345",
"x": 6,
"y": 28,
"width": 86,
"height": 30,
"barcode_text": { "enabled": true, "position": "bottom" }
}
]
}
]
}
Was gPdf übernimmt
- Vektor-SSCC-Barcode-Rendering innerhalb von PDF-Seiten.
- Label-Layout mit Text, Kästen, Barcode-Text und optionalem Template-Binding.
- PDF-Ausgabe für Druck, Speicherung oder Lager-Reprint-Workflows.
- Gemeinsames Fehler-Envelope, wenn ein Request die Validierung nicht besteht.
Was Ihr System verantwortet
- GS1-Firmenpräfix, Erweiterungsziffer, Serienreferenz, Prüfziffer und codierten Payload.
- Lagerprozessregeln, Scanner-Abnahme und Validierung des Labelmaterials.
- Jeden EDI-, ASN-, Carrier- oder Handelspartner-Workflow, der den SSCC konsumiert.
Produktions-Checkliste
- Validieren Sie SSCC-Wert und Prüfziffer, bevor Sie gPdf aufrufen.
- Scannen Sie die Ausgabe mit Produktionsscannern und Produktionslabelmaterial.
- Dokumentieren Sie, welche Lagerereignisse SSCC-Labels erzeugen und erneut drucken.
- Nutzen Sie Template Render für freigegebene SSCC-Label-Layouts.
- Halten Sie Handelspartner-Compliance-Prüfungen außerhalb des Render-Aufrufs.
Aussagegrenzen
- gPdf rendert den SSCC-Barcode als PDF; es vergibt oder zertifiziert keine SSCC-Werte.
- GS1- und Handelspartner-Compliance bleiben Ihre Verantwortung.
- SSCC-Labels implizieren keine Carrier-Sendungserstellung.
SSCC-Labels sind ein fokussierter Barcode-Workflow
SSCC-Labels sind enger als allgemeine Palettenlabels. Entscheidend ist der Serial Shipping Container Code selbst. gPdf rendert den Code in einem PDF; Ihr System verantwortet Codevergabe, GS1-Regeln und Handelspartneranforderungen.
FAQ
- Kann gPdf eine SSCC-Nummer erzeugen?
- Nein. Ihr System erzeugt und validiert den SSCC-Wert. gPdf rendert ihn als Barcode in einem PDF.
- Welches Barcode-Format sollte ich nutzen?
- Nutzen Sie beim Rendern eines SSCC-Barcode-Elements einen unterstützten SSCC-Alias wie sscc-18.
- Kann das eine Vorlage sein?
- Ja. Die meisten SSCC-Labels sollten nach Freigabe von Layout und Feldmapping in Template Render verschoben werden.
- Zertifiziert das GS1-Konformität?
- Nein. gPdf rendert Vektor-Barcode-Ausgabe. Compliance und Scanner-Abnahme sind getrennte Verantwortlichkeiten.