GS1 Digital Link -resolveri: näin se toimii

Mikä on GS1 Digital Link -resolveri

GS1 Digital Link -resolveri on verkkopalvelu, joka toimii älykkäänä välittäjänä tuotetunnisteen ja tuotteeseen liittyvien tietojen välillä. Kun kuluttaja skannaa tuotteen QR-koodin tai kun järjestelmä hakee tuotteen tunnisteella ohjelmallisesti, resolveri vastaanottaa GS1 Digital Link -URI:n ja päättää, minne pyyntö ohjataan tuotteen identiteetin, pyydetyn tiedon tyypin ja pyynnön asiayhteyden perusteella.

Resolveria voi ajatella tuotetietojen älykkäänä tienviittana. Samoin kuin DNS-palvelin muuntaa verkkotunnukset IP-osoitteiksi, Digital Link -resolveri muuntaa tuotetunnisteet URL-osoitteiksi, joista tuotetiedot, myös digitaalisen tuotepassin tiedot, löytyvät. Tämä epäsuoruus on ratkaisevan tärkeää, koska se erottaa pysyvän tuotetunnisteen tuotetietojen mahdollisesti muuttuvasta sijainnista.

ESPR-asetuksen mukaisissa digitaalisissa tuotepasseissa resolverilla on keskeinen rooli. Tuotteen tietojenkantaja koodaa GS1 Digital Link -URI:n. Skannattaessa URI päätyy resolverille, joka ohjaa pyynnön DPP-tietolähteeseen. Jos DPP-alusta vaihtuu tai tiedot siirretään uudelle palvelimelle, vain resolverin määritykset on päivitettävä: tuotteisiin jo painetut miljoonat QR-koodit toimivat edelleen oikein.

Digital Link -resolverin arkkitehtuuri

GS1 Digital Link -resolveri koostuu useista loogisista komponenteista, jotka yhdessä käsittelevät saapuvat pyynnöt ja tuottavat asianmukaiset vastaukset.

URI-jäsennin on ensimmäinen komponentti, joka käsittelee saapuvan pyynnön. Se poimii Digital Link -URI:sta GS1-tunnisteet: ensisijaisen tunnisteen (yleensä GTIN), mahdolliset tarkenteet (sarjanumero, erä-/tuotantoeränumero) ja mahdolliset lisämääritteet. Se tarkistaa, että URI noudattaa GS1 Digital Link -syntaksimäärittelyä, ja hylkää virheellisesti muodostetut pyynnöt.

Linkkien selvitysmoottori on resolverin ydin. Se ylläpitää linkkitietueiden tietokantaa eli tuotetunnisteiden ja niiden URL-osoitteiden välisiä kytkentöjä, joista tuotteita koskevat tiedot löytyvät. Jokainen linkkitietue määrittää, mihin tuotetunnisteeseen se liittyy, millaista tietoa on saatavilla (tuotesivu, digitaalinen tuotepassi, turvallisuustiedot, takaisinvetotiedot), kohde-URL:n sekä mahdolliset ehdot sille, milloin linkkiä käytetään.

Sisältöneuvottelumoduuli tutkii saapuvan pyynnön selvittääkseen, millaista vastausta pyytäjä odottaa. Tämä tapahtuu HTTP Accept -otsakkeiden, kyselyparametrien tai itse URI:n rakenteen avulla. Selain, joka pyytää text/html-sisältöä, saa uudelleenohjauksen ihmisluettavalle sivulle. Kone, joka pyytää application/json-sisältöä, saa rakenteista dataa. Järjestelmä, joka pyytää application/ld+json-sisältöä, saa JSON-LD-muotoista linkitettyä dataa. Tämä yhden URI:n ja useiden esitysmuotojen periaate on Digital Link -arkkitehtuurin perusta.

Vastausmoduuli luo asianmukaisen HTTP-vastauksen, yleensä 307 (Temporary Redirect), joka ohjaa pyytäjän linkkien selvitysmoottorin määrittämään kohde-URL-osoitteeseen. API-pyynnöissä resolveri voi uudelleenohjauksen sijaan palauttaa linkkijoukon (JSON-dokumentin, jossa luetellaan kaikki tunnistetun tuotteen saatavilla olevat tietoresurssit).

Näin selvitys toimii vaihe vaiheelta

Digital Link -resolverin käytännön toimintaa voi havainnollistaa seuraavalla esimerkillä: kuluttaja skannaa tuotteen QR-koodin. QR-koodiin on koodattu URI https://resolver.example.com/01/05012345678901/21/SN12345.

Ensin kuluttajan älypuhelin purkaa QR-koodin ja avaa URI:n selaimessa. Selain lähettää HTTP GET -pyynnön osoitteeseen resolver.example.com polulla /01/05012345678901/21/SN12345. Pyyntö sisältää Accept-otsakkeen, joka kertoo selaimen suosivan text/html-sisältöä.

Resolverin URI-jäsennin poimii polusta GTIN-tunnisteen (05012345678901) ja sarjanumeron (SN12345). Se validoi tunnisteet ja välittää ne linkkien selvitysmoottorille.

Linkkien selvitysmoottori hakee tunnisteyhdistelmää tietokannastaan. Se löytää tuotteelle useita linkkitietueita:

• Digitaalisen tuotepassin linkki, joka osoittaa osoitteeseen https://dpp.example.com/passport/SN12345
• Tuotetietosivun linkki, joka osoittaa osoitteeseen https://brand.example.com/products/widget-pro
• Takaisinvetotietojen linkki, joka osoittaa osoitteeseen https://recalls.example.com/check/05012345678901
• JSON-LD-muotoisen linkitetyn datan päätepiste, joka osoittaa osoitteeseen https://api.example.com/01/05012345678901/21/SN12345

Sisältöneuvottelumoduuli havaitsee, että pyyntö tulee selaimelta, joka pyytää HTML-sisältöä. Resolverin oletuslinkkityypin määritysten ja pyynnön asiayhteyden perusteella se valitsee digitaalisen tuotepassin linkin sopivimmaksi vastaukseksi QR-koodia skannaavalle kuluttajalle.

Resolveri palauttaa vastauksen 307 Temporary Redirect, jonka Location-otsakkeen arvo on https://dpp.example.com/passport/SN12345. Kuluttajan selain seuraa uudelleenohjausta ja näyttää digitaalisen tuotepassin sivun.

Linkkityypit ja GS1:n vaatimustenmukaisuuskehys

GS1 määrittelee linkkityyppien sanaston, jonka avulla resolverit luokittelevat tuotteisiin liittyvät tietoresurssit. Nämä standardoidut linkkityypit varmistavat, että eri resolverit tarjoavat yhdenmukaisen kokemuksen ja että tietoja käyttävät järjestelmät voivat luotettavasti pyytää tietyntyyppisiä tietoja.

Digitaalisten tuotepassien kannalta keskeisiä linkkityyppejä ovat muun muassa:

• gs1:digitalProductPassport, ensisijainen DPP-tietoresurssi, joka sisältää ESPR-asetuksen edellyttämät kattavat tuotepassin tiedot
• gs1:productSustainabilityInfo, tuotteen ympäristö- ja kestävyystiedot
• gs1:pip, tuotetietosivu, yleensä brändin kuluttajille suunnattu tuotesivu
• gs1:safetyInfo, turvallisuuteen liittyvät tiedot, kuten käyttöturvallisuustiedotteet ja varoitukset vaaroista
• gs1:recallStatus, tieto siitä, koskeeko tuotetta takaisinveto
• gs1:traceability, toimitusketjun jäljitettävyystiedot, mahdollisesti linkitettynä EPCIS-tapahtumatietoihin
• gs1:certificationInfo, tuotteeseen liittyvät sertifikaatit ja vaatimustenmukaisuusvakuutukset

GS1 on julkaissut Digital Link -resolvereille vaatimustenmukaisuuskehyksen, joka määrittelee eri valmiustasot. Tason 0 resolverit tekevät perustason HTTP-uudelleenohjauksia. Tason 1 resolverit tukevat sisältöneuvottelua. Tason 2 resolverit tukevat koko linkkijoukko-API:a, jolloin koneet voivat löytää kaikki tuotteen saatavilla olevat tietoresurssit. Tason 3 resolverit tukevat lisäksi pakattuja Digital Link -URI:ita ja muita edistyneitä ominaisuuksia.

DPP-toteutuksiin suositellaan tason 1 tai tason 2 resolveria. Sisältöneuvottelu (taso 1) varmistaa, että sekä ihmiskäyttäjät että konejärjestelmät saavat asianmukaiset vastaukset. Linkkijoukko-API (taso 2) mahdollistaa sen, että viranomaisjärjestelmät ja DPP-rekisterit voivat ohjelmallisesti löytää minkä tahansa tuotteen passitiedot ja käyttää niitä.

Toteutusvaihtoehdot: rakenna, osta tai käytä GS1:tä

DPP:tä käyttöön ottavilla yrityksillä on kolme päävaihtoehtoa Digital Link -resolverin infrastruktuurille: oman resolverin rakentaminen, kaupallisen resolveripalvelun käyttö tai GS1:n resolveriverkon hyödyntäminen.

Oman resolverin rakentaminen antaa parhaan hallinnan selvityslogiikkaan, brändäykseen ja integrointiin olemassa olevien järjestelmien kanssa. GS1 on julkaissut avoimen lähdekoodin referenssitoteutuksia, joita voi käyttää lähtökohtana. Resolverin ylläpito suuressa mittakaavassa vaatii kuitenkin vankan verkkoinfrastruktuurin, valvontaa ja jatkuvaa ylläpitoa. Resolverin on oltava erittäin hyvin saatavilla: jos se kaatuu, jokainen siihen osoittava QR-koodi lakkaa toimimasta.

Kaupalliset resolveripalvelut, joita tarjoavat useat teknologiatoimittajat, myös DPP-alustat, tarjoavat hallinnoidun resolveri-infrastruktuurin ilman operatiivista taakkaa. Palveluihin kuuluu yleensä verkkopohjainen hallintakäyttöliittymä linkkitietueiden hallintaan, analytiikkanäkymät skannausaktiivisuudesta sekä integraatiorajapinnat ohjelmalliseen linkkien hallintaan. Useimmille yrityksille hallinnoitu resolveripalvelu tarjoaa parhaan tasapainon toiminnallisuuden ja ylläpidon helppouden välillä.

GS1:n resolveriverkko (id.gs1.org) on GS1:n itsensä ylläpitämä maailmanlaajuinen selvityspalvelu. Brändinomistajat voivat rekisteröidä tuotteensa ja määrittää selvityskohteet oman GS1-jäsenorganisaationsa kautta. Tämä vaihtoehto hyödyntää GS1-verkkotunnuksen maailmanlaajuista tunnettuutta ja luotettavuutta, mutta se voi tarjota vähemmän joustavuutta mukauttamiseen ja brändäykseen kuin oman resolveriverkkotunnuksen ylläpito.

Monissa DPP-alustoissa, kuten MyProductPassport, on sisäänrakennettu resolveritoiminnallisuus osana palvelua. Tämän integroidun lähestymistavan ansiosta yritysten ei tarvitse rakentaa erillistä resolveri-infrastruktuuria: alusta hoitaa URI-selvityksen, sisältöneuvottelun ja linkkien hallinnan passitietojen hallinnan ja QR-koodien luonnin ohella.

Resolverin määritykset DPP-vaatimustenmukaisuutta varten

Resolverin määrittäminen ESPR-asetuksen mukaisille digitaalisille tuotepasseille edellyttää useiden sääntely- ja teknisten vaatimusten huomioimista.

Resolverin on tuettava pysyvää pääsyä passitietoihin. ESPR edellyttää, että DPP-tiedot pysyvät saatavilla määritellyn ajan tuotteen markkinoille saattamisen jälkeen. Tämä tarkoittaa, että resolverin on oltava toiminnassa ja vastattava pyyntöihin koko säilytysajan, vaikka tuotteen valmistus olisi lopetettu. Yritysten tulee varmistaa, että niiden resolveri-infrastruktuuri tai palveluntarjoaja sitoutuu vaadittuihin säilytysaikoihin.

Resolverin vastauksiin tulee sisällyttää asianmukaiset HTTP-otsakkeet välimuistia ja CORS:ia (Cross-Origin Resource Sharing) varten, jotta DPP-tietoja voidaan käyttää verkkosovelluksista, mobiilisovelluksista ja viranomaisjärjestelmistä. Link-otsakkeen tulee ilmoittaa saatavilla olevat linkkityypit, mikä mahdollistaa tietoresurssien löytämisen suoraan HTTP:n avulla.

Tuotteissa, joissa on sarjatason tunnistus, resolverin on käsiteltävä URI-polun sarjanumerotarkenteita. Linkkitietokannassa on siis oltava sarjatason tietueet (tai sen on tuettava jokerimerkkihakua, joka ohjaa sarjakohtaiset pyynnöt oikeaan passi-instanssiin). Erätasolla tunnistettavissa tuotteissa resolverin on vastaavasti käsiteltävä erä-/tuotantoerätarkenteita.

Tietoturva on tärkeä näkökohta resolverin toteutuksessa. Resolverin tulee käyttää yksinomaan HTTPS:ää, rajoittaa pyyntöjen määrää väärinkäytön estämiseksi ja harkita todennusta hallinnollisille toiminnoille. Itse selvityksen tulee olla julkisesti saatavilla (jotta DPP-tietoihin on avoin pääsy ESPR:n tarkoituksen mukaisesti), mutta hallintakäyttöliittymä on suojattava.

Edistyneet resolveriominaisuudet DPP-ekosysteemeille

Perusselvityksen lisäksi useat edistyneet resolveriominaisuudet vahvistavat DPP-ekosysteemiä:

• Analytiikka ja skannausten seuranta: resolverit voivat kirjata skannaustapahtumat ja antaa brändeille tietoa siitä, missä, milloin ja kuinka usein niiden tuotteiden passeja avataan
• Sijaintitietoinen selvitys: resolverit voivat ohjata pyynnöt kieli- tai aluekohtaiseen passisisältöön pyytäjän sijainnin perusteella
• Ajallinen selvitys: resolverit voivat säilyttää linkkitietueiden historiallisia versioita, jolloin passitietoihin pääsee sellaisina kuin ne olivat tiettynä ajankohtana
• Varaselvitys: resolverit voivat käyttää porrastettua selvityslogiikkaa ja kokeilla useita tietolähteitä peräkkäin, jos ensisijainen lähde ei ole käytettävissä
• Pakattujen URI:iden tuki: GS1 Digital Link määrittelee pakattuja URI-muotoja, jotka vähentävät QR-koodien datatiheysvaatimuksia ja mahdollistavat pienemmät koodit tai paremman virheenkorjauksen

Nämä ominaisuudet eivät ole pakollisia ESPR-perusvaatimusten täyttämiseksi, mutta ne voivat parantaa merkittävästi DPP-toteutusten käytettävyyttä ja luotettavuutta. Skannausanalytiikka tuottaa esimerkiksi arvokasta markkinatietoa siitä, miten kuluttajat perehtyvät kestävyystietoihin, ja auttaa yrityksiä ymmärtämään DPP-investointinsa tuoton.

DPP-ekosysteemin kypsyessä resolverien ominaisuudet todennäköisesti laajenevat edelleen. Euroopan komission DPP-rekisteri, joka on ollut avoinna 20. heinäkuuta 2026 lähtien, toimii yhdessä resolverien kanssa passitietojen indeksoimiseksi ja käyttämiseksi koko EU:n markkinoilla. Resolverien ylläpitäjien tulee seurata kehitystä ja varmistaa, että niiden toteutukset pysyvät yhteensopivina muuttuvien infrastruktuurivaatimusten kanssa.

Resolveritoteutuksen testaus ja validointi

Ennen resolverin tuotantokäyttöä perusteellinen testaus on välttämätöntä, jotta voidaan varmistaa GS1:n määrittelyjen noudattaminen ja luotettava toiminta todellisissa olosuhteissa.

GS1 tarjoaa vaatimustenmukaisuuden testisarjoja, jotka validoivat resolverin toiminnan Digital Link -määrittelyä vasten. Testit tarkistavat URI:n oikean jäsentämisen, oikeat HTTP-vastauskoodit, täsmällisen sisältöneuvottelun ja määrittelyn mukaisen linkkijoukkojen luonnin. Kun testit ajetaan omaa resolveritoteutusta vastaan, poikkeamat määrittelystä havaitaan ennen kuin ne aiheuttavat ongelmia todellisten tuotteiden ja kuluttajien kanssa.

Kuormitustestaus on yhtä tärkeää. Suurten volyymien kuluttajabrändin resolverin voi olla käsiteltävä tuhansia pyyntöjä sekunnissa ruuhkahuippujen aikana, esimerkiksi tuotelanseerauksessa, sosiaalisen median viraalihetkessä tai viranomaisten tarkastuskampanjassa. Kun tunnet resolverisi kapasiteettirajat ja otat käyttöön sopivat skaalausstrategiat (välimuisti, kuormantasaus, CDN-jakelu), varmistat tasaisen suorituskyvyn.

Päästä päähän -testauksen tulee varmistaa koko ketju QR-koodin skannauksesta passin näyttämiseen. Tämä tarkoittaa QR-koodien fyysistä tulostamista, niiden skannaamista eri älypuhelinmalleilla ja käyttöjärjestelmillä sekä sen varmistamista, että resolveri ohjaa jokaisen pyynnön oikeaan passisisältöön. Testaus sekä kuluttajalaitteilla että ohjelmallisilla asiakkailla varmistaa, että kaikki käyttöpolut toimivat oikein.

Lopuksi tuotannossa olevalle resolveri-infrastruktuurille tulee järjestää valvonta ja hälytykset. Käytettävyyden valvonta, vasteaikojen seuranta ja virhetasojen hälytykset mahdollistavat sellaisten ongelmien nopean havaitsemisen ja korjaamisen, jotka voisivat estää kuluttajia ja viranomaisia pääsemästä digitaalisen tuotepassin tietoihin.