DPP QR kodovi: dimenzije, ispravljanje pogrešaka i GS1 (vodič za programere)

QR kod na digitalnoj putovnici proizvoda nije bilo kakav QR — nosi GS1 Digital Link, mora preživjeti ispis na proizvodu i mora se razriješiti do putovnice. Inženjerski detalji koje većina vodiča preskače, uz kôd za generiranje spreman za ispis.

autor QR3 Redaktion

DPP QR kodovi: dimenzije, ispravljanje pogrešaka i GS1 (vodič za programere)

QR kod na digitalnoj putovnici proizvoda izgleda kao svaki drugi crno-bijeli kvadrat. Nije. Mora nositi GS1 Digital Link, preživjeti ispis u maloj veličini na zakrivljenom proizvodu sklonom ogrebotinama i pouzdano se razriješiti do putovnice tijekom cijelog životnog vijeka proizvoda. Evo što stvarno bitno kad ga generirate — dijelovi koje većina članaka o "DPP QR kodu" preskače.

DPP QR kodira strukturirani GS1 URL, a ne example.com/product/123:

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

01 je GTIN, 21 serijski broj. Svaka kamera ga otvara; resolver vraća ispravnu reprezentaciju ovisno o pozivatelju (vidi The GS1 Digital Link Resolver, Explained). Usmjerite QR na svoj resolver i GTIN/serijski broj zauvijek ostaju stabilni.

Razina ispravljanja pogrešaka: za proizvode odaberite Q ili H

QR kodovi imaju četiri razine ispravljanja pogrešaka — što je viša, to veći dio simbola može biti oštećen, a kod se i dalje skenira:

Razina Oporavak Za DPP?
L ~7 % Ne — prekrhko na fizičkim proizvodima
M ~15 % Samo web/zaslon
Q ~25 % Da — etikete, ambalaža
H ~30 % Da — mali, zakrivljeni proizvodi ili oni izloženi grubom trošenju

Etiketa putovnice može se ogrebati, savinuti oko ćelije baterije ili djelomično istrošiti. Koristite Q ili H kako bi se i dalje skenirala nakon godinu dana u terenskoj upotrebi. Viša razina ispravljanja znači gušći simbol, pa to uravnotežite s veličinom ispisa.

Mirna zona i minimalna veličina ispisa

  • Mirna zona: zadržite čistu marginu od najmanje 4 modula oko simbola. Bez logotipa, bez teksta u njoj.
  • Minimalna veličina: kao pravilo, veličina modula trebala bi biti ≥ 0,33 mm za skeniranje telefonom iz blizine; veća ako se skenira s udaljenosti. Na tipičnom pisaču etiketa od 300 DPI to je otprilike simbol veličine 2 × 2 cm za Digital Link sa serijskim brojem — provjerite sa svojim najnepovoljnijim scenarijem skenera i osvjetljenja.

Dinamičan, ne statičan — inače nije usklađen

Statični QR ugrađuje podatke u sam simbol. Podaci DPP-a mijenjaju se tijekom životnog vijeka proizvoda (ponovno izmjeren ugljični otisak, dosegnut cilj udjela recikliranog materijala, ažurirani podaci o popravku). Ako su podaci ugrađeni, ne možete ih ažurirati bez ponovnog ispisa svake etikete — a zastarjela putovnica nije usklađena.

Stoga DPP QR mora biti dinamičan: nosi stabilan URL resolvera (nepromjenjivi GTIN/serijski broj), a podaci iza njega ažuriraju se putem API-ja. Ispišite jednom, ažurirajte zauvijek.

Generirajte DPP QR spreman za ispis (kôd)

Stvaranje putovnice vraća QR u četiri formata — bez zasebnog koraka za 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 — skalira se na bilo koju veličinu etikete, bez pikselizacije
console.log(passport.qr.pdf); // CMYK PDF za ispis
// qr.png za web, qr.eps za profesionalne pisače etiketa

Za etikete koristite SVG ili EPS (vektor preživljava bilo kakvo skaliranje); PNG za web. QR već kodira GS1 Digital Link do putovnice.

Sićušni proizvodi: GS1 Data Matrix

Kad nema mjesta za QR (mala elektronika, nakit), GS1 Data Matrix nosi isti Digital Link u manje prostora i podržavaju ga isti standardi. Isti URL, manji simbol.

FAQ

Mogu li dodati svoj logotip u sredinu? Da, unutar budžeta za ispravljanje pogrešaka — na razini Q/H mali centrirani logotip može se oporaviti. Zadržite mirnu zonu čistom i testirajte skeniranjem.

Sadrži li QR same podatke o proizvodu? Ne — sadrži GS1 Digital Link. Podaci žive iza resolvera i ostaju ažurni. To je ono što putovnicu čini trajnom.

SVG ili PNG za etikete? SVG/EPS (vektor) za sve što se ispisuje — čisto se skalira na bilo koju veličinu. PNG samo za web upotrebu fiksne veličine.

Izvori

Započnite besplatno i generirajte DPP QR spreman za ispis: app.qr3.app/sign-up