Resolver GS1 Digital Link: come risponde a ogni scansione e come testarne uno

Un resolver GS1 Digital Link è il servizio web che risponde al dominio stampato nel vostro QR code, e decide dove va ogni scansione. Questa guida ne spiega le regole secondo il GS1-Conformant Resolver Standard 1.2.1, e come configurarne e testarne uno.

È pensata per produttori ed esportatori che stampano codici GS1 Digital Link. Se fornite marchi e rivenditori europei, è il resolver a decidere che cosa vedono i loro clienti e le loro app. L'URI in sé è spiegato nella nostra pagina su GS1 Digital Link. Una regola è cambiata nel 2024: un'app che chiede un tipo di link che non avete mai registrato riceve un 404, non la vostra pagina predefinita.

Controllate il vostro URI codificato con il nostro generatore gratuito di QR GS1 Digital Link.

Che cos'è un resolver GS1 Digital Link?

Un resolver GS1 Digital Link è un servizio web sul dominio contenuto in un codice GS1 Digital Link. Legge le chiavi GS1 nell'URI richiesto e risponde con uno dei link registrati per quell'articolo: il predefinito, un link tipizzato o l'elenco completo. Non è il passaporto, né il registro, né il codice.

Sono tre cose facili da confondere. Il passaporto digitale di prodotto (DPP) è il record a cui il resolver rimanda. Il registro UE previsto dall'articolo 13 dell'ESPR (regolamento sulla progettazione ecocompatibile), il regolamento (UE) 2024/1781, conserva identificativi e non è un resolver. Il QR code porta solo l'indirizzo.

Questo articolo parte dal server. Le sue regole sono il GS1-Conformant Resolver Standard 1.2.1 e la URI Syntax 1.7.0, entrambi ratificati ad agosto 2026. Le guide scritte prima del 2024 descrivono invece il vecchio standard onnicomprensivo.

Che cosa risponde un resolver GS1 Digital Link a ogni tipo di richiesta?

Un resolver GS1 Digital Link riceve normale traffico web. Deve rispondere alle comuni richieste web su HTTPS, comprese quelle di app che girano in un browser. Nei termini dello standard: HTTP/1.1 o superiore per GET, HEAD e OPTIONS, più CORS.

Le basi, un codice con molte destinazioni, sono nel nostro confronto GS1 Digital Link vs codice QR. Ecco che cosa lo standard si aspetta in risposta a ogni richiesta.

Il testo dello standard non nomina alcun codice di reindirizzamento. Solo il suo diagramma di flusso etichetta i reindirizzamenti come 307, e id.gs1.org ha risposto 307 quando l'abbiamo testato il 6 ottobre 2026. Nulla impone 301 o 302. Le regole su 400 e 404 sono nel testo, e un errore non deve mai restituire 200 OK.

Il 404 per un tipo di link mancante è la regola più recente. Con il vecchio GS1 Digital Link 1.1 onnicomprensivo, il resolver ripiegava sul link predefinito. Il Resolver Standard autonomo ha sostituito questa regola dalla sua prima release, a febbraio 2024.

Lingue. Una scansione semplice non porta alcun tipo di link, quindi il resolver reindirizza al predefinito, a meno che la richiesta non dica di più. Secondo l'approccio raccomandato dallo standard, sceglie poi solo tra i link tipizzati gs1:defaultLink e gs1:defaultLinkMulti.

Le versioni linguistiche si distinguono solo dalle intestazioni della richiesta, come la lingua del telefono inviata in Accept-Language. Quindi, con l'approccio raccomandato, una pagina prodotto in tedesco raggiunge un telefono in tedesco solo se è tipizzata anche gs1:defaultLinkMulti. Il supporto di questo tipo è facoltativo; chiedetelo al vostro fornitore.

Paesi. GS1 dice che id.gs1.org non sa da dove arriva una scansione, anche se l'app chiamante può trasmetterlo. L'unico canale standard è il parametro facoltativo context: i suoi valori non sono standardizzati, i resolver non sono tenuti a supportarlo, e id.gs1.org non ne dichiara nessuno. Lo standard non definisce alcuna geolocalizzazione.

Quali tipi di link dovrebbe registrare un produttore in un resolver GS1 Digital Link?

Ogni link che memorizzate in un resolver GS1 Digital Link richiede un URL di destinazione, un tipo di link (link type) e un titolo leggibile. Lingua, tipo di media e contesto sono facoltativi. I tipi di link vengono dal GS1 Web Vocabulary, ora alla versione 1.18, dove gs1: sta per https://ref.gs1.org/voc/.

Eliminate due nomi da qualsiasi configurazione copiata da una guida più vecchia: gs1:productSustainabilityInfo (ora gs1:sustainabilityInfo) e gs1:epcis (ora gs1:epcisRepository). Non inventate tipi dove GS1 ne ha già uno; lo standard avverte che i tipi personalizzati riducono molto l'interoperabilità. Fate puntare ogni link a una pagina su quell'articolo, non alla vostra homepage.

Come gestisce un resolver GS1 Digital Link i numeri di lotto e di serie?

Il vostro codice stampato può portare più di un GTIN: un lotto (AI 10), un numero di serie (AI 21) o una variante del prodotto di consumo (AI 22). Cinque regole decidono che cosa ne fa un resolver GS1 Digital Link.

1. I link si ereditano verso il basso. I livelli di lotto, serie e variante ereditano i link dal GTIN. Ogni richiesta, per quanto granulare, deve trovare un predefinito al proprio livello o a uno superiore. La via semplice è un predefinito per GTIN.
2. I qualificatori possono essere ignorati. Un resolver che supporta il GTIN deve accettare lotto, serie e variante, ma può scartarli e risolvere solo sul GTIN. Non dovrebbe reindirizzare verso un URI meno granulare.
3. La risposta è un'unione. Una richiesta restituisce i link al proprio livello più quelli di ogni combinazione meno granulare delle stesse chiavi. Un richiamo registrato su GTIN più lotto viene quindi trovato anche da un codice che porta GTIN, variante e lotto.
4. Un link a livello di serie sta da solo. Un link registrato per GTIN più serie non può portare anche lotto o variante.
5. Il resolver risponde solo alla richiesta che riceve. Un link registrato su GTIN più variante più lotto non viene trovato da un codice che porta GTIN più lotto.

La regola 5 è la trappola dei richiami, mostrata nell'esempio pratico più sotto. La regola 2 significa che dovreste testare un URI con lotto sul vostro resolver GS1 Digital Link prima di stamparne uno.

Gli attributi di dati sono un'altra cosa. Una data di scadenza (AI 17) va nella query string, come ?17=271231, e non fa parte dell'identificativo. In un reindirizzamento, il resolver deve passare l'intera query string alla destinazione.

Nel nostro test su id.gs1.org, ?17=271231 è ricomparso invariato nell'intestazione Location del reindirizzamento, cioè l'indirizzo verso cui il reindirizzamento punta.

Come si verifica che un resolver GS1 Digital Link sia conforme?

Partite da un file. Un resolver GS1 Digital Link conforme deve pubblicare un Resolver Description File (file di descrizione del resolver) in /.well-known/gs1resolver. Lo standard GS1 URI Syntax lo indica come uno dei modi per capire se un resolver è presente. Due proprietà sono obbligatorie: resolverRoot e supportedPrimaryKeys.

Eseguite questi controlli sul vostro dominio, con uno dei vostri GTIN. Se non gestite server vostri, mandate i quattro comandi a chi ospita il vostro sito o il vostro resolver GS1 Digital Link, e chiedete l'output.

# 0. Is there a resolver here at all?
curl -s https://id.example.com/.well-known/gs1resolver

# 1. Plain scan: expect a 3xx redirect (id.gs1.org uses 307) and a Location header
curl -sI "https://id.example.com/01/09520123456788?17=271231"

# 2. Unregistered link type: expect 404, not a redirect
curl -sI "https://id.example.com/01/09520123456788?linkType=gs1:recallStatus"

# 3. Full link list: expect 200 and JSON
curl -s -H "Accept: application/linkset+json" https://id.example.com/01/09520123456788

Il controllo 0 dice se lì c'è un resolver. Il controllo 1 simula una scansione semplice: qualsiasi codice di reindirizzamento lo supera, perché il testo dello standard non ne nomina nessuno. Conta dove punta l'intestazione Location, e che ?17=271231 vi ricompaia.

Il controllo 2 chiede un tipo di link non registrato e deve ricevere 404. Se invece reindirizza alla vostra pagina predefinita, il servizio segue ancora la regola precedente al 2024, oppure è un semplice reindirizzamento e non un resolver conforme. Il controllo 3 deve restituire 200 e l'elenco dei link in JSON. Il resolver di GS1, id.gs1.org, supera tutti e quattro i controlli per il prodotto dimostrativo di GS1, https://id.gs1.org/01/09506000134352, quindi potete confrontare le risposte.

Dalla Release 1.2.0, il file di descrizione deve essere validato rispetto a https://ref.gs1.org/standards/resolver/description-file-schema e l'elenco dei link rispetto a https://ref.gs1.org/standards/resolver/linkset-schema.

Quando scegliete un servizio, chiedete un'altra cosa. Lo standard dice che dovrebbe essere impossibile registrare un link su un identificativo GS1 non valido. Un servizio che accetta una cifra di controllo errata non sta controllando per voi.

Dove ospitarlo: dominio proprio, organizzazione membro GS1 o id.gs1.org?

Il dominio del vostro resolver GS1 Digital Link sopravvive a ogni altra scelta, perché è stampato sul prodotto. GS1 dice che chiunque può gestire un resolver, e presume che i marchi useranno i propri nomi di dominio.

Il servizio Link management di GS1 Sweden, per esempio, crea i link sul resolver di GS1 Sweden, e i suoi membri possono gestirne uno proprio. La nostra lettura: con un'organizzazione membro o con id.gs1.org controllate le destinazioni, non il dominio. Il dominio stampato cambia solo con nuove tirature.

Lo standard ammette una delega a livello di prefisso aziendale, quindi chiedete alla vostra organizzazione membro se inoltrerebbe il vostro prefisso al vostro resolver. La delega si vede nella pratica: un GTIN con prefisso tedesco richiesto su id.gs1.org ha ricevuto un 307 verso il resolver di GS1 Germany, con rel="gs1:handledBy".

Ora confrontate tutto questo con la legge. L'articolo 11, lettera e), dell'ESPR dice che il passaporto deve restare disponibile per il periodo fissato negli atti delegati, anche dopo insolvenza, liquidazione o cessazione dell'attività nell'Unione. L'articolo 10, paragrafo 4, impone una copia di riserva tramite un fornitore di servizi per il passaporto.

L'ESPR non dice nulla sui resolver. Secondo la nostra lettura, un codice stampato su un dominio che nessuno mantiene interrompe il percorso di scansione verso il passaporto, anche se la copia di riserva esiste ancora.

La buona pratica di GS1 va nella stessa direzione: costruire gli URI su un dominio di vostra proprietà, preferibilmente un sottodominio id. Un dominio è un bene del marchio che può essere trasferito se il marchio viene venduto, così i codici non vanno ristampati.

Esempio pratico: un ipotetico produttore di mobili a Poznań

Prendiamo un ipotetico produttore di mobili a Poznań con 420 GTIN, che vende in Polonia, in Germania e oltre. I suoi codici vanno sull'etichetta del cartone.

Passo 1: il dominio. Crea id. sul dominio del proprio marchio e lo fa puntare a un resolver GS1 Digital Link. Il file di descrizione è online prima che venga stampato qualsiasi codice.

Passo 2: un predefinito per GTIN, più le varianti linguistiche. La pagina prodotto in polacco è il predefinito per tutti i 420 GTIN, tipizzata gs1:defaultLink con il solo titolo. Le pagine in polacco, tedesco e inglese vengono poi tipizzate ciascuna gs1:pip e gs1:defaultLinkMulti, con i tag pl, de ed en.

La pagina polacca compare due volte, come nell'esempio linguistico dello standard stesso, così un telefono polacco che elenca anche l'inglese riceve comunque il polacco. Sono quattro link per GTIN: 1.680 in tutto.

Su un resolver che supporta gs1:defaultLinkMulti, un telefono tedesco ora arriva alla pagina tedesca. Un telefono francese arriva al predefinito polacco, perché non esiste una variante francese.

Passo 3: link tipizzati a livello di GTIN. Un link gs1:instructions per GTIN punta al PDF di montaggio: altri 420 link. Un link gs1:dpp si aggiunge per GTIN man mano che ogni pagina del passaporto va online. Non serve ristampare, perché il codice porta già il GTIN.

Passo 4: il codice stampato. Il cartone porta GTIN più lotto, per esempio https://id.example.com/01/09520123456788/10/2611A.

Passo 5: un richiamo. Un difetto delle cerniere riguarda il lotto 2611A su 12 GTIN di tavoli. Il produttore registra 12 link gs1:recallStatus a livello di GTIN più lotto. Qualsiasi app che chiede lo stato di richiamo di un cartone di quel lotto lo trova.

Primo controfattuale: il richiamo al livello sbagliato. Supponiamo che l'ERP gestisca il richiamo per variante di colore, e che i link vengano registrati su GTIN più variante più lotto. I cartoni portano solo GTIN più lotto.

Il resolver GS1 Digital Link risponde solo alla richiesta che riceve, quindi il link di richiamo non viene mai trovato. Un'app di richiamo riceve 404, che si legge come «nessuna informazione di richiamo».

Secondo controfattuale: un carattere sbagliato. L'app di un rivenditore richiede linkType=gs1:instruction, senza la s finale. L'esempio dello standard stesso prevede 404 per qualsiasi tipo non registrato.

Quando abbiamo testato id.gs1.org il 6 ottobre 2026, ha inviato quella richiesta alla pagina predefinita; un tipo valido ma non registrato come gs1:recallStatus ha ricevuto 404. In entrambi i casi, l'app non ottiene le istruzioni.

Una cifra di controllo digitata male nel modello dell'etichetta è peggio: ogni scansione della tiratura restituisce 400.

Casi limite

URI compressi. Un resolver GS1 Digital Link conforme deve decomprimere le stringhe binarie EPC, la codifica compatta usata sui tag RFID. Decomprimere gli URI compressi in generale è facoltativo, quindi un codice compresso può fallire su alcuni resolver. Lo standard DPP provvisorio di GS1, non ancora ratificato, chiede la forma non compressa.

Barra finale. /01/09520123456788/ non è sintassi valida, ma i resolver dovrebbero tollerarla. Non stampatela.

Nessuna corrispondenza di lingua. Se un'app chiede gs1:instructions e avete registrato versioni in polacco e in tedesco, un telefono francese può ricevere 300 Multiple Choices con entrambe in elenco. Aggiungete una versione per ogni lingua in cui vendete, oppure accettate che alcuni utenti vedano un elenco.

Catene di reindirizzamenti. id.gs1.org può passare una richiesta al resolver di un'organizzazione membro, che reindirizza alla vostra pagina. Ogni passaggio aggiunge latenza e un punto di guasto.

Fughe di dati nella query string. L'intera query string arriva alla vostra pagina di destinazione. Assicuratevi che la pagina tolleri parametri come ?17=271231. Non mettete mai dati personali o segreti in un URI stampato.

App senza resolver. Un URI che segue la sintassi Digital Link non prova che dietro ci sia un resolver. Le app non devono presumerlo; controllare /.well-known/gs1resolver è il test descritto dallo standard URI Syntax.

Il quadro generale: perché il resolver deve sopravvivervi

Un passaporto riguarda i dati. Il resolver GS1 Digital Link riguarda la raggiungibilità, ed è la raggiungibilità che la legge fissa nel tempo.

Legge adottata. L'articolo 9, paragrafo 2, lettera i), dell'ESPR dice che ciascun atto delegato stabilisce per quanto tempo il passaporto resta disponibile, almeno per la durata di vita prevista del prodotto. L'articolo 10, paragrafo 1, lega il supporto dati a un identificativo univoco del prodotto persistente e impone che i dati possano essere trasferiti senza blocco da parte del fornitore (lock-in).

Nessuna di queste norme nomina un resolver. Secondo la nostra lettura, il dominio sulla confezione, e il resolver GS1 Digital Link dietro di esso, è il punto in cui questi obblighi si incontrano nella pratica.

Legge adottata, norme volontarie. La decisione di esecuzione (UE) 2026/1736 della Commissione cita sei norme armonizzate sul DPP: EN 18216, EN 18219, EN 18220, EN 18221, EN 18222 ed EN 18223. Seguirle dà una presunzione di conformità agli articoli 10 e 11 dell'ESPR.

I testi completi di quelle norme sono a pagamento, e non attribuiamo loro alcuna regola sui resolver.

Sconosciuto. gs1:dpp esiste, ma non abbiamo trovato alcun atto delegato che lo imponga, né che imponga un comportamento specifico del resolver. In base all'articolo 9, paragrafo 2, lettera b), dell'ESPR, ciascun atto delegato specifica i supporti dati per il suo gruppo di prodotti.

Atteso. Lo standard applicativo GS1 per il DPP è provvisorio e lo dichiara. Privilegia l'URI completo sul dominio del titolare del marchio, QR Code o Data Matrix, e URI non compressi.

Il passaporto della batteria segue un regolamento distinto, il regolamento (UE) 2023/1542, con una data fissata per legge: 18 febbraio 2027. Il suo articolo 77, paragrafo 3, nomina già il supporto dati: un QR code.

Per il quadro, leggete la nostra guida all'ESPR e che cos'è il passaporto digitale di prodotto.

Che cosa fare in questo trimestre

1. Assicuratevi il sottodominio id. sul dominio del vostro marchio prima di stampare un altro codice.
2. Impostate un predefinito per GTIN, e tipizzate ogni pagina linguistica, compresa quella nella lingua del predefinito, come gs1:defaultLinkMulti.
3. Registrate link tipizzati con i nomi GS1 attuali: gs1:instructions, gs1:sustainabilityInfo, e gs1:dpp quando i passaporti esisteranno.
4. Pubblicate o verificate /.well-known/gs1resolver e validatelo rispetto allo schema di GS1.
5. Testate il vostro resolver GS1 Digital Link con i quattro controlli qui sopra, e verificate ogni URI codificato con il generatore gratuito. Non richiede registrazione e funziona nel vostro browser.

Passmith offre anche un piano gratuito se volete andare oltre.

Approfondimenti: GS1 Digital Link vs codice QR · GS1 Digital Link spiegato · Guida ai codici a barre 2D GS1 · DPP per i produttori extra-UE · Generatore gratuito di QR GS1 Digital Link

Articoli correlati

GS1 Digital Link vs codice QR: qual è la differenza?Ogni GS1 Digital Link è un codice QR, ma non ogni QR è un Digital Link. La differenza, una tabella di confronto e quando ciascuno dei due basta.Transizione ai codici 2D: roadmap 2027 per produttoriLa distribuzione vuole casse che leggano il 2D entro fine 2027. Dal codice lineare al QR GS1 in cinque passi, con un pilota di 90 giorni e controlli di stampa.Passaporto digitale di prodotto: guida completa 2026Che cos'è il passaporto digitale di prodotto, come funziona, quali prodotti lo richiedono e quando (batterie dal 18 febbraio 2027) e quali dati contiene.