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 jeder erfassten Kategorie, 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 niederfrequenter Discovery-Call und zählt daher nicht gegen Ihr tägliches Lese-Limit. Authentifizierung per `tp_` API-Schlüssel oder OAuth-Token mit dem Scope `passports:read`.

Header

  • Authorizationerforderlich

    string

    `Bearer <token>` — entweder ein `tp_` API-Schlüssel (Developer → API Keys; am einfachsten, für Server-zu-Server) oder ein OAuth-2.0-Access-Token (Developer → OAuth Apps; für nutzerautorisierte Apps, scoped und widerrufbar). Die Authentication-Seite enthält den vollständigen OAuth-Flow und die Scope-Liste.

    e.g. Bearer tp_REDACTED_xxxxxxxxxxxx

Anfrage

curl -sS https://app.tracepass.eu/api/v1/templates \
  -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx"

Antwort

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

Verwandte Endpoints