Kodiċijiet QR tad-DPP: Daqs, Korrezzjoni tal-Iżbalji u GS1 (gwida għall-iżviluppaturi)

Il-kodiċi QR fuq Passaport Diġitali tal-Prodott mhuwiex sempliċiment kwalunkwe QR — iġorr GS1 Digital Link, irid jissopravvivi l-istampar fuq prodott, u jrid jirrisolvi għall-passaport. Id-dettalji tekniċi li ħafna gwidi jaqbżu, b'kodiċi ta' ġenerazzjoni lest għall-istampar.

minn QR3 Redaktion

Kodiċijiet QR tad-DPP: Daqs, Korrezzjoni tal-Iżbalji u GS1 (gwida għall-iżviluppaturi)

Il-kodiċi QR fuq Passaport Diġitali tal-Prodott jidher bħal kwalunkwe kwadru abjad u iswed ieħor. Mhuwiex. Irid iġorr GS1 Digital Link, jissopravvivi li jiġi stampat żgħir fuq prodott imgħawweġ u li jista' jinħakk, u jirrisolvi b'mod affidabbli għall-passaport għal ħajja sħiħa tal-prodott. Hawn x'verament jgħodd meta tiġġenera wieħed — il-partijiet li ħafna mill-artikli dwar "kodiċi QR tad-DPP" jaqbżu.

QR tad-DPP jikkodifika URL strutturat tal-GS1, mhux example.com/product/123:

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

01 huwa l-GTIN, 21 is-serje. Kwalunkwe kamera tiftħu; resolver jirritorna r-rappreżentazzjoni t-tajba skont min jitlobha (ara The GS1 Digital Link Resolver, Explained). Idderieġi l-QR lejn ir-resolver tiegħek u l-GTIN/serje jibqgħu stabbli għal dejjem.

Livell ta' korrezzjoni tal-iżbalji: agħżel Q jew H għall-prodotti

Il-kodiċijiet QR għandhom erba' livelli ta' korrezzjoni tal-iżbalji — iktar ma jkun għoli, iktar parti mis-simbolu tista' tiġi danneġġjata u xorta tiġi skennjata:

Livell Irkupru Tużah għal DPP?
L ~7 % Le — fraġli wisq fuq prodotti fiżiċi
M ~15 % Web/skrin biss
Q ~25 % Iva — tikketti, ippakkjar
H ~30 % Iva — prodotti żgħar, imgħawġin jew b'użu aħrax

Tikketta tal-passaport tista' tinħakk, tintewa madwar ċellola ta' batterija, jew tikkonsma parzjalment. Uża Q jew H biex xorta tiġi skennjata wara sena fuq il-post. Korrezzjoni ogħla tfisser simbolu iktar dens, għalhekk ibbilanċja kontra d-daqs tal-istampar.

Żona kwieta u daqs minimu tal-istampar

  • Żona kwieta: żomm marġni ċar ta' mill-inqas 4 moduli madwar is-simbolu. L-ebda logos, l-ebda test fih.
  • Daqs minimu: bħala regola ġenerali, id-daqs tal-modulu għandu jkun ≥ 0.33 mm għal skennjar mill-qrib bit-telefon; ikbar jekk jiġi skennjat mill-bogħod. Fuq stampatur tipiku ta' tikketti b'300 DPI dak huwa bejn wieħed u ieħor simbolu ta' 2 × 2 cm għal Digital Link li jġorr serje — ivverifika bl-agħar każ ta' skener u dawl tiegħek.

Dinamiku, mhux statiku — jew inkella mhuwiex konformi

QR statiku jaħmi d-data fis-simbolu. Id-data ta' DPP tinbidel matul il-ħajja tal-prodott (footprint tal-karbonju mkejjel mill-ġdid, mira ta' kontenut riċiklat milħuqa, informazzjoni dwar tiswija aġġornata). Jekk id-data tinħema, ma tistax taġġornaha mingħajr ma tistampa kull tikketta mill-ġdid — u passaport li mhux aġġornat mhuwiex konformi.

Għalhekk QR tad-DPP irid ikun dinamiku: iġorr URL stabbli tar-resolver (GTIN/serje immutabbli), u d-data wara tiegħu tiġi aġġornata permezz tal-API. Stampa darba, aġġorna għal dejjem.

Iġġenera QR tad-DPP lest għall-istampar (kodiċi)

Il-ħolqien ta' passaport jirritorna l-QR f'erba' formati — l-ebda pass QR separat:

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); // vector — scales to any label size, no pixelation
console.log(passport.qr.pdf); // CMYK PDF for print
// qr.png for the web, qr.eps for professional label printers

Uża SVG jew EPS għat-tikketti (il-vettur jissopravvivi kwalunkwe skalar); PNG għall-web. Il-QR diġà jikkodifika l-GS1 Digital Link għall-passaport.

Prodotti ċkejknin: GS1 Data Matrix

Meta ma jkunx hemm wisa' għal QR (elettronika żgħira, ġojjellerija), GS1 Data Matrix iġorr l-istess Digital Link f'inqas spazju u huwa appoġġjat mill-istess standards. L-istess URL, simbolu iżgħar.

FAQ

Nista' nżid il-logo tiegħi fin-nofs? Iva, fil-baġit tal-korrezzjoni tal-iżbalji — fil-livell Q/H logo żgħir iċċentrat jista' jiġi rkuprat. Żomm iż-żona kwieta ċara u ittestja l-iskennjar.

Il-QR fih id-data tal-prodott innifisha? Le — fih il-GS1 Digital Link. Id-data tgħix wara r-resolver u tibqa' tista' tiġi aġġornata. Dak huwa li jagħmel il-passaport durabbli.

SVG vs PNG għat-tikketti? SVG/EPS (vettur) għal kull ma jiġi stampat — jiskala b'mod nadif għal kwalunkwe daqs. PNG biss għal użu fuq il-web b'daqs fiss.

Sorsi

Ibda b'xejn u ġġenera QR tad-DPP lest għall-istampar: app.qr3.app/sign-up