QR-kode DPP: velikost, korekcija napak in GS1 (vodnik za razvijalce)

QR-koda na digitalnem potnem listu izdelka ni kar tako navadna QR-koda — vsebuje GS1 Digital Link, mora preživeti tisk na izdelku in se mora razrešiti do potnega lista. Inženirski podrobnosti, ki jih večina vodnikov izpusti, skupaj s kodo za generiranje, pripravljeno za tisk.

avtor QR3 Redaktion

QR-kode DPP: velikost, korekcija napak in GS1 (vodnik za razvijalce)

QR-koda na digitalnem potnem listu izdelka je videti kot vsak drug črno-bel kvadrat. Pa ni. Vsebovati mora GS1 Digital Link, preživeti tisk v majhni velikosti na ukrivljenem in odrgnjivem izdelku ter se vse življenje izdelka zanesljivo razreševati do potnega lista. Tukaj je tisto, kar je pri generiranju resnično pomembno — deli, ki jih večina člankov o »QR-kodah za DPP« izpusti.

QR-koda DPP kodira strukturiran URL GS1, ne example.com/product/123:

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

01 je GTIN, 21 serijska številka. Vsaka kamera jo odpre; razreševalnik (resolver) klicatelju vrne pravo predstavitev (glej The GS1 Digital Link Resolver, Explained). Usmerite QR-kodo na svoj razreševalnik in GTIN/serijska številka ostaneta za vedno stabilna.

Raven korekcije napak: za izdelke izberite Q ali H

QR-kode imajo štiri ravni korekcije napak — višja kot je, večji del simbola je lahko poškodovan in se še vedno skenira:

Raven Obnovitev Za DPP?
L ~7 % Ne — preveč krhko za fizične izdelke
M ~15 % Samo za splet/zaslon
Q ~25 % Da — etikete, embalaža
H ~30 % Da — majhni, ukrivljeni ali grobo obrabljeni izdelki

Etiketa s potnim listom se lahko opraska, upogne okrog baterijske celice ali delno obrabi. Uporabite Q ali H, da se še vedno skenira po letu dni na terenu. Višja korekcija pomeni gostejši simbol, zato to uravnotežite z velikostjo tiska.

Mirno območje in najmanjša velikost tiska

  • Mirno območje (quiet zone): okrog simbola ohranite prazen rob vsaj 4 modulov. Brez logotipov, brez besedila v njem.
  • Najmanjša velikost: kot pravilo, velikost modula naj bo ≥ 0,33 mm za skeniranje s telefonom od blizu; večja, če se skenira z razdalje. Na tipičnem tiskalniku etiket pri 300 DPI to pomeni približno 2 × 2 cm velik simbol za Digital Link s serijsko številko — preverite z najslabšim možnim skenerjem in osvetlitvijo.

Dinamičen, ne statičen — sicer ni skladen

Statična QR-koda vbije podatke v simbol. Podatki DPP se v življenjski dobi izdelka spreminjajo (ogljični odtis se ponovno izmeri, cilj deleža recikliranih materialov se doseže, podatki o popravilih se posodobijo). Če so podatki vbiti v simbol, jih ne morete posodobiti, ne da bi ponovno natisnili vsako etiketo — zastarel potni list pa ni skladen.

Zato mora biti QR-koda DPP dinamična: vsebuje stabilen URL razreševalnika (nespremenljiv GTIN/serijska številka), podatki za njo pa se posodabljajo prek API-ja. Natisnite enkrat, posodabljajte za vedno.

Generiranje QR-kode DPP, pripravljene za tisk (koda)

Ob ustvarjanju potnega lista dobite QR-kodo v štirih oblikah — brez ločenega 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 — prilagodi se vsaki velikosti etikete, brez pikseliranja
console.log(passport.qr.pdf); // CMYK PDF za tisk
// qr.png za splet, qr.eps za profesionalne tiskalnike etiket

Za etikete uporabite SVG ali EPS (vektor preživi vsako spreminjanje velikosti); PNG za splet. QR-koda že kodira GS1 Digital Link do potnega lista.

Drobni izdelki: GS1 Data Matrix

Kadar za QR-kodo ni prostora (drobna elektronika, nakit), enako vsebino Digital Link na manjšem prostoru nosi GS1 Data Matrix, ki ga podpirajo isti standardi. Enak URL, manjši simbol.

Pogosta vprašanja

Ali lahko v sredino dodam svoj logotip? Da, v okviru proračuna za korekcijo napak — pri ravni Q/H je majhen sredinski logotip še obnovljiv. Ohranite mirno območje prazno in preizkusite skeniranje.

Ali QR-koda vsebuje same podatke o izdelku? Ne — vsebuje GS1 Digital Link. Podatki živijo za razreševalnikom in ostanejo posodobljivi. Prav to naredi potni list trajen.

SVG ali PNG za etikete? SVG/EPS (vektor) za vse natisnjeno — čisto se prilagodi vsaki velikosti. PNG samo za spletno uporabo v fiksni velikosti.

Viri

Začnite brezplačno in ustvarite QR-kodo DPP, pripravljeno za tisk: app.qr3.app/sign-up