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) agus an Rialachán Cadhnraí AE 2023/1542, 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);
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 { verifyWebhook } from "@qr3/sdk";
app.post("/webhooks/qr3", async (req, res) => {
const event = verifyWebhook(req.body, req.headers["qr3-signature"], secret);
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ú.
- Easpórtáil táirgí athraithe ó d'ERP.
client.dpp.validate(...)gach ceann acu — teip ar an mbuild ar earráidí bailíochtaithe.client.dpp.batch(...)táirgí nua;client.dpp.update(...)cinn athraithe.- Brúigh na URLanna
qr.svgar 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; baineann teorainneacha ráta le 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í
Tosaigh saor in aisce agus cruthaigh do chéad DPP trí API: app.qr3.app/sign-up
