Digitaler Produktpass aus einer JSON-Datei

Digitaler Produktpass mit QR-Code, gehostet auf GitHub Pages, ohne Abo.

Kostenlos, auch im Unternehmen. Lizenz PolyForm Shield 1.0.0.

passports/akku.json

{
  "template": "battery",
  "gtin": "09520123456788",
  "productName": "Akku 500 Wh",
  "category": "lmt",
  "chemistry": "Li-Ion NMC 811",
  "ratedCapacityAh": 13.9,
  "voltage": "30 V / 36 V / 42 V",
  "items": [
    { "serial": "AK500-000123",
      "manufactureDate": "2026-09" }
  ]
}
Passseite des Beispiel-Akkus mit Name, GTIN, Seriennummer, QR-Code und den ersten Pflichtfeldern
Links die Datei, rechts die Seite hinter dem QR-Code.

Vom Datenblatt zur Passseite

  1. Datenblatt einlesen

    PDF hochladen. Claude trägt ein, was drinsteht, und markiert jeden Vorschlag.

    Editor mit geöffnetem KI-Import: eingefügter Datenblatt-Text, API-Schlüssel, Meldung über neun vorgeschlagene Felder
  2. Pflichtangaben prüfen

    Fehlt eine Angabe aus Anhang XIII, nennt die Liste sie mit Fundstelle.

    Prüfliste mit drei fehlenden Angaben über der Vorschau der Passseite
  3. Veröffentlichen

    JSON-Datei committen. Jede Seriennummer bekommt eine Seite mit eigenem QR-Code.

    Passseite einer einzelnen Seriennummer auf dem Handy

Was jede Passseite mitbringt

QR-Code nach GS1 Digital Link

Jede Handykamera liest ihn.

/01/09520123456788/21/AK500-000123/

Beispiel öffnen

Alle öffentlichen Felder aus Anhang XIII

Jedes Feld mit Fundstelle.

Nennkapazität
Anh. XIII 1(g)
Löschmittel
Anh. VI A Nr. 9
Konformitätserklärung
Anh. XIII 1(r)

Maschinenlesbar

JSON und schema.org-Product in jeder Seite.

{ "@type": "Product",
  "gtin14": "09520123456788",
  "serialNumber": "AK500-000123" }

Keine laufenden Kosten

Statische Dateien. Jeder Webspace reicht.

Ihr Schlüssel, Ihr Browser

Das Datenblatt geht direkt an Anthropic, nie an Passwerk.

Fristen aus der Batterieverordnung

Verordnung (EU) 2023/1542, Stand 8. November 2026.

AbPflichtFundstelle
18.08.2025Symbol für getrennte Sammlung auf jeder BatterieArt. 13 Abs. 4
18.08.2026 oder späterEtikett mit Hersteller, Chemie, Gewicht und KapazitätArt. 13 Abs. 1
18.02.2027QR-Code auf jeder BatterieArt. 13 Abs. 6
18.02.2027Batteriepass für LMT-, Industrie- (über 2 kWh) und ElektrofahrzeugbatterienArt. 77 Abs. 1

Zum Pflicht-Check

Fragen vor dem ersten Pass

Reicht GitHub Pages für die Pflicht?

Die Verordnung schreibt kein Hosting vor. Sie verlangt aber, dass der Pass erreichbar bleibt, auch wenn Ihr Unternehmen aufhört (Art. 78 Buchst. e). Ein GitHub-Konto allein sichert das nicht. Legen Sie die Seiten zusätzlich auf eine eigene Domain mit Hosting-Vertrag.

Was ist mit Daten, die nicht öffentlich sein dürfen?

Detaillierte Zusammensetzung, Demontage und Prüfberichte (Anhang XIII Nr. 2 bis 4) bekommen nur Berechtigte. Passwerk veröffentlicht den öffentlichen Teil und nennt für den Rest einen Kontakt. Eine Zugriffssteuerung hat es nicht.

Brauche ich eine GTIN?

Nein. Ohne GTIN liegen die Pässe unter /p/kurzname/. Die Kennung muss aber den Normen ISO/IEC 15459 folgen (Art. 77 Abs. 3). Eine GTIN von GS1 erfüllt das.

Darf meine Firma Passwerk nutzen?

Ja, kostenlos und mit eigenen Änderungen. Die Lizenz PolyForm Shield verbietet nur, Passwerk als konkurrierendes Produkt anzubieten. Eine Open-Source-Lizenz im Sinne der OSI ist sie nicht.

Ist das Rechtsberatung?

Nein. Passwerk bildet die Felder aus dem Gesetzestext ab. Ob Ihr Pass vollständig ist, klären Sie in Ihrer Konformitätsbewertung.

Vier Befehle bis zur ersten Passseite

Node 20 oder neuer, keine Abhängigkeiten. Für GitHub Pages: forken, bei Settings unter Pages „GitHub Actions“ wählen, JSON-Dateien in passports/ legen.

# Pässe liegen in passports/, die fertigen Seiten in _site/
git clone https://github.com/BrickyStudios/digitaler-produktpass
cd digitaler-produktpass
npm run build
  beispiel-ebike-akku.json → 01/09520123456788/ (+2 Seriennummern)
  example-tshirt.json → 01/09520987654320/ (+0 Seriennummern)
  fertig: _site/ für http://localhost:8080
npm run preview