QR codes do DPP: dimensionamento, correção de erros e GS1 (um guia para programadores)

O QR code de um Passaporte Digital de Produto não é um QR qualquer — transporta um GS1 Digital Link, tem de sobreviver à impressão num produto e tem de resolver para o passaporte. Os detalhes de engenharia que a maioria dos guias ignora, com código de geração pronto a imprimir.

por QR3 Redaktion

QR codes do DPP: dimensionamento, correção de erros e GS1 (um guia para programadores)

O QR code de um Passaporte Digital de Produto parece um quadrado preto e branco como qualquer outro. Não é. Tem de transportar um GS1 Digital Link, sobreviver a ser impresso em pequeno num produto curvo e suscetível a riscos, e resolver de forma fiável para o passaporte durante toda a vida do produto. Eis o que realmente importa quando se gera um — as partes que a maioria dos artigos sobre "QR codes do DPP" ignora.

Um QR de DPP codifica um URL GS1 estruturado, não example.com/product/123:

https://id.gs1.org/01/04019999999902/21/DEMO-BAT-01

01 é o GTIN, 21 o número de série. Qualquer câmara o abre; um resolver devolve a representação correta consoante quem o chama (ver O GS1 Digital Link Resolver, explicado). Aponte o QR para o seu resolver e o GTIN/número de série mantêm-se estáveis para sempre.

Nível de correção de erros: escolha Q ou H para produtos

Os QR codes têm quatro níveis de correção de erros — quanto mais alto, maior a parte do símbolo que pode estar danificada e ainda assim ser legível:

Nível Recuperação Usar num DPP?
L ~7 % Não — demasiado frágil em produtos físicos
M ~15 % Apenas web/ecrã
Q ~25 % Sim — etiquetas, embalagens
H ~30 % Sim — produtos pequenos, curvos ou de desgaste intenso

Uma etiqueta de passaporte pode ficar riscada, dobrada à volta de uma célula de bateria ou parcialmente desgastada. Use Q ou H para que continue legível após um ano de uso em campo. Maior correção significa um símbolo mais denso, por isso equilibre com o tamanho de impressão.

Zona de silêncio e tamanho mínimo de impressão

  • Zona de silêncio: mantenha uma margem livre de pelo menos 4 módulos à volta do símbolo. Sem logótipos, sem texto dentro dela.
  • Tamanho mínimo: como regra prática, o tamanho do módulo deve ser ≥ 0,33 mm para leituras de perto com telemóvel; maior se for lido à distância. Numa impressora de etiquetas típica de 300 DPI, isso corresponde aproximadamente a um símbolo de 2 × 2 cm para um Digital Link com número de série — confirme com o seu pior cenário de scanner e iluminação.

Dinâmico, não estático — ou não é conforme

Um QR estático embute os dados no próprio símbolo. Os dados de um DPP mudam ao longo da vida do produto (pegada de carbono remedida, meta de conteúdo reciclado atingida, informação de reparação atualizada). Se os dados estiverem embutidos, não os pode atualizar sem reimprimir todas as etiquetas — e um passaporte desatualizado não é conforme.

Por isso, um QR de DPP tem de ser dinâmico: transporta um URL de resolver estável (GTIN/número de série imutáveis), e os dados por detrás dele são atualizados via API. Imprima uma vez, atualize para sempre.

Gerar um QR de DPP pronto a imprimir (código)

Criar um passaporte devolve o QR em quatro formatos — sem qualquer passo de QR à parte:

import { QR3 } from "@qr3/sdk";

const client = new QR3({ apiKey: process.env.QR3_API_KEY! });

const passport = await client.dpp.create({
  gtin: "04019999999902",
  serial: "SN-00012345",
  product_name: "PowerCell 5 kWh LFP",
  manufacturer: "ExampleTech GmbH",
  origin_country: "DE",
  category: "battery",
  battery_data: { capacity_kwh: 5, carbon_footprint_kg: 62, recycled_content_pct: 12, recyclability_pct: 95, manufacturer_warranty_years: 8 },
});

console.log(passport.qr.svg); // vetor — escala para qualquer tamanho de etiqueta, sem pixelização
console.log(passport.qr.pdf); // PDF CMYK para impressão
// qr.png para a web, qr.eps para impressoras de etiquetas profissionais

Use SVG ou EPS para etiquetas (o vetor sobrevive a qualquer escalamento); PNG para a web. O QR já codifica o GS1 Digital Link para o passaporte.

Produtos minúsculos: GS1 Data Matrix

Quando não há espaço para um QR (pequenos componentes eletrónicos, joalharia), uma GS1 Data Matrix transporta o mesmo Digital Link em menos espaço e é suportada pelos mesmos standards. Mesmo URL, símbolo mais pequeno.

FAQ

Posso adicionar o meu logótipo ao centro? Sim, dentro do orçamento de correção de erros — ao nível Q/H um pequeno logótipo centrado é recuperável. Mantenha a zona de silêncio livre e faça testes de leitura.

O QR contém os próprios dados do produto? Não — contém o GS1 Digital Link. Os dados vivem por detrás do resolver e mantêm-se atualizáveis. É isso que torna o passaporte durável.

SVG ou PNG para etiquetas? SVG/EPS (vetor) para tudo o que for impresso — escala de forma limpa para qualquer tamanho. PNG apenas para uso web de tamanho fixo.

Fontes

Comece gratuitamente e gere um QR de DPP pronto a imprimir: app.qr3.app/sign-up