Barcodes and retail

API de codes-barres PDF417 pour documents et étiquettes PDF

Générez des codes-barres PDF417 dans des PDF pour workflows logistique, billetterie, documents de type carte d'embarquement et documents métier, pendant que votre système détient les règles de payload.

API PRINCIPALE JSON Render
ENDPOINT /api/v1/pdf/render
SYSTÈMES backend logistique / backend billetterie / workflow voyage / service d'automatisation documentaire
Tâche à accomplir

Rendre des payloads de codes-barres PDF417 comme éléments PDF vectoriels dans des étiquettes, tickets, formulaires ou documents de type carte d'embarquement, pendant que votre système détient le format encodé et la validation aval.

Quand utiliser cette API

  • Vous avez besoin d'un code-barres PDF417 intégré dans un document ou une étiquette PDF.
  • Votre système possède le payload encodé final et connaît les exigences du scanner aval.
  • Vous avez besoin de mises en page PDF417 répétées via Template Render.
  • Vous voulez une sortie PDF plutôt qu'une image de code-barres autonome.

Ce qu'elle ne remplace pas

  • Vous voulez que gPdf certifie des formats de payload de compagnie aérienne, gouvernementaux, logistiques ou sectoriels.
  • Vous avez besoin de gestion d'inventaire de billets, attribution de siège ou logique de réservation voyage.
  • Vous avez besoin de gestion de matériel scanner.

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 PDF417 sur une page de type ticket.

{
  "pages": [
    {
      "size": "a6",
      "elements": [
        {
          "type": "text",
          "x": 10,
          "y": 14,
          "content": "Boarding pass sample",
          "style": { "font_size": 14, "font_family": "NotoSans-Regular" }
        },
        {
          "type": "barcode",
          "format": "pdf417",
          "content": "M1DOE/JOHN         EABC123 JFKLAX GP 042 001A0001 100",
          "x": 10,
          "y": 38,
          "width": 80,
          "height": 28
        }
      ]
    }
  ]
}

Ce que gPdf prend en charge

  • Rendu de codes-barres PDF417 vectoriels dans une sortie PDF.
  • Mise en page de document ou étiquette autour du code-barres.
  • Binding de template pour des mises en page répétées de tickets ou logistique.
  • Réponse PDF binaire via les API publiques de rendu.

Ce que votre système garde

  • Payload PDF417 encodé, règles sectorielles, état de ticket ou d'expédition et identité client.
  • Acceptation scanner, tests d'impression physique et prévention de fraude.
  • Toute opération aval de réservation, accès ou logistique déclenchée par le code-barres.

Checklist de production

  1. Valider le payload PDF417 avec le scanner ou système partenaire consommateur.
  2. Imprimer et scanner à la taille et sur le matériau de production.
  3. Garder les données sensibles hors du code-barres sauf si le workflow de destination l'exige.
  4. Utiliser Template Render pour les mises en page répétées approuvées.
  5. Journaliser les request IDs avec l'ID ticket, expédition ou document.

Limites de la promesse

  • gPdf génère des codes-barres PDF417 ; il ne certifie pas les formats de payload sectoriels.
  • La sémantique billetterie, voyage, identité et logistique reste sous votre responsabilité.
  • La validation physique au scan reste nécessaire.

PDF417 est le code-barres, pas le processus métier

PDF417 apparaît souvent dans les workflows de ticket, voyage, identité et logistique. gPdf peut générer le code-barres dans un PDF. Le format du payload, les contrôles d’identité, l’état de réservation et l’acceptation aval restent hors de l’API de rendu.

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 PDF417 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 PDF417 ?
Oui. L'enum public des formats de codes-barres inclut pdf417 et les alias MicroPDF417.
gPdf peut-il créer des payloads de carte d'embarquement aérienne ?
Non. gPdf génère la valeur PDF417 que vous envoyez. Votre système voyage ou billetterie détient la construction du payload.
PDF417 peut-il être utilisé avec Template Render ?
Oui. Utilisez Template Render quand une mise en page répétée doit seulement accepter le payload et les données métier.
Dois-je tester le résultat au scan ?
Oui. Les workflows PDF417 doivent être validés avec les scanners consommateurs et le matériau d'impression de production.