La tecnologia GS1 Digital Link: la sintassi dell'URI, regola per regola, con esempi

TL;DR

• Un URI GS1 Digital Link è un indirizzo web con una grammatica fissa: un dominio, una chiave primaria come /01/ con un GTIN a 14 cifre, qualificatori di chiave facoltativi nel percorso e attributi di dati nella query string.
• I suoi numeri sono identificatori di applicazione GS1 (AI), gli stessi usati nei codici a barre GS1-128, quindi un URI si converte in una stringa di elementi tradizionale e viceversa senza perdere dati GS1.
• Le regole su cui si inciampa più spesso: GTIN portati a 14 cifre con una cifra di controllo valida, qualificatori in un ordine fisso (22, 10, 21), attributi solo dopo ? e simboli nei valori sottoposti a codifica percentuale.

Un URI GS1 Digital Link è un indirizzo HTTPS che contiene identificativi GS1 in una struttura standard, così un telefono può aprirlo e uno scanner può estrarne gli identificativi. Il percorso contiene l'identità; la query string contiene dati aggiuntivi e istruzioni per il resolver. Per il vocabolario, vedi le basi di GS1 Digital Link; per che cosa succede dopo una scansione, la guida al resolver.

La sintassi dell'URI GS1 Digital Link in sintesi

Quali sono le parti di un URI GS1 Digital Link?

Un esempio completo:

https://id.example.com/01/09506000134352/22/2A/10/LOT42/21/1234?17=271231&3103=000750

Letto da sinistra a destra: GTIN 09506000134352, variante di prodotto di consumo 2A, lotto LOT42, numero di serie 1234, data di scadenza 31 dicembre 2027, peso netto 0,750 kg.

Quali chiavi primarie può usare un GS1 Digital Link?

Il GTIN è la chiave dei prodotti di consumo, ma la sintassi copre anche le altre chiavi GS1:

Le chiavi per i beni, come il GRAI (8003) e il GIAI (8004), seguono lo stesso schema.

Come funzionano i qualificatori di chiave per un GTIN?

I qualificatori di chiave restringono un GTIN da un prodotto a una variante, a un lotto o a una singola unità. Vanno nel percorso, in questo ordine:

Ognuno si può omettere, ma quelli che usi mantengono quell'ordine:

Un resolver usa i qualificatori per trovare la voce più specifica che ha, risalendo al livello di prodotto se necessario.

Quali attributi di dati vanno nella query string?

Gli attributi di dati descrivono l'articolo senza cambiarne l'identità:

Ogni attributo compare una sola volta, in qualsiasi ordine. Quando reindirizza, un resolver trasmette la query string invariata, così la pagina di destinazione può leggerla.

Come si scrive un GTIN in un GS1 Digital Link?

Sempre con 14 cifre. I GTIN più corti ricevono zeri iniziali, che non cambiano né il numero né la sua cifra di controllo:

L'ultima cifra è una cifra di controllo. Per 9506000134352, moltiplica le dodici cifre che la precedono, partendo da destra, per 3, 1, 3, 1 e così via, e somma i risultati: 78. La cifra di controllo porta quel totale al multiplo di dieci successivo: 80 − 78 = 2.

Quali caratteri richiedono la codifica percentuale?

Lettere, cifre, -, . e _ si inseriscono così come sono. Gli altri simboli nei valori di lotto, numero di serie o CPV sono sottoposti a codifica percentuale, così non possono essere scambiati per la struttura dell'indirizzo:

I valori distinguono tra maiuscole e minuscole, quindi LOT42 e lot42 sono lotti diversi, e gli spazi non sono ammessi.

Che cos'è la forma compressa?

Lo standard definisce anche una forma compressa per i codici molto piccoli: tutto ciò che segue il dominio viene condensato in una breve stringa di lettere, cifre, - e _, illeggibile a occhio, che il resolver espande prima di convalidarla. Usa la forma non compressa a meno che la dimensione del simbolo non lasci alternative: è più facile da controllare prima della stampa, e un codice compresso funziona solo dove ogni scanner e ogni app della tua catena sono in grado di decomprimerlo.

Come si inseriscono linkType e linkset nell'URI?

linkType non è un identificativo ma un'istruzione per il resolver, scritta nella query string:

I tipi di link provengono dal GS1 Web Vocabulary, come gs1:pip (pagina di informazioni sul prodotto), gs1:instructions e gs1:allergenInfo. La lingua non si indica nell'URI: il resolver la ricava dalla richiesta del telefono.

Come si collega un GS1 Digital Link a una stringa di elementi?

Contengono gli stessi dati GS1 in due sintassi:

In una stringa di elementi, le parentesi compaiono solo nel testo stampato, e un valore a lunghezza variabile come un lotto termina con un carattere separatore quando segue un altro AI; nell'URI, questo compito lo svolgono le barre, ? e &. Convertire un URI in una stringa di elementi conserva ogni AI e ogni valore ed elimina il dominio e le istruzioni per il resolver, che è ciò che fa una cassa abilitata al 2D, senza connessione a internet. Per la scelta del simbolo, vedi codice QR vs Data Matrix.

Come costruire un URI GS1 Digital Link valido: sette passi

1. Scegli il dominio. Inizia con https:// e un dominio che controlli, come id.yourbrand.com, così i codici restano tuoi qualunque sia il fornitore che gestisce il resolver.
2. Scegli la chiave primaria. Per un prodotto, l'AI 01 e il suo GTIN: /01/.
3. Scrivi il GTIN con 14 cifre. Completalo con zeri iniziali e controlla l'ultima cifra: 9506000134352 diventa 09506000134352.
4. Aggiungi i qualificatori di chiave che ti servono, in ordine. CPV /22/, lotto /10/, numero di serie /21/.
5. Applica la codifica percentuale ai valori. Mantieni lettere, cifre, -, . e _, e codifica il resto: AB/12 diventa AB%2F12.
6. Aggiungi gli attributi di dati dopo ?. Scrivi ciascuno come AI=value, uniti da &: ?17=271231&3103=000750.
7. Convalida prima di stampare. Converti l'URI in una stringa di elementi e controlla ogni valore, aprilo in un browser, poi scansiona il codice stampato con più telefoni e con uno scanner 2D. La guida alla risoluzione dei problemi elenca gli errori più comuni.

Il risultato per un lotto con data di scadenza: https://id.yourbrand.com/01/09506000134352/10/AB%2F12?17=271231.

Dove si inserisce la piattaforma Digital Link

Digital Link, la piattaforma dietro questo sito, scrive questi URI al posto tuo. Convalida ogni GTIN quando si crea un link, e aggiunge lotto, numero di serie, data di scadenza, peso netto, paese di origine, data di confezionamento o variante di prodotto di consumo come varianti di un link, ciascuna con il proprio insieme di link. I codici si possono creare in blocco da un file CSV, sul tuo sottodominio o su quello incluso, dlink.is.

Crea il tuo primo codice QR GS1 Digital Link

Domande frequenti

Un GS1 Digital Link richiede un GTIN a 14 cifre?

Sì. Un GTIN-8, GTIN-12 o GTIN-13 viene completato con zeri iniziali fino a 14 cifre, quindi 9506000134352 si scrive /01/09506000134352. La cifra di controllo resta la stessa e deve essere valida.

In che ordine vanno i qualificatori di chiave?

Per un GTIN: variante di prodotto di consumo 22, poi lotto 10, poi numero di serie 21. Ognuno si può omettere, ma quelli che usi mantengono quell'ordine.

Il dominio cambia l'identità del prodotto?

No. Il dominio decide quale resolver risponde a un telefono, ma l'identità è data dalla chiave primaria e dai suoi qualificatori. Lo stesso GTIN sotto due domini è lo stesso prodotto.

Qual è la differenza tra un URI GS1 Digital Link e una stringa di elementi?

Sono gli stessi dati in due formati. Una stringa di elementi, come (01)09506000134352(10)LOT42, è il formato dei codici a barre GS1-128. Un URI GS1 Digital Link la scrive come indirizzo web che i telefoni possono aprire.

Conviene usare la forma compressa?

Solo se il simbolo è troppo piccolo per l'indirizzo completo. Un codice compresso funziona solo dove ogni scanner e ogni app sono in grado di decomprimerlo.