API per codici a barre GS1 in etichette PDF vettoriali
Renderizza codici a barre GS1 vettoriali nei PDF, inclusi GS1-128, GS1 DataMatrix, GS1 QR, ITF-14 e processi di etichette SSCC-18.
/api/v1/pdf/render Renderizzare contenuti GS1 come codici a barre in etichette o documenti PDF vettoriali, mentre il vostro sistema prodotto, magazzino o retail resta responsabile di Application Identifier, check digit e accettazione scanner corretti.
Quando usare questa API
- Vi servono moduli di codice a barre disegnati come contenuto PDF vettoriale invece di immagini bitmap incollate.
- Il vostro sistema possiede già il contenuto GS1 corretto e l'interpretazione leggibile da persone.
- Vi servono GS1-128, GS1 DataMatrix, GS1 QR, ITF-14 o processi SSCC-18 in etichette o documenti.
- Volete spostare layout ripetuti di etichette con codici a barre in Template Render.
Cosa non sostituisce
- Vi serve certificazione GS1 o verifica della semantica dei dati prodotto da parte di gPdf.
- Vi serve che gPdf assegni prefissi aziendali GS1, GTIN, SSCC o check digit.
- Vi serve gestione inventario o gestione dei dati master prodotto.
Quale endpoint chiamare
/api/v1/pdf/render
JSON Render è il percorso predefinito per questo flusso.
/api/v1/template-render
Usalo quando il flusso richiede l'API collegata, un contratto di template o una verifica delle capacità.
Request minimo
POST /api/v1/pdf/render - elemento codice a barre PDF in stile GS1-128.
{
"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" }
}
]
}
]
}
Cosa gestisce gPdf
- Rendering di codici a barre vettoriali dentro output PDF.
- Posizionamento dei codici a barre con testo, linee, dati prodotto e strutture di etichetta.
- Template Render per etichette ripetute di prodotto, bancale, collo e magazzino.
- Output PDF adatto a test di scansione e stampa.
Cosa controlla il tuo sistema
- Application Identifier GS1, prefissi aziendali, GTIN, SSCC e check digit.
- Dati corretti per il codice a barre, dati prodotto, testo regolatorio e test di accettazione scanner.
- Processo di stampa, supporto etichetta, zone di quiete e QA operativo.
Checklist di produzione
- Generate il contenuto GS1 a monte e mantenetelo testabile.
- Stampate e scansionate su stampanti e scanner di produzione.
- Validate zone di quiete, dimensione dei moduli, testo leggibile e supporto etichetta.
- Usate Template Render dopo l'approvazione del layout dell'etichetta.
- Documentate che gPdf renderizza codici a barre ma non certifica conformità GS1.
Limiti della promessa
- gPdf renderizza codici a barre PDF vettoriali; non è un organismo di certificazione GS1.
- Il sistema chiamante possiede semantica dei dati GS1 e check digit.
- L'accettazione scanner deve essere validata nell'ambiente di produzione del sistema chiamante.
Il rendering dei codici a barre GS1 è un lavoro di rendering PDF
gPdf è responsabile del disegno del codice a barre nel PDF. Non è responsabile di decidere se una sequenza GTIN, SSCC o Application Identifier sia valida per la vostra attività. Tenete quella logica nel vostro ERP, WMS, sistema di informazioni prodotto o tooling GS1.
Usate JSON Render o Template Render
Usate JSON Render quando il codice dispone direttamente etichetta o documento. Usate Template Render quando il codice a barre è un campo dentro un layout di etichetta ripetuto. In entrambi i casi, il sistema chiamante invia il contenuto da codificare.
Validate con scanner reali
Il successo di un codice a barre si misura con l’accettazione scanner, non con l’aspetto di un’immagine sul monitor. Validate l’output stampato con le stesse stampanti, gli stessi scanner e lo stesso supporto etichetta usati in produzione.
FAQ
- gPdf certifica etichette GS1?
- No. gPdf renderizza grafica vettoriale di codici a barre nei PDF. Il vostro team possiede correttezza del contenuto GS1, test scanner ed eventuale processo di certificazione.
- I codici a barre GS1 possono essere usati con Template Render?
- Sì. Un template pubblicato può contenere campi codice a barre e i sistemi chiamanti possono inviare solo i dati variabili per layout etichetta ripetuti.
- Chi crea SSCC o GTIN?
- Il vostro sistema prodotto, magazzino o ERP crea e valida gli identificativi. gPdf riceve il contenuto e lo renderizza.
- Perché usare codici a barre vettoriali?
- I moduli vettoriali evitano artefatti di scalatura raster e mantengono i PDF delle etichette più nitidi tra DPI stampante e livelli di zoom diversi.