QR kódy pre DPP: veľkosť, korekcia chýb a GS1 (príručka pre vývojárov)

QR kód na digitálnom produktovom pase nie je len obyčajný QR — nesie GS1 Digital Link, musí prežiť potlač na produkte a musí sa rozlíšiť na pas. Technické detaily, ktoré väčšina príručiek vynecháva, spolu s kódom na generovanie pripravené na tlač.

autor QR3 Redaktion

QR kódy pre DPP: veľkosť, korekcia chýb a GS1 (príručka pre vývojárov)

QR kód na digitálnom produktovom pase vyzerá ako každý iný čierno-biely štvorec. Nie je to tak. Musí niesť GS1 Digital Link, prežiť potlač v malej veľkosti na zakrivenom, odieratelnom produkte a počas celého života produktu sa spoľahlivo rozlíšiť na pas. Tu je to, na čom skutočne záleží pri jeho generovaní — časti, ktoré väčšina článkov o „QR kódoch pre DPP" vynecháva.

QR kód pre DPP kóduje štruktúrovanú GS1 URL, nie example.com/product/123:

https://id.gs1.org/01/04019999999902/21/DEMO-BAT-01

01 je GTIN, 21 sériové číslo. Otvorí ho ktorýkoľvek fotoaparát; resolver vráti správnu reprezentáciu podľa volajúceho (pozri GS1 Digital Link Resolver, vysvetlené). Nasmerujte QR na svoj resolver a GTIN/sériové číslo zostanú navždy stabilné.

Úroveň korekcie chýb: pre produkty zvoľte Q alebo H

QR kódy majú štyri úrovne korekcie chýb — čím vyššia, tým väčšia časť symbolu môže byť poškodená a kód sa stále načíta:

Úroveň Obnova Použiť pre DPP?
L ~7 % Nie — príliš krehké na fyzických produktoch
M ~15 % Iba web/obrazovka
Q ~25 % Áno — štítky, obaly
H ~30 % Áno — malé, zakrivené alebo produkty s tvrdým opotrebovaním

Štítok pasu sa môže poškriabať, ohnúť okolo článku batérie alebo čiastočne opotrebovať. Použite Q alebo H, aby sa dal načítať aj po roku v prevádzke. Vyššia korekcia znamená hustejší symbol, takže ju vyvážte oproti veľkosti tlače.

Tichá zóna a minimálna veľkosť tlače

  • Tichá zóna: okolo symbolu ponechajte voľný okraj aspoň 4 modulov. Žiadne logá, žiadny text v ňom.
  • Minimálna veľkosť: podľa základného pravidla by mala byť veľkosť modulu ≥ 0,33 mm pre skenovanie telefónom zblízka; väčšia, ak sa skenuje z diaľky. Na bežnej štítkovej tlačiarni s rozlíšením 300 DPI to predstavuje zhruba symbol s veľkosťou 2 × 2 cm pre Digital Link nesúci sériové číslo — overte si to so svojím najhorším možným skenerom a osvetlením.

Dynamický, nie statický — inak nie je v súlade

Statický QR vpečie údaje priamo do symbolu. Údaje pasu pre DPP sa počas životnosti produktu menia (uhlíková stopa sa premeria nanovo, dosiahne sa cieľ podielu recyklovaného materiálu, aktualizujú sa informácie o oprave). Ak sú údaje vpečené natrvalo, nemôžete ich aktualizovať bez opätovnej tlače každého štítku — a zastaraný pas nie je v súlade s predpismi.

QR kód pre DPP teda musí byť dynamický: nesie stabilnú URL resolvera (nemenné GTIN/sériové číslo) a údaje za ním sa aktualizujú cez API. Vytlačte raz, aktualizujte navždy.

Vygenerujte QR pre DPP pripravené na tlač (kód)

Vytvorenie pasu vráti QR v štyroch formátoch — žiadny samostatný krok QR:

import { QR3 } from "@qr3/sdk";

const client = new QR3({ apiKey: process.env.QR3_API_KEY! });

const passport = await client.dpp.create({
  gtin: "04019999999902",
  serial: "SN-00012345",
  product_name: "PowerCell 5 kWh LFP",
  manufacturer: "ExampleTech GmbH",
  origin_country: "DE",
  category: "battery",
  battery_data: { capacity_kwh: 5, carbon_footprint_kg: 62, recycled_content_pct: 12, recyclability_pct: 95, manufacturer_warranty_years: 8 },
});

console.log(passport.qr.svg); // vektor — škáluje sa na ľubovoľnú veľkosť štítku, bez pixelizácie
console.log(passport.qr.pdf); // CMYK PDF pre tlač
// qr.png pre web, qr.eps pre profesionálne štítkové tlačiarne

Pre štítky používajte SVG alebo EPS (vektor prežije akékoľvek škálovanie); PNG pre web. QR už kóduje GS1 Digital Link na pas.

Drobné produkty: GS1 Data Matrix

Keď nie je miesto pre QR (malá elektronika, šperky), GS1 Data Matrix nesie ten istý Digital Link na menšom priestore a podporujú ho rovnaké normy. Rovnaká URL, menší symbol.

FAQ

Môžem doprostred pridať svoje logo? Áno, v rámci rozpočtu korekcie chýb — na úrovni Q/H je malé vycentrované logo obnoviteľné. Ponechajte tichú zónu voľnú a otestujte skenovanie.

Obsahuje QR samotné údaje o produkte? Nie — obsahuje GS1 Digital Link. Údaje žijú za resolverom a zostávajú aktualizovateľné. Práve to robí pas trvácnym.

SVG vs PNG pre štítky? SVG/EPS (vektor) pre čokoľvek tlačené — škáluje sa čisto na ľubovoľnú veľkosť. PNG iba pre webové použitie s pevnou veľkosťou.

Zdroje

Začnite zadarmo a vygenerujte QR pre DPP pripravené na tlač: app.qr3.app/sign-up