QR code per DPP: dimensionamento, correzione degli errori e GS1 (la guida per sviluppatori)

Il QR code di un Passaporto Digitale di Prodotto non è un QR qualunque — contiene un GS1 Digital Link, deve sopravvivere alla stampa su un prodotto e deve risolvere verso il passaporto. I dettagli ingegneristici che la maggior parte delle guide salta, con codice di generazione pronto per la stampa.

di QR3 Redaktion

QR code per DPP: dimensionamento, correzione degli errori e GS1 (la guida per sviluppatori)

Il QR code di un Passaporto Digitale di Prodotto sembra un qualsiasi altro quadrato in bianco e nero. Non lo è. Deve contenere un GS1 Digital Link, sopravvivere a una stampa di piccole dimensioni su un prodotto curvo e soggetto a graffi, e risolvere in modo affidabile verso il passaporto per l'intera vita del prodotto. Ecco ciò che conta davvero quando ne generi uno — gli aspetti che la maggior parte degli articoli sui "QR code per DPP" tralascia.

Un QR per DPP codifica una URL GS1 strutturata, non example.com/product/123:

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

01 è il GTIN, 21 il numero di serie. Qualsiasi fotocamera lo apre; un resolver restituisce la rappresentazione corretta in base a chi effettua la chiamata (vedi Il GS1 Digital Link Resolver, spiegato). Punta il QR verso il tuo resolver e il GTIN/numero di serie rimangono stabili per sempre.

Livello di correzione degli errori: scegli Q o H per i prodotti

I QR code hanno quattro livelli di correzione degli errori — più alto è il livello, maggiore è la porzione del simbolo che può essere danneggiata pur rimanendo scansionabile:

Livello Recupero Da usare per un DPP?
L ~7 % No — troppo fragile sui prodotti fisici
M ~15 % Solo web/schermo
Q ~25 % — etichette, packaging
H ~30 % — prodotti piccoli, curvi o soggetti a usura intensa

Un'etichetta di passaporto può graffiarsi, piegarsi attorno a una cella di batteria o usurarsi parzialmente. Usa Q o H così che resti scansionabile anche dopo un anno sul campo. Una correzione più alta significa un simbolo più denso, quindi bilancia in funzione delle dimensioni di stampa.

Quiet zone e dimensione minima di stampa

  • Quiet zone: mantieni un margine libero di almeno 4 moduli attorno al simbolo. Niente loghi, niente testo al suo interno.
  • Dimensione minima: regola pratica, la dimensione del modulo dovrebbe essere ≥ 0,33 mm per scansioni da smartphone a distanza ravvicinata; più grande se scansionato da lontano. Su una tipica stampante per etichette a 300 DPI ciò corrisponde all'incirca a un simbolo di 2 × 2 cm per un Digital Link con numero di serie — verifica con lo scanner e l'illuminazione peggiori previsti.

Dinamico, non statico — altrimenti non è conforme

Un QR statico incorpora i dati nel simbolo. I dati di un DPP cambiano nel corso della vita del prodotto (impronta di carbonio rimisurata, obiettivo di contenuto riciclato raggiunto, informazioni di riparazione aggiornate). Se i dati sono incorporati, non puoi aggiornarli senza ristampare ogni etichetta — e un passaporto non aggiornato non è conforme.

Quindi un QR per DPP deve essere dinamico: contiene una URL del resolver stabile (GTIN/numero di serie immutabili), e i dati che vi stanno dietro vengono aggiornati tramite API. Stampa una volta, aggiorna per sempre.

Genera un QR per DPP pronto per la stampa (codice)

La creazione di un passaporto restituisce il QR in quattro formati — nessun passaggio QR separato:

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); // vettoriale — si adatta a qualsiasi dimensione di etichetta, senza pixelatura
console.log(passport.qr.pdf); // PDF CMYK per la stampa
// qr.png per il web, qr.eps per stampanti professionali di etichette

Usa SVG o EPS per le etichette (il vettoriale sopravvive a qualsiasi ridimensionamento); PNG per il web. Il QR codifica già il GS1 Digital Link verso il passaporto.

Prodotti minuscoli: GS1 Data Matrix

Quando non c'è spazio per un QR (piccola elettronica, gioielleria), un GS1 Data Matrix contiene lo stesso Digital Link in uno spazio inferiore ed è supportato dagli stessi standard. Stessa URL, simbolo più piccolo.

FAQ

Posso aggiungere il mio logo al centro? Sì, entro il budget della correzione degli errori — al livello Q/H un piccolo logo centrato è recuperabile. Mantieni libera la quiet zone ed esegui una scansione di prova.

Il QR contiene i dati di prodotto stessi? No — contiene il GS1 Digital Link. I dati risiedono dietro al resolver e restano aggiornabili. È questo che rende durevole il passaporto.

SVG o PNG per le etichette? SVG/EPS (vettoriale) per tutto ciò che viene stampato — si adatta in modo pulito a qualsiasi dimensione. PNG solo per l'uso web a dimensione fissa.

Fonti

Inizia gratis e genera un QR per DPP pronto per la stampa: app.qr3.app/sign-up