TL;DR
- Um resolver GS1 Digital Link é o serviço web por trás do domínio de um GS1 Digital Link. Ele lê os identificadores de um endereço escaneado e envia o leitor ao destino certo: uma página de produto, um aviso de recall, um manual ou dados legíveis por máquina.
- Ele responde a três tipos de solicitação: uma leitura simples vai para o link padrão, uma solicitação de um tipo de link específico vai para esse link, e uma solicitação do linkset devolve todos os links que ele guarda para o produto.
- Os resolvers podem ser operados por marcas, organizações membro da GS1, varejistas ou fornecedores de soluções. Como cada um é independente e segue o mesmo padrão da GS1, qualquer app conforme pode usar qualquer resolver.
Um resolver GS1 Digital Link é um servidor web que conecta um identificador GS1, como o GTIN de um produto, às informações sobre ele na internet. Quando um celular lê um QR code GS1 Digital Link, a solicitação vai para o resolver no domínio do código. O resolver verifica o endereço, encontra os links guardados para aquele produto, lote ou item e redireciona para o que corresponde à solicitação. É isso que permite que um único código atenda compradores, parceiros comerciais e sistemas, cada um com algo diferente.
O resolver em resumo
| O que é | Um servidor web que resolve identificadores GS1 para recursos online |
| Entrada | Uma URI GS1 Digital Link: domínio, chave primária, qualificadores e atributos |
| Saída | Um redirecionamento para um destino, uma lista de links ou um erro explicando por que não há nenhum |
| Quem opera | Marcas, organizações membro da GS1, varejistas ou fornecedores de soluções |
| Padrão | A especificação da GS1 para resolvers conformes, ao lado da sintaxe de URI GS1 Digital Link |
| Protocolo | HTTPS, respondendo a solicitações GET, HEAD e OPTIONS, com CORS para que apps web possam consultá-lo |
As três formas de consultar um resolver
| Solicitação | O que o resolver faz | Leitor típico |
|---|---|---|
| Uma leitura simples do endereço | Redireciona para o link padrão, normalmente a página do produto | O celular de um comprador |
O endereço com um parâmetro linkType, como ?linkType=gs1:recallStatus | Redireciona para o link desse tipo, se houver um | Um app ou um parceiro comercial em busca de algo específico |
O endereço com linkType=linkset | Devolve a lista completa de links que guarda para esse identificador, em formato legível por máquina | Sistemas e apps que querem descobrir tudo o que está disponível |
Os links também podem ser escolhidos por idioma e por contexto. Um comprador na França pode ser enviado à página em francês e um comprador na Alemanha à página em alemão, a partir do mesmo código.
O que um resolver faz com cada solicitação
- Descompactar. Se o código carregar a forma compactada que o padrão permite para símbolos pequenos, o resolver a expande.
- Validar. Ele verifica a sintaxe: uma chave primária GS1 válida, qualificadores de chave na ordem certa e atributos de dados válidos.
- Procurar. Ele encontra os links guardados para esse identificador, no nível mais específico que tiver: item, lote ou produto.
- Escolher. Ele seleciona o link que corresponde à solicitação: o link padrão, o tipo de link solicitado ou o linkset.
- Responder. Ele devolve um redirecionamento, a lista de links ou um erro com uma explicação.
Os metadados guardados com cada link
| Atributo | Obrigatório | Exemplo |
|---|---|---|
| URL de destino | Sim | O endereço de uma página sobre esse produto, não uma página inicial nem resultados de busca |
| Tipo de link | Sim | Uma página de informações do produto, gs1:pip |
| Título | Sim | "Informações do produto", exibido quando um app lista as opções |
| Idioma | Não | en, fr, de |
| Tipo de mídia | Não | text/html para uma página, application/json para dados |
| Contexto | Não | Um território ou um uso, para roteamento por mercado |
Um destino pode ter mais de um tipo de link quando uma única página cumpre várias funções, por exemplo uma página de produto que também mostra informações sobre alergênicos.
Como um resolver responde
| Situação | Resposta |
|---|---|
| Existe um link correspondente | Um redirecionamento para ele (307 Temporary Redirect), com o linkset exposto no cabeçalho HTTP Link |
| O resolver não tem informações, mas outro resolver pode ter | Um redirecionamento para o resolver alternativo (307) |
| O resolver não tem informações | 404 Not Found |
| O resolver sabe por que não pode atender o identificador | 303 See Other, apontando para uma explicação |
| O endereço está malformado | Uma resposta de erro que diz o que está errado |
Os valores da query string do endereço original, como a data de validade, são repassados sem alteração quando o resolver redireciona. Cada redirecionamento extra acrescenta tempo de espera para quem escaneia, por isso as cadeias de resolvers devem ser curtas.
Como configurar um resolver GS1 Digital Link: cinco passos
- Escolha o domínio. Um subdomínio próprio, como
id.yourbrand.com, mantém os códigos como seus seja qual for o fornecedor que opera o resolver, e mostra a sua marca aos compradores no endereço. - Desenvolva o seu ou use um fornecedor. Qualquer pessoa pode desenvolver um resolver conforme com tempo e engenharia suficientes. Um fornecedor entrega um pronto para usar. Em qualquer caso, verifique se ele segue o padrão de resolver da GS1, para que qualquer app conforme consiga ler os seus códigos.
- Carregue os seus produtos e os links padrão. Acrescente cada GTIN com o seu destino padrão, e acrescente registros no nível de lote ou de item onde precisar de destinos diferentes, por exemplo para um recall.
- Acrescente tipos de link, idiomas e contexto. Dê a cada link o seu tipo e título, acrescente versões por idioma e faça o roteamento por mercado onde o conteúdo for diferente.
- Teste todos os caminhos. Verifique uma leitura simples, uma solicitação de cada tipo de link, o linkset, um GTIN desconhecido e um endereço malformado, e depois monitore as leituras após o lançamento. O guia de solução de problemas explica o que verificar quando um código não abre.
O resolver na plataforma Digital Link
A Digital Link, a plataforma por trás deste site, opera um resolver conforme à GS1 para os seus códigos, no domínio dela ou no seu subdomínio por meio de um registro CNAME. Cada produto recebe um destino padrão, com versões por idioma e país, e variantes para lotes ou itens. Todo link pode ser alterado a qualquer momento sem reimpressão.
Crie o seu primeiro QR code GS1 Digital Link
Perguntas frequentes
O que é um resolver GS1 Digital Link?
O serviço web por trás do domínio de um GS1 Digital Link. Ele lê os identificadores de um endereço escaneado, encontra os links guardados para aquele produto, lote ou item e redireciona para o destino que corresponde à solicitação.
Quem opera os resolvers GS1 Digital Link?
Marcas, organizações membro da GS1, varejistas e fornecedores de soluções podem operar um. Cada um é independente e, como todos seguem o mesmo padrão da GS1, um app pode consultar qualquer um deles.
O que é um tipo de link?
A categoria de um destino que um resolver pode oferecer para um produto, como a página de informações do produto, gs1:pip, ou o status de recall, gs1:recallStatus. Um app pede um tipo de link para obter um recurso específico em vez da página padrão.
O que é um linkset?
A lista completa de links que um resolver guarda para um identificador, devolvida em formato legível por máquina quando um app pede linkType=linkset. Ela permite que os sistemas descubram tudo o que está disponível sobre um produto.
Preciso do meu próprio resolver?
Você precisa de um resolver conforme por trás dos seus códigos, mas não necessariamente de um que você mesmo tenha desenvolvido. A maioria das marcas usa um fornecedor e coloca os códigos no próprio subdomínio, para que continuem sendo delas.
O caixa usa o resolver?
Não. Um caixa preparado para 2D lê o GTIN, o lote e a data de validade direto do código, sem internet. Só os celulares e os apps que abrem o endereço chegam ao resolver.
