API de codes-barres DataMatrix pour sortie PDF vectorielle
Générez des codes-barres DataMatrix et GS1 DataMatrix dans des étiquettes et documents PDF pour les flux produit, médical, retail et entrepôt.
/api/v1/pdf/render Rendre des payloads DataMatrix ou GS1 DataMatrix comme éléments de codes-barres PDF vectoriels dans des étiquettes produit, étiquettes entrepôt ou documents, pendant que votre système conserve la responsabilité du payload métier encodé.
Quand utiliser cette API
- Vous avez besoin d'un code-barres 2D DataMatrix dans un document ou une étiquette PDF.
- Votre application connaît déjà l'identifiant, le lot, le numéro de série ou le payload produit encodé.
- Vous avez besoin de mises en page répétées d'étiquettes DataMatrix via Template Render.
- Vous voulez une sortie de code-barres vectorielle plutôt que des images raster intégrées dans un PDF.
Ce qu'elle ne remplace pas
- Vous avez besoin d'une certification réglementaire, d'une approbation d'étiquetage de dispositif ou d'une certification GS1 fournie par gPdf.
- Vous voulez que gPdf génère des identifiants métier ou vérifie des registres externes.
- Vous avez besoin de gérer un parc de scanners.
Quel endpoint appeler
/api/v1/pdf/render
JSON Render est le chemin par défaut pour ce flux.
/api/v1/template-render
À utiliser si le flux 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 - code-barres GS1 DataMatrix sur une étiquette produit.
{
"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" }
}
]
}
]
}
Ce que gPdf prend en charge
- Rendu de codes-barres DataMatrix et GS1 DataMatrix vectoriels dans des PDF.
- Mise en page d'étiquette ou de document autour du code-barres.
- Binding de template pour des étiquettes produit ou entrepôt répétées.
- Sortie PDF binaire pour flux d'impression, d'archivage ou de téléchargement.
Ce que votre système garde
- Contenu du payload encodé, application identifiers, numéros de série, lots et texte réglementaire.
- Tests de scan, validation de taille de module, stock d'étiquettes et critères d'acceptation.
- Tout flux de conformité sectoriel qui consomme le code-barres.
Checklist de production
- Vérifier la syntaxe du payload avant le rendu.
- Imprimer et scanner à la taille, au DPI et sur le matériau de production.
- Tester les identifiants longs et les variantes produit multilingues.
- Garder certification et revue réglementaire hors de gPdf.
- Utiliser Template Render pour les familles d'étiquettes approuvées.
Limites de la promesse
- gPdf génère des codes-barres DataMatrix ; il ne certifie pas la conformité réglementaire.
- Votre système détient la sémantique du payload de code-barres et l'acceptation au scan.
- Le rendu vectoriel ne remplace pas la validation physique de l'impression.
DataMatrix dans un PDF est un travail de rendu
Les codes-barres DataMatrix portent souvent des identifiants produit ou logistique. La frontière importante est le payload. gPdf génère un code-barres vectoriel à partir de la valeur que vous envoyez ; votre système décide ce que cette valeur signifie et si elle satisfait les exigences externes.
FAQ
- gPdf prend-il en charge les codes-barres DataMatrix ?
- Oui. Le schema public liste les alias de format de code-barres datamatrix et GS1 DataMatrix.
- gPdf valide-t-il le contenu réglementaire ?
- Non. gPdf génère le code-barres. Votre système détient l'exactitude du payload et la revue réglementaire.
- Les étiquettes DataMatrix peuvent-elles utiliser Template Render ?
- Oui. Utilisez Template Render quand une mise en page d'étiquette répétée ne doit accepter que des données métier.
- Faut-il encore faire des tests de scan ?
- Oui. Validez toujours avec les imprimantes, matériaux et scanners de production.