Digital Link

Por que o meu GS1 Digital Link não resolve? Causas e soluções

Paula Rivero

Por Paula Rivero

Cofundadora e CEO da Digital Link, focada em padrões GS1 e conformidade de embalagens na UE.

Uma embalagem flexível de produto com um QR code no centro, ladeada por um ícone de leitor de caixa contando vendas e um ícone de celular contando leituras

Fatos principais

  • Um GS1 Digital Link resolve quando a leitura de um celular chega a um resolver que reconhece os identificadores da URL e redireciona para uma página ativa. Quando falha, a causa quase sempre está em um de quatro pontos: o código impresso, a sintaxe da URL, o domínio ou o registro do produto no resolver.
  • O caixa lê a identidade do produto no próprio código, sem internet. Por isso um código pode registrar a venda no caixa e ainda assim falhar nos celulares: isso aponta para o domínio ou para o resolver, nunca para o GTIN.
  • Comece decodificando o código para ler a URL exata, sem abri-la. A maioria dos problemas aparece nessa única linha.
  • Na Digital Link Connexum, a plataforma por trás deste site, um subdomínio personalizado precisa de um registro CNAME apontando para whitelabel.digitallink.ai e de uma etapa final com o suporte, e os GTINs são validados quando cada link é criado.

"Não resolve" abrange várias falhas diferentes, e cada uma tem uma solução diferente. A tabela abaixo relaciona o que você vê à causa provável. Os seis passos que vêm depois encontram a causa em poucos minutos, em ordem da verificação mais barata para a mais trabalhosa.

Sintoma, causa e solução

O que você vêCausa provávelSolução
A câmera do celular não reage ao códigoUm problema de leitura, não de resolução: tamanho, zona de silêncio, contraste ou danos na impressãoConfira a impressão com o guia de legibilidade
"Servidor não encontrado" ou um erro de DNSO domínio ou subdomínio da URL não está configurado, ou o seu registro DNS está erradoCorrija o registro DNS (passo 3) e espere a propagação
Um alerta de segurança ou de certificadoAinda não foi emitido um certificado HTTPS para o domínio personalizadoConclua a configuração do domínio com o seu fornecedor de resolver
Uma página "não encontrado" do resolverO resolver não tem registro para esse GTIN, ou o GTIN na URL tem um erro de digitaçãoCadastre o produto no resolver, ou corrija o código (passo 4)
Alguns itens abrem, outros do mesmo produto nãoO código carrega um lote ou número de série sem registro, e o resolver não recorre ao nível de produtoCadastre os lotes, ou defina um destino padrão no nível do GTIN
Abre, mas na página erradaO destino padrão está desatualizado, ou o código foi impresso a partir de uma versão anteriorDecodifique o código (passo 1) e atualize o destino
Abre no idioma erradoNão há versões por idioma configuradas no resolverAcrescente as versões por idioma do destino
Registra a venda no caixa, mas falha nos celularesA identidade no código está correta; o lado web (domínio ou resolver) está com problemaVá direto aos passos 3 e 4
Funciona nos celulares, mas o caixa não lêO caixa não está preparado para 2D, ou não está configurado para interpretar GS1 Digital LinkFale com o varejista e, enquanto isso, mantenha o código de barras linear (veja o guia do código duplo)
  1. Decodifique o código e copie a URL. Use um app leitor que mostre o conteúdo do código em vez de abri-lo, ou a pré-visualização que a câmera do celular exibe. Compare-a caractere por caractere com o link que você pretendia imprimir: um código impresso a partir de um arquivo antigo é uma das causas mais comuns.
  2. Verifique a sintaxe da URL. O endereço deve começar com https://, seguido do seu domínio, depois /01/ e o GTIN no formato de 14 dígitos, com os GTINs mais curtos completados com zeros à esquerda e um dígito verificador válido. Os qualificadores vêm em uma ordem fixa, /10/ (lote) antes de /21/ (número de série), e atributos como a data de validade, 17, vão na query string depois de ?, não no caminho. O guia de tecnologia traz as regras completas.
  3. Abra o domínio em um navegador no computador. Cole a URL. Se o navegador não encontrar o servidor ou mostrar um alerta de certificado, o problema é o domínio: no caso de um subdomínio personalizado, verifique se o registro DNS existe e aponta para onde o seu fornecedor indica, e se a configuração foi concluída.
  4. Verifique o registro no resolver. Procure o GTIN no seu resolver. Ele precisa de um registro ativo com um destino padrão. Se o código carrega um lote ou um número de série, esse nível também precisa de um registro, ou o resolver precisa recorrer ao nível de produto. O guia do resolver explica como esse roteamento funciona.
  5. Verifique a página de destino. Se o redirecionamento funciona mas a página falha, o problema é a própria página: uma página excluída, uma campanha encerrada ou uma página atrás de um login.
  6. Leia a partir da embalagem, em vários dispositivos. Quando a URL abrir no navegador, leia o código impresso em dois ou três celulares e, se puder, em um leitor de caixa 2D. Se os celulares continuarem sem reagir, é um problema de impressão, não de resolução.

Algumas causas são específicas da forma como a plataforma é configurada:

  • Subdomínio personalizado. Os códigos no seu próprio subdomínio, como qr.yourbrand.com, precisam de um registro CNAME apontando para whitelabel.digitallink.ai. O domínio raiz (yourbrand.com) e o www não podem ser usados. Depois de acrescentar o registro, entre em contato com o suporte para concluir a configuração, incluindo o certificado. O artigo da central de ajuda traz os passos exatos.
  • Erros de GTIN. A plataforma valida cada GTIN quando um link é criado, então um número inválido é detectado antes da impressão. Se um código impresso carrega um GTIN que a plataforma nunca aceitou, o código foi gerado em outro lugar.
  • Destinos. Todo link é dinâmico: você pode mudar o destino, acrescentar versões por idioma ou definir uma página de recall sem reimprimir.

Se nenhum dos passos encontrar a causa, escreva para support@digital-link.com com a URL decodificada e uma foto do código impresso.

Perguntas frequentes

Porque o caixa lê o GTIN direto do código, sem internet, enquanto o celular precisa chegar ao seu domínio e ao seu resolver. Se o caixa funciona e os celulares não, o código está correto e o problema está no lado web: o domínio, o seu certificado ou o registro no resolver.

Normalmente porque o destino padrão no resolver está desatualizado, ou porque o código impresso carrega uma URL diferente daquela que você está editando. Decodifique o código para ver a URL exata e depois atualize o destino desse GTIN.

Use o formato de 14 dígitos. Um GTIN-8, GTIN-12 ou GTIN-13 é completado com zeros à esquerda até 14 dígitos na URL, e o último dígito deve ser um dígito verificador válido.

Sim, desde que a URL no código esteja correta: o domínio, o registro no resolver e o destino podem ser corrigidos depois da impressão. A reimpressão só é necessária quando o próprio código carrega um domínio errado, um GTIN errado ou uma sintaxe inválida.

Porque o código carrega um lote ou um número de série para o qual o resolver não tem registro, e ele não está configurado para recorrer ao nível de produto. Cadastre os lotes, ou defina um destino padrão no nível do GTIN.

Seja líder na transição dos códigos de barras para os QR codes GS1