--- title: "EU Digital Product Passport per API erstellen — qr3.app Blog" description: "Die meisten DPP-Ratgeber erklären, was ein Passport enthalten muss. Dieser zeigt, wie man EU-konforme Digital Product Passports programmatisch erstellt — mit curl, dem qr3-SDK, Batch-Anlage, Validierung, GS1-QR-Codes und Webhooks." canonical: "https://qr3.app/de/blog/dpp-api-generate-passports/" lang: "de" robots: "index,follow,max-image-preview:large,max-snippet:-1" --- # EU Digital Product Passport per API erstellen — qr3.app Blog > Die meisten DPP-Ratgeber erklären, was ein Passport enthalten muss. Dieser zeigt, wie man EU-konforme Digital Product Passports programmatisch erstellt — mit curl, dem qr3-SDK, Batch-Anlage, Validierung, GS1-QR-Codes und Webhooks. Canonical: [← Blog](/de/blog/) [Tutorials](/de/blog/kategorie/tutorials/) 30. Mai 2026 4 min Lesezeit [Tutorials](/de/blog/kategorie/tutorials/) [dpp](/de/blog/tag/dpp/)[api](/de/blog/tag/api/)[gs1-digital-link](/de/blog/tag/gs1-digital-link/)[entwickler](/de/blog/tag/entwickler/)[eu-2024-1781](/de/blog/tag/eu-2024-1781/) # EU Digital Product Passport per API erstellen Die meisten DPP-Ratgeber erklären, was ein Passport enthalten muss. Dieser zeigt, wie man EU-konforme Digital Product Passports programmatisch erstellt — mit curl, dem qr3-SDK, Batch-Anlage, Validierung, GS1-QR-Codes und Webhooks. von **QR3 Redaktion** ![EU Digital Product Passport per API erstellen](https://qr3-blog-agent.meistern.workers.dev/cdn/blog/dpp-api-generate-passports/hero.png) Die meisten Artikel über den EU Digital Product Passport (DPP) erklären, *was* ein Passport enthalten muss. Deutlich seltener zeigt jemand, *wie* man einen erstellt — und fast nie, wie man das für einen Katalog mit 500 oder 50.000 Artikeln tut, ohne 50.000-mal ein Formular auszufüllen. Dieser Leitfaden ist die Entwickler-Version. Jeder Schritt unten ist ein echter, funktionierender Aufruf gegen die qr3.app-API (`https://qr3.app/v1`). Wenn deine Produktdaten in einem ERP, PIM oder einer Datenbank liegen, kannst du die DPP-Erstellung direkt in deine bestehende Pipeline einbinden. ## Warum eine API für DPPs entscheidend ist Ein Digital Product Passport ist kein Einmal-Dokument. Unter der [Ökodesign-Verordnung (ESPR, EU 2024/1781)](https://eur-lex.europa.eu/legal-content/DE/TXT/?uri=CELEX:32024R1781) und der [EU-Batterieverordnung 2023/1542](https://eur-lex.europa.eu/eli/reg/2023/1542/oj) braucht jede regulierte Einheit einen Passport, der über die gesamte Lebensdauer aktuell bleibt. Für Hersteller bedeutet das: - **Skalierung** — Hunderte bis Zehntausende Produkte, jedes mit eigener GTIN/Seriennummer. - **Aktualität** — Daten (CO₂-Fußabdruck, Rezyklatanteil, Reparaturinfos) ändern sich und müssen aktualisiert, nicht neu erstellt werden. - **Integration** — die Datenquelle ist dein ERP/PIM, nicht ein Web-Formular. Das ist ein API-Problem. Ein manuelles Web-Tool bringt dir die ersten zehn Passports; eine API bringt dir alle. ## 1. Authentifizierung Jeder Request nutzt einen Bearer-Token (API-Key im Dashboard erstellen). Die Basis-URL ist `https://qr3.app/v1`. ``` curl https://qr3.app/v1/dpp \ -H "Authorization: Bearer $QR3_API_KEY" ``` Oder mit dem offiziellen SDK: ``` import { QR3 } from "@qr3/sdk"; const client = new QR3({ apiKey: process.env.QR3_API_KEY! }); ``` ## 2. Einen Batterie-Passport anlegen Ein DPP wird mit `POST /dpp` erstellt. Die Top-Level-Felder sind für jede Kategorie gleich; die kategoriespezifischen Daten landen in `battery_data`, `textile_data` oder `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"] } }' ``` Derselbe Aufruf mit dem 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); // druckfertiger GS1-Digital-Link-QR ``` Die Antwort enthält eine verbrauchergerechte Landingpage (lokalisiert in 25 EU-Sprachen) und einen **GS1-Digital-Link**-QR-Code, fertig für den Etikettendruck — kein separater QR-Schritt nötig. ## 3. Validieren, bevor du anlegst Fehlende oder ungültige Felder vor dem Speichern abfangen? `POST /dpp/validate` führt exakt die EU-Validierungsregeln aus, ohne etwas anzulegen. Ideal als Pre-Commit-Check 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. Einen ganzen Katalog per Batch anlegen Für einen Produktkatalog sendest du bis zu **100 Passports pro Request** an `POST /dpp/batch`. Über deinen ERP-Export iterieren — und dein ganzes Sortiment steht in Minuten. ``` 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, }, })); // In Blöcke à 100 aufteilen const result = await client.dpp.batch({ items: items.slice(0, 100) }); ``` ## 5. QR-Code für den Etikettendruck holen Jeder Passport stellt seinen GS1-Digital-Link-QR in vier Druckformaten bereit. Über das Passport-Objekt oder direkt: ``` curl https://qr3.app/v1/dpp/dpp_xxxxxxxx/qr.svg \ -H "Authorization: Bearer $QR3_API_KEY" -o label.svg ``` `qr.svg`, `qr.png`, `qr.pdf` und `qr.eps` sind verfügbar — SVG/EPS für den Etikettendrucker, PNG fürs Web. ## 6. Daten aktuell halten (ohne den QR zu brechen) GTIN/Seriennummer/Charge sind nach der Erstellung **unveränderlich** — das hält die gedruckte GS1-URI für immer stabil. Alles andere lässt sich mit `PUT /dpp/{id}` aktualisieren: ``` await client.dpp.update(passport.id, { battery_data: { capacity_kwh: 5, carbon_footprint_kg: 58, // neu gemessen, niedriger recycled_content_pct: 16, // 2031-Ziel früh erreicht recyclability_pct: 95, manufacturer_warranty_years: 8, }, }); ``` Der QR auf dem physischen Produkt ändert sich nie; die Daten dahinter schon. Genau das ist der Sinn eines *dynamischen* Passports. ## 7. An das EU-Register übermitteln Sobald das zentrale EU-DPP-Register für dein Produkt relevant ist, übermittelst du einen Passport mit einem Aufruf (ab Business-Plan): ``` const reg = await client.dpp.registerForEuRegistry(passport.id); console.log(reg.data.eu_registry_status); // "pending" console.log(reg.data.registry_request_id); ``` > **Stand heute:** Die EU hat die API ihres zentralen DPP-Registers noch nicht veröffentlicht. Bis dahin ist dieser Aufruf ein Testpfad — der Status bleibt `pending`, und keine Behörde erhält den Pass. Sobald die API live ist, wird derselbe Aufruf zur echten Anmeldung. ## 8. Auf Scans mit Webhooks reagieren DPP-Scans sind Events. Abonniere `qr.scanned` und du kannst sie in deine Analytics streamen, Nachbestellungen auslösen oder einen Rückruf markieren — in Echtzeit. Payloads sind signiert (HMAC-SHA256); verifiziere die Signatur immer. ``` 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); }); ``` ## Alles zusammen: DPP-Generierung in CI Der Endzustand, den die meisten Hersteller wollen: Produktdaten leben im ERP/PIM, und ein geplanter Job hält die Passports synchron. 1. Geänderte Produkte aus dem ERP exportieren. 2. Jedes per `client.dpp.validate(...)` prüfen — Build bei Validierungsfehlern abbrechen. 3. Neue Produkte per `client.dpp.batch(...)`, geänderte per `client.dpp.update(...)`. 4. Die zurückgegebenen `qr.svg`-URLs an dein Etiketten-Drucksystem schieben. Kein Web-Formular, kein Copy-Paste, keine Drift zwischen Stammdaten und Passports. ## FAQ **Brauche ich ein separates QR-Code-Tool?** Nein. Jeder DPP liefert einen GS1-Digital-Link-QR in SVG/PNG/PDF/EPS. Der QR *ist* der Zugangspunkt zum Passport. **Kann ich einen Passport nach dem Etikettendruck noch ändern?** Ja — das ist die Kernidee. GTIN/Seriennummer sind unveränderlich, damit die gedruckte URI gültig bleibt; alle Datenfelder sind über `PUT /dpp/{id}` aktualisierbar. **Wie viele Passports kann ich auf einmal anlegen?** Bis zu 100 pro `POST /dpp/batch`-Request. Größere Kataloge aufteilen; es gelten 60 Requests pro Minute je API-Key, in allen Tarifen. **Welche Kategorien werden unterstützt?** `battery` und `textile` haben heute volle EU-Validierung; `general` deckt weitere Produkttypen ab. Batterie und Textil enthalten eine Live-EU-Compliance-Prüfung (ESPR / AGEC). ## Quellen - [ESPR — Verordnung (EU) 2024/1781](https://eur-lex.europa.eu/legal-content/DE/TXT/?uri=CELEX:32024R1781) - [EU-Batterieverordnung 2023/1542](https://eur-lex.europa.eu/eli/reg/2023/1542/oj) - [GS1 Digital Link](https://www.gs1.org/standards/gs1-digital-link) **Kostenlos starten** und deinen ersten DPP per API erstellen: [app.qr3.app/sign-up](https://app.qr3.app/sign-up) ## Verwandte Beiträge - [![](https://qr3-blog-agent.meistern.workers.dev/cdn/blog/gs1-resolver-test-suite-dpp-links/hero.png) Tutorials GS1 Resolver Test Suite: DPP-Links vor dem Go-live belastbar prüfen Die stabile GS1-Test-Suite macht Resolver 1.2 prüfbar. So testen Sie Redirects, Linksets, CORS, Sprachen und Fehlerfälle vor dem Go-live.](/de/blog/gs1-resolver-test-suite-dpp-links/) - [![](https://qr3-blog-agent.meistern.workers.dev/cdn/blog/dpp-battery-passport-2027-20260715/hero.png) Branchen-News BatteryPass-Ready startet Testumgebung für den Digitalen Batteriepass Das Konsortium BatteryPass-Ready hat am 24. Juni 2026 eine öffentliche Testumgebung für den Digitalen Batteriepass gestartet – mit Blick auf die EU-Pflicht ab Februar 2027.](/de/blog/dpp-battery-passport-2027-20260715/) - [![](https://qr3-blog-agent.meistern.workers.dev/cdn/blog/sector-20260713/hero.png) Branchen-News Digitaler Batteriepass 2027: Was Hersteller jetzt wissen müssen Webinare, Open-Source-Tools und neue Normen: Der EU-Batteriepass nimmt Fahrt auf. Ein Überblick über den Stand im Juli 2026 und die offenen Fragen bis Februar 2027.](/de/blog/sector-20260713/) - [![](https://qr3-blog-agent.meistern.workers.dev/cdn/blog/sector-20260711/hero.png) Branchen-News Digitaler Batteriepass 2026: Testumgebungen, Normen und offene Fragen Wo steht die Industrie beim Digitalen Batteriepass? Ein Überblick über Testumgebungen, CEN/CENELEC-Normen, Open-Source-Tools und regulatorische Weichenstellungen im Juli 2026.](/de/blog/sector-20260711/) [← Alle Artikel](/de/blog/) [Kostenlos starten](https://app.qr3.app/sign-up)