Il mio codice QR non funziona

Prima, divida il problema in due

Scansioni il codice con una normale fotocamera di un telefono:

• Non succede nulla → il codice in sé non può essere letto. Cause 1–4.
• Si apre una pagina, ma è un avviso anziché il Suo passaporto → il codice si legge perfettamente; il problema è lo stato del passaporto o il GTIN. Cause 5–7.

Causa 1: stampato troppo piccolo

Sintomo: il codice si scansiona dal Suo monitor ma non dall'etichetta stampata, oppure si scansiona solo quando il telefono è a una distanza impraticabile.

I codici piccoli sono il problema di stampa più comune, specialmente sui tessili dove la superficie si curva e si sgualcisce. I valori minimi:

• Etichette di cura: 20 mm
• Cartellini: 25 mm o più grandi
• Etichette tessute: 14 mm, tessute dall'SVG

Soluzione: ristampi alla dimensione minima per la collocazione o oltre. I preset di dimensione e le indicazioni di stampa complete si trovano in Scaricare e stampare i codici QR.

Causa 2: contrasto basso o colori invertiti

Sintomo: il codice è abbastanza grande ma gli scanner faticano, in particolare con scarsa illuminazione.

Gli scanner si aspettano moduli scuri su sfondo chiaro. I codici ricolorati con contrasto basso, le inversioni chiaro-su-scuro o i codici stampati su file grafici affollati riducono tutti il tasso di scansione. Il bordo bianco intorno al codice (la zona di rispetto) fa parte dello standard — file grafici o bordi dell'etichetta che vi sconfinano compromettono anch'essi la scansione.

Soluzione: usi il codice scaricato in nero su bianco così com'è dove possibile. Se il Suo designer lo ricolora, mantenga scuro su chiaro con un forte contrasto, preservi la zona di rispetto e provi un campione fisico prima della tiratura di produzione.

Causa 3: il file è stato convertito in JPG

Sintomo: il codice stampato appare leggermente sfocato o presenta deboli aloni intorno ai quadrati, e la scansione è inaffidabile.

PassportCraft esporta solo SVG e PNG — non esiste un'esportazione JPG, quindi un JPG nella Sua filiera di stampa significa che qualcuno l'ha convertito lungo il percorso. La compressione JPG sbava i bordi netti dei moduli da cui dipendono gli scanner.

Soluzione: torni al download originale. Invii ai fornitori di stampa l'SVG; se un flusso di lavoro richiede un'immagine raster, usi il PNG. Non risalvi mai nessuno dei due come JPG.

Causa 4: codice danneggiato o collocato male

Sintomo: il codice si scansionava perfettamente da nuovo ma fallisce dopo l'usura — oppure fallisce solo sul prodotto fisico, non su una stampa di prova piana.

I codici di PassportCraft sono generati con un'elevata correzione degli errori (tollerano fino al 30% di danni), ma il tessuto è un terreno ostile: i codici stampati attraverso una cucitura o una piega, su etichette molto sgualcite o consumate, oppure sotto finiture lucide che riflettono la luce possono comunque fallire.

Soluzione: collochi il codice su un'area piana lontana da cuciture e pieghe, preferisca le finiture opache e, per le etichette molto consumate, ristampi. Se il codice dello stesso passaporto continua a fallire sul campo, valuti di spostarlo dall'etichetta di cura a un cartellino di dimensione maggiore.

Causa 5: il passaporto è una bozza

Sintomo: il codice si scansiona e si apre una pagina — ma recita "Questo passaporto non è ancora stato pubblicato" con un'opzione di accesso.

L'URL del codice QR non cambia mai, ma si risolve nel passaporto online solo finché il passaporto è pubblicato. Una bozza — incluso un passaporto pubblicato una volta e poi con pubblicazione annullata — mostra invece questo avviso neutro. Non viene esposto alcun dato di prodotto e il Suo team può accedere da quella pagina per vedere l'anteprima della bozza.

Soluzione: pubblichi il passaporto. Il codice stampato recepisce la modifica immediatamente — niente da ristampare.

Causa 6: il passaporto è stato disattivato da un cambio di piano

Sintomo: la pagina recita "Questo Passaporto Digitale di Prodotto è stato temporaneamente disattivato. Contatta il brand per informazioni sul prodotto."

È l'avviso per i passaporti messi offline da un downgrade di piano — ad esempio quando i passaporti pubblicati hanno superato il limite di un nuovo piano dopo il periodo di tolleranza. Veda Upgrade, downgrade e periodo di tolleranza per capire come avviene e come evitarlo.

Soluzione: liberi dei posti di pubblicazione o effettui l'upgrade, poi ripubblichi il passaporto.

Causa 7: il GTIN non corrisponde

Sintomo: la pagina recita "Questo Passaporto Digitale di Prodotto non è disponibile."

L'URL nel codice QR è costruito a partire da un GTIN — e nessun passaporto nel sistema vi corrisponde. Ragioni tipiche: il GTIN del passaporto è stato modificato dopo la stampa del codice, l'etichetta reca un codice generato dal GTIN sbagliato, oppure un URL serializzato rimanda a un numero di serie che nessun passaporto possiede.

Soluzione: apra il passaporto e confronti il suo GTIN (e il numero di serie, se usato) con l'URL codificato mostrato nel pannello QR, poi con ciò che è stampato. Come vengono costruiti questi URL è trattato in GS1 Digital Link spiegato.

App fotocamera e app scanner

Qualsiasi fotocamera di un telefono moderno legge questi codici — sono codici QR standard che contengono un comune URL https, senza bisogno di un'app speciale. Se una fotocamera non ne capta uno: aggiunga luce, tenga il telefono a 10–30 cm di distanza e fermo ed eviti i riflessi sulle superfici lucide. Un'app dedicata per la scansione di QR può aiutare con i codici marginali (piccoli, consumati o a basso contrasto), ma se un codice si scansiona solo in un'app dedicata, lo consideri come un test fallito — i Suoi clienti useranno le loro fotocamere.