QR kódy pro DPP: velikost, korekce chyb a GS1 (průvodce pro vývojáře)

QR kód na digitálním produktovém pasu není jen tak ledajaký QR kód — nese GS1 Digital Link, musí přežít tisk na produktu a musí vést k danému pasu. Technické detaily, které většina průvodců vynechává, včetně kódu pro generování připraveného k tisku.

autor QR3 Redaktion

QR kódy pro DPP: velikost, korekce chyb a GS1 (průvodce pro vývojáře)

QR kód na digitálním produktovém pasu vypadá jako každý jiný černobílý čtverec. Není tomu tak. Musí nést GS1 Digital Link, přežít tisk v malé velikosti na zakřivený, odíratelný produkt a po celou životnost produktu spolehlivě vést k jeho pasu. Zde je to, na čem při generování opravdu záleží — části, které většina článků o „QR kódech pro DPP" přeskakuje.

QR kód pro DPP kóduje strukturovanou URL adresu GS1, nikoli example.com/product/123:

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

01 je GTIN, 21 je sériové číslo. Otevře jej libovolný fotoaparát; resolver podle volajícího vrátí správnou reprezentaci (viz The GS1 Digital Link Resolver, Explained). Nasměrujte QR kód na svůj resolver a GTIN/sériové číslo zůstanou navždy stabilní.

Úroveň korekce chyb: pro produkty zvolte Q nebo H

QR kódy mají čtyři úrovně korekce chyb — čím vyšší, tím větší část symbolu může být poškozena a stále se naskenuje:

Úroveň Obnova Použít pro DPP?
L ~7 % Ne — na fyzických produktech příliš křehké
M ~15 % Pouze web/obrazovka
Q ~25 % Ano — etikety, obaly
H ~30 % Ano — malé, zakřivené nebo silně namáhané produkty

Etiketa s pasem se může poškrábat, ohnout kolem článku baterie nebo se částečně opotřebovat. Použijte Q nebo H, aby se naskenovala i po roce v terénu. Vyšší korekce znamená hustší symbol, takže ji vyvažte s velikostí tisku.

Klidová zóna a minimální velikost tisku

  • Klidová zóna: ponechte volný okraj alespoň 4 modulů kolem symbolu. Žádná loga, žádný text v ní.
  • Minimální velikost: orientačně by velikost modulu měla být ≥ 0,33 mm pro skenování telefonem z blízka; pro skenování z dálky větší. Na typické etiketovací tiskárně s 300 DPI to je u Digital Linku se sériovým číslem zhruba symbol 2 × 2 cm — ověřte s nejhorším možným skenerem a osvětlením.

Dynamický, ne statický — jinak není v souladu s předpisy

Statický QR kód zapéká data přímo do symbolu. Data DPP se během životnosti produktu mění (znovu změřená uhlíková stopa, dosažený cíl podílu recyklovaného materiálu, aktualizované informace o opravách). Pokud jsou data zapečena, nelze je aktualizovat bez opětovného tisku každé etikety — a zastaralý pas není v souladu s předpisy.

QR kód pro DPP tedy musí být dynamický: nese stabilní URL adresu resolveru (neměnný GTIN/sériové číslo) a data za ní se aktualizují přes API. Vytiskněte jednou, aktualizujte navždy.

Vygenerujte QR kód pro DPP připravený k tisku (kód)

Vytvoření pasu vrátí QR kód ve čtyřech formátech — žádný samostatný krok pro 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 se na libovolnou velikost etikety, bez pixelace
console.log(passport.qr.pdf); // CMYK PDF pro tisk
// qr.png pro web, qr.eps pro profesionální etiketovací tiskárny

Pro etikety použijte SVG nebo EPS (vektor přežije libovolné škálování); pro web PNG. QR kód již kóduje GS1 Digital Link vedoucí k pasu.

Drobné produkty: GS1 Data Matrix

Když není místo pro QR kód (malá elektronika, šperky), GS1 Data Matrix nese stejný Digital Link na menším prostoru a je podporován stejnými standardy. Stejná URL, menší symbol.

FAQ

Mohu doprostřed přidat své logo? Ano, v rámci rozpočtu korekce chyb — na úrovni Q/H je malé vystředěné logo obnovitelné. Ponechte klidovou zónu volnou a otestujte skenování.

Obsahuje QR kód samotná data produktu? Ne — obsahuje GS1 Digital Link. Data žijí za resolverem a zůstávají aktualizovatelná. To je to, co dělá pas trvanlivým.

SVG vs PNG pro etikety? SVG/EPS (vektor) pro cokoli tištěného — škáluje se čistě na libovolnou velikost. PNG pouze pro web s pevnou velikostí.

Zdroje

Začněte zdarma a vygenerujte QR kód pro DPP připravený k tisku: app.qr3.app/sign-up