Aller au contenu principal
API PDF4meIntégrationsBase de connaissancesExtensionsTesteur d'APIBlog

Vous avez du mal à ajouter des codes-barres à vos PDF ? Voici la solution complète !

· 7 minutes de lecture
Sankalp Mishra
SEO and Content Writer

Imaginez la scène : vous développez un système de gestion des commandes. Tout fonctionne à merveille jusqu’à ce que le client demande : « Peut-on ajouter des codes-barres de suivi aux factures ? » Soudain, vous vous retrouvez plongé dans un labyrinthe de bibliothèques de codes-barres, de normes d’encodage et de subtilités liées à la manipulation des PDF.

Cela vous semble familier ? Vous n’êtes pas seul. L’intégration des codes-barres fait partie de ces fonctionnalités qui paraissent simples jusqu’à ce qu’on les mette en œuvre.

Ce guide simplifie les choses. Nous explorerons des méthodes pratiques pour ajouter des codes-barres aux PDF, quand utiliser quel type de code-barres et comment éviter les pièges courants.

Choisir le bon type de code-barres​

Tous les codes-barres ne se valent pas. Le format à choisir dépend des données à encoder et du lieu de lecture.

Quand utiliser les codes-barres 2D​

Les codes-barres 2D stockent les données à la fois horizontalement et verticalement, ce qui leur permet de contenir beaucoup plus d'informations que les codes-barres linéaires.

Code QRLe format 2D le plus répandu. Idéal pour les URL, les informations de contact ou toute donnée pouvant être scannée par un smartphone. Peut contenir jusqu'à 4 296 caractères alphanumériques.

Matrice de donnéesCompact et fiable. Très apprécié dans les secteurs de la production et de la santé où l'espace est limité. Meilleure correction d'erreurs que les codes QR.

PDF417Utilisé sur les cartes d'identité, les cartes d'embarquement et les étiquettes d'expédition. Permet d'encoder des documents entiers.

Idéal pour : URL, données volumineuses, numérisation mobile, environnements sujets aux erreurs

Stratégies de positionnement​

L'emplacement du code-barres est aussi important que son type. Un mauvais positionnement entraîne des échecs de lecture.

Meilleures pratiques de positionnement

  • Zone calmeLaissez un espace blanc autour du code-barres (au moins 10 fois la largeur de la barre la plus étroite).
  • Évitez les plisNe placez pas les codes-barres aux endroits où les documents se plient habituellement.
  • Emplacement constantUtilisez la même position pour tous les types de documents afin d'accélérer la numérisation.
  • Taille appropriéePlus grand n'est pas toujours mieux ; adaptez la taille à la distance du scanner

Implémentation avec l'API PDF4me​

Le point de terminaison PDF4me Add Barcode gère la génération de codes-barres et l'intégration de PDF en un seul appel d'API :

POST https://api.pdf4me.com/api/v2/addbarcode

Paramètres principaux :

ParamètreDescriptionExemple
barcodeTypeFormat à générer"QrCode", "Code128"
textDonnées à encoder"https://example.com"
pageNrPage cible (indexée à partir de 1)1
x, yPosition en points50, 700
width, heightDimensions en points100, 100

Pour la liste complète des paramètres, consultez le Documentation API.

Scénarios réels​

Scénario 1 : Suivi des factures

Problème: Une équipe financière doit pouvoir suivre les factures payées en scannant un code.

Solution: Ajoutez un code QR à chaque facture, contenant son identifiant. Une fois scanné, ce code déclenchera une recherche dans votre système de paiement.

Type de code-barres : Code QR (compatible avec les smartphones, encode les identifiants alphanumériques) Position: Coin supérieur droit, identique sur toutes les factures

Scénario 2 : Listes de prélèvement en entrepôt

Problème: Les magasiniers doivent scanner rapidement les articles sur les listes de prélèvement pour confirmer leur sélection.

Solution: Ajoutez des codes-barres Code128 à côté de chaque article, codant l'UGS.

Type de code-barres : Code 128 (numérisation rapide avec appareils portables) Position: Marge gauche, alignée avec chaque ligne de produit

Scénario 3 : Billets pour l'événement

Problème: Les organisateurs d'événements ont besoin de billets scannables compatibles avec les applications pour smartphones et les scanners dédiés.

Solution: Générez des billets PDF avec des codes QR contenant un identifiant unique et les détails de l'événement.

Type de code-barres : Code QR (compatible avec tout appareil équipé d'un appareil photo) Position: Centre du billet, suffisamment grand pour un scan rapide

Scénario 4 : Documents de conformité

Problème: Les documents juridiques nécessitent des identifiants lisibles par machine pour être conformes à la réglementation.

Solution: Ajoutez des codes-barres PDF417 qui encodent les métadonnées du document et les hachages de vérification.

Type de code-barres : PDF417 (grande capacité de données, norme industrielle pour les cartes d'identité) Position: La zone de pied de page n'interfère pas avec le contenu du document.

Testez avant de construire​

Avant d'écrire le code d'intégration, validez votre approche à l'aide de notre testeur d'API interactif. Vous pouvez tester différents types, positions et tailles de codes-barres pour observer précisément leur rendu.

Open Barcode API TesterView API Documentation

Guide de référence rapide : Types de codes-barres​

Capacité de données élevée

  • Code QR, jusqu'à 4 296 caractères
  • PDF417, jusqu'à 1 850 caractères
  • DataMatrix, jusqu'à 2 335 caractères

Numérisation rapide

  • Code 128, norme logistique
  • Code39, compatible avec les versions précédentes
  • EAN-13, optimisé pour la vente au détail

Prochaines étapes​

Prêt à ajouter des codes-barres à vos PDF ?

  1. Obtenez votre clé APIDébut gratuit
  2. Essayez le testeur d'APIExpérimentez sans code
  3. Parcourir les exemples de codeExemples en C#, Python, Java et JavaScript
  4. Consultez la documentation complèteRéférence complète des paramètres
Get Started Free