GS1 Digital Link Resolver: Her Okutmaya Nasıl Yanıt Verir, Nasıl Test Edilir?

GS1 Digital Link resolver, QR kodunuza basılan alan adındaki web hizmetidir ve her okutmanın nereye gideceğine o karar verir. Bu rehber, GS1-Conformant Resolver Standard 1.2.1 kapsamındaki kurallarını ve bir resolver'ın nasıl kurulup test edileceğini anlatıyor.

Rehber, GS1 Digital Link kodu basan üreticiler ve ihracatçılar için. İnegöl'den mobilya ya da Bursa'dan ev tekstili gönderiyorsanız ve AB'li alıcınız kartonda Digital Link'li bir karekod istiyorsa, kodun arkasındaki sunucu artık sizin de konunuz.

URI'nin kendisini GS1 Digital Link sayfamız açıklıyor. 2024'te bir kural değişti: hiç kaydetmediğiniz bir bağlantı tipini isteyen uygulama, varsayılan sayfanızı değil, 404 alır. Kodladığınız URI'yi ücretsiz GS1 Digital Link QR oluşturucumuzla kontrol edin.

GS1 Digital Link resolver nedir?

GS1 Digital Link resolver, bir GS1 Digital Link kodundaki alan adında çalışan web hizmetidir. İstenen URI'deki GS1 anahtarlarını okur ve o ürün için kaydedilmiş bağlantılardan biriyle yanıt verir: varsayılan, tipli bir bağlantı ya da listenin tamamı. Pasaport, sicil veya kodun kendisi değildir.

Bu üçü kolayca karıştırılır. Dijital Ürün Pasaportu (DPP), resolver'ın bağlandığı kayıttır. (AB) 2024/1781 sayılı Tüzük'ün, yani ESPR'nin (Sürdürülebilir Ürünler için Ekotasarım Yönetmeliği) 13. maddesi kapsamındaki AB sicili tanımlayıcıları saklar; bir resolver değildir. QR kod ise yalnızca adresi taşır.

Bu yazı sunucudan başlıyor. Kuralları, ikisi de Ağustos 2026'da onaylanan GS1-Conformant Resolver Standard 1.2.1 ve URI Syntax 1.7.0. 2024'ten önce yazılmış rehberler bunun yerine eski, hepsi bir arada standardı anlatır.

GS1 Digital Link resolver her istek türüne ne yanıt verir?

GS1 Digital Link resolver sıradan web trafiği alır. Tarayıcıda çalışan uygulamalardan gelenler dahil, HTTPS üzerinden normal web isteklerine yanıt vermelidir. Standardın terimleriyle bu, GET, HEAD ve OPTIONS için HTTP/1.1 veya üstü, artı CORS demek.

Temel fikir, yani tek kod ve çok hedef, GS1 Digital Link ile QR kod farkı karşılaştırmamızda. Burada standardın her istek için beklediği yanıt var.

Standardın metni bir yönlendirme kodu belirtmiyor. Yönlendirmeleri yalnızca akış şeması 307 olarak etiketliyor ve 6 Ekim 2026'da test ettiğimizde id.gs1.org 307 ile yanıt verdi. Hiçbir şey 301 veya 302'yi şart koşmuyor. 400 ve 404 kuralları metinde yer alıyor ve bir hata asla 200 OK döndürmemeli.

Eksik bağlantı tipi için 404 daha yeni bir kural. Eski, hepsi bir arada GS1 Digital Link 1.1'de resolver varsayılan bağlantıya düşüyordu. Bağımsız Resolver Standard bunu Şubat 2024'teki ilk sürümünden itibaren değiştirdi.

Diller. Düz bir okutma bağlantı tipi taşımaz; istek daha fazlasını söylemedikçe resolver varsayılana yönlendirir. Standardın önerdiği yaklaşımda resolver bu durumda yalnızca gs1:defaultLink ve gs1:defaultLinkMulti tipli bağlantılar arasından seçer.

Dil versiyonları yalnızca istek başlıklarıyla, örneğin telefonun Accept-Language olarak gönderdiği dille ayırt edilir. Dolayısıyla önerilen yaklaşımda Almanca bir ürün sayfası, ancak gs1:defaultLinkMulti olarak da tiplendirilmişse Almanca bir telefona ulaşır. Bu tipin desteklenmesi isteğe bağlı; sağlayıcınıza sorun.

Ülkeler. GS1, id.gs1.org'un okutmanın nereden geldiğini bilmediğini söylüyor; ancak çağıran uygulama bunu iletebilir. Tek standart kanal isteğe bağlı context parametresi: değerleri standartlaştırılmamış, resolver'ların onu desteklemesi gerekmiyor ve id.gs1.org hiçbir değer beyan etmiyor. Standart coğrafi konum tanımlamıyor.

Üretici GS1 Digital Link resolver'a hangi bağlantı tiplerini kaydetmeli?

GS1 Digital Link resolver'a kaydettiğiniz her bağlantı bir hedef URL, bir bağlantı tipi ve insanların okuyabileceği bir başlık ister. Dil, medya türü ve bağlam isteğe bağlı. Bağlantı tipleri, şu anda 1.18 sürümündeki GS1 Web Vocabulary'den gelir; burada gs1:, https://ref.gs1.org/voc/ demek.

Eski bir rehberden kopyalanmış her yapılandırmadan iki adı silin: gs1:productSustainabilityInfo (artık gs1:sustainabilityInfo) ve gs1:epcis (artık gs1:epcisRepository). GS1'in bir tipi varsa kendi tipinizi uydurmayın; standart, özel tiplerin birlikte çalışabilirliği büyük ölçüde azalttığı uyarısını yapıyor. Her bağlantıyı ana sayfanıza değil, o ürüne ait bir sayfaya yönlendirin.

GS1 Digital Link resolver parti ve seri numaralarını nasıl ele alır?

Basılı kodunuz GTIN'den fazlasını taşıyabilir: bir parti (AI 10), bir seri (AI 21) veya bir tüketici ürün varyantı (AI 22). GS1 Digital Link resolver'ın bunlarla ne yapacağını beş kural belirler.

1. Bağlantılar aşağıya doğru devralınır. Parti, seri ve varyant düzeyleri bağlantıları GTIN'den devralır. Her istek, ne kadar ayrıntılı olursa olsun, kendi düzeyinde veya daha üstte bir varsayılan bulmalıdır. En basit yol GTIN başına bir varsayılan.
2. Niteleyiciler yok sayılabilir. GTIN'i destekleyen bir resolver parti, seri ve varyantı kabul etmek zorunda, ama bunları atıp yalnızca GTIN üzerinden çözümleyebilir. Daha az ayrıntılı bir URI'ye yukarı doğru yönlendirme yapmamalıdır.
3. Yanıt bir birleşimdir. Bir istek, kendi düzeyindeki bağlantıları ve aynı anahtarların daha az ayrıntılı her kombinasyonundaki bağlantıları döndürür. Bu yüzden GTIN artı partide kayıtlı bir geri çağırma, GTIN, varyant ve parti taşıyan bir kodla da bulunur.
4. Seri düzeyindeki bağlantı tek başına durur. GTIN artı seri için kaydedilen bir bağlantı ayrıca parti veya varyant taşıyamaz.
5. Resolver yalnızca aldığı sorguyu yanıtlar. GTIN artı varyant artı partide kaydedilen bir bağlantı, GTIN artı parti taşıyan bir kodla bulunmaz.

Kural 5, aşağıdaki örnekte gösterilen geri çağırma tuzağıdır. Kural 2 ise bir parti URI'sini basmadan önce GS1 Digital Link resolver'ınızda test etmeniz gerektiği anlamına gelir.

Veri nitelikleri farklıdır. Son kullanma tarihi (AI 17) ?17=271231 gibi sorgu dizesine girer ve tanımlayıcının parçası değildir. Yönlendirmede resolver sorgu dizesinin tamamını hedefe aktarmak zorundadır.

id.gs1.org testimizde ?17=271231, yönlendirmenin işaret ettiği adres olan Location başlığında değişmeden yeniden göründü.

Bir GS1 Digital Link resolver'ın uyumlu olduğunu nasıl kontrol edersiniz?

Tek bir dosyayla başlayın. Uyumlu bir GS1 Digital Link resolver, /.well-known/gs1resolver adresinde bir Resolver Tanım Dosyası (Resolver Description File) yayımlamak zorundadır. GS1'in URI Syntax standardı bunu, orada bir resolver olup olmadığını anlamanın yollarından biri olarak anıyor. İki özellik zorunlu: resolverRoot ve supportedPrimaryKeys.

Bu kontrolleri kendi alan adınızda, GTIN'lerinizden biriyle çalıştırın. Kendi sunucularınızı işletmiyorsanız dört komutu sitenizi ya da GS1 Digital Link resolver'ınızı barındıran kişiye gönderin ve çıktıyı isteyin.

# 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

Kontrol 1'i her yönlendirme kodu geçer, çünkü standardın metni hiçbirini belirtmiyor. Önemli olan, Location başlığının nereye işaret ettiği ve ?17=271231'in orada yeniden görünmesi.

Kontrol 2 varsayılan sayfanıza yönlendiriyorsa, hizmet hâlâ 2024 öncesi kuralı izliyordur ya da uyumlu bir resolver değil, düz bir yönlendirmedir. GS1'in id.gs1.org'u, GS1'in demo ürünü https://id.gs1.org/01/09506000134352 için dört kontrolün hepsini geçiyor; yanıtları karşılaştırabilirsiniz.

Sürüm 1.2.0'dan bu yana tanım dosyası https://ref.gs1.org/standards/resolver/description-file-schema şemasına, bağlantı listesi de https://ref.gs1.org/standards/resolver/linkset-schema şemasına göre doğrulanmalı.

Bir hizmet seçerken bir şey daha sorun. Standart, geçersiz bir GS1 tanımlayıcısına bağlantı kaydetmenin imkânsız olması gerektiğini söylüyor. Yanlış kontrol hanesini kabul eden bir hizmet, sizin yerinize kontrol yapmıyor demektir.

Nerede barındırmalı: kendi alan adınızda mı, GS1 üye kuruluşunda mı, id.gs1.org'da mı?

GS1 Digital Link resolver'ınızın alan adı buradaki diğer bütün seçimlerden uzun yaşar, çünkü ürünün üzerine basılır. GS1 herkesin resolver işletebileceğini söylüyor ve markaların kendi alan adlarını kullanacağını varsayıyor.

Örneğin GS1 Sweden'ın Link management hizmeti bağlantıları GS1 Sweden'ın kendi resolver'ında oluşturuyor ve üyeleri bunun yerine kendi resolver'larını işletebiliyor. Bizim yorumumuz: bir üye kuruluşla ya da id.gs1.org ile hedefleri siz kontrol edersiniz, alan adını değil. Basılı alan adı ancak yeni baskılarla değişir.

Standart şirket öneki düzeyinde bir devre izin veriyor; dolayısıyla üye kuruluşunuza, önekinizi kendi resolver'ınıza yönlendirip yönlendirmeyeceğini sorun. Devir pratikte de görülebiliyor: id.gs1.org'da istenen Alman önekli bir GTIN, rel="gs1:handledBy" ile GS1 Germany'nin resolver'ına 307 aldı.

Şimdi bunu yasanın istedikleriyle karşılaştırın. ESPR Madde 11(e), pasaportun delege yasalarda belirlenen süre boyunca, Birlik içinde iflas, tasfiye veya faaliyetin sona ermesinden sonra da erişilebilir kalması gerektiğini söylüyor. Madde 10(4) ise bir pasaport hizmet sağlayıcısı aracılığıyla yedek kopya istiyor.

ESPR resolver'lar hakkında hiçbir şey söylemiyor. Bizim yorumumuz şu: kimsenin sahip çıkmadığı bir alan adına basılmış kod, yedek kopya var olsa bile pasaporta giden okutma yolunu koparır.

GS1'in kendi en iyi uygulaması da aynı yönü gösteriyor: URI'leri sahibi olduğunuz bir alan adında, tercihen bir id alt alan adında kurun. Alan adı, marka satılırsa devredilebilen bir marka varlığıdır; böylece kodların yeniden basılması gerekmez.

Örnek: İnegöl'de varsayımsal bir mobilya üreticisi

Türkiye'de, Almanya'da ve ötesinde satış yapan, 420 GTIN'li varsayımsal bir İnegöl mobilya üreticisi düşünün. Kodları karton etiketinde yer alıyor.

1. adım: alan adı. Kendi marka alan adında id. alt alan adını oluşturuyor ve onu bir GS1 Digital Link resolver'a yönlendiriyor. Tanım dosyası, tek bir kod basılmadan önce yayında.

2. adım: GTIN başına bir varsayılan, artı dil varyantları. Türkçe ürün sayfası 420 GTIN'in tamamı için varsayılan; yalnızca bir başlıkla gs1:defaultLink olarak tiplendiriliyor. Ardından Türkçe, Almanca ve İngilizce sayfaların her biri gs1:pip ve gs1:defaultLinkMulti olarak tiplendirilip tr, de ve en etiketleri alıyor.

Standardın kendi dil örneğindeki gibi Türkçe sayfa iki kez listeleniyor; böylece dili Türkçe olan ve İngilizceyi de listeleyen bir telefon yine Türkçe sayfayı alıyor. Bu, GTIN başına dört bağlantı demek: toplam 1.680.

gs1:defaultLinkMulti tipini destekleyen bir resolver'da Almanca bir telefonda artık Almanca sayfa açılıyor. Fransızca varyant olmadığı için Fransızca bir telefonda Türkçe varsayılan sayfa açılıyor.

3. adım: GTIN düzeyinde tipli bağlantılar. Her GTIN için bir gs1:instructions bağlantısı montaj PDF'ine işaret ediyor: 420 bağlantı daha. Her pasaport sayfası yayına girdikçe GTIN başına bir gs1:dpp bağlantısı ekleniyor. Kod zaten GTIN'i taşıdığı için yeniden baskı gerekmiyor.

4. adım: basılı kod. Karton GTIN artı partiyi taşıyor, örneğin https://id.example.com/01/09520123456788/10/2611A.

5. adım: geri çağırma. Bir menteşe hatası, 12 masa GTIN'inde 2611A partisini etkiliyor. Üretici GTIN artı parti düzeyinde 12 gs1:recallStatus bağlantısı kaydediyor. O partiden bir kartonun geri çağırma durumunu soran her uygulama bu bağlantıyı buluyor.

Birinci karşı senaryo: yanlış düzeyde geri çağırma. ERP'nin geri çağırmayı renk varyantı bazında tuttuğunu ve bağlantıların GTIN artı varyant artı parti düzeyinde girildiğini varsayın. Kartonlar ise yalnızca GTIN artı parti taşıyor.

Resolver yalnızca aldığı sorguyu yanıtladığı için geri çağırma bağlantısı hiç bulunmuyor. Bir geri çağırma uygulaması 404 alıyor ve bu "geri çağırma bilgisi yok" gibi okunuyor.

İkinci karşı senaryo: tek yanlış karakter. Bir perakendecinin uygulaması sondaki s harfi olmadan linkType=gs1:instruction istiyor. Standardın kendi örneği, kayıtlı olmayan her tip için 404 bekliyor.

6 Ekim 2026'da id.gs1.org'u test ettiğimizde bu istek varsayılan sayfaya gitti; gs1:recallStatus gibi geçerli ama kayıtsız bir tip ise 404 aldı. Her iki durumda da uygulama talimatlara ulaşamıyor.

Etiket şablonunda yanlış yazılmış bir kontrol hanesi daha da kötü: o baskının her okutması 400 döndürür.

Sınır durumlar

Sıkıştırılmış URI'ler. Uyumlu bir GS1 Digital Link resolver, RFID etiketlerinde kullanılan kompakt kodlama olan EPC ikili dizelerini açmak zorundadır. Genel sıkıştırılmış URI'leri açmak isteğe bağlı; bu yüzden sıkıştırılmış bir kod bazı resolver'larda başarısız olabilir. GS1'in henüz onaylanmamış geçici DPP standardı sıkıştırılmamış formu istiyor.

Sondaki eğik çizgi. /01/09520123456788/ geçerli bir sözdizimi değil, ama resolver'ların buna tolerans göstermesi bekleniyor. Bu biçimi basmayın.

Dil eşleşmesi yok. Bir uygulama gs1:instructions isterse ve siz Türkçe ve Almanca sürümler kaydettiyseniz, Fransızca bir telefon ikisinin listelendiği bir 300 Multiple Choices alabilir. Sattığınız her dil için bir sürüm ekleyin ya da bazı kullanıcıların bir liste göreceğini kabul edin.

Yönlendirme zincirleri. id.gs1.org bir isteği üye kuruluş resolver'ına devredebilir, o da sizin sayfanıza yönlendirir. Her adım gecikme ve bir arıza noktası ekler.

Sorgu dizesi sızıntısı. Sorgu dizesinin tamamı hedef sayfanıza ulaşır. Sayfanın ?17=271231 gibi parametrelere dayanıklı olduğundan emin olun. Basılı bir URI'ye asla kişisel veya gizli veri koymayın.

Resolver'ı olmayan uygulamalar. Digital Link sözdizimine uyan bir URI, arkasında bir resolver olduğunu kanıtlamaz. Uygulamalar bir resolver olduğunu varsaymamalı; URI Syntax standardının tarif ettiği test, /.well-known/gs1resolver adresini kontrol etmektir.

Büyük resim: resolver neden sizden uzun yaşamalı?

Pasaport veriyle ilgilidir. GS1 Digital Link resolver ise ulaşılabilirlikle ilgilidir ve yasanın zamana bağladığı şey de ulaşılabilirliktir.

Kabul edilmiş yasa. ESPR Madde 9(2)(i), her delege yasanın pasaportun ne kadar süre erişilebilir kalacağını, en az ürünün beklenen ömrü kadar, belirleyeceğini söylüyor. Madde 10(1) veri taşıyıcıyı kalıcı bir benzersiz ürün tanımlayıcısına bağlıyor ve verinin tedarikçi bağımlılığı (vendor lock-in) olmadan taşınabilmesini şart koşuyor.

Bunların hiçbiri bir resolver'ın adını anmıyor. Bizim yorumumuz şu: ambalajdaki alan adı ve arkasındaki GS1 Digital Link resolver, bu yükümlülüklerin pratikte buluştuğu yer.

Kabul edilmiş yasa, gönüllü standartlar. (AB) 2026/1736 sayılı Komisyon Uygulama Kararı altı uyumlaştırılmış DPP standardına atıf yapıyor: EN 18216, EN 18219, EN 18220, EN 18221, EN 18222 ve EN 18223. Bunlara uymak, ESPR Madde 10 ve 11'e uygunluk karinesi sağlıyor.

Bu standartların tam metinleri ücretli ve onlara herhangi bir resolver kuralı atfetmiyoruz.

Bilinmeyen. gs1:dpp var, ama onu ya da belirli bir resolver davranışını şart koşan bir delege yasa bulamadık. ESPR Madde 9(2)(b)'ye göre her delege yasa kendi ürün grubunun veri taşıyıcılarını belirliyor.

Beklenen. GS1'in DPP uygulama standardı geçici ve bunu açıkça söylüyor. Marka sahibinin alan adında tam URI'yi, QR kod veya Data Matrix'i ve sıkıştırılmamış URI'leri tercih ediyor.

Batarya pasaportu ayrı bir tüzükle, (AB) 2023/1542 sayılı Tüzük'le yürüyor ve yasada sabit bir tarihi var: 18 Şubat 2027. Tüzüğün Madde 77(3)'ü veri taşıyıcıyı zaten adlandırıyor: QR kod.

Çerçeve için ESPR rehberimizi ve dijital ürün pasaportu nedir yazımızı okuyun.

Bu çeyrekte ne yapmalı?

1. Marka alan adınızdaki id. alt alan adına sahip çıkın, bir sonraki kodu basmadan önce.
2. GTIN başına bir varsayılan belirleyin ve varsayılanın dili dahil her dil sayfasını gs1:defaultLinkMulti olarak tiplendirin.
3. Tipli bağlantıları güncel GS1 adlarıyla kaydedin: gs1:instructions, gs1:sustainabilityInfo ve pasaportlar oluştuğunda gs1:dpp.
4. /.well-known/gs1resolver dosyasını yayımlayın veya doğrulayın ve GS1'in şemasına göre kontrol edin.
5. GS1 Digital Link resolver'ınızı yukarıdaki dört kontrolle test edin ve kodladığınız her URI'yi ücretsiz oluşturucuyla kontrol edin. Oluşturucu kayıt gerektirmez ve tarayıcınızda çalışır.

Daha ileri gitmek isterseniz Passmith'in bir ücretsiz planı da var.

İlgili: GS1 Digital Link ile QR kod farkı · GS1 Digital Link nedir? · GS1 2D barkod rehberi · AB dışı üreticiler için DPP · Ücretsiz GS1 Digital Link QR oluşturucu

İlgili yazılar

GS1 Digital Link ile QR Kod Farkı Nedir?Her GS1 Digital Link bir QR koddur, ama her QR kod GS1 Digital Link değildir. Fark nerede, karşılaştırma tablosu ve hangi durumda hangisi yeterli.Karekoda Geçiş: Üreticiler İçin 2027 Yol HaritasıPerakende 2027 sonuna kadar kasada karekod okutmayı hedefliyor. Klasik barkoddan GS1 uyumlu karekoda beş adımda geçiş, 90 günlük pilot ve baskı kontrol listesi.Dijital Ürün Pasaportu Nedir? 2026 Kapsamlı RehberDijital Ürün Pasaportu (DPP) nedir, nasıl çalışır, hangi ürünlerde ne zaman zorunlu (bataryalarda 18 Şubat 2027), hangi verileri içerir? Kapsamlı rehber.