API DataMatrix per output PDF vettoriale
Renderizza codici DataMatrix e GS1 DataMatrix in etichette e documenti PDF per processi prodotto, medicali, retail e di magazzino.
/api/v1/pdf/render Renderizzare contenuti DataMatrix o GS1 DataMatrix come elementi vettoriali di codice a barre dentro etichette, documenti o layout PDF di prodotto, mentre il vostro sistema resta responsabile del contenuto di business codificato.
Quando usare questa API
- Vi serve un codice a barre DataMatrix 2D dentro un documento o un'etichetta PDF.
- La vostra applicazione conosce già identificativo, lotto, seriale o contenuto prodotto da codificare.
- Vi servono layout ripetuti di etichette DataMatrix tramite Template Render.
- Volete output vettoriale del codice a barre invece di immagini raster incorporate in un PDF.
Cosa non sostituisce
- Vi serve certificazione normativa, approvazione dell'etichettatura dei dispositivi o certificazione GS1 da parte di gPdf.
- Vi serve che gPdf generi identificativi di business o controlli registri esterni.
- Vi serve gestione del parco scanner.
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 - codice a barre GS1 DataMatrix su un'etichetta prodotto.
{
"pages": [
{
"size": "label_100_100",
"elements": [
{
"type": "barcode",
"format": "gs1-datamatrix",
"content": "(01)09506000134352(10)LOT26A",
"x": 10,
"y": 14,
"width": 34,
"height": 34
},
{
"type": "text",
"x": 10,
"y": 56,
"content": "GTIN 09506000134352\nLOT LOT26A",
"style": { "font_size": 9, "font_family": "NotoSans-Regular" }
}
]
}
]
}
Cosa gestisce gPdf
- Rendering vettoriale di codici a barre DataMatrix e GS1 DataMatrix nei PDF.
- Layout di etichette o documenti attorno al codice a barre.
- Associazione al template per etichette ripetute di prodotto o magazzino.
- Output PDF binario per processi di stampa, archiviazione o download.
Cosa controlla il tuo sistema
- Contenuto codificato, Application Identifier, seriali, lotti e testi regolatori.
- Test scanner, verifica della dimensione dei moduli, supporto etichetta e criteri di accettazione.
- Qualsiasi processo di conformità specifico del settore che utilizza il codice a barre.
Checklist di produzione
- Verificate la sintassi del contenuto prima del rendering.
- Stampate e scansionate a dimensione, DPI e materiale di produzione.
- Testate identificativi lunghi e varianti prodotto in più lingue.
- Mantenete certificazione e revisione regolatoria fuori da gPdf.
- Usate Template Render per famiglie di etichette confermate.
Limiti della promessa
- gPdf renderizza codici a barre DataMatrix; non certifica conformità normativa.
- Il vostro sistema possiede la semantica del contenuto del codice a barre e l'accettazione scanner.
- Il rendering vettoriale non sostituisce la verifica della stampa fisica.
DataMatrix nei PDF è un lavoro di rendering
I codici a barre DataMatrix spesso trasportano identificativi di prodotto o logistici. Il confine importante è il contenuto codificato. gPdf renderizza un codice a barre vettoriale dal valore che inviate; il vostro sistema decide che cosa significa quel valore e se soddisfa requisiti esterni.
FAQ
- gPdf supporta codici a barre DataMatrix?
- Sì. Lo schema pubblico elenca alias di formato per datamatrix e GS1 DataMatrix.
- gPdf verifica contenuti regolatori?
- No. gPdf renderizza il codice a barre. Correttezza del contenuto e revisione regolatoria restano responsabilità del vostro sistema.
- Le etichette DataMatrix possono usare Template Render?
- Sì. Usate Template Render quando un layout ripetuto di etichetta deve accettare solo dati di business.
- Serve comunque fare test di scansione?
- Sì. Validate sempre con stampanti, materiali e scanner di produzione.