GS1 Digital Link-resolver: hoe hij elke scan beantwoordt, en hoe u er een test

Een GS1 Digital Link-resolver is de webdienst achter het domein dat in uw QR-code staat, en hij bepaalt waar elke scan heen gaat. Deze gids behandelt zijn regels onder de GS1-Conformant Resolver Standard 1.2.1, en hoe u er een opzet en test.

De gids is bedoeld voor merken en fabrikanten die GS1 Digital Link-codes drukken, en voor logistieke partners wier apps die codes opvragen. De URI zelf leggen we uit op onze pagina over GS1 Digital Link. Eén regel veranderde in 2024: een app die vraagt om een linktype dat u nooit hebt geregistreerd, krijgt een 404, niet uw standaardpagina.

Controleer uw gecodeerde URI met onze gratis QR-codegenerator voor GS1 Digital Link.

Wat is een GS1 Digital Link-resolver?

Een GS1 Digital Link-resolver is een webdienst op het domein in een GS1 Digital Link-code. Hij leest de GS1-sleutels in de opgevraagde URI en antwoordt met een van de links die voor dat artikel zijn geregistreerd: de standaardlink, een getypeerde link of de volledige lijst. Hij is niet het paspoort, niet het register en niet de code.

Die drie worden makkelijk verward. Het digitaal productpaspoort (DPP) is het dossier waarnaar de resolver linkt. Het EU-register onder de ESPR (verordening ecologisch ontwerp), Verordening (EU) 2024/1781, artikel 13, slaat identificatiecodes op en is geen resolver. De QR-code draagt alleen het adres.

Dit artikel begint bij de server. Zijn regels zijn de GS1-Conformant Resolver Standard 1.2.1 en de URI Syntax 1.7.0, beide geratificeerd in augustus 2026. Gidsen van vóór 2024 beschrijven nog de oude alles-in-één-standaard.

Wat antwoordt een GS1 Digital Link-resolver op elk soort verzoek?

Een GS1 Digital Link-resolver ontvangt gewoon webverkeer. Hij moet normale webverzoeken over HTTPS beantwoorden, ook verzoeken van apps die in een browser draaien. In de termen van de standaard: HTTP/1.1 of hoger voor GET, HEAD en OPTIONS, plus CORS.

De basis, één code met vele bestemmingen, staat in onze vergelijking GS1 Digital Link vs QR-code. Hier ziet u wat de standaard per verzoek terug verwacht.

De lopende tekst van de standaard noemt geen doorverwijscode. Alleen het stroomschema labelt doorverwijzingen met 307, en id.gs1.org antwoordde 307 toen we het op 6 oktober 2026 testten. Niets vereist 301 of 302. De regels voor 400 en 404 staan wel in de tekst, en een fout mag nooit 200 OK teruggeven.

De 404 voor een ontbrekend linktype is de nieuwere regel. Onder de oude alles-in-één-standaard GS1 Digital Link 1.1 viel de resolver terug op de standaardlink. De zelfstandige Resolver Standard verving dat vanaf zijn eerste release in februari 2024.

Talen. Een gewone scan draagt geen linktype, dus de resolver verwijst door naar de standaardlink, tenzij het verzoek meer zegt. Volgens de aanbevolen aanpak van de standaard kiest hij dan alleen tussen links met het type gs1:defaultLink en gs1:defaultLinkMulti.

Taalversies worden alleen onderscheiden via verzoekheaders, zoals de taal van de telefoon, verstuurd als Accept-Language. Volgens de aanbevolen aanpak bereikt een Duitse productpagina een Duitse telefoon dus alleen als die pagina ook het type gs1:defaultLinkMulti heeft. Ondersteuning voor dat type is optioneel; vraag het uw aanbieder.

Landen. GS1 zegt dat id.gs1.org niet weet waar een scan vandaan komt, al kan de aanroepende app dat doorgeven. Het enige standaardkanaal is de optionele context-parameter: de waarden zijn niet gestandaardiseerd, resolvers hoeven hem niet te ondersteunen, en id.gs1.org declareert er geen. De standaard definieert geen geolocatie.

Welke linktypes registreert een fabrikant in een GS1 Digital Link-resolver?

Elke link die u in een GS1 Digital Link-resolver opslaat, heeft een doel-URL, een linktype en een voor mensen leesbare titel nodig. Taal, mediatype en context zijn optioneel. Linktypes komen uit de GS1 Web Vocabulary, nu versie 1.18, waarin gs1: staat voor https://ref.gs1.org/voc/.

Schrap twee namen uit elke configuratie die u uit een oudere gids hebt overgenomen: gs1:productSustainabilityInfo (nu gs1:sustainabilityInfo) en gs1:epcis (nu gs1:epcisRepository). Bedenk geen eigen types waar GS1 er al een heeft; de standaard waarschuwt dat eigen types de interoperabiliteit sterk verminderen. Laat elke link wijzen naar een pagina over dat artikel, niet naar uw homepage.

Hoe gaat een GS1 Digital Link-resolver om met batch- en serienummers?

Uw gedrukte code kan meer dragen dan een GTIN: een batch (AI 10), een serienummer (AI 21) of een consumentenproductvariant (AI 22). Vijf regels bepalen wat een GS1 Digital Link-resolver daarmee doet.

1. Links erven naar beneden. Batch-, serie- en variantniveaus erven links van de GTIN. Elk verzoek, hoe gedetailleerd ook, moet een standaardlink vinden op zijn eigen niveau of hoger. De eenvoudige manier is één standaardlink per GTIN.
2. Kwalificatoren mogen worden genegeerd. Een resolver die de GTIN ondersteunt, moet batch, serienummer en variant accepteren, maar mag ze weglaten en alleen op basis van de GTIN antwoorden. Hij hoort niet door te verwijzen naar een minder gedetailleerde URI.
3. Het antwoord combineert alle niveaus. Een verzoek levert de links op zijn eigen niveau op, plus elke minder gedetailleerde combinatie van dezelfde sleutels. Een terugroeping op GTIN plus batch wordt dus ook gevonden door een code met GTIN, variant en batch.
4. Een link op serieniveau staat op zichzelf. Een link die is geregistreerd voor GTIN plus serienummer, mag niet ook batch of variant dragen.
5. De resolver beantwoordt alleen de vraag die hij krijgt. Een link die is geregistreerd op GTIN plus variant plus batch, wordt niet gevonden door een code met GTIN plus batch.

Regel 5 is de terugroepval, uitgewerkt in het praktijkvoorbeeld hieronder. Regel 2 betekent dat u een batch-URI op uw GS1 Digital Link-resolver moet testen voordat u er een drukt.

Gegevensattributen zijn iets anders. Een vervaldatum (AI 17) hoort in de querystring, zoals ?17=271231, en maakt geen deel uit van de identificatiecode. Bij een doorverwijzing moet de resolver de hele querystring aan het doel doorgeven.

In onze test van id.gs1.org kwam ?17=271231 ongewijzigd terug in de Location-header van de doorverwijzing, het adres waarnaar de doorverwijzing wijst.

Hoe controleert u of een GS1 Digital Link-resolver conform is?

Begin met één bestand. Een conforme GS1 Digital Link-resolver moet een Resolver Description File publiceren op /.well-known/gs1resolver. De URI Syntax-standaard van GS1 noemt dat als één manier om te zien of er een resolver aanwezig is. Twee eigenschappen zijn verplicht: resolverRoot en supportedPrimaryKeys.

Voer deze controles uit op uw eigen domein, met een van uw GTIN's. Draait u zelf geen servers, stuur dan de vier opdrachten naar wie uw website of uw GS1 Digital Link-resolver host, en vraag om de uitvoer.

# 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

Elke doorverwijscode slaagt voor controle 1, omdat de lopende tekst van de standaard er geen noemt. Waar het om gaat: waar de Location-header naar wijst, en dat ?17=271231 daarin terugkomt.

Verwijst controle 2 door naar uw standaardpagina, dan volgt de dienst nog de regel van vóór 2024, of is het een gewone doorverwijzing in plaats van een conforme resolver. id.gs1.org van GS1 slaagt voor alle vier de controles voor het demoproduct van GS1, https://id.gs1.org/01/09506000134352, dus u kunt de antwoorden vergelijken.

Sinds release 1.2.0 moet het beschrijvingsbestand valideren tegen https://ref.gs1.org/standards/resolver/description-file-schema en de linklijst tegen https://ref.gs1.org/standards/resolver/linkset-schema.

Stel bij de keuze van een dienst nog één vraag. De standaard zegt dat het onmogelijk hoort te zijn een link te registreren op een ongeldige GS1-identificatiecode. Een dienst die een fout controlecijfer accepteert, controleert niet voor u.

Waar host u hem: eigen domein, GS1-lidorganisatie of id.gs1.org?

Het domein van uw GS1 Digital Link-resolver overleeft elke andere keuze hier, omdat het op het product gedrukt staat. GS1 zegt dat iedereen een resolver mag draaien, en gaat ervan uit dat merken hun eigen domeinnamen gebruiken.

Link management van GS1 Zweden maakt bijvoorbeeld links aan op de eigen resolver van GS1 Zweden, en leden mogen in plaats daarvan hun eigen resolver draaien. Onze lezing: bij een lidorganisatie of id.gs1.org beheert u de doelen, niet het domein. Het gedrukte domein verandert alleen met nieuwe drukoplagen.

De standaard staat wel een overdracht op het niveau van het bedrijfsprefix toe, dus vraag uw lidorganisatie of ze uw prefix naar uw eigen resolver zou doorsturen. De overdracht is in de praktijk zichtbaar: een GTIN met een Duits prefix, opgevraagd op id.gs1.org, kreeg een 307 naar de resolver van GS1 Germany, met rel="gs1:handledBy".

Leg dit nu naast de wet. ESPR-artikel 11, punt e), zegt dat het paspoort beschikbaar moet blijven gedurende de periode die in gedelegeerde handelingen is vastgesteld, ook na insolventie, liquidatie of stopzetting van de activiteit in de Unie. Artikel 10, lid 4, eist een back-upkopie via een aanbieder van paspoortdiensten.

De ESPR zegt niets over resolvers. Onze lezing is dat een code die gedrukt staat op een domein dat niemand onderhoudt, het scanpad naar het paspoort breekt, ook al bestaat de back-upkopie nog.

De eigen best practice van GS1 wijst dezelfde kant op: bouw URI's op een domein dat u bezit, bij voorkeur een id-subdomein. Een domein is een merkbezit dat kan worden overgedragen als het merk wordt verkocht, zodat de codes geen herdruk nodig hebben.

Praktijkvoorbeeld: een hypothetische meubelmaker in Poznań

Neem een hypothetische meubelmaker in Poznań met 420 GTIN's, die verkoopt in Polen, Duitsland en daarbuiten. Zijn codes staan op het doosetiket.

Stap 1: het domein. Hij maakt id. aan op zijn eigen merkdomein en laat het wijzen naar een GS1 Digital Link-resolver. Het beschrijvingsbestand staat live voordat er ook maar één code wordt gedrukt.

Stap 2: één standaardlink per GTIN, plus taalvarianten. De Poolse productpagina is de standaardlink voor alle 420 GTIN's, met het type gs1:defaultLink en alleen een titel. De Poolse, Duitse en Engelse pagina's krijgen daarna elk de types gs1:pip en gs1:defaultLinkMulti, met de taaltags pl, de en en.

De Poolse pagina staat er dus twee keer in, net als in het taalvoorbeeld van de standaard zelf, zodat een Poolse telefoon die ook Engels vermeldt, toch Pools krijgt. Dat maakt vier links per GTIN: 1.680 in totaal.

Op een resolver die gs1:defaultLinkMulti ondersteunt, komt een Duitse telefoon nu op de Duitse pagina. Een Nederlandse telefoon komt op de Poolse standaardpagina, omdat er geen Nederlandse variant bestaat.

Stap 3: getypeerde links op GTIN-niveau. Eén gs1:instructions-link per GTIN wijst naar de montage-pdf: nog eens 420 links. Een gs1:dpp-link komt er per GTIN bij zodra de betreffende paspoortpagina live gaat. Er is geen herdruk nodig, omdat de code de GTIN al draagt.

Stap 4: de gedrukte code. De doos draagt GTIN plus batch, bijvoorbeeld https://id.example.com/01/09520123456788/10/2611A.

Stap 5: een terugroeping. Een scharnierfout treft batch 2611A over 12 tafel-GTIN's. De maker registreert 12 gs1:recallStatus-links op GTIN plus batch. Elke app die naar de terugroepstatus van een doos uit die batch vraagt, vindt ze.

Tegenscenario één: de terugroeping op het verkeerde niveau. Stel dat het ERP de terugroeping per kleurvariant bijhoudt, en de links op GTIN plus variant plus batch worden ingevoerd. De dozen dragen alleen GTIN plus batch.

De resolver beantwoordt alleen de vraag die hij krijgt, dus de terugroeplink wordt nooit gevonden. Een terugroepapp krijgt 404, wat leest als "geen terugroepinformatie".

Tegenscenario twee: één verkeerd teken. De app van een retailer vraagt linkType=gs1:instruction, zonder de s aan het eind. Het eigen voorbeeld van de standaard verwacht 404 voor elk type dat niet is geregistreerd.

Toen we id.gs1.org op 6 oktober 2026 testten, stuurde het dat verzoek in plaats daarvan naar de standaardpagina; een geldig maar niet-geregistreerd type zoals gs1:recallStatus kreeg 404. Hoe dan ook krijgt de app de instructies niet.

Een controlecijfer dat in het etiketsjabloon verkeerd is getypt, is erger: elke scan van de hele oplage levert 400 op.

Randgevallen

Gecomprimeerde URI's. Een conforme GS1 Digital Link-resolver moet binaire EPC-strings decomprimeren, de compacte codering op RFID-tags. Het decomprimeren van algemene gecomprimeerde URI's is optioneel, dus een gecomprimeerde code kan op sommige resolvers mislukken. De voorlopige, nog niet geratificeerde DPP-standaard van GS1 vraagt om de ongecomprimeerde vorm.

Slash aan het eind. /01/09520123456788/ is geen geldige syntaxis, maar resolvers horen hem te tolereren. Druk hem niet af.

Geen taalmatch. Vraagt een app om gs1:instructions en hebt u een Poolse en een Duitse versie geregistreerd, dan kan een Nederlandse telefoon 300 Multiple Choices krijgen, met beide in de lijst. Voeg een versie toe voor elke taal waarin u verkoopt, of accepteer dat sommige gebruikers een lijst zien.

Doorverwijzingsketens. id.gs1.org kan een verzoek overdragen aan een resolver van een lidorganisatie, die doorverwijst naar uw pagina. Elke stap voegt vertraging en een mogelijk faalpunt toe.

Lekken via de querystring. De hele querystring bereikt uw doelpagina. Zorg dat de pagina parameters als ?17=271231 verdraagt. Zet nooit persoonlijke of geheime gegevens in een gedrukte URI.

Apps zonder resolver. Een URI die de Digital Link-syntaxis volgt, bewijst niet dat er een resolver achter zit. Apps mogen er niet van uitgaan dat die er is; /.well-known/gs1resolver controleren is de test die de URI Syntax-standaard beschrijft.

Uitgezoomd: waarom de resolver u moet overleven

Een paspoort draait om data. De GS1 Digital Link-resolver draait om bereikbaarheid, en bereikbaarheid is wat de wet in de tijd vastlegt.

Vastgestelde wet. ESPR-artikel 9, lid 2, punt i), zegt dat elke gedelegeerde handeling bepaalt hoe lang het paspoort beschikbaar blijft: minstens de verwachte levensduur van het product. Artikel 10, lid 1, verbindt de gegevensdrager met een permanente unieke productidentificatiecode en eist dat data zonder afhankelijkheid van één aanbieder kunnen worden overgedragen.

Niets hiervan noemt een resolver. Onze lezing is dat het domein op de verpakking, en de GS1 Digital Link-resolver erachter, de plek is waar deze plichten in de praktijk samenkomen.

Vastgestelde wet, vrijwillige normen. Uitvoeringsbesluit (EU) 2026/1736 van de Commissie vermeldt zes geharmoniseerde DPP-normen: EN 18216, EN 18219, EN 18220, EN 18221, EN 18222 en EN 18223. Wie ze volgt, krijgt een vermoeden van conformiteit met de ESPR-artikelen 10 en 11.

De volledige teksten van die normen zitten achter een betaalmuur, en we schrijven er geen resolverregels aan toe.

Onbekend. gs1:dpp bestaat, maar we vonden geen gedelegeerde handeling die het voorschrijft, of die enig specifiek resolvergedrag eist. Volgens ESPR-artikel 9, lid 2, punt b), legt elke gedelegeerde handeling de gegevensdragers voor haar productgroep vast.

Verwacht. De DPP-applicatiestandaard van GS1 is voorlopig en zegt dat ook. Hij geeft de voorkeur aan de volledige URI op het domein van de merkeigenaar, QR Code of Data Matrix, en ongecomprimeerde URI's.

Het batterijpaspoort valt onder een aparte verordening, (EU) 2023/1542, met een vaste datum in de wet: 18 februari 2027. Haar artikel 77, lid 3, noemt de gegevensdrager al: een QR-code.

Voor het kader, lees onze ESPR-gids en wat een digitaal productpaspoort is.

Wat u dit kwartaal doet

1. Neem het id.-subdomein op uw merkdomein in gebruik voordat u nog een code drukt.
2. Stel één standaardlink per GTIN in, en geef elke taalpagina, inclusief die in de taal van de standaardlink, het type gs1:defaultLinkMulti.
3. Registreer getypeerde links met de actuele GS1-namen: gs1:instructions, gs1:sustainabilityInfo, en gs1:dpp zodra er paspoorten zijn.
4. Publiceer of controleer /.well-known/gs1resolver en valideer het tegen het schema van GS1.
5. Test uw GS1 Digital Link-resolver met de vier controles hierboven, en controleer elke gecodeerde URI met de gratis generator. Die vraagt geen registratie en werkt in uw browser.

Passmith biedt ook een gratis plan als u verder wilt gaan.

Verder lezen: GS1 Digital Link vs QR-code · GS1 Digital Link uitgelegd · Gids voor GS1 2D-barcodes · DPP voor fabrikanten buiten de EU · Gratis QR-codegenerator voor GS1 Digital Link

Gerelateerde artikelen

GS1 Digital Link vs QR-code: wat is het verschil?Elke GS1 Digital Link is een QR-code, maar niet elke QR-code is een Digital Link. Het verschil, een vergelijkingstabel en wanneer welke volstaat.Overstap naar 2D-codes: routekaart 2027 voor fabrikantenDe retail wil kassa's eind 2027 2D-codes laten lezen. De overstap van streepjescode naar GS1-QR in vijf stappen, met een 90-dagenpilot en een drukchecklist.Digitaal productpaspoort: complete gids 2026Wat het digitaal productpaspoort is, hoe het werkt, welke producten er wanneer een nodig hebben (batterijen vanaf 18 februari 2027) en welke data het draagt.