TracePass
Loslegen
Vorlagen

Kategorie-Vorlagen auflisten

Listet die DPP-Kategorie-Vorlagen auf — die regulatorischen Feldschemata (Batterie, Textil, Elektronik, …). Jeder Eintrag liefert den Kategorieschlüssel, sein englisches Label, die Gesamt- und Pflichtfeldanzahl, die maßgebliche Verordnung und die Vorlagenversion. Vorlagen sind globale Referenzdaten, nicht mandantengebunden.

GET/api/v1/templates
OpenAPI 3.1 herunterladen
GET/api/v1/templates

Kategorie-Vorlagen auflisten

Listet die DPP-Kategorie-Vorlagen auf — die regulatorischen Feldschemata (Batterie, Textil, Elektronik, …). Jeder Eintrag liefert den Kategorieschlüssel, sein englisches Label, die Gesamt- und Pflichtfeldanzahl, die maßgebliche Verordnung und die Vorlagenversion. Vorlagen sind globale Referenzdaten, nicht mandantengebunden.

Damit finden Sie heraus, was ein konformer Pass in einer Kategorie braucht, *bevor* Sie Produkte und Pässe anlegen. Das vollständige Feld-für-Feld-Schema einer Kategorie liefert `GET /api/v1/templates/{category}`.

`requiredFieldCount` ist der kategorieunabhängige Wert. Wenn die Pflicht je nach Produktkategorie variiert, enthält der Eintrag zusätzlich `requiredFieldCountByCategory` — bei Batterien ist das so, denn die EU-Batterieverordnung verlangt von verschiedenen Batterietypen Unterschiedliches. Lesen Sie diese Zuordnung statt der einzelnen Zahl: bei Batterien liegt der pauschale Wert unter dem tatsächlichen für EV und LMT, da er die Felder nicht mitzählt, die erst mit bekannter Batteriekategorie verpflichtend werden. Beachten Sie außerdem, dass nur EV-, LMT- und Industriebatterien über 2 kWh überhaupt einen Batteriepass benötigen; Geräte- und Starterbatterien (SLI) fallen nicht darunter, für sie ist kein Feld verpflichtend.

Dies ist ein öffentlicher Endpoint — keine Authentifizierung erforderlich. Rate-Limit: 60 Anfragen pro Minute und IP-Adresse.

Anfrage

curl -sS https://app.tracepass.eu/api/v1/templates

Antwort

{
  "templates": [
    {
      "category": "battery",
      "categoryLabel": "Battery",
      "fieldCount": 142,
      "requiredFieldCount": 41,
      "requiredFieldCountByCategory": {
        "EV": 56,
        "LMT": 56,
        "industrial_gt_2kwh": 41
      },
      "regulation": "EU Battery Regulation 2023/1542",
      "version": 1
    },
    {
      "category": "textile",
      "categoryLabel": "Textile",
      "fieldCount": 60,
      "requiredFieldCount": 12,
      "regulation": "ESPR 2024/1781",
      "version": 2
    }
  ]
}

Verwandte Endpoints