Mon QR code ne fonctionne pas

D'abord, séparez le problème en deux

Scannez le code avec un appareil photo de téléphone ordinaire :

• Rien ne se passe → le code lui-même ne peut pas être lu. Causes 1 à 4.
• Une page s'ouvre, mais c'est une information au lieu de votre passeport → le code se lit bien ; le problème vient de l'état du passeport ou du GTIN. Causes 5 à 7.

Cause 1 : imprimé trop petit

Symptôme : Le code se scanne depuis votre écran mais pas depuis l'étiquette imprimée, ou ne se scanne que lorsque le téléphone est anormalement proche.

Les codes trop petits sont l'échec d'impression le plus fréquent, surtout sur le textile où la surface s'incurve et se froisse. Les minimums :

• Étiquettes d'entretien : 20mm
• Étiquettes volantes : 25mm ou plus
• Étiquettes tissées : 14mm, tissées à partir du SVG

Solution : Réimprimez à la taille minimale ou au-dessus pour l'emplacement. Les préréglages de taille et le guide d'impression complet figurent dans Télécharger et imprimer les QR codes.

Cause 2 : contraste faible ou couleurs inversées

Symptôme : Le code est assez grand mais les scanners peinent, en particulier en faible lumière.

Les scanners attendent des modules sombres sur fond clair. Les codes recolorés à faible contraste, les inversions clair-sur-foncé ou les codes imprimés par-dessus une maquette chargée réduisent tous le taux de scan. La bordure blanche autour du code (la zone de silence) fait partie de la norme — une maquette ou un bord d'étiquette qui y empiète nuit aussi au scan.

Solution : Utilisez le code noir sur blanc téléchargé tel quel autant que possible. Si votre graphiste le recolore, conservez du sombre-sur-clair avec un fort contraste, préservez la zone de silence et testez un échantillon physique avant la série de production.

Cause 3 : le fichier a été converti en JPG

Symptôme : Le code imprimé paraît légèrement flou ou présente de légers halos autour des carrés, et le scan est peu fiable.

PassportCraft exporte uniquement en SVG et PNG — il n'existe pas d'export JPG, donc un JPG dans votre chaîne d'impression signifie que quelqu'un l'a converti en cours de route. La compression JPG brouille les arêtes nettes des modules dont dépendent les scanners.

Solution : Repartez du téléchargement d'origine. Envoyez le SVG aux fournisseurs d'impression ; si une chaîne de travail exige une image matricielle, utilisez le PNG. Ne réenregistrez jamais l'un ou l'autre en JPG.

Cause 4 : code abîmé ou mal placé

Symptôme : Le code se scannait bien à l'état neuf mais échoue après usure — ou échoue uniquement sur le produit physique, pas sur une impression de test à plat.

Les codes PassportCraft sont générés avec une correction d'erreur élevée (ils tolèrent jusqu'à 30 % de dommages), mais le tissu est un terrain hostile : les codes imprimés à cheval sur une couture ou une pliure, sur des étiquettes très froissées ou abrasées, ou sous des finitions brillantes qui reflètent la lumière peuvent quand même échouer.

Solution : Placez le code sur une zone plane à l'écart des coutures et des pliures, privilégiez les finitions mates, et pour les étiquettes très usées, réimprimez. Si le code d'un même passeport continue d'échouer sur le terrain, envisagez de le déplacer de l'étiquette d'entretien vers une étiquette volante à une taille plus grande.

Cause 5 : le passeport est en brouillon

Symptôme : Le code se scanne et une page s'ouvre — mais elle affiche « Ce passeport n'a pas encore été publié » avec une option de connexion.

L'URL du QR code ne change jamais, mais elle ne mène au passeport en ligne que tant que le passeport est publié. Un brouillon — y compris un passeport qui a été publié une fois puis dépublié — affiche cette information neutre à la place. Aucune donnée produit n'est exposée, et votre propre équipe peut se connecter depuis cette page pour prévisualiser le brouillon.

Solution : Publiez le passeport. Le code imprimé prend en compte le changement immédiatement — rien à réimprimer.

Cause 6 : le passeport a été désactivé par un changement de plan

Symptôme : La page affiche « Ce passeport numérique de produit a été temporairement désactivé. Contactez la marque pour obtenir les informations produit. »

C'est l'information affichée pour les passeports retirés du public par un passage à un plan inférieur — par exemple lorsque les passeports publiés ont dépassé la limite d'un nouveau plan après la période de grâce. Voir Changement de plan et période de grâce pour comprendre comment cela se produit et comment l'éviter.

Solution : Libérez des emplacements de publication ou passez à un plan supérieur, puis republiez le passeport.

Cause 7 : le GTIN ne correspond pas

Symptôme : La page affiche « Ce passeport numérique de produit n'est pas disponible. »

L'URL du QR code est construite à partir d'un GTIN — et aucun passeport du système ne lui correspond. Raisons typiques : le GTIN du passeport a été modifié après l'impression du code, l'étiquette porte un code généré à partir du mauvais GTIN, ou une URL sérialisée pointe vers un numéro de série qu'aucun passeport ne possède.

Solution : Ouvrez le passeport et comparez son GTIN (et son numéro de série, le cas échéant) à l'URL encodée affichée dans le panneau QR, puis à ce qui est imprimé. La façon dont ces URL sont construites est traitée dans GS1 Digital Link expliqué.

Applications appareil photo et applications de scan

Tout appareil photo de téléphone moderne lit ces codes — ce sont des QR codes standard contenant une URL https ordinaire, sans application spéciale. Si un appareil photo n'en capte pas un : ajoutez de la lumière, tenez le téléphone à 10–30 cm et stable, et évitez les reflets sur les surfaces brillantes. Une application de scan QR dédiée peut aider avec les codes limites (petits, usés ou à faible contraste), mais si un code ne se scanne qu'avec une application dédiée, considérez cela comme un test échoué — vos clients utiliseront leur appareil photo.