GS1 Barcode API voor vector-PDF-etiketten
Render vector-GS1-barcodes in PDF's, waaronder GS1-128, GS1 DataMatrix, GS1 QR, ITF-14 en SSCC-18-processen voor etiketten.
/api/v1/pdf/render Render GS1-barcode-inhoud als vector-PDF-etiketten of documenten, terwijl uw product-, magazijn- of retailsysteem verantwoordelijk blijft voor correcte applicatie-identifiers, controlecijfers en scanneracceptatie.
Wanneer deze API past
- U hebt barcodemodules nodig die als vector-PDF-inhoud worden getekend, niet als geplakte bitmapafbeeldingen.
- Uw systeem heeft al de juiste GS1-inhoud en leesbare interpretatie.
- U hebt GS1-128-, GS1 DataMatrix-, GS1 QR-, ITF-14- of SSCC-18-processen nodig in etiketten of documenten.
- U wilt herhaalde barcode-etiketlay-outs verplaatsen naar Template Render.
Wat dit niet vervangt
- U hebt GS1-certificering of validatie van productdatasemantiek door gPdf nodig.
- U hebt gPdf nodig om GS1-bedrijfsprefixen, GTINs, SSCCs of controlecijfers toe te wijzen.
- U hebt voorraadbeheer of beheer van productmasterdata nodig.
Welk endpoint aanroepen
/api/v1/pdf/render
JSON Render is het standaardpad voor deze workflow.
/api/v1/template-render
Gebruik dit wanneer de workflow een verwant API-pad, templatecontract of capability lookup nodig heeft.
Minimale request
POST /api/v1/pdf/render - PDF-barcode-element in GS1-128-stijl.
{
"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" }
}
]
}
]
}
Wat gPdf afhandelt
- Rendering van vectorbarcodes binnen PDF-output.
- Plaatsing van barcodes met tekst, lijnen, productdata en etiketstructuren.
- Template Render voor herhaalde product-, pallet-, doos- en magazijnetiketten.
- PDF-output die geschikt is voor scanner- en printtests.
Wat uw systeem beheert
- GS1-applicatie-identifiers, bedrijfsprefixen, GTINs, SSCCs en controlecijfers.
- Correcte barcodedata, productdata, gereguleerde tekst en scanneracceptatietests.
- Printproces, etiketmateriaal, quiet zones en operationele QA.
Productiechecklist
- Genereer de GS1-inhoud upstream en houd deze testbaar.
- Print en scan met productieprinters en scanners.
- Controleer quiet zones, modulegrootte, leesbare tekst en etiketmateriaal.
- Gebruik Template Render zodra de etiketlay-out is goedgekeurd.
- Documenteer dat gPdf barcodes rendert, maar GS1-naleving niet certificeert.
Grenzen van de claim
- gPdf rendert vectorbarcodes in PDF's; het is geen GS1-certificeringsinstantie.
- Het aanroepende systeem beheert GS1-datasemantiek en controlecijfers.
- Scanneracceptatie moet worden gevalideerd in de productieomgeving van het aanroepende systeem.
GS1-barcoderendering is een PDF-renderingtaak
gPdf is verantwoordelijk voor het tekenen van de barcode in de PDF. Het bepaalt niet of een GTIN, SSCC of reeks applicatie-identifiers geldig is voor uw bedrijf. Houd die logica in uw ERP, WMS, productinformatiesysteem of GS1-tooling.
Gebruik JSON Render of Template Render
Gebruik JSON Render wanneer code het etiket of document direct opmaakt. Gebruik Template Render wanneer de barcode één veld is binnen een herhaalde etiketlay-out. In beide gevallen stuurt het aanroepende systeem de inhoud die moet worden gecodeerd.
Valideer met echte scanners
Barcodesucces wordt gemeten aan scanneracceptatie, niet aan de vraag of een afbeelding er op een monitor correct uitziet. Valideer geprinte output met dezelfde printers, scanners en etiketmateriaal die in productie worden gebruikt.
FAQ
- Certificeert gPdf GS1-etiketten?
- Nee. gPdf rendert vector-barcodegraphics in PDF's. Uw team beheert de juistheid van GS1-inhoud, scannertests en eventuele certificering.
- Kunnen GS1-barcodes met Template Render worden gebruikt?
- Ja. Een gepubliceerd sjabloon kan barcodevelden bevatten, waarna aanroepende systemen alleen de variabele data voor herhaalde etiketlay-outs sturen.
- Wie maakt de SSCC of GTIN?
- Uw product-, magazijn- of ERP-systeem maakt en valideert identificatoren. gPdf ontvangt de inhoud en rendert deze.
- Waarom vectorbarcodes gebruiken?
- Vectormodules vermijden schaalartefacten van rasterbeelden en houden etiket-PDF's scherper bij verschillende printer-DPI's en zoomniveaus.