API de codes-barres GS1 pour des étiquettes PDF vectorielles
Générez des codes-barres GS1 vectoriels dans des PDF, notamment GS1-128, GS1 DataMatrix, GS1 QR, ITF-14 et des workflows d'étiquettes SSCC-18.
/api/v1/pdf/render Rendre des payloads de codes-barres GS1 dans des étiquettes ou documents PDF vectoriels, pendant que votre système produit, entrepôt ou retail reste responsable des application identifiers, chiffres de contrôle et acceptation au scan.
Quand utiliser cette API
- Vous avez besoin de modules de code-barres dessinés comme contenu PDF vectoriel plutôt que d'images bitmap collées.
- Votre système possède déjà le payload GS1 correct et son interprétation lisible.
- Vous avez besoin de workflows GS1-128, GS1 DataMatrix, GS1 QR, ITF-14 ou SSCC-18 dans des étiquettes ou documents.
- Vous voulez déplacer des mises en page répétées d'étiquettes code-barres vers Template Render.
Ce qu'elle ne remplace pas
- Vous avez besoin d'une certification GS1 ou d'une validation de sémantique produit par gPdf.
- Vous voulez que gPdf attribue des préfixes entreprise GS1, GTIN, SSCC ou chiffres de contrôle.
- Vous avez besoin de gérer inventaire ou master data produit.
Quel endpoint appeler
/api/v1/pdf/render
JSON Render est le chemin par défaut pour ce workflow.
/api/v1/template-render
À utiliser si le workflow a besoin d'un chemin API lié, d'un contrat de modèle ou d'une recherche de capacités.
Requête minimale
POST /api/v1/pdf/render - élément de code-barres PDF de type 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" }
}
]
}
]
}
Ce que gPdf prend en charge
- Rendu de codes-barres vectoriels dans une sortie PDF.
- Placement de codes-barres avec texte, lignes, données produit et structures d'étiquette.
- Template Render pour des étiquettes produit, palette, carton et entrepôt répétées.
- Sortie PDF adaptée aux tests de scan et d'impression.
Ce que votre système garde
- Application identifiers GS1, préfixes entreprise, GTIN, SSCC et chiffres de contrôle.
- Données de code-barres correctes, données produit, texte réglementaire et tests d'acceptation scanner.
- Processus d'impression, stock d'étiquettes, quiet zones et QA opérationnelle.
Checklist de production
- Générer le payload GS1 en amont et le garder testable.
- Imprimer et scanner avec les imprimantes et scanners de production.
- Valider quiet zones, taille de module, texte lisible et stock d'étiquettes.
- Utiliser Template Render une fois la mise en page d'étiquette approuvée.
- Documenter que gPdf génère les codes-barres mais ne certifie pas la conformité GS1.
Limites de la promesse
- gPdf génère des codes-barres PDF vectoriels ; ce n'est pas un organisme de certification GS1.
- L'appelant détient la sémantique des données GS1 et les chiffres de contrôle.
- L'acceptation au scan doit être validée dans l'environnement de production de l'appelant.
Le rendu de codes-barres GS1 est un travail de rendu PDF
gPdf est responsable de dessiner le code-barres dans le PDF. Il n’est pas responsable de décider si un GTIN, un SSCC ou une séquence d’application identifier est valide pour votre activité. Gardez cette logique dans votre ERP, WMS, système d’information produit ou outillage GS1.
Utiliser JSON Render ou Template Render
Utilisez JSON Render quand le code compose directement l’étiquette ou le document. Utilisez Template Render quand le code-barres est un champ dans une mise en page d’étiquette répétée. Dans les deux cas, l’appelant envoie le payload qui doit être encodé.
Valider avec de vrais scanners
Le succès d’un code-barres se mesure à l’acceptation scanner, pas à l’apparence correcte d’une image sur écran. Validez la sortie imprimée avec les mêmes imprimantes, scanners et stocks d’étiquettes qu’en production.
FAQ
- gPdf certifie-t-il les étiquettes GS1 ?
- Non. gPdf génère des graphiques de codes-barres vectoriels dans des PDF. Votre équipe détient l'exactitude du payload GS1, les tests scanner et tout workflow de certification.
- Les codes-barres GS1 peuvent-ils être utilisés avec Template Render ?
- Oui. Un template publié peut contenir des champs de code-barres, et les appelants peuvent envoyer uniquement les données variables pour les mises en page d'étiquette répétées.
- Qui crée le SSCC ou le GTIN ?
- Votre système produit, entrepôt ou ERP crée et valide les identifiants. gPdf reçoit le payload et le rend.
- Pourquoi utiliser des codes-barres vectoriels ?
- Les modules vectoriels évitent les artefacts de mise à l'échelle raster et gardent les PDF d'étiquettes plus nets selon les DPI d'imprimante et les niveaux de zoom.