GS1-tunnisteet & Onboarding

qr3.app perustuu BYO-GTIN/BYO-GLN-malliin (Bring Your Own): Tuot mukanasi olemassa olevat GS1-tunnisteesi — qr3 hoitaa niiden päällä olevan digitaalisen tuotekerroksen (Product Layer).

Mitä GS1 tekee?

GS1 myöntää maailmanlaajuisesti yksilöllisiä tunnisteita tuotteille ja toimipaikoille:

Tunniste	Kuvaus	Esimerkki
GTIN-14	Global Trade Item Number (tuotetunniste)	`04012345678901`
GLN-13	Global Location Number (toimipaikka/yritys)	`4012345000009`
Company Prefix	Yritystunniste (7–12 numeroa), josta GTIN-koodit johdetaan	`4012345`

Saadaksesi GTIN-koodeja tarvitset GS1-jäsenyyden kansalliselta GS1-organisaatioltasi (esim. GS1 Finland).

Mitä qr3.app tekee?

qr3.app hyödyntää olemassa olevia GS1-tunnisteitasi ja tarjoaa:

GS1-yhteensopiva resolveri — /01/{GTIN}/21/{Serial} sisällön neuvottelulla (Content-Negotiation)
EU Digital Product Passport — DPP-luonti, validointi, kuluttajanäkymä
Tulostusvalmiit QR-tiedostot — SVG, PNG, vektori-PDF, EPS
JSON-LD, DCAT-AP — Koneellisesti luettavat tuotetiedot

Onboarding-prosessi

1. Rekisteröi GS1-tunnisteet

Ennen kuin voit luoda DPP-passeja, sinun on rekisteröitävä GTIN-koodisi (tai Company Prefix -yritystunnisteesi):

API:n kautta:

curl -X POST https://qr3.app/v1/gs1/identifiers \
  -H "Authorization: Bearer qr3_sk_..." \
  -H "Content-Type: application/json" \
  -d '{"identifier_type": "company_prefix", "value": "4012345", "label": "GreenPower GmbH"}'

Hallintapaneelin kautta:

Siirry kohtaan Dashboard → GS1
Valitse tyyppi (GTIN, GLN tai Company Prefix)
Syötä arvo — tarkistusnumeron validointi tapahtuu automaattisesti
Napsauta Lisää tunniste

2. Luo DPP-passit

Kun GTIN on rekisteröity (joko suoraan tai Company Prefix -tunnisteen kautta), voit luoda sille DPP-passeja:

curl -X POST https://qr3.app/v1/dpp \
  -H "Authorization: Bearer qr3_sk_..." \
  -H "Content-Type: application/json" \
  -d '{"gtin": "04012345678901", "product_name": "EcoMax Battery", ...}'

3. Omistajuuden tarkistus

qr3.app tarkistaa jokaisen DPP-luonnin yhteydessä, kuuluuko käytetty GTIN organisaatiollesi:

Suora rekisteröinti — GTIN on rekisteröity tyypillä identifier_type: "gtin"
Prefix-osuma — GTIN alkaa rekisteröidyllä Company Prefix -tunnisteella (GTIN-14-koodin sijainnit 2..N)

Ilman vastaavaa rekisteröintiä palautetaan 422-virhe ja ilmoitus, että GTIN on rekisteröitävä ensin.

Milloin tarvitsen molempia?

Tehtävä	GS1	qr3.app
Omien GTIN-/GLN-koodien hankkiminen	✅ Jäsenyys vaaditaan	—
GTIN-tarkistusnumeron validointi	—	✅ API + Hallintapaneeli
QR-koodin luominen tuotteelle	—	✅
DPP-passin luominen EU-asetuksen mukaisesti	—	✅
GS1 Digital Link -selvitys (resolving)	—	✅ Resolveri + `/.well-known/gs1resolver`
Rekisteröinti EU-rekisteriin	Suunniteltu (Q4 2026)	Suunniteltu (Vaihe 4c)

API-viite

POST /v1/gs1/identifiers — Rekisteröinti
GET /v1/gs1/identifiers — Listaus
DELETE /v1/gs1/identifiers/:id — Poistaminen
POST /v1/gs1/validate — Validointi (ilman rekisteröintiä, ei todennusta)

Katso lisätietoja API-dokumentaatiosta.