DPP:n QR-koodit: koko, virheenkorjaus ja GS1 (kehittäjän opas)

Digitaalisen tuotepassin QR-koodi ei ole mikä tahansa QR — se sisältää GS1 Digital Linkin, sen on kestettävä tuotteeseen painamista ja sen on ohjattava passiin. Tekniset yksityiskohdat, jotka useimmat oppaat sivuuttavat, sekä painovalmis generointikoodi.

kirjoittanut QR3 Redaktion

DPP:n QR-koodit: koko, virheenkorjaus ja GS1 (kehittäjän opas)

Digitaalisen tuotepassin QR-koodi näyttää aivan tavalliselta mustavalkoiselta neliöltä. Se ei ole sitä. Sen on sisällettävä GS1 Digital Link, kestettävä pienenä painettuna kaarevaan, naarmuuntuvaan tuotteeseen ja ohjattava luotettavasti passiin koko tuotteen elinkaaren ajan. Tässä on se, millä todella on merkitystä, kun generoit sellaisen — ne osat, jotka useimmat "DPP-QR-koodi"-artikkelit sivuuttavat.

DPP-QR koodaa rakenteisen GS1-URL-osoitteen, ei example.com/product/123:

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

01 on GTIN, 21 sarjanumero. Mikä tahansa kamera avaa sen; resolveri palauttaa oikean esitysmuodon kullekin kutsujalle (katso The GS1 Digital Link Resolver, Explained). Osoita QR resolveriisi, niin GTIN/sarjanumero pysyvät muuttumattomina ikuisesti.

Virheenkorjaustaso: valitse tuotteille Q tai H

QR-koodeilla on neljä virheenkorjaustasoa — mitä korkeampi, sitä suurempi osa symbolista voi vaurioitua ja silti skannautua:

Taso Palautuminen DPP:hen?
L ~7 % Ei — liian hauras fyysisissä tuotteissa
M ~15 % Vain web/näyttö
Q ~25 % Kyllä — etiketit, pakkaukset
H ~30 % Kyllä — pienet, kaarevat tai kovassa kulutuksessa olevat tuotteet

Passietiketti voi naarmuuntua, taipua akkukennon ympärille tai kulua osittain. Käytä tasoa Q tai H, jotta se skannautuu yhä vuoden kentällä olon jälkeen. Korkeampi korjaustaso tarkoittaa tiheämpää symbolia, joten tasapainota se painokoon kanssa.

Hiljainen alue ja vähimmäispainokoko

  • Hiljainen alue: pidä symbolin ympärillä vähintään 4 moduulin vapaa marginaali. Ei logoja, ei tekstiä siinä.
  • Vähimmäiskoko: nyrkkisääntö, moduulin koon tulisi olla ≥ 0,33 mm lähietäisyydeltä tehtäviin puhelinskannauksiin; suurempi, jos skannataan etäältä. Tyypillisellä 300 DPI:n etikettitulostimella se on suunnilleen 2 × 2 cm kokoinen symboli sarjanumeron sisältävälle Digital Linkille — varmenna pahimman tapauksen skannerillasi ja valaistuksellasi.

Dynaaminen, ei staattinen — tai se ei ole vaatimustenmukainen

Staattinen QR sisällyttää datan symboliin. DPP:n data muuttuu tuotteen elinkaaren aikana (hiilijalanjälki mitataan uudelleen, kierrätysmateriaalitavoite saavutetaan, korjaustiedot päivitetään). Jos data on poltettu sisään, et voi päivittää sitä painamatta jokaista etikettiä uudelleen — ja vanhentunut passi ei ole vaatimustenmukainen.

Joten DPP-QR:n on oltava dynaaminen: se sisältää vakaa resolveri-URL-osoitteen (muuttumaton GTIN/sarjanumero), ja sen takana oleva data päivitetään APIn kautta. Paina kerran, päivitä ikuisesti.

Generoi painovalmis DPP-QR (koodi)

Passin luominen palauttaa QR:n neljässä muodossa — ei erillistä QR-vaihetta:

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); // vektori — skaalautuu mihin tahansa etikettikokoon, ei pikselöitymistä
console.log(passport.qr.pdf); // CMYK PDF painoa varten
// qr.png webiin, qr.eps ammattilaisten etikettitulostimille

Käytä etiketeissä SVG:tä tai EPS:ää (vektori kestää minkä tahansa skaalauksen); PNG:tä webiin. QR koodaa jo GS1 Digital Linkin passiin.

Pienet tuotteet: GS1 Data Matrix

Kun QR:lle ei ole tilaa (pieni elektroniikka, korut), GS1 Data Matrix sisältää saman Digital Linkin pienemmässä tilassa ja samat standardit tukevat sitä. Sama URL, pienempi symboli.

UKK

Voinko lisätä logoni keskelle? Kyllä, virheenkorjausbudjetin rajoissa — tasolla Q/H pieni keskitetty logo on palautettavissa. Pidä hiljainen alue vapaana ja testaa skannaamalla.

Sisältääkö QR itse tuotedatan? Ei — se sisältää GS1 Digital Linkin. Data sijaitsee resolverin takana ja pysyy päivitettävissä. Juuri se tekee passista kestävän.

SVG vai PNG etiketteihin? SVG/EPS (vektori) kaikkeen painettavaan — se skaalautuu siististi mihin tahansa kokoon. PNG vain kiinteäkokoiseen web-käyttöön.

Lähteet

Aloita ilmaiseksi ja generoi painovalmis DPP-QR: app.qr3.app/sign-up