JSON-LD do Phasanna Táirgí Digiteacha (agus an áit a luíonn EPCIS 2.0)

Tá Pas Táirge Digiteach ceaptha le bheith inléite ag daoine agus ag meaisíní: córas iontógála athchúrsálaí, API custaim, crawler margaidh, script iniúchóra inbhuanaitheachta. Ní leor leathanach HTML atá dírithe ar dhaoine amháin. Caithfidh an pas a bheith inléite ag meaisín — pálasta struchtúrtha is féidir le clár a pharsáil, a nascadh agus réasúnaíocht a dhéanamh air gan scríobadh.

Tá an treoir seo dírithe ar fhorbróirí atá ag cur na ceiste loighciúla seo: nuair atá DPP agam, conas a léann meaisín é i ndáiríre? Is é an freagra do qr3 ná JSON-LD thar an réiteoir poiblí. Taispeánfaimid an fíorfhreagra, míneoimid conas a fhreastalaíonn an URL céanna ar dhaoine agus ar mheaisíní, agus ansin cuirfimid EPCIS 2.0 — caighdeán comhlántach imeachtaí GS1 — i gcomhthéacs.

Cad is brí le hinléiteacht meaisín do DPP

Is mó ná "filleann JSON" atá i gceist le hinléiteacht meaisín. Maidir le pas táirge, ciallaíonn sé trí rud:

• Struchtúrtha — réimsí is féidir le parsálaí a sheoladh (gtin, name, …), ní prós le scríobadh.
• Cineáil agus nasctha — téarmaí ancairithe le foclóirí roinnte ionas go gciallaíonn Product an rud céanna do gach duine. Sin é an Sonraí Nasctha in JSON-LD.
• Cobhsaí le fáil — URL marthanach amháin in aghaidh an mhíre is féidir le script GET a dhéanamh air ar feadh shaolré iomlán an táirge.

Soláthraíonn JSON-LD (JSON for Linking Data) na trí cinn. Is gnáth-JSON é móide @context a léarscáilíonn gach eochair go téarma i bhfoclóir poiblí — anseo schema.org agus an GS1 Web Vocabulary. Tuigeann crawler a thuigeann schema.org cheana féin an pas gan aon chomhtháthú saincheaptha.

An DPP mar JSON-LD (fíor-curl + freagra fíoraithe)

Réitíonn gach pas qr3 ag URL GS1 Digital Link: https://qr3.app/dpp/{gtin}/{serial}. Cuir ?format=jsonld leis chun an radharc Sonraí Nasctha a iarraidh. In aghaidh an taispeántais cheallraí bheo:

curl -s "https://qr3.app/dpp/04019999999902/DEMO-BAT-01?format=jsonld"

filleann sé:

{
  "@context": ["https://schema.org", "https://gs1.org/voc/"],
  "@type": "Product",
  "gtin": "04019999999902",
  "name": "EcoMax 5000 (Demo)"
}

Trí rud le tabhairt faoi deara:

• Is eagar de dhá fhoclóir é @context — schema.org don ghréasán ginearálta agus gs1.org/voc/ do théarmaí táirge GS1. Réitíonn na heochracha i gcoinne an dá cheann.
• Insíonn @type: "Product" d'aon tomhaltóir Sonraí Nasctha go díreach cén cineál aonáin é seo.
• Tá na luachanna (gtin, name) fíor agus beo — is é seo an fíorphálasta, ní bréagshamhail.

Sin é an pointe ar fad: ní gá do script athchúrsálaí cliant a bhaineann go sonrach le qr3. Déanann sé HTTP GET, parsálann sé JSON-LD a thuigeann sé cheana féin, agus léann sé an GTIN agus ainm an táirge díreach as.

URL amháin, dhá lucht féachana: caibidlíocht ábhair

Freastalaíonn an URL https://qr3.app/dpp/{gtin}/{serial} céanna ar phas HTML atá éasca do dhaoine agus ar an radharc meaisín — socraíonn an freastalaí cad a fhilleann sé bunaithe ar an méid a iarrann an glaoiteoir. Dhá bhealach le hiarraidh:

Mar sin tagann ceamara fóin a osclaíonn an Cód QR ar an bpas HTML inléite, agus iarrann script ar an URL comhionann application/ld+json agus faigheann sé sonraí struchtúrtha:

# Machine view via header negotiation — same URL, no query string
curl -s -H "Accept: application/ld+json" \
  "https://qr3.app/dpp/04019999999902/DEMO-BAT-01"

Aitheantóir amháin, URL amháin, go leor léirithe. Fanann an GTIN/sraithuimhir cobhsaí; oiriúnaíonn an radharc don ghlaoiteoir. Sin go díreach an rud a fhágann go bhfuil DPP marthanach agus idir-inoibritheach ag an am céanna.

An áit a luíonn EPCIS 2.0 (imeachtaí vs. pas)

Ceist choitianta ina dhiaidh sin: cad faoi EPCIS — nach é sin caighdeán GS1 dó seo? Idirdhealú tábhachtach:

• Is é an DPP ná cur síos statach ar mhír táirge amháin — a aitheantas, a ábhair, a lorg carbóin, a in-athchúrsáilteacht. Freagraíonn sé "cad é an rud seo?" Is é an JSON-LD thuas an seat sin.
• Is é EPCIS 2.0 caighdeán GS1 do imeachtaí slabhra soláthair — na sonraí infheictheachta faoi cad a tharla, cén áit, cathain agus cén fáth: coimisiúnaíodh mír, seoladh í, fuarthas í, athchúrsáladh í. Freagraíonn sé "cad a tharla don rud seo, agus cá bhfuil sé?"

Tá siad comhlántach, ní iomaíoch. Insíonn an pas duit gur ceallra 5.2 kWh é an táirge le 35% ábhar athchúrsáilte; d'inseodh rian imeachtaí EPCIS duit gur monaraíodh i Hamburg ar dháta ar leith é, gur seoladh trí ionad dáileacháin é, agus gur shroich sé athchúrsálaí. Tá EPCIS 2.0 féin oiriúnach do JSON/JSON-LD, mar sin roinneann an dá cheann an dearcadh Sonraí Nasctha céanna agus na haitheantóirí GS1 céanna (GTIN + sraithuimhir) mar eochair cheangail.

Scóip qr3 (bí cruinn): aschuireann qr3 an DPP mar JSON-LD — sin a léiríonn an postáil seo. Ní sholáthraíonn qr3 gabháil imeachtaí EPCIS ná críochphointí EPCIS. Caith le EPCIS 2.0 anseo mar an caighdeán coincheapúil, comhlántach a ghlacfá in éineacht le DPP le haghaidh inrianaitheacht iomlán an tslabhra soláthair, ní mar ghné qr3.

Mar sin is é an tsamhail mheabhrach ná: is é an DPP (qr3, JSON-LD) bileog aitheantais an táirge; is é EPCIS 2.0 (córas ar leithligh) a logleabhar taistil. Na haitheantóirí céanna, dhá cheist freagartha.

DPP a ghineann a nochtann JSON-LD a chruthú

Ní dhéanann tú aon rud speisialta chun JSON-LD a "chumasú" — cruthaigh an pas agus freastalaíonn an réiteoir ar gach léiriú go huathoibríoch:

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",
  market_countries: ["DE", "FR", "AT"],
  status: "live",
  battery_data: {
    capacity_kwh: 5,
    carbon_footprint_kg: 62,
    recycled_content_pct: 12,
    recyclability_pct: 95,
  },
});

// The passport now resolves at https://qr3.app/dpp/04019999999902/SN-00012345
// Humans get HTML; machines append ?format=jsonld (or send Accept: application/ld+json).
console.log(passport.qr.svg); // QR encodes the GS1 Digital Link to the resolver

A luaithe a chruthaítear é, freagraíonn URL na míre an dá lucht féachana láithreach — gan aon chéim foilsithe bhreise don radharc meaisín.

Ceisteanna Coitianta

Cén fáth JSON-LD agus ní gnáth-JSON? Tá gnáth-JSON struchtúrtha ach ní féinchuradh síos: caithfidh tomhaltóir d'ainmneacha réimse a fhoghlaim. Cuireann JSON-LD @context leis, ag léarscáiliú gach eochair go téarmaí schema.org / GS1, ionas go dtuigeann aon tomhaltóir Sonraí Nasctha é gan comhtháthú saincheaptha. Más léamh tapa amháin atá uait, tá ?format=json ar fáil fós.

An gcuireann qr3 EPCIS 2.0 i bhfeidhm? Ní chuireann. Aschuireann qr3 an DPP mar JSON-LD. Is é EPCIS 2.0 an caighdeán GS1 ar leithligh, comhlántach do imeachtaí slabhra soláthair; rithfeá in éineacht leis é, ceangailte leis an GTIN + sraithuimhir roinnte.

Conas a fhaighim an radharc meaisín? Cuir ?format=jsonld le URL an réiteora, nó seol Accept: application/ld+json. Filleann an dá cheann an pálasta Sonraí Nasctha céanna.

An bhfuil an @context cobhsaí? Pionnann sé schema.org móide an GS1 Web Vocabulary (gs1.org/voc/) — foclóirí poiblí, leaganaithe iad araon, mar sin is féidir le tomhaltóirí brath ar bhríonna na dtéarmaí.

Foinsí

• JSON-LD 1.1 (W3C Recommendation)
• GS1 Web Vocabulary
• GS1 EPCIS and CBV 2.0
• schema.org Product
• ESPR — Regulation (EU) 2024/1781

Tosaigh saor in aisce agus cruthaigh DPP a nochtann JSON-LD: app.qr3.app/sign-up