Pular para o conteúdo
qr3.app Docs

Resolver GS1

Resolver GS1

O Resolver GS1 é a camada de leitura pública para um DPP. O URL canônico tem a seguinte aparência:

https://qr3.app/01/{GTIN}
https://qr3.app/01/{GTIN}/10/{LOT}
https://qr3.app/01/{GTIN}/21/{SERIAL}
https://qr3.app/01/{GTIN}/10/{LOT}/21/{SERIAL}

serial e lot devem usar segmentos de caminho seguros do GS1: apenas A-Z, a-z, 0-9, ., _, ~, - e um comprimento de 1 a 20 caracteres. Separadores de URL reservados são rejeitados para garantir que o link canônico permaneça resolvível.

Negociação de Conteúdo

O mesmo resolver fornece diferentes representações dependendo do cabeçalho Accept:

AcceptResposta
text/htmlHTML do consumidor
application/ld+jsonJSON-LD
application/jsonJSON bruto do DPP
application/linkset+jsonLinkset com alternativas

Rotas publicamente visíveis

  • GET /01/... é o resolver canônico
  • GET /dpp/:gtin/:serial?lot=... é um alias HTML
  • GET /v1/dpp/:id/qr.svg fornece o SVG
  • GET /v1/dpp/:id/qr.png fornece o PNG
  • GET /v1/dpp/:id/qr.pdf fornece o PDF
  • GET /v1/dpp/:id/qr.eps fornece o EPS

A visibilidade dos assets de QR depende do status do DPP:

  • live está disponível publicamente sem autenticação
  • draft e archived precisam de um contexto de autenticação válido e acesso ao Workspace
  • Autenticação inválida retorna 401
  • Workspaces invisíveis ou de terceiros retornam 404

Fallback

Se o qr3.app não encontrar correspondência, ele redirecionará para o Resolver GS1 de nível superior. Isso é importante para garantir que os códigos impressos funcionem mesmo se um produto ainda não estiver registrado localmente.

Na Prática

  1. Criar o DPP no painel (Dashboard).
  2. Usar o URI do GS1 como destino do QR.
  3. Direcionar os sistemas consumidores para o formato desejado usando o cabeçalho Accept.