GS1 идентификатори и онбординг

GS1 идентификатори и онбординг

qr3.app залага на BYO-GTIN/BYO-GLN модел (Bring Your Own): Вие носите вашите съществуващи GS1 идентификатори — qr3 поема цифровия Product-Layer над тях.

Какво прави GS1?

GS1 издава глобално уникални идентификатори за продукти и локации:

Идентификатор	Описание	Пример
GTIN-14	Global Trade Item Number (ID на продукт)	04012345678901
GLN-13	Global Location Number (локация/фирма)	4012345000009
Company Prefix	Фирмен префикс (7-12 цифри), от който се извличат GTIN	4012345

За да получите GTIN, се нуждаете от GS1 членство във вашата национална GS1 организация (напр. GS1 Austria, GS1 Germany).

Какво прави qr3.app?

qr3.app използва вашите съществуващи GS1 идентификатори и предлага:

• GS1-съвместим Resolver — /01/{GTIN}/21/{Serial} с Content-Negotiation
• EU Digital Product Passport — създаване на DPP, валидиране, изглед за потребители
• Готови за печат QR активи — SVG, PNG, векторно PDF, EPS
• JSON-LD, DCAT-AP — машинно четими данни за продукти

Процес на онбординг

1. Регистриране на GS1 идентификатори

Преди да можете да създавате DPP, трябва да регистрирате вашите GTIN (или вашия Company Prefix):

Чрез API:

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"}'

Чрез таблото за управление (Dashboard):

1. Отидете на Dashboard → GS1
2. Изберете типа (GTIN, GLN oder Company Prefix)
3. Въведете стойността — валидирането на контролната цифра (Check-Digit) става автоматично
4. Кликнете върху Добавяне на идентификатор

2. Създаване на DPP

След като даден GTIN е регистриран (директно или чрез Company Prefix), можете да създавате DPP с него:

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. Проверка на собствеността (Ownership)

qr3.app проверява при всяко създаване на DPP дали използваният GTIN принадлежи на вашата организация:

1. Директна регистрация — GTIN е регистриран като identifier_type: "gtin"
2. Съвпадение на префикса (Prefix-Match) — GTIN започва с регистриран Company Prefix (позиция 2..N на GTIN-14)

Без съответстваща регистрация ще получите грешка 422 с указание първо да регистрирате GTIN.

Кога имам нужда и от двете?

Задача	GS1	qr3.app
Получаване на собствени GTIN/GLN	✅ Необходимо е членство	—
Валидиране на GTIN контролна цифра	—	✅ API + Dashboard
Генериране на QR код за продукт	—	✅
Създаване на DPP съгласно регламента на ЕС	—	✅
Разрешаване (resolving) на GS1 Digital Link	—	✅ Resolver + /.well-known/gs1resolver
Регистриране в регистъра на ЕС	Планирано (Q4 2026)	Планирано (Фаза 4c)

API Справка

• POST /v1/gs1/identifiers — Регистриране
• GET /v1/gs1/identifiers — Списък
• DELETE /v1/gs1/identifiers/:id — Изтриване
• POST /v1/gs1/validate — Валидиране (без регистрация, без оторизация)

Вижте API документацията за подробности.