--- title: "O Resolver GS1 Digital Link, explicado (com um exemplo ao vivo) — qr3.app Blog" description: "Um código QR de DPP não é um link para uma página web — é um GS1 Digital Link, e o resolver transforma um identificador em muitas respostas sensíveis ao contexto. Eis como funciona, com um passaporte ao vivo que pode consultar via curl agora mesmo." canonical: "https://qr3.app/pt/blog/gs1-digital-link-resolver/" lang: "pt" robots: "index,follow,max-image-preview:large,max-snippet:-1" --- # O Resolver GS1 Digital Link, explicado (com um exemplo ao vivo) — qr3.app Blog > Um código QR de DPP não é um link para uma página web — é um GS1 Digital Link, e o resolver transforma um identificador em muitas respostas sensíveis ao contexto. Eis como funciona, com um passaporte ao vivo que pode consultar via curl agora mesmo. Canonical: [← Blog](/pt/blog/) [Tutoriais](/pt/blog/category/tutorials/) 30 de maio de 2026 4 min de leitura [Tutoriais](/pt/blog/category/tutorials/) [gs1-digital-link](/pt/blog/tag/gs1-digital-link/)[resolver](/pt/blog/tag/resolver/)[dpp](/pt/blog/tag/dpp/)[gtin](/pt/blog/tag/gtin/)[json-ld](/pt/blog/tag/json-ld/) # O Resolver GS1 Digital Link, explicado (com um exemplo ao vivo) Um código QR de DPP não é um link para uma página web — é um GS1 Digital Link, e o resolver transforma um identificador em muitas respostas sensíveis ao contexto. Eis como funciona, com um passaporte ao vivo que pode consultar via curl agora mesmo. por **QR3 Redaktion** ![O Resolver GS1 Digital Link, explicado (com um exemplo ao vivo)](https://qr3-blog-agent.meistern.workers.dev/cdn/blog/gs1-digital-link-resolver/hero.png) A maioria das explicações sobre códigos QR de Passaporte Digital de Produto fica-se pelo "leia o código, abra um site". Isso deixa de fora a parte interessante. O código QR de um produto conforme codifica um **GS1 Digital Link**, e o componente que o torna útil é o **resolver** — o serviço que transforma um identificador de produto em muitas respostas diferentes e sensíveis ao contexto. Este artigo mostra o que o resolver faz de facto, com um **passaporte ao vivo que pode chamar agora mesmo** (sem registo, sem chave). ## O que é, de facto, um GS1 Digital Link Um GS1 Digital Link é um URL HTTPS normal que incorpora identificadores GS1 como segmentos de caminho, cada um etiquetado com um **Application Identifier (AI)**: ``` https://id.gs1.org/01/09520000000011/21/DEMO-BAT-01 └─01─┘ └──GTIN───┘ └21┘ └─serial─┘ ``` - `01` → GTIN (Global Trade Item Number) — *que produto* - `21` → número de série — *que unidade individual* - `10` → lote (alternativa ao número de série) Por ser um URL simples, qualquer câmara de telemóvel o abre. Por ser *estruturado*, as máquinas conseguem interpretá-lo. Essa dupla natureza é o cerne de tudo. ## O resolver: um URI, muitas respostas Um código QR sem inteligência devolve uma única página fixa. Um **resolver** inspeciona o pedido e devolve a representação que se adequa a quem chama: - um **consumidor** com um navegador no telemóvel recebe uma página HTML legível por humanos; - o sistema de um **reciclador** pede JSON-LD e recebe dados estruturados legíveis por máquina; - uma **autoridade** pode pedir o *linkset* completo — cada ligação tipada que o produto expõe. O mesmo URL, respostas diferentes, decididas pelo cabeçalho `Accept` (ou por uma substituição `?format=`). ## Um resolver ao vivo que pode chamar agora mesmo A qr3.app aloja um passaporte de bateria de demonstração público. Abra-o num navegador: > **[https://qr3.app/dpp/09520000000011/DEMO-BAT-01](https://qr3.app/dpp/09520000000011/DEMO-BAT-01)** Verá a página de consumidor de *EcoMax 5000 (Demo)* da GreenPower GmbH. Agora peça ao **mesmo URL** JSON-LD legível por máquina: ``` curl "https://qr3.app/dpp/09520000000011/DEMO-BAT-01?format=jsonld" ``` ``` { "@context": ["https://schema.org", "https://gs1.org/voc/"], "@type": "Product", "gtin": "09520000000011", "name": "EcoMax 5000 (Demo)" } ``` É o resolver a fazer o seu trabalho: um identificador, uma página para humanos **e** um documento JSON-LD construído sobre `schema.org` + o vocabulário web da GS1. Outras representações estão disponíveis da mesma forma — `?format=json` (passaporte em bruto), `?format=linkset` (todas as ligações tipadas), `?format=dcat-ap` — ou através da negociação `Accept` padrão (`Accept: application/ld+json`). ## Valide os identificadores antes de criar links Um resolver é tão fiável quanto os identificadores que estão por detrás dele. Valide um GTIN antes de construir um Digital Link para ele: ``` import { QR3 } from "@qr3/sdk"; const client = new QR3({ apiKey: process.env.QR3_API_KEY! }); const result = await client.gs1.validateGs1({ identifier_type: "gtin", value: "09520000000011", }); console.log(result.valid); // true console.log(result.detail); // "Valid GTIN-14" ``` ## Registe os seus GTIN Mantenha sob gestão os identificadores que utiliza, para que cada Digital Link possa ser rastreado até um produto conhecido: ``` const gtin = await client.gs1.createGs1Identifier({ identifier_type: "gtin", // or "gln" | "company_prefix" value: "09520000000011", label: "EcoMax 5000", }); ``` ## Usar a qr3 como o seu resolver Não tem de construir e operar um resolver por conta própria. Aponte o código QR do seu produto para o Digital Link, aloje o passaporte na qr3.app, e o resolver serve a representação certa por pedido. O GTIN/número de série no URL permanecem **estáveis para sempre** (para que as etiquetas impressas nunca deixem de funcionar), enquanto os dados por detrás deles continuam atualizáveis. ## FAQ **O próprio código QR é diferente de um normal?** Não — é um QR padrão (ou Data Matrix) que transporta um URL GS1 Digital Link. Qualquer câmara o abre; a inteligência está no resolver, não no símbolo. **Os consumidores e os recicladores recebem mesmo conteúdo diferente?** Sim — isso é negociação de conteúdo. O navegador recebe HTML; um sistema que pede `application/ld+json` (ou `?format=jsonld`) recebe dados estruturados a partir do mesmo URL. **Posso manter a minha própria página de produto e continuar conforme?** Sim. O Digital Link pode expor várias ligações tipadas (um `linkset`) — a sua página de marketing, o passaporte oficial, uma ficha técnica de reciclagem — cada uma etiquetada com um tipo de ligação. ## Fontes - [Norma GS1 Digital Link](https://www.gs1.org/standards/gs1-digital-link) - [GS1 Digital Link: Resolver](https://www.gs1.org/standards/resolver) - [ESPR — Regulamento (UE) 2024/1781](https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=CELEX:32024R1781) **Experimente o passaporte ao vivo** acima e depois [comece gratuitamente](https://app.qr3.app/sign-up) e resolva o seu próprio. São demonstrações funcionais com dados de produtos fictícios e GTIN de exemplo do prefixo GS1 952. Não comprovam identificadores de produto atribuídos, inscrição num registo ou certificação. ## Artigos relacionados - [![](https://qr3-blog-agent.meistern.workers.dev/cdn/blog/dpp-json-ld-epcis/hero.png) Tutoriais JSON-LD para Passaportes Digitais de Produto (e onde o EPCIS 2.0 se encaixa) Um DPP só é útil para máquinas se for legível por máquina. Este guia mostra o JSON-LD real que um passaporte qr3 expõe através do resolver ao vivo, como um único URL serve simultaneamente humanos e máquinas por meio de negociação de conteúdo, e onde o padrão complementar de eventos EPCIS 2.0 se encaixa.](/pt/blog/dpp-json-ld-epcis/) - [![](https://qr3-blog-agent.meistern.workers.dev/cdn/blog/gs1-resolver-test-suite-dpp-links/hero.png) Tutoriais Suíte de testes do Resolver GS1: verificar a robustez dos DPP-Links antes do go-live A suíte de testes GS1 estável permite verificar o Resolver 1.2. Teste redirecionamentos, conjuntos de links, CORS, idiomas e casos de erro antes do go-live.](/pt/blog/gs1-resolver-test-suite-dpp-links/) - [![](https://qr3-blog-agent.meistern.workers.dev/cdn/blog/dpp-battery-passport-2027-20260715/hero.png) Notícias do setor BatteryPass-Ready lança ambiente de testes para o Passaporte Digital de Baterias O consórcio BatteryPass-Ready lançou, em 24 de junho de 2026, um ambiente público de testes para o Passaporte Digital de Baterias, tendo em vista a obrigação da UE a partir de fevereiro de 2027.](/pt/blog/dpp-battery-passport-2027-20260715/) - [![](https://qr3-blog-agent.meistern.workers.dev/cdn/blog/sector-20260713/hero.png) Notícias do setor Passaporte Digital de Baterias 2027: o que os fabricantes precisam saber agora Webinars, ferramentas de código aberto e novas normas: o passaporte de baterias da UE ganha impulso. Uma visão geral da situação em julho de 2026 e das questões em aberto até fevereiro de 2027.](/pt/blog/sector-20260713/) [← Todos os artigos](/pt/blog/) [Começar gratuitamente](https://app.qr3.app/sign-up)