---
title: "Pasanna Táirgí Digiteacha an AE a ghiniúint trí API — qr3.app Blog"
description: "Insíonn formhór na dtreoracha DPP duit cad nach mór do phas a bheith ann. Taispeánann an ceann seo conas Pasanna Táirgí Digiteacha atá comhlíontach leis an AE a chruthú go cláreagraithe — le curl, SDK qr3, cruthú baisce, bailíochtú, cóid QR GS1 agus webhooks."
canonical: "https://qr3.app/ga/blog/dpp-api-generate-passports/"
lang: "ga"
robots: "index,follow,max-image-preview:large,max-snippet:-1"
---

# Pasanna Táirgí Digiteacha an AE a ghiniúint trí API — qr3.app Blog

> Insíonn formhór na dtreoracha DPP duit cad nach mór do phas a bheith ann. Taispeánann an ceann seo conas Pasanna Táirgí Digiteacha atá comhlíontach leis an AE a chruthú go cláreagraithe — le curl, SDK qr3, cruthú baisce, bailíochtú, cóid QR GS1 agus webhooks.

Canonical: <https://qr3.app/ga/blog/dpp-api-generate-passports/>

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

May 30, 2026 4 nóim léite [Ranganna teagaisc](/ga/blog/category/tutorials/) [dpp](/ga/blog/tag/dpp/)[api](/ga/blog/tag/api/)[gs1-digital-link](/ga/blog/tag/gs1-digital-link/)[developers](/ga/blog/tag/developers/)[eu-2024-1781](/ga/blog/tag/eu-2024-1781/)

# Pasanna Táirgí Digiteacha an AE a ghiniúint trí API

Insíonn formhór na dtreoracha DPP duit cad nach mór do phas a bheith ann. Taispeánann an ceann seo conas Pasanna Táirgí Digiteacha atá comhlíontach leis an AE a chruthú go cláreagraithe — le curl, SDK qr3, cruthú baisce, bailíochtú, cóid QR GS1 agus webhooks.

le **QR3 Redaktion**

![Pasanna Táirgí Digiteacha an AE a ghiniúint trí API](https://qr3-blog-agent.meistern.workers.dev/cdn/blog/dpp-api-generate-passports/hero.png)

Míníonn formhór na n-alt faoi Phas Táirge Digiteach an AE (DPP) *cad* nach mór do phas a bheith ann. Is annamh a thaispeánann siad duit *conas* ceann a chruthú — agus is ar éigean a thaispeánann ceann ar bith díobh duit conas é a dhéanamh do chatalóg de 500 nó 50,000 SKU gan brú trí fhoirm 50,000 uair.

Is é seo leagan an fhorbróra. Is glao fíor-oibre é gach céim thíos in aghaidh API qr3.app (`https://qr3.app/v1`). Má bhainistíonn tú sonraí táirge in ERP, in PIM nó i mbunachar sonraí, is féidir leat giniúint DPP a shníomh go díreach isteach i do phíblíne reatha.

## Cén fáth a bhfuil API tábhachtach do DPPanna

Ní doiciméad aonuaire é Pas Táirge Digiteach. Faoin [Rialachán um Éicedhearadh do Tháirgí Inbhuanaithe (ESPR, AE 2024/1781)](https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=CELEX:32024R1781) agus an [Rialachán Cadhnraí AE 2023/1542](https://eur-lex.europa.eu/eli/reg/2023/1542/oj), teastaíonn pas ó gach aonad rialáilte a fhanann cothrom le dáta thar a shaolré ar fad. Do mhonaróir ciallaíonn sé sin:

- **Scála** — na céadta go dtí na mílte táirge, gach ceann acu lena GTIN/sraithuimhir féin.

- **Úire** — athraíonn sonraí (lorg carbóin, ábhar athchúrsáilte, faisnéis deisithe) agus ní mór iad a nuashonrú, ní iad a athchruthú.

- **Comhtháthú** — is é d'ERP/PIM foinse na fírinne, ní foirm ghréasáin.

Is fadhb API é sin. Faigheann uirlis ghréasáin láimhe an chéad deich bpas duit; faigheann API gach ceann acu duit.

## 1. Fíordheimhniú

Úsáideann gach iarratas token iompróra (cruthaigh eochair API sa deais). Is é an bun-URL ná `https://qr3.app/v1`.

```
curl https://qr3.app/v1/dpp \
  -H "Authorization: Bearer $QR3_API_KEY"
```

Nó leis an SDK oifigiúil:

```
import { QR3 } from "@qr3/sdk";

const client = new QR3({ apiKey: process.env.QR3_API_KEY! });
```

## 2. Pas cadhnra a chruthú

Cruthaítear DPP le `POST /dpp`. Tá na réimsí ardleibhéil mar an gcéanna do gach catagóir; téann na sonraí a bhaineann go sonrach leis an gcatagóir isteach in `battery_data`, `textile_data` nó `general_data`.

```
curl -X POST https://qr3.app/v1/dpp \
  -H "Authorization: Bearer $QR3_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "gtin": "09506000134376",
    "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,
      "carbon_footprint_class": "B",
      "recycled_content_pct": 12,
      "recyclability_pct": 95,
      "manufacturer_warranty_years": 8,
      "lithium_content_pct": 6.5,
      "certifications": ["CE", "UN38.3"]
    }
  }'
```

An glao céanna leis an SDK:

```
const passport = await client.dpp.create({
  gtin: "09506000134376",
  serial: "SN-00012345",
  product_name: "PowerCell 5 kWh LFP",
  manufacturer: "ExampleTech GmbH",
  origin_country: "DE",
  category: "battery",
  market_countries: ["DE", "FR", "AT"],
  battery_data: {
    capacity_kwh: 5,
    carbon_footprint_kg: 62,
    recycled_content_pct: 12,
    recyclability_pct: 95,
    manufacturer_warranty_years: 8,
  },
});

console.log(passport.id);      // dpp_xxxxxxxx
console.log(passport.qr.svg);  // print-ready GS1 Digital Link QR
```

Áirítear sa fhreagra leathanach tuirlingthe atá dírithe ar an tomhaltóir (logánaithe go 25 teanga AE) agus cód QR **GS1 Digital Link** atá réidh do phriontáil lipéid — ní gá céim QR ar leith.

## 3. Bailíochtaigh sula gcruthaíonn tú

Ar mhaith leat réimsí ar iarraidh nó neamhbhailí a aimsiú sula seasaítear iad? Ritheann `POST /dpp/validate` rialacha bailíochtaithe cruinne an AE gan rud ar bith a chruthú. Foirfe mar sheiceáil réamhthiomanta in CI.

```
const result = await client.dpp.validate({
  gtin: "09506000134376",
  product_name: "PowerCell 5 kWh LFP",
  manufacturer: "ExampleTech GmbH",
  origin_country: "DE",
  category: "battery",
  battery_data: {
    capacity_kwh: 5,
    carbon_footprint_kg: 62,
    recycled_content_pct: 12,
    recyclability_pct: 95,
    manufacturer_warranty_years: 8,
  },
});

if (!result.valid) {
  console.error(result.errors);
  // [{ field: "battery_data.recyclability_pct", message: "..." }]
}
```

## 4. Catalóg iomlán a chruthú ina bhaisc

Le haghaidh catalóg táirgí, seol suas le **100 pas in aghaidh an iarratais** chuig `POST /dpp/batch`. Lúbaigh thar d'easpórtáil ERP agus tá do raon iomlán agat i gceann nóiméad.

```
const items = products.map((p) => ({
  gtin: p.gtin,
  serial: p.serial,
  product_name: p.name,
  manufacturer: "ExampleTech GmbH",
  origin_country: "DE",
  category: "battery" as const,
  battery_data: {
    capacity_kwh: p.capacityKwh,
    carbon_footprint_kg: p.co2Kg,
    recycled_content_pct: p.recycledPct,
    recyclability_pct: p.recyclablePct,
    manufacturer_warranty_years: p.warrantyYears,
  },
}));

// Chunk into batches of 100
const result = await client.dpp.batch({ items: items.slice(0, 100) });
```

## 5. An cód QR a fháil le haghaidh priontáil lipéid

Nochtann gach pas a chód QR GS1 Digital Link i gceithre fhormáid phriontála. Tarraing iad tríd an réad pas nó go díreach:

```
curl https://qr3.app/v1/dpp/dpp_xxxxxxxx/qr.svg \
  -H "Authorization: Bearer $QR3_API_KEY" -o label.svg
```

Tá `qr.svg`, `qr.png`, `qr.pdf` agus `qr.eps` ar fad ar fáil — SVG/EPS do do phriontálaí lipéad, PNG don ghréasán.

## 6. Coinnigh sonraí cothrom le dáta (gan an QR a bhriseadh)

Tá an GTIN/sraithuimhir/luchtóg **dochorraithe** tar éis a gcruthaithe — coinníonn sé sin an URI clóite GS1 cobhsaí go deo. Is féidir gach rud eile a nuashonrú le `PUT /dpp/{id}`:

```
await client.dpp.update(passport.id, {
  battery_data: {
    capacity_kwh: 5,
    carbon_footprint_kg: 58, // re-measured, lower footprint
    recycled_content_pct: 16, // 2031 target reached early
    recyclability_pct: 95,
    manufacturer_warranty_years: 8,
  },
});
```

Ní athraíonn an QR ar an táirge fisiciúil riamh; athraíonn na sonraí atá taobh thiar de. Sin é an pointe iomlán a bhaineann le pas *dinimiciúil*.

## 7. Cuir isteach chuig clár an AE

Nuair atá clár lárnach DPP an AE i raon feidhme do do tháirge, cuir pas isteach le glao amháin (plean Business agus os a chionn):

```
const reg = await client.dpp.registerForEuRegistry(passport.id);
console.log(reg.data.eu_registry_status);          // "pending"
console.log(reg.data.registry_request_id);
```

> **Mar atá cúrsaí inniu:** Níl API a chlárlainne lárnaí DPP foilsithe ag an AE fós. Go dtí sin, is cosán tástála é an glao seo — fanann an stádas `pending`, agus ní fhaigheann aon údarás an pas. Chomh luath agus a bheidh an API beo, beidh an glao céanna ina fhíorchlárú.

## 8. Freagair do scananna le webhooks

Is imeachtaí iad scananna DPP. Liostáil le `qr.scanned` agus is féidir leat iad a shruthú isteach i d'anailísíocht, athorduithe a spreagadh, nó aisghairm a chur in iúl — i bhfíor-am. Tá na pálasta sínithe (HMAC-SHA256); fíoraigh an síniú i gcónaí.

```
import { createHmac, timingSafeEqual } from "crypto";

app.post("/webhooks/qr3", express.raw({ type: "application/json" }), (req, res) => {
  const expected = createHmac("sha256", secret).update(req.body).digest("hex");
  const expectedBytes = Buffer.from(`sha256=${expected}`);
  const receivedBytes = Buffer.from(String(req.headers["x-qr3-signature"] ?? ""));
  const ok =
    expectedBytes.length === receivedBytes.length &&
    timingSafeEqual(expectedBytes, receivedBytes);
  if (!ok) return res.sendStatus(401);

  const event = JSON.parse(req.body.toString("utf8"));
  if (event.type === "qr.scanned") {
    console.log(event.data.country, event.data.dpp_id);
  }
  res.sendStatus(200);
});
```

## É a chur le chéile: giniúint DPP in CI

An staid deiridh a theastaíonn ó fhormhór na monaróirí: cónaíonn sonraí táirge san ERP/PIM, agus coinníonn jab sceidealta na pasanna i sioncrónú.

1. Easpórtáil táirgí athraithe ó d'ERP.

2. `client.dpp.validate(...)` gach ceann acu — teip ar an mbuild ar earráidí bailíochtaithe.

3. `client.dpp.batch(...)` táirgí nua; `client.dpp.update(...)` cinn athraithe.

4. Brúigh na URLanna `qr.svg` ar ais chuig do chóras priontála lipéid.

Gan foirm ghréasáin, gan cóipeáil-greamú, gan aon imdhreapadh idir do mháistir-shonraí agus do phasanna.

## Ceisteanna Coitianta

**An gá dom uirlis cód QR ar leith?**
Ní gá. Filleann gach DPP cód QR GS1 Digital Link in SVG/PNG/PDF/EPS. Is é an QR an pointe rochtana chuig an bpas.

**An féidir liom pas a nuashonrú tar éis don lipéad a bheith clóite?**
Is féidir — sin é an croísmaoineamh. Tá an GTIN/sraithuimhir dochorraithe ionas go bhfanann an URI clóite bailí; is féidir na réimsí sonraí go léir a nuashonrú trí `PUT /dpp/{id}`.

**Cé mhéad pas is féidir liom a chruthú in aon uair amháin?**
Suas le 100 in aghaidh an iarratais `POST /dpp/batch`. Bris catalóga níos mó ina smutáin; is é an teorainn ná 60 iarratas in aghaidh an nóiméid in aghaidh an eochair API, ar gach plean.

**Cé na catagóirí a dtacaítear leo?**
Seoltar `battery` agus `textile` le bailíochtú AE iomlán inniu; clúdaíonn `general` cineálacha eile táirgí. Áirítear le battery agus textile seiceáil bheo um chomhlíonadh an AE (ESPR / AGEC).

## Foinsí

- [ESPR — Rialachán (AE) 2024/1781](https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=CELEX:32024R1781)

- [Rialachán Cadhnraí AE 2023/1542](https://eur-lex.europa.eu/eli/reg/2023/1542/oj)

- [GS1 Digital Link](https://www.gs1.org/standards/gs1-digital-link)

**Tosaigh saor in aisce** agus cruthaigh do chéad DPP trí API: [app.qr3.app/sign-up](https://app.qr3.app/sign-up)

## Postanna gaolmhara

- [![](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/)
- [![](https://qr3-blog-agent.meistern.workers.dev/cdn/blog/sector-20260711/hero.png) Nuacht Tionscail Pas Digiteach Ceallraí 2026: Timpeallachtaí tástála, caighdeáin agus ceisteanna oscailte Cén staid ina bhfuil an tionscal maidir leis an bPas Digiteach Ceallraí? Forléargas ar thimpeallachtaí tástála, caighdeáin CEN/CENELEC, uirlisí foinse oscailte agus forbairtí rialála i mí Iúil 2026.](/ga/blog/sector-20260711/)

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