Kody QR w DPP: rozmiar, korekcja błędów i GS1 (przewodnik dla deweloperów)

Kod QR na cyfrowym paszporcie produktu to nie zwykły QR — przenosi GS1 Digital Link, musi przetrwać nadruk na produkcie i niezawodnie prowadzić do paszportu. Szczegóły techniczne, które pomija większość przewodników, wraz z gotowym do druku kodem generującym.

autor: QR3 Redaktion

Kody QR w DPP: rozmiar, korekcja błędów i GS1 (przewodnik dla deweloperów)

Kod QR na cyfrowym paszporcie produktu wygląda jak każdy inny czarno-biały kwadrat. Ale nim nie jest. Musi przenosić GS1 Digital Link, przetrwać nadruk w małym rozmiarze na zakrzywionym, podatnym na zarysowania produkcie i niezawodnie prowadzić do paszportu przez całe życie produktu. Oto, co naprawdę ma znaczenie, gdy taki kod generujesz — czyli to, co większość artykułów o „kodach QR w DPP" pomija.

Kod QR w DPP koduje ustrukturyzowany adres URL GS1, a nie example.com/product/123:

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

01 to GTIN, 21 to numer seryjny. Każdy aparat go otworzy; resolver zwraca odpowiednią reprezentację w zależności od tego, kto wysyła zapytanie (zobacz The GS1 Digital Link Resolver, Explained). Skieruj kod QR do swojego resolvera, a GTIN/numer seryjny pozostaną stabilne na zawsze.

Poziom korekcji błędów: dla produktów wybierz Q lub H

Kody QR mają cztery poziomy korekcji błędów — im wyższy, tym większą część symbolu można uszkodzić, a kod nadal się zeskanuje:

Poziom Odzysk Czy do DPP?
L ~7 % Nie — zbyt podatny na uszkodzenia na fizycznych produktach
M ~15 % Tylko web/ekran
Q ~25 % Tak — etykiety, opakowania
H ~30 % Tak — małe, zakrzywione lub mocno eksploatowane produkty

Etykieta paszportu może zostać zarysowana, wygięta wokół ogniwa baterii lub częściowo starta. Użyj Q lub H, aby skanowała się nawet po roku użytkowania w terenie. Wyższa korekcja oznacza gęstszy symbol, więc trzeba ją zbilansować względem rozmiaru nadruku.

Strefa wolna i minimalny rozmiar nadruku

  • Strefa wolna (quiet zone): zachowaj wolny margines o szerokości co najmniej 4 modułów wokół symbolu. Żadnych logo ani tekstu w jego obrębie.
  • Minimalny rozmiar: zasada praktyczna mówi, że rozmiar modułu powinien wynosić ≥ 0,33 mm przy skanowaniu telefonem z bliska; większy, jeśli kod jest skanowany z odległości. Na typowej drukarce etykiet 300 DPI to mniej więcej symbol 2 × 2 cm dla Digital Link zawierającego numer seryjny — zweryfikuj to z najgorszym możliwym scenariuszem skanera i oświetlenia.

Dynamiczny, a nie statyczny — inaczej nie jest zgodny z przepisami

Statyczny kod QR zapisuje dane na trwałe w symbolu. Dane w DPP zmieniają się w cyklu życia produktu (ponownie zmierzony ślad węglowy, osiągnięty cel udziału materiałów z recyklingu, zaktualizowane informacje o naprawach). Jeśli dane są wpisane na stałe, nie da się ich zaktualizować bez ponownego druku każdej etykiety — a nieaktualny paszport jest niezgodny z przepisami.

Dlatego kod QR w DPP musi być dynamiczny: przenosi stabilny adres URL resolvera (niezmienny GTIN/numer seryjny), a dane stojące za nim są aktualizowane przez API. Wydrukuj raz, aktualizuj zawsze.

Wygeneruj gotowy do druku kod QR dla DPP (kod)

Utworzenie paszportu zwraca kod QR w czterech formatach — bez osobnego kroku generowania 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); // wektor — skaluje się do dowolnego rozmiaru etykiety, bez pikselozy
console.log(passport.qr.pdf); // PDF w CMYK do druku
// qr.png do internetu, qr.eps do profesjonalnych drukarek etykiet

Do etykiet używaj SVG lub EPS (wektor przetrwa dowolne skalowanie); do internetu — PNG. Kod QR już koduje GS1 Digital Link prowadzący do paszportu.

Maleńkie produkty: GS1 Data Matrix

Gdy nie ma miejsca na kod QR (mała elektronika, biżuteria), GS1 Data Matrix przenosi ten sam Digital Link na mniejszej przestrzeni i jest obsługiwany przez te same standardy. Ten sam adres URL, mniejszy symbol.

FAQ

Czy mogę umieścić logo na środku? Tak, w ramach budżetu korekcji błędów — przy poziomie Q/H małe, wyśrodkowane logo da się odzyskać. Pozostaw strefę wolną pustą i wykonaj testowe skanowanie.

Czy kod QR zawiera same dane produktu? Nie — zawiera GS1 Digital Link. Dane znajdują się za resolverem i pozostają aktualizowalne. To właśnie sprawia, że paszport jest trwały.

SVG czy PNG do etykiet? SVG/EPS (wektor) do wszystkiego, co drukowane — skaluje się czysto do dowolnego rozmiaru. PNG tylko do użytku w internecie o stałym rozmiarze.

Źródła

Zacznij za darmo i wygeneruj gotowy do druku kod QR dla DPP: app.qr3.app/sign-up