Barcodes and retail

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 workflows produit, médical, retail et entrepôt.

API PRINCIPALE JSON Render
ENDPOINT /api/v1/pdf/render
SYSTÈMES système d'étiquettes produit / backend entrepôt / backend retail / workflow produit réglementé
Tâche à accomplir

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

PRINCIPAL

/api/v1/pdf/render

JSON Render est le chemin par défaut pour ce workflow.

SECONDAIRE 1

/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 - 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 workflows 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 workflow de conformité sectoriel qui consomme le code-barres.

Checklist de production

  1. Vérifier la syntaxe du payload avant le rendu.
  2. Imprimer et scanner à la taille, au DPI et sur le matériau de production.
  3. Tester les identifiants longs et les variantes produit multilingues.
  4. Garder certification et revue réglementaire hors de gPdf.
  5. 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.

Choix de l’endpoint

L’appel par défaut utilise /api/v1/pdf/render. Utilisez JSON Render tant que le layout évolue ou que l’appelant décrit toute la page. Une fois le layout approuvé, publiez-le comme template et envoyez seulement les données métier via Template Render.

Réservez E-Invoice Render aux paquets Factur-X / ZUGFeRD PDF/A-3b avec XML EN 16931 CII embarqué. Les PDF opérationnels, étiquettes, reçus et rapports ordinaires ne doivent pas être traités comme un flux de facture électronique.

Validation avant production

Validez API de codes-barres DataMatrix avec des données réelles et les systèmes qui consommeront le PDF. Conservez les request IDs, les sorties rendues et les preuves d’acceptation pour le support, l’audit et les réimpressions. gPdf rend le PDF ; les règles métier, le routage externe, la fiscalité, les transporteurs et la conformité marketplace restent dans votre système.

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.