---
title: "JSON-LD do Phasanna Táirgí Digiteacha (agus an áit a luíonn EPCIS 2.0) — qr3.app Blog"
description: "Níl DPP úsáideach do mheaisíní ach amháin más féidir le meaisín é a léamh. Taispeánann an treoir seo an fíor-JSON-LD a nochtann pas qr3 tríd an réiteoir beo, conas a fhreastalaíonn URL amháin ar dhaoine agus ar mheaisíní le caibidlíocht ábhair, agus an áit a luíonn caighdeán comhlántach imeachtaí EPCIS 2.0."
canonical: "https://qr3.app/ga/blog/dpp-json-ld-epcis/"
lang: "ga"
robots: "index,follow,max-image-preview:large,max-snippet:-1"
---

# JSON-LD do Phasanna Táirgí Digiteacha (agus an áit a luíonn EPCIS 2.0) — qr3.app Blog

> Níl DPP úsáideach do mheaisíní ach amháin más féidir le meaisín é a léamh. Taispeánann an treoir seo an fíor-JSON-LD a nochtann pas qr3 tríd an réiteoir beo, conas a fhreastalaíonn URL amháin ar dhaoine agus ar mheaisíní le caibidlíocht ábhair, agus an áit a luíonn caighdeán comhlántach imeachtaí EPCIS 2.0.

Canonical: <https://qr3.app/ga/blog/dpp-json-ld-epcis/>

[← Blag](/ga/blog/) [Ranganna teagaisc](/ga/blog/category/tutorials/)

May 30, 2026 7 nóim léite [Ranganna teagaisc](/ga/blog/category/tutorials/) [dpp](/ga/blog/tag/dpp/)[json-ld](/ga/blog/tag/json-ld/)[epcis](/ga/blog/tag/epcis/)[gs1-digital-link](/ga/blog/tag/gs1-digital-link/)[interoperability](/ga/blog/tag/interoperability/)

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

Níl DPP úsáideach do mheaisíní ach amháin más féidir le meaisín é a léamh. Taispeánann an treoir seo an fíor-JSON-LD a nochtann pas qr3 tríd an réiteoir beo, conas a fhreastalaíonn URL amháin ar dhaoine agus ar mheaisíní le caibidlíocht ábhair, agus an áit a luíonn caighdeán comhlántach imeachtaí EPCIS 2.0.

le **QR3 Redaktion**

![JSON-LD do Phasanna Táirgí Digiteacha (agus an áit a luíonn EPCIS 2.0)](https://qr3-blog-agent.meistern.workers.dev/cdn/blog/dpp-json-ld-epcis/hero.png)

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](https://schema.org) agus an [GS1 Web Vocabulary](https://gs1.org/voc/). 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/09520000000011/DEMO-BAT-01?format=jsonld"
```

filleann sé:

```
{
  "@context": ["https://schema.org", "https://gs1.org/voc/"],
  "@type": "Product",
  "gtin": "09520000000011",
  "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:

| Atá uait | Paraiméadar ceiste | Nó ceanntásc Accept |
| --- | --- | --- |
| Leathanach HTML do dhaoine | *(réamhshocrú)* | `Accept: text/html` |
| JSON-LD (Sonraí Nasctha) | `?format=jsonld` | `Accept: application/ld+json` |
| Gnáth-JSON | `?format=json` | — |
| Linkset (acmhainní gaolmhara) | `?format=linkset` | — |
| DCAT-AP (meiteashonraí tacar sonraí) | `?format=dcat-ap` | — |

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/09520000000011/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: "09520000000011",
  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/09520000000011/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)](https://www.w3.org/TR/json-ld11/)

- [GS1 Web Vocabulary](https://www.gs1.org/voc/)

- [GS1 EPCIS and CBV 2.0](https://www.gs1.org/standards/epcis)

- [schema.org Product](https://schema.org/Product)

- [ESPR — Regulation (EU) 2024/1781](https://eur-lex.europa.eu/eli/reg/2024/1781/oj)

**Tosaigh saor in aisce** agus cruthaigh DPP a nochtann JSON-LD: [app.qr3.app/sign-up](https://app.qr3.app/sign-up)

Is taispeántais fheidhmiúla iad seo le sonraí táirge ficseanúla agus GTINanna samplacha ón réimír GS1 952. Ní chruthaíonn siad aitheantóirí táirge leithdháilte, iontráil i gclár ná deimhniú.

## Postanna gaolmhara

- [![](https://qr3-blog-agent.meistern.workers.dev/cdn/blog/gs1-digital-link-resolver/hero.png) Ranganna teagaisc An GS1 Digital Link Resolver, Mínithe (le sampla beo) Ní nasc chuig leathanach gréasáin é cód QR DPP — is GS1 Digital Link é, agus iompaíonn an resolver aitheantóir amháin ina iliomad freagraí atá feasach ar chomhthéacs. Seo mar a oibríonn sé, le pas beo is féidir leat curl a dhéanamh air anois díreach.](/ga/blog/gs1-digital-link-resolver/)
- [![](https://qr3-blog-agent.meistern.workers.dev/cdn/blog/gs1-resolver-test-suite-dpp-links/hero.png) Ranganna teagaisc Sraith Tástála Resolver GS1: DPP a sheiceáil go hiontaofa roimh an seoladh beo Fágann an tsraith chobhsaí tástála GS1 gur féidir Resolver 1.2 a thástáil. Seo mar a thástálfar atreoruithe, tacair nasc, CORS, teangacha agus cásanna earráide roimh an seoladh beo.](/ga/blog/gs1-resolver-test-suite-dpp-links/)
- [![](https://qr3-blog-agent.meistern.workers.dev/cdn/blog/dpp-battery-passport-2027-20260715/hero.png) Nuacht Tionscail Seolann BatteryPass-Ready timpeallacht tástála don Phas Ceallraí Digiteach Sheol cuibhreannas BatteryPass-Ready timpeallacht tástála phoiblí don Phas Ceallraí Digiteach an 24 Meitheamh 2026, roimh cheanglas an AE ó mhí Feabhra 2027.](/ga/blog/dpp-battery-passport-2027-20260715/)
- [![](https://qr3-blog-agent.meistern.workers.dev/cdn/blog/sector-20260713/hero.png) Nuacht Tionscail Pas Digiteach Ceallraí 2027: An méid nach mór do mhonaróirí a bheith ar an eolas faoi anois Seimineáir ghréasáin, uirlisí foinse oscailte agus caighdeáin nua: tá Pas Ceallraí an AE ag dul chun cinn. Forléargas ar an staid i mí Iúil 2026 agus ar na ceisteanna oscailte go dtí Feabhra 2027.](/ga/blog/sector-20260713/)

[← Gach alt](/ga/blog/) [Tosaigh saor in aisce](https://app.qr3.app/sign-up)