Resolvedor GS1 Digital Link: como funciona

O que é um resolvedor GS1 Digital Link

Um resolvedor GS1 Digital Link é um serviço web que funciona como intermediário inteligente entre um identificador de produto e a informação associada a esse produto. Quando um consumidor lê um código QR num produto, ou quando um sistema consulta o identificador de um produto de forma automatizada, o resolvedor recebe o URI GS1 Digital Link e determina para onde encaminhar o pedido com base na identidade do produto, no tipo de informação solicitada e no contexto do pedido.

Pense num resolvedor como uma sinalização inteligente para a informação de produto. Tal como um servidor DNS traduz nomes de domínio em endereços IP, um resolvedor Digital Link traduz identificadores de produto nos URL onde se encontra a informação do produto, incluindo os dados do passaporte digital do produto. Esta indireção é de importância crucial, pois dissocia o identificador permanente do produto da localização, potencialmente variável, dos dados do produto.

Nos passaportes digitais dos produtos previstos no ESPR, o resolvedor desempenha um papel central. O suporte de dados aposto no produto codifica um URI GS1 Digital Link. Quando lido, este URI chega a um resolvedor, que redireciona o pedido para a fonte de dados do DPP. Se a plataforma DPP mudar, ou se os dados forem transferidos para um novo alojamento, basta atualizar a configuração do resolvedor: os milhões de códigos QR já impressos nos produtos continuam a funcionar corretamente.

A arquitetura de um resolvedor Digital Link

Um resolvedor GS1 Digital Link é composto por vários componentes lógicos que trabalham em conjunto para processar os pedidos recebidos e fornecer as respostas adequadas.

O analisador de URI é o primeiro componente a processar um pedido recebido. Extrai do URI Digital Link os identificadores GS1: o identificador principal (normalmente um GTIN), eventuais qualificadores (número de série, número de lote) e quaisquer atributos adicionais. Verifica se o URI está em conformidade com a especificação de sintaxe GS1 Digital Link e rejeita os pedidos mal formados.

O motor de resolução de ligações é o núcleo do resolvedor. Mantém uma base de dados de registos de ligações, ou seja, correspondências entre identificadores de produto e os URL onde se encontra informação sobre esses produtos. Cada registo especifica o identificador de produto a que se aplica, o tipo de informação disponível (página do produto, passaporte digital do produto, dados de segurança, informação sobre recolhas), o URL de destino e as condições que determinam quando essa ligação deve ser utilizada.

O módulo de negociação de conteúdo analisa o pedido recebido para determinar que tipo de resposta o requerente espera. Para isso, recorre aos cabeçalhos HTTP Accept, aos parâmetros de consulta ou à própria estrutura do URI. Um navegador web que solicita text/html recebe um redirecionamento para uma página legível por pessoas. Uma máquina que solicita application/json recebe dados estruturados. Um sistema que solicita application/ld+json recebe dados ligados em JSON-LD. Esta abordagem de um único URI com múltiplas representações é fundamental na arquitetura Digital Link.

O módulo de resposta gera a resposta HTTP adequada, normalmente um 307 (Temporary Redirect) que envia o requerente para o URL de destino identificado pelo motor de resolução de ligações. Nos pedidos de API, o resolvedor pode, em vez de redirecionar, devolver um linkset (um documento JSON que enumera todos os recursos de informação disponíveis para o produto identificado).

Como funciona a resolução, passo a passo

Para compreender como funciona na prática um resolvedor Digital Link, considere o seguinte cenário: um consumidor lê um código QR num produto. O código QR codifica o URI https://resolver.example.com/01/05012345678901/21/SN12345.

Primeiro, o smartphone do consumidor descodifica o código QR e abre o URI num navegador web. O navegador envia um pedido HTTP GET para resolver.example.com com o caminho /01/05012345678901/21/SN12345. O pedido inclui um cabeçalho Accept que indica que o navegador prefere conteúdo text/html.

O analisador de URI do resolvedor extrai do caminho o GTIN (05012345678901) e o número de série (SN12345). Valida estes identificadores e transmite-os ao motor de resolução de ligações.

O motor de resolução de ligações procura a combinação de identificadores na sua base de dados e encontra vários registos de ligações para este produto:

• Uma ligação para o passaporte digital do produto que aponta para https://dpp.example.com/passport/SN12345
• Uma ligação para a página de informação do produto que aponta para https://brand.example.com/products/widget-pro
• Uma ligação para informação sobre recolhas que aponta para https://recalls.example.com/check/05012345678901
• Um ponto de acesso de dados ligados JSON-LD que aponta para https://api.example.com/01/05012345678901/21/SN12345

O módulo de negociação de conteúdo verifica que o pedido provém de um navegador web que solicita HTML. Com base no tipo de ligação predefinido configurado no resolvedor e no contexto do pedido, seleciona a ligação para o passaporte digital do produto como a resposta mais adequada para um consumidor que lê um código QR.

O resolvedor devolve uma resposta 307 Temporary Redirect com o cabeçalho Location definido como https://dpp.example.com/passport/SN12345. O navegador do consumidor segue o redirecionamento e apresenta a página do passaporte digital do produto.

Tipos de ligação e o quadro de conformidade GS1

A GS1 define um vocabulário de tipos de ligação que os resolvedores utilizam para categorizar os recursos de informação associados aos produtos. Estes tipos de ligação normalizados garantem que diferentes resolvedores proporcionam experiências coerentes e que os sistemas consumidores podem solicitar de forma fiável tipos específicos de informação.

Os principais tipos de ligação relevantes para os passaportes digitais dos produtos incluem:

• gs1:digitalProductPassport, o recurso principal de dados do DPP, que contém a informação completa do passaporte exigida pelo ESPR
• gs1:productSustainabilityInfo, informação ambiental e de sustentabilidade sobre o produto
• gs1:pip, a página de informação do produto, normalmente a página web do produto da marca destinada aos consumidores
• gs1:safetyInfo, informação relacionada com a segurança, incluindo fichas de dados de segurança e advertências de perigo
• gs1:recallStatus, informação sobre se o produto está sujeito a uma recolha
• gs1:traceability, informação sobre a rastreabilidade na cadeia de abastecimento, possivelmente com ligação a dados de eventos EPCIS
• gs1:certificationInfo, certificados e declarações de conformidade associados ao produto

A GS1 publicou um quadro de conformidade para resolvedores Digital Link que define diferentes níveis de capacidade. Os resolvedores de nível 0 efetuam redirecionamentos HTTP básicos. Os de nível 1 suportam a negociação de conteúdo. Os de nível 2 suportam a API de linkset completa, permitindo às máquinas descobrir todos os recursos de informação disponíveis para um produto. Os de nível 3 acrescentam suporte para URI Digital Link comprimidos e outras funcionalidades avançadas.

Nas implementações de DPP, recomenda-se um resolvedor de nível 1 ou 2. A negociação de conteúdo (nível 1) garante que tanto os utilizadores humanos como os sistemas automáticos recebem respostas adequadas. A API de linkset (nível 2) permite aos sistemas das autoridades e aos registos DPP descobrir e aceder de forma automatizada aos dados do passaporte de qualquer produto.

Opções de implementação: desenvolver, adquirir ou usar a GS1

As empresas que implementam DPP têm três opções principais para a infraestrutura de resolução Digital Link: desenvolver um resolvedor próprio, utilizar um serviço de resolução comercial ou recorrer à rede de resolvedores da GS1.

Desenvolver um resolvedor próprio oferece o máximo controlo sobre a lógica de resolução, a imagem de marca e a integração com os sistemas existentes. A GS1 publicou implementações de referência em código aberto que podem servir de ponto de partida. No entanto, operar um resolvedor em grande escala exige uma infraestrutura web robusta, monitorização e manutenção contínua. O resolvedor tem de ter elevada disponibilidade: se falhar, todos os códigos QR que apontam para ele deixam de funcionar.

Os serviços de resolução comerciais, oferecidos por vários fornecedores de tecnologia, incluindo plataformas DPP, disponibilizam uma infraestrutura de resolução gerida sem o encargo operacional. Estes serviços oferecem normalmente interfaces de administração web para gerir os registos de ligações, painéis de análise da atividade de leitura e API de integração para a gestão automatizada de ligações. Para a maioria das empresas, um serviço de resolução gerido oferece o melhor equilíbrio entre funcionalidade e simplicidade operacional.

A rede de resolvedores da GS1 (id.gs1.org) é um serviço de resolução global mantido pela própria GS1. Os titulares de marcas podem registar os seus produtos e configurar os destinos de resolução através da sua organização-membro da GS1. Esta abordagem tira partido do reconhecimento e da confiança mundiais do domínio GS1, mas pode oferecer menos flexibilidade de personalização e de imagem de marca do que operar um domínio de resolução próprio.

Muitas plataformas DPP, incluindo a MyProductPassport, incluem funcionalidade de resolução integrada na sua oferta. Graças a esta abordagem integrada, as empresas não precisam de montar uma infraestrutura de resolução separada: a plataforma trata da resolução de URI, da negociação de conteúdo e da gestão de ligações, a par da gestão dos dados do passaporte e da geração de códigos QR.

Configuração do resolvedor para a conformidade do DPP

Configurar um resolvedor para passaportes digitais dos produtos conformes com o ESPR exige atenção a vários requisitos regulamentares e técnicos.

O resolvedor tem de garantir o acesso persistente aos dados do passaporte. O ESPR exige que a informação do DPP permaneça acessível durante um período definido após a colocação de um produto no mercado. Assim, o resolvedor tem de continuar a funcionar e a resolver pedidos durante todo esse período de conservação, mesmo que o produto tenha sido descontinuado. As empresas devem assegurar que a sua infraestrutura de resolução ou o seu prestador de serviços se compromete com os períodos de conservação exigidos.

As respostas do resolvedor devem incluir os cabeçalhos HTTP adequados para cache e CORS (Cross-Origin Resource Sharing), de modo que os dados do DPP possam ser acedidos a partir de aplicações web, aplicações móveis e sistemas das autoridades. O cabeçalho Link deve anunciar os tipos de ligação disponíveis, permitindo a descoberta de recursos de informação de forma nativa em HTTP.

Nos produtos com identificação ao nível do número de série, o resolvedor tem de tratar os qualificadores de número de série no caminho do URI. Isto significa que a base de dados de ligações tem de conter registos ao nível do número de série (ou suportar correspondência por carateres universais que encaminhe os pedidos específicos de cada número de série para a instância correta do passaporte). Nos produtos identificados ao nível do lote, o resolvedor tem igualmente de tratar os qualificadores de lote.

A segurança é um aspeto importante na implementação de um resolvedor. O resolvedor deve utilizar exclusivamente HTTPS, aplicar limitação de pedidos para evitar abusos e prever autenticação para as funções administrativas. Embora a resolução em si deva ser acessível ao público (para permitir o acesso aberto aos dados do DPP pretendido pelo ESPR), a interface de gestão tem de estar protegida.

Funcionalidades avançadas dos resolvedores para ecossistemas DPP

Para além da resolução básica, várias funcionalidades avançadas enriquecem o ecossistema DPP:

• Análise e acompanhamento de leituras: os resolvedores podem registar os eventos de leitura, dando às marcas informação sobre onde, quando e com que frequência os passaportes dos seus produtos são consultados
• Resolução baseada na geolocalização: os resolvedores podem encaminhar os pedidos para conteúdos do passaporte específicos de um idioma ou região com base na localização do requerente
• Resolução temporal: os resolvedores podem manter versões históricas dos registos de ligações, permitindo aceder aos dados do passaporte tal como existiam num determinado momento
• Resolução alternativa: os resolvedores podem aplicar uma lógica de resolução em cascata, tentando sucessivamente várias fontes de dados se a fonte principal estiver indisponível
• Suporte de URI comprimidos: o GS1 Digital Link define formatos de URI comprimidos que reduzem a densidade de dados exigida aos códigos QR, permitindo códigos mais pequenos ou uma correção de erros mais elevada

Estas funcionalidades não são necessárias para a conformidade básica com o ESPR, mas podem melhorar significativamente a usabilidade e a fiabilidade das implementações de DPP. A análise das leituras, por exemplo, fornece informação de mercado valiosa sobre o interesse dos consumidores pela informação de sustentabilidade, ajudando as empresas a compreender o retorno do seu investimento no DPP.

À medida que o ecossistema DPP amadurece, as capacidades dos resolvedores deverão continuar a expandir-se. O registo DPP da Comissão Europeia, em funcionamento desde 20 de julho de 2026, interage com os resolvedores para indexar e aceder aos dados dos passaportes em todo o mercado da UE. Os operadores de resolvedores devem acompanhar esta evolução e garantir que as suas implementações se mantêm compatíveis com requisitos de infraestrutura em evolução.

Testar e validar a implementação do seu resolvedor

Antes de colocar um resolvedor em produção, é essencial realizar testes exaustivos para garantir a conformidade com as especificações GS1 e um funcionamento fiável em condições reais.

A GS1 disponibiliza conjuntos de testes de conformidade que validam o comportamento do resolvedor face à especificação Digital Link. Estes testes verificam a análise correta dos URI, os códigos de resposta HTTP adequados, a exatidão da negociação de conteúdo e a geração conforme de linksets. Executar estes testes na sua implementação permite identificar desvios à especificação antes que causem problemas com produtos e consumidores reais.

Os testes de carga são igualmente importantes. O resolvedor de uma marca de consumo de grande volume pode ter de processar milhares de pedidos por segundo em períodos de pico: um lançamento de produto, um momento viral nas redes sociais ou uma campanha de inspeção das autoridades. Conhecer os limites de capacidade do seu resolvedor e aplicar estratégias de escalabilidade adequadas (cache, balanceamento de carga, distribuição por CDN) garante um desempenho consistente.

Os testes ponta a ponta devem verificar toda a cadeia, desde a leitura do código QR até à apresentação do passaporte. Isto implica imprimir fisicamente códigos QR, lê-los com diferentes modelos de smartphone e sistemas operativos e confirmar que o resolvedor encaminha corretamente cada pedido para o conteúdo do passaporte adequado. Testar tanto com dispositivos de consumo como com clientes automatizados garante que todos os percursos de acesso funcionam corretamente.

Por fim, devem ser implementadas monitorização e alertas para a infraestrutura de resolução em produção. A monitorização da disponibilidade, o acompanhamento dos tempos de resposta e os alertas sobre taxas de erro permitem detetar e resolver rapidamente problemas que possam impedir os consumidores e as autoridades de aceder aos dados do passaporte digital do produto.