--- title: "Kody QR w DPP: rozmiar, korekcja błędów i GS1 (przewodnik dla deweloperów) — qr3.app Blog" description: "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." canonical: "https://qr3.app/pl/blog/dpp-qr-code-guide/" lang: "pl" robots: "index,follow,max-image-preview:large,max-snippet:-1" --- # Kody QR w DPP: rozmiar, korekcja błędów i GS1 (przewodnik dla deweloperów) — qr3.app Blog > 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. Canonical: [← Blog](/pl/blog/) [Poradniki](/pl/blog/category/tutorials/) 30 maja 2026 4 min czytania [Poradniki](/pl/blog/category/tutorials/) [dpp](/pl/blog/tag/dpp/)[qr-code](/pl/blog/tag/qr-code/)[gs1-digital-link](/pl/blog/tag/gs1-digital-link/)[error-correction](/pl/blog/tag/error-correction/)[labeling](/pl/blog/tag/labeling/) # 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)](https://qr3-blog-agent.meistern.workers.dev/cdn/blog/dpp-qr-code-guide/hero.png) 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. ## To GS1 Digital Link, a nie zwykły adres URL Kod QR w DPP koduje ustrukturyzowany adres URL GS1, a nie `example.com/product/123`: ``` https://id.gs1.org/01/09520000000011/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: "09520000000011", 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 - [GS1 Digital Link standard](https://www.gs1.org/standards/gs1-digital-link) - [ISO/IEC 18004 — QR Code symbology](https://www.iso.org/standard/62021.html) - [EU Battery Regulation 2023/1542](https://eur-lex.europa.eu/eli/reg/2023/1542/oj) **Zacznij za darmo** i wygeneruj gotowy do druku kod QR dla DPP: [app.qr3.app/sign-up](https://app.qr3.app/sign-up) To działające demonstracje z fikcyjnymi danymi produktów i przykładowymi numerami GTIN z prefiksu GS1 952. Nie potwierdzają przydzielonych identyfikatorów produktów, wpisu do rejestru ani certyfikacji. ## Powiązane artykuły - [![](https://qr3-blog-agent.meistern.workers.dev/cdn/blog/gs1-resolver-test-suite-dpp-links/hero.png) Poradniki Pakiet testów Resolvera GS1: DPP-Linki — rzetelna weryfikacja przed uruchomieniem produkcyjnym Stabilny pakiet testów GS1 umożliwia weryfikację Resolvera 1.2. Sprawdź przekierowania, zestawy linków, CORS, języki i przypadki błędów przed uruchomieniem produkcyjnym.](/pl/blog/gs1-resolver-test-suite-dpp-links/) - [![](https://qr3-blog-agent.meistern.workers.dev/cdn/blog/ppwr-one-data-carrier-dpp/hero.png) Technologia kodów QR PPWR, kod QR i DPP: Dlaczego wystarczy jeden nośnik danych PPWR wymaga otwartych cyfrowych nośników danych dla informacji o opakowaniach. Dzięki nim można połączyć opakowanie, sortowanie i paszport produktu za pomocą stabilnego punktu dostępu.](/pl/blog/ppwr-one-data-carrier-dpp/) - [![](https://qr3-blog-agent.meistern.workers.dev/cdn/blog/dpp-battery-passport-2027-20260715/hero.png) Wiadomości branżowe BatteryPass-Ready uruchamia środowisko testowe dla Cyfrowego Paszportu Baterii Konsorcjum BatteryPass-Ready uruchomiło 24 czerwca 2026 r. publiczne środowisko testowe dla Cyfrowego Paszportu Baterii, z myślą o obowiązku UE od lutego 2027 r.](/pl/blog/dpp-battery-passport-2027-20260715/) - [![](https://qr3-blog-agent.meistern.workers.dev/cdn/blog/sector-20260713/hero.png) Wiadomości branżowe Cyfrowy paszport baterii 2027: co producenci muszą wiedzieć już teraz Webinary, narzędzia open source i nowe normy: unijny paszport baterii nabiera tempa. Przegląd sytuacji w lipcu 2026 r. i otwartych kwestii do lutego 2027 r.](/pl/blog/sector-20260713/) [← Wszystkie artykuły](/pl/blog/) [Zacznij za darmo](https://app.qr3.app/sign-up)