Majoritatea explicațiilor despre codurile QR pentru Pașaportul Digital al Produsului se opresc la „scanezi codul, deschizi un site web". Asta ratează partea interesantă. Codul QR de pe un produs conform encodează un GS1 Digital Link, iar componenta care îl face util este resolverul — serviciul care transformă un singur identificator de produs în mai multe răspunsuri diferite, sensibile la context.
Acest articol arată ce face efectiv resolverul, cu un pașaport live pe care îl poți apela chiar acum (fără înregistrare, fără cheie).
Ce este de fapt un GS1 Digital Link
Un GS1 Digital Link este un URL HTTPS obișnuit care integrează identificatori GS1 ca segmente de cale, fiecare marcat cu un Application Identifier (AI):
https://id.gs1.org/01/04019999999902/21/DEMO-BAT-01
└─01─┘ └──GTIN───┘ └21┘ └─serial─┘
01→ GTIN (Global Trade Item Number) — care produs21→ serie — care unitate individuală10→ lot/șarjă (alternativă la serie)
Pentru că este un URL simplu, orice cameră de telefon îl deschide. Pentru că este structurat, mașinile îl pot parsa. Această natură duală este întreaga idee.
Resolverul: un singur URI, multe răspunsuri
Un cod QR „prost" returnează o singură pagină fixă. Un resolver inspectează cererea și returnează reprezentarea care se potrivește apelantului:
- un consumator cu un browser de telefon primește o pagină HTML lizibilă pentru oameni;
- sistemul unui reciclator cere JSON-LD și primește date structurate, citibile de mașini;
- o autoritate poate solicita întregul linkset — fiecare link tipizat pe care îl expune produsul.
Același URL, răspunsuri diferite, decise de antetul Accept (sau de o suprascriere ?format=).
Un resolver live pe care îl poți apela chiar acum
qr3.app găzduiește un pașaport demo public pentru o baterie. Deschide-l într-un browser:
Vei vedea pagina pentru consumator pentru EcoMax 5000 (Demo) de la GreenPower GmbH. Acum cere același URL pentru JSON-LD citibil de mașini:
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)"
}
Asta este resolverul care își face treaba: un singur identificator, o pagină pentru oameni și un document JSON-LD construit pe schema.org + vocabularul web GS1. Alte reprezentări sunt disponibile în același mod — ?format=json (pașaport brut), ?format=linkset (toate linkurile tipizate), ?format=dcat-ap — sau prin negociere standard Accept (Accept: application/ld+json).
Validează identificatorii înainte de a genera linkuri
Un resolver este la fel de demn de încredere ca identificatorii din spatele lui. Validează un GTIN înainte de a construi un Digital Link pentru el:
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"
Înregistrează-ți GTIN-urile
Ține sub control identificatorii pe care îi folosești, astfel încât fiecare Digital Link să fie legat de un produs cunoscut:
const gtin = await client.gs1.createGs1Identifier({
identifier_type: "gtin", // or "gln" | "company_prefix"
value: "04019999999902",
label: "EcoMax 5000",
});
Folosirea qr3 ca resolver al tău
Nu trebuie să construiești și să operezi un resolver tu însuți. Direcționează codul QR al produsului tău către Digital Link, găzduiește pașaportul pe qr3.app, iar resolverul servește reprezentarea corectă pentru fiecare cerere. GTIN-ul/seria din URL rămân stabile pentru totdeauna (astfel încât etichetele tipărite nu se strică niciodată), în timp ce datele din spatele lor rămân actualizabile.
Întrebări frecvente
Codul QR în sine este diferit de unul normal? Nu — este un cod QR standard (sau Data Matrix) care poartă un URL GS1 Digital Link. Orice cameră îl deschide; inteligența se află în resolver, nu în simbol.
Consumatorii și reciclatorii primesc cu adevărat conținut diferit?
Da — aceasta este negocierea de conținut. Browserul primește HTML; un sistem care cere application/ld+json (sau ?format=jsonld) primește date structurate de la același URL.
Pot să-mi păstrez propria pagină de produs și să fiu totuși conform?
Da. Digital Link-ul poate expune mai multe linkuri tipizate (un linkset) — pagina ta de marketing, pașaportul oficial, o fișă tehnică de reciclare — fiecare marcată cu un tip de link.
Surse
Încearcă pașaportul live de mai sus, apoi începe gratuit și rezolvă-l pe al tău.
