Per què el teu codi QR no s'escaneja (i com arreglar-ho): la guia completa de resolució de problemes

Els codis QR fallen per un nombre reduït de raons ben enteses. Camina per aquesta guia de dalt a baix i arreglaràs el 95% dels problemes d'escaneig en cinc minuts.

El marc que ajuda: cada codi QR és un contracte entre tres parts. El codi imprès (o mostrat), el mòbil que el vol escanejar i el servidor on apunta finalment la URL. Un escaneig falla quan qualsevol d'aquestes tres parts trenca el contracte.

Aquesta guia està organitzada per quina part és la culpable. La majoria de problemes són amb el codi mateix, així que comencem allà.

El diagnòstic ràpid: descobreix qui té la culpa en 30 segons

Abans de resoldre problemes en profunditat, fes aquesta prova:

1. Prova un codi conegut com a bo. Obre qualsevol altre QR dinàmic que hagis provat abans i escaneja'l. Si això s'escaneja, el teu mòbil està bé.
2. Prova el codi problemàtic en un mòbil diferent. Demana'n un. Si el seu mòbil l'escaneja, el problema és del teu mòbil. Si cap mòbil l'escaneja, el problema és del codi.
3. Prova el codi problemàtic amb millor llum. Porta'l a una finestra o a un llum brillant. Si ara s'escaneja, el teu problema és la il·luminació o el contrast.
4. Llegeix la URL manualment si està impresa al costat del codi. Escriu-la al navegador. Si la pàgina carrega, la destinació està bé i el codi mateix està trencat. Si la pàgina falla, la destinació està trencada i el codi és innocent.

Sigui quin sigui el pas que ha revelat el culpable, salta a aquella secció més avall.

Problema 1: el codi està físicament malmès

Els codis QR tenen correcció d'errors integrada. Fins a un 30% del patró pot estar obscurit o malmès i el codi encara s'escanejarà. Però «30%» és el màxim al nivell més alt de correcció d'errors: molts codis del món real es generen amb una correcció d'errors més baixa i toleren molts menys danys.

Com es veu el dany:

• Plecs o arrugues a través del codi
• Taques de cafè, anells d'aigua, taques de menjar
• Ratllades que han eliminat la tinta
• Decoloració per exposició al sol
• Adhesius o etiquetes cobrint part del codi
• Defectes d'impressió (bandes, desalineació, taques)

La solució:

• Per a danys menors (menys del 10% obscurit), la majoria de càmeres de mòbil moderns encara llegeixen el codi. Prova escanejant des de diferents angles o distàncies.
• Per a danys importants, necessites una nova impressió. Si el codi subjacent és dinàmic, no hi ha problema: imprimeix una nova còpia. Si el codi és estàtic, la URL està codificada directament al patró, així que una nova impressió del mateix codi funcionarà.

La prevenció: imprimeix codis sobre materials duradors per a qualsevol ubicació de molt trànsit. Plastificat, expositors d'acrílic i vinil resistent a la intempèrie afegeixen anys a la vida útil del codi. Per a codis exteriors, la tinta resistent als UV val el cost addicional.

Problema 2: el codi està imprès massa petit

Un codi QR ha de ser prou gros perquè la càmera resolgui els mòduls individuals (els petits quadrats negres que formen el patró de dades).

La regla general:

Mida mínima = distància d'escaneig ÷ 10

Un codi escanejat des de 30 cm (distància de braç) ha de fer com a mínim 3 cm. Un codi escanejat des de 3 metres (un pòster a la paret) ha de fer com a mínim 30 cm.

A la pràctica, els mínims per a escenaris comuns:

• Targetes de visita / expositors de taula: 2,5–3 cm mínim
• Anuncis de revista / fulletons: 3–4 cm
• Aparadors: 5–8 cm
• Pòsters a distància interior: 10–15 cm
• Pòsters grans vistos des de l'altre cantó d'una habitació: 20–30 cm
• Tanques publicitàries: depèn de la distància de visualització; pot ser més d'un metre

La solució: si el teu codi és just al límit de petit, reimprimeix-lo més gros. Si ja l'has imprès en volum, l'única solució pràctica és portar el material imprès més a prop de l'usuari, però normalment no és factible.

La prevenció: mesura dues vegades, imprimeix una. Prova sempre la mida real impresa en l'entorn real abans d'imprimir en volum.

Problema 3: el contrast és massa baix

Els codis QR s'escanegen amb més fiabilitat quan els quadrats foscos són molt foscos i els quadrats clars són molt clars. La relació de contrast entre ells ha de ser alta.

Fallades de contrast comunes:

• Codi gris mitjà sobre fons blanc
• Codi fosc sobre fons de color fosc
• Codis de colors (especialment pastel) sense contrast suficient
• Codis blancs sobre fons negre (funciona en la majoria de mòbils moderns, falla en Androids antics)
• Codis amb superposicions semitransparents
• Codis impresos sobre paper texturitzat o de colors on el color s'estén als mòduls

La solució:

• Reimprimeix amb més contrast. Negre sobre blanc és el més segur.
• Si necessites un codi de color per a la marca, fes servir un color molt fosc (blau marí profund, verd bosc, granat) sobre un fons molt clar.
• Si el codi està sobre una superfície de color, afegeix un panell blanc al voltant del codi.

La prevenció: prova el codi imprès real sobre el paper o superfície real en la il·luminació real. Un codi que queda bonic al mockup de disseny en el monitor calibrat d'un dissenyador sovint falla en un restaurant amb poca llum.

Problema 4: reflex o reflexió

El paper brillant, el plastificat, el packaging de plàstic i els expositors d'acrílic brillant reflecteixen tots la llum. Si el reflex toca la lent de la càmera, la càmera no pot veure el codi clarament.

La solució:

• Inclina el mòbil 15–20° fora d'eix. Això trenca el reflex sense canviar la capacitat de la càmera per llegir el codi.
• Mou-te perquè la font de llum estigui darrere teu, no darrere del codi.
• Per a codis sobre superfícies brillants, atenua els llums del sostre si pots.

La prevenció: evita acabats d'alta brillantor per a codis QR en entorns amb molta llum. Els acabats mat o setinats són més tolerants.

Problema 5: la URL de destinació està trencada

El codi QR es pot escanejar perfectament, però la URL a la qual apunta retorna un 404 (o un error «no es pot accedir al lloc»), així que l'usuari pensa que el codi ha fallat.

Com passa això:

• La pàgina de destinació s'ha mogut o eliminat.
• La URL es va escriure malament quan es va generar el codi.
• El lloc està temporalment fora de servei.
• La URL tenia una errada o un espai extra.
• La URL conté caràcters que necessitaven codificació.

La solució:

• Si el codi és dinàmic: inicia sessió al teu proveïdor de QR, canvia la URL de destinació i el mateix codi ara apunta a la nova URL. Sense reimpressió. Aquest és el superpoder del codi dinàmic.
• Si el codi és estàtic: la URL està codificada al codi. No la pots canviar. Les úniques opcions són reimprimir amb la URL correcta, o configurar una redirecció a la URL original al teu propi servidor.

La prevenció: prova sempre la URL de destinació en el moment que es genera el codi i de nou després que la pàgina estigui activa. Actualitza rutinàriament si l'estructura del teu lloc canvia.

Problema 6: el codi dinàmic ha caducat o s'ha desactivat

Aquest és el mode de fallada més dolorós, perquè el codi mateix està bé: és només que el servidor del proveïdor ja no està redirigint.

Causes habituals:

• El teu període de prova gratuït amb el proveïdor de QR ha acabat.
• Has cancel·lat o rebaixat la teva subscripció, i la política del proveïdor és desactivar els codis dinàmics en cancel·lar.
• El teu compte ha estat suspès per impagament.
• El proveïdor ha tancat.
• El proveïdor ha eliminat el codi per inactivitat (rar però passa).

La solució:

• Inicia sessió al compte del proveïdor de QR. Si el codi està pausat o desactivat, reactiva'l (cosa que normalment significa tornar-se a subscriure).
• Si el proveïdor ha tancat o el teu compte ha desaparegut, hauràs de generar nous codis en una nova plataforma i reimprimir.

La prevenció: aquesta és la raó més important per triar un proveïdor de QR amb codis que no es trenquin en cancel·lar. La política de QR Cake és que els codis continuïn funcionant a l'última destinació desada fins i tot després de la cancel·lació. La majoria de proveïdors de pagament desactiven els codis quan acaben les subscripcions. Llegeix la lletra petita abans d'apostar els teus actius impresos en un proveïdor.

Problema 7: problemes amb la càmera del mòbil

Menys habitual del que la gent suposa, però passa.

Problemes habituals del costat del mòbil:

• La lent està bruta. Neteja-la amb un drap de microfibra. Això arregla més codis QR «trencats» que qualsevol altra intervenció.
• L'aplicació Càmera és la incorrecta. Alguns fabricants d'Android tenen diverses aplicacions de càmera. Assegura't que estàs fent servir la estàndard amb suport QR activat.
• L'escaneig de QR està desactivat a la configuració de càmera. Alguns Samsungs i Xiaomis ho amaguen a Configuració → Càmera → Escaneja codis QR.
• La càmera està en un mode que no escaneja. El mode selfie no escaneja fiablement; alguns modes «professionals» tampoc. Fes servir el mode foto estàndard.
• El sistema operatiu és massa antic. iOS anterior al 11 i Android anterior al 8 no tenen escaneig de QR integrat.

La solució: prova el codi problemàtic en un mòbil diferent, o instal·la una aplicació d'escàner de tercers fiable (TeaCapps QR & Barcode Scanner a Android; l'aplicació Càmera de l'iPhone o l'Escàner de codis del Centre de control a iOS).

Problema 8: el codi és massa dens

Aquesta és una fallada del costat del productor que és fàcil de no veure. Com més dades codifiques en un codi QR estàtic, més dens esdevé el patró. Una URL curta produeix un codi dispers, fàcil d'escanejar. Una URL llarga amb paràmetres UTM produeix un codi dens i fràgil.

La solució:

• Per a codis estàtics, escurça la URL abans de generar el codi. Fes servir un escurçador d'URL o mou el seguiment UTM al costat del servidor.
• Millor: canvia a un codi dinàmic. Els codis dinàmics sempre codifiquen una URL de redirecció curta, així que el patró és dispers i tolerant fins i tot a mides petites. Un codi QR Cake dinàmic gratuït és una forma ràpida de provar si la densitat era el problema: torna a generar la mateixa destinació com a codi dinàmic i compara'ls al costat.

La prevenció: mai posis URL llargues a codis QR estàtics si el codi s'imprimirà petit. Prova el codi resultant a la mida d'impressió planificada abans de comprometre't.

Problema 9: mala col·locació

Fins i tot un codi perfectament generat i perfectament imprès pot fallar per on està col·locat.

Fallades de col·locació comunes:

• Darrere de vidre que reflecteix (vitrines de museu, pòsters emmarcats)
• Sobre una superfície corba (packaging cilíndric, llaunes de begudes)
• Sobre teixit o material teixit que distorsiona el patró
• En una posició on només arriba llum d'un costat
• On els usuaris s'aproximen des d'un angle que distorsiona el codi a la seva càmera

La solució: mou el codi a una posició plana, ben il·luminada i accessible. Prova sempre la col·locació real abans d'imprimir en volum.

La prevenció: tracta la col·locació com a part del disseny, no com un afegit posterior.

Problema 10: colors invertits

Els codis QR estan dissenyats per ser llegits com «mòduls foscos sobre fons clar». Els codis invertits —mòduls clars sobre fons fosc— funcionen en iPhones moderns i Androids recents, però els dispositius més antics sovint fallen.

La solució: imprimeix el codi amb quadrats foscos sobre fons clar. Encara que el teu mockup de disseny mostri el contrari, la versió de producció ha de ser convencional.

La prevenció: si necessites una estètica clar-sobre-fosc per raons de disseny, prova exhaustivament amb mòbils Android antics abans de comprometre't. Molts Androids antics (especialment els models econòmics) genuïnament no poden llegir codis invertits.

Com provar el teu codi abans d'imprimir en volum

Abans de comprometre't a imprimir 1.000 de qualsevol cosa, fes aquesta prova de 10 minuts:

1. Imprimeix una còpia del codi a la mida real planificada.
2. Escaneja amb un iPhone (aplicació Càmera).
3. Escaneja amb un mòbil Android (aplicació Càmera o Google Lens).
4. Escaneja des de la distància més propera des de la qual algú es pugui aproximar.
5. Escaneja des de la distància més llunyana des de la qual algú es pugui aproximar.
6. Mou-te a la part més fosca de l'habitació on el codi pot viure i escaneja allà.
7. Prova en almenys un mòbil amb un SO antic (iOS 14 o Android 9 si és possible).
8. Obre la URL de destinació i confirma que carrega en menys de 3 segons al mòbil.

Si algun pas falla, arregla-ho abans d'imprimir en volum.

Preguntes freqüents

Per què el meu codi QR s'escaneja en un mòbil però no en un altre? Normalment una de tres coses: el mòbil que funciona té millor òptica de càmera, millor detecció de QR a nivell de programari (SO més nou), o l'estàs aguantant a una distància/angle diferent. Prova el mòbil que falla amb els suggeriments de la secció de càmera anterior.

El meu codi QR funcionava ahir i avui no. Per què? Tres causes probables, per ordre: (1) la URL de destinació ha canviat o retorna un error, (2) la subscripció del codi dinàmic s'ha acabat, (3) el codi s'ha danyat físicament.

Puc arreglar un codi QR estàtic sense reimprimir? No pots canviar el codi mateix: la URL està codificada. Però si controles el domini de la URL de destinació, pots configurar una redirecció al costat del servidor des de la URL original a una de nova. Això manté el codi imprès funcionant.

Per què alguns codis QR s'escanegen instantàniament i altres triguen uns segons? Els d'escaneig ràpid tenen més contrast, millor qualitat d'impressió, mida òptima i patrons de dades dispersos (normalment URL curtes). Els lents tenen una o més debilitats que el mòbil ha de treballar més per superar.

El nivell de correcció d'errors afecta l'escaneig? Sí. Una correcció d'errors més alta (L, M, Q, H, sent H la més alta) fa que els codis tolerin més danys però també són més densos. La majoria de generadors per defecte fan servir M (mitjà), que funciona per a la majoria de casos. Per a ús a l'exterior o industrial, canvia a Q o H.

Els iPhones escanegen codis QR que els Androids antics no poden? Sovint sí. Els iPhones generalment tenen millor detecció de QR que els Androids de gamma mitjana i antics. Si estàs produint codis per al públic, optimitza per al mòbil més fluix raonable de la teva audiència, que normalment vol dir un Android antic.

Els codis QR de colors són menys fiables? No intrínsecament. La fiabilitat depèn del contrast, no del color. Un codi negre i un codi blau marí fosc funcionen igual de bé sobre un fons blanc. Un codi groc pastel sobre fons blanc funciona malament. Prova abans de comprometre't.

Per què el meu codi funciona a la llum del dia però falla amb la il·luminació d'un restaurant? Els nivells de llum afecten la capacitat d'enfocament de la càmera i el contrast percebut del codi. Amb poca llum, la càmera triga més a enfocar i pot veure menys contrast del que veuria a la llum del dia. Codi més gran, més contrast, superfície més amigable amb el reflex = millor rendiment amb poca llum.

En cas de dubte

Si has treballat per aquesta guia i el codi encara no s'escaneja, el problema és gairebé segur un de:

• Codi generat amb paràmetres trencats (rar però passa: prova de tornar-lo a generar)
• Tall del costat del proveïdor (revisa la pàgina d'estat del teu proveïdor)
• El servidor de destinació està caigut o està bloquejant el teu trànsit

Si cap d'aquests s'aplica, el codi pot tenir un defecte subtil de producció. La solució més ràpida és regenerar el codi des d'un proveïdor conegut com a bo i reimprimir.

Crea un nou codi QR dinàmic