La maggior parte delle spiegazioni sui QR code dei Digital Product Passport si ferma a "scansiona il codice, apri un sito web". Ma così si perde la parte interessante. Il QR code su un prodotto conforme codifica un GS1 Digital Link, e il componente che lo rende utile è il resolver: il servizio che trasforma un singolo identificativo di prodotto in molte risposte diverse e sensibili al contesto.
Questo articolo mostra cosa fa davvero il resolver, con un passaporto dal vivo che puoi chiamare subito (nessuna registrazione, nessuna chiave).
Che cos'è davvero un GS1 Digital Link
Un GS1 Digital Link è un normale URL HTTPS che incorpora gli identificativi GS1 come segmenti del percorso, ciascuno etichettato con un Application Identifier (AI):
https://id.gs1.org/01/04019999999902/21/DEMO-BAT-01
└─01─┘ └──GTIN───┘ └21┘ └─serial─┘
01→ GTIN (Global Trade Item Number) — quale prodotto21→ numero di serie — quale singola unità10→ lotto/partita (alternativa al numero di serie)
Poiché è un URL semplice, qualsiasi fotocamera di smartphone lo apre. Poiché è strutturato, le macchine possono interpretarlo. Questa duplice natura è proprio il punto centrale.
Il resolver: un URI, molte risposte
Un QR code "stupido" restituisce una sola pagina fissa. Un resolver esamina la richiesta e restituisce la rappresentazione adatta a chi la effettua:
- un consumatore con un browser su smartphone ottiene una pagina HTML leggibile dall'uomo;
- il sistema di un riciclatore richiede il JSON-LD e ottiene dati strutturati leggibili dalle macchine;
- un'autorità può richiedere l'intero linkset, cioè ogni link tipizzato che il prodotto espone.
Stesso URL, risposte diverse, decise dall'header Accept (o da un override ?format=).
Un resolver dal vivo che puoi chiamare subito
qr3.app ospita un passaporto dimostrativo pubblico per una batteria. Aprilo in un browser:
Vedrai la pagina per il consumatore di EcoMax 5000 (Demo) di GreenPower GmbH. Ora chiedi allo stesso URL il JSON-LD leggibile dalle macchine:
curl "https://qr3.app/dpp/04019999999902/DEMO-BAT-01?format=jsonld"
{
"@context": ["https://schema.org", "https://gs1.org/voc/"],
"@type": "Product",
"gtin": "04019999999902",
"name": "EcoMax 5000 (Demo)"
}
Questo è il resolver che fa il suo lavoro: un identificativo, una pagina per l'uomo e un documento JSON-LD costruito su schema.org + il vocabolario web GS1. Altre rappresentazioni sono disponibili nello stesso modo — ?format=json (passaporto grezzo), ?format=linkset (tutti i link tipizzati), ?format=dcat-ap — oppure tramite la negoziazione standard con Accept (Accept: application/ld+json).
Convalida gli identificativi prima di coniare i link
Un resolver è affidabile solo quanto gli identificativi che gli stanno dietro. Convalida un GTIN prima di costruirci un Digital Link:
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: "04019999999902",
});
console.log(result.valid); // true
console.log(result.detail); // "Valid GTIN-14"
Registra i tuoi GTIN
Tieni sotto gestione gli identificativi che usi, così ogni Digital Link risale a un prodotto noto:
const gtin = await client.gs1.createGs1Identifier({
identifier_type: "gtin", // or "gln" | "company_prefix"
value: "04019999999902",
label: "EcoMax 5000",
});
Usare qr3 come resolver
Non devi costruire e gestire tu stesso un resolver. Punta il QR code del tuo prodotto al Digital Link, ospita il passaporto su qr3.app, e il resolver fornisce la rappresentazione giusta per ogni richiesta. Il GTIN/numero di serie nell'URL restano stabili per sempre (così le etichette stampate non si rompono mai), mentre i dati che vi stanno dietro restano aggiornabili.
FAQ
Il QR code in sé è diverso da uno normale? No: è un QR standard (o Data Matrix) che porta un URL GS1 Digital Link. Qualsiasi fotocamera lo apre; l'intelligenza sta nel resolver, non nel simbolo.
Consumatori e riciclatori ricevono davvero contenuti diversi?
Sì, è la negoziazione dei contenuti. Il browser ottiene HTML; un sistema che richiede application/ld+json (o ?format=jsonld) ottiene dati strutturati dallo stesso URL.
Posso mantenere la mia pagina prodotto ed essere comunque conforme?
Sì. Il Digital Link può esporre più link tipizzati (un linkset) — la tua pagina di marketing, il passaporto ufficiale, una scheda dati per il riciclo — ciascuno etichettato con un tipo di link.
Fonti
Prova il passaporto dal vivo qui sopra, poi inizia gratis e risolvi il tuo.
