Αναγνωριστικά GS1 & Onboarding

Το 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 Ελλάς, GS1 Germany).

Τι κάνει το qr3.app;

Το qr3.app χρησιμοποιεί τα υπάρχοντα αναγνωριστικά GS1 σας και προσφέρει:

Resolver συμβατός με GS1 — /01/{GTIN}/21/{Serial} με Content-Negotiation
Ψηφιακό Διαβατήριο Προϊόντος ΕΕ (DPP) — Δημιουργία DPP, επικύρωση, προβολή καταναλωτή
Έτοιμα για εκτύπωση QR assets — SVG, PNG, διανυσματικό PDF, EPS
JSON-LD, DCAT-AP — Μηχανικά αναγνώσιμα δεδομένα προϊόντος

Ροή Onboarding

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:

Μεταβείτε στο Dashboard → GS1
Επιλέξτε τον τύπο (GTIN, GLN ή Company Prefix)
Εισαγάγετε την τιμή — η επικύρωση του ψηφίου ελέγχου (Check-Digit) γίνεται αυτόματα
Κάντε κλικ στο Προσθήκη αναγνωριστικού

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 ανήκει στον οργανισμό σας:

Απευθείας καταχώριση — Το GTIN είναι καταχωρισμένο ως identifier_type: "gtin"
Ταύτιση προθέματος (Prefix-Match) — Το GTIN ξεκινά με ένα καταχωρισμένο Company Prefix (θέσεις 2..N του GTIN-14)

Χαρακτηριστικά, χωρίς αντίστοιχη καταχώριση, επιστρέφεται ένα σφάλμα 422 με την επισήμανση να καταχωρίσετε πρώτα το GTIN.

Πότε χρειάζομαι και τα δύο;

Εργασία	GS1	qr3.app
Απόκτηση δικών σας GTIN/GLN	✅ Απαιτείται συνδρομή μέλους	—
Επικύρωση ψηφίου ελέγχου GTIN	—	✅ API + Dashboard
Δημιουργία κώδικα QR για προϊόν	—	✅
Δημιουργία DPP σύμφωνα με τον κανονισμό της ΕΕ	—	✅
Ανάλυση (Resolve) GS1 Digital Link	—	✅ Resolver + `/.well-known/gs1resolver`
Καταχώριση στο Μητρώο της ΕΕ (EU Registry)	Σχεδιάζεται (Q4 2026)	Σχεδιάζεται (Φάση 4c)

Αναφορά API

POST /v1/gs1/identifiers — Καταχώριση
GET /v1/gs1/identifiers — Λίστα
DELETE /v1/gs1/identifiers/:id — Κατάργηση
POST /v1/gs1/validate — Επικύρωση (χωρίς καταχώριση, χωρίς Auth)

Δείτε την Τεκμηρίωση API για λεπτομέρειες.