GS1 Barcode API für Vektor-PDF-Labels
Rendern Sie GS1-Barcodes als Vektoren in PDFs, darunter GS1-128, GS1 DataMatrix, GS1 QR, ITF-14 und SSCC-18-Label-Workflows.
/api/v1/pdf/render Rendern Sie GS1-Barcode-Payloads als Vektor-PDF-Labels oder Dokumente, während Ihr Produkt-, Lager- oder Retail-System für korrekte Application Identifier, Prüfziffern und Scanner-Abnahme verantwortlich bleibt.
Wann diese API passt
- Sie benötigen Barcode-Module, die als Vektor-PDF-Inhalt gezeichnet werden, statt eingefügter Bitmap-Bilder.
- Ihr System hat bereits den korrekten GS1-Payload und die menschenlesbare Interpretation.
- Sie benötigen GS1-128-, GS1 DataMatrix-, GS1 QR-, ITF-14- oder SSCC-18-Workflows in Labels oder Dokumenten.
- Wiederholte Barcode-Label-Layouts sollen in Template Render verlagert werden.
Was sie nicht ersetzt
- Sie benötigen GS1-Zertifizierung oder Validierung der Produktdaten-Semantik durch gPdf.
- Sie benötigen, dass gPdf GS1-Firmenpräfixe, GTINs, SSCCs oder Prüfziffern vergibt.
- Sie benötigen Bestands- oder Produktstammdatenverwaltung.
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 - GS1-128-artiges PDF-Barcode-Element.
{
"pages": [
{
"size": "label_4_6_in",
"elements": [
{
"type": "barcode",
"format": "gs1-128",
"content": "(00)012345678901234567",
"x": 8,
"y": 22,
"width": 86,
"height": 24,
"barcode_text": { "enabled": true, "position": "bottom" }
},
{
"type": "text",
"x": 8,
"y": 56,
"content": "SSCC pallet label",
"style": { "font_size": 10, "font_family": "NotoSans-Regular" }
}
]
}
]
}
Was gPdf übernimmt
- Vektor-Barcode-Rendering innerhalb der PDF-Ausgabe.
- Barcode-Platzierung mit Text, Linien, Produktdaten und Label-Strukturen.
- Template Render für wiederholte Produkt-, Paletten-, Karton- und Lagerlabels.
- PDF-Ausgabe, die sich für Scanner- und Drucktests eignet.
Was Ihr System verantwortet
- GS1 Application Identifier, Firmenpräfixe, GTINs, SSCCs und Prüfziffern.
- Korrekte Barcode-Daten, Produktdaten, regulatorische Texte und Scanner-Abnahmetests.
- Druckprozess, Labelmaterial, Ruhezonen und operative QA.
Produktions-Checkliste
- Erzeugen Sie den GS1-Payload vorgelagert und halten Sie ihn testbar.
- Drucken und scannen Sie auf Produktionsdruckern und mit Produktionsscannern.
- Validieren Sie Ruhezonen, Modulgröße, menschenlesbaren Text und Labelmaterial.
- Nutzen Sie Template Render, sobald das Label-Layout freigegeben ist.
- Dokumentieren Sie, dass gPdf Barcodes rendert, aber keine GS1-Konformität zertifiziert.
Aussagegrenzen
- gPdf rendert Vektor-PDF-Barcodes; es ist keine GS1-Zertifizierungsstelle.
- Der Aufrufer verantwortet GS1-Datensemantik und Prüfziffern.
- Scanner-Abnahme muss in der Produktionsumgebung des Aufrufers validiert werden.
GS1-Barcode-Rendering ist ein PDF-Rendering-Job
gPdf ist dafür verantwortlich, den Barcode in das PDF zu zeichnen. Es ist nicht dafür verantwortlich zu entscheiden, ob eine GTIN, SSCC oder Application-Identifier-Sequenz für Ihr Geschäft gültig ist. Halten Sie diese Logik in ERP, WMS, Produktinformationssystem oder GS1-Tooling.
JSON Render oder Template Render nutzen
Nutzen Sie JSON Render, wenn Code das Label oder Dokument direkt layoutet. Nutzen Sie Template Render, wenn der Barcode ein Feld in einem wiederholten Label-Layout ist. In beiden Fällen sendet der Aufrufer den Payload, der codiert werden soll.
Mit echten Scannern validieren
Barcode-Erfolg misst sich an Scanner-Abnahme, nicht daran, ob ein Bild am Monitor korrekt aussieht. Validieren Sie gedruckte Ausgabe mit denselben Druckern, Scannern und Labelmaterialien, die in Produktion genutzt werden.
FAQ
- Zertifiziert gPdf GS1-Labels?
- Nein. gPdf rendert Vektor-Barcode-Grafiken in PDFs. Ihr Team verantwortet GS1-Payload-Korrektheit, Scanner-Tests und jeden Zertifizierungsworkflow.
- Können GS1-Barcodes mit Template Render verwendet werden?
- Ja. Eine veröffentlichte Vorlage kann Barcode-Felder enthalten; Aufrufer senden dann nur die variablen Daten für wiederholte Label-Layouts.
- Wer erzeugt SSCC oder GTIN?
- Ihr Produkt-, Lager- oder ERP-System erzeugt und validiert die Kennungen. gPdf erhält den Payload und rendert ihn.
- Warum Vektor-Barcodes nutzen?
- Vektormodule vermeiden Raster-Skalierungsartefakte und halten Label-PDFs über Drucker-DPI und Zoomstufen hinweg schärfer.