TracePass
Pässe

Registry-Bereitschaft des Passes prüfen

Liefert, ob ein Pass die formale Einreichungsprüfung des EU DPP Registry bestehen würde — { ready, findings[] }. Dies ist die *mechanische* Vorabprüfung des Registry, verschieden von und ergänzend zum substanziellen /compliance-Urteil: Ein Pass kann Registry-bereit sein, ohne substanziell konform zu sein, und umgekehrt. Rufen Sie sie vor der Einreichung beim Registry auf, um formale Lücken früh zu erkennen.

GET/api/v1/passports/{id}/registry-readiness
OpenAPI 3.1 herunterladen
GET/api/v1/passports/{id}/registry-readiness

Registry-Bereitschaft des Passes prüfen

Liefert, ob ein Pass die formale Einreichungsprüfung des EU DPP Registry bestehen würde — { ready, findings[] }. Dies ist die *mechanische* Vorabprüfung des Registry, verschieden von und ergänzend zum substanziellen /compliance-Urteil: Ein Pass kann Registry-bereit sein, ohne substanziell konform zu sein, und umgekehrt. Rufen Sie sie vor der Einreichung beim Registry auf, um formale Lücken früh zu erkennen.

Sechs formale Prüfungen, jede auf der Standard-Finding-Form mit einer REG-READY-* ruleId. REG-READY-MANDATORY: Jedes Pflichtfeld, das auf diesen Batterietyp zutrifft, ist vorhanden und freigegeben — anwendbarkeitsbewusst, sodass ein Feld, das für die Batteriekategorie nicht zutrifft (z. B. State-of-Certified-Energy bei einer Nicht-EV-Batterie), nicht als fehlend gezählt wird und ein Feld mit unknown-Anwendbarkeit als Warning erscheint, nicht als Blocker. REG-READY-FORMAT: Ausgefüllte Felder sind wohlgeformt (Typen, Enums, Patterns, Grenzen). REG-READY-LINK: Die Adresse, die das Registry erhalten würde, löst auf — die beim Vorbereiten einer Registrierung eingefrorene Adresse (registryUpi), sonst die aktuelle öffentliche Adresse des Passes. Ein Live-Probe; bei einem unveröffentlichten Pass ist dies eine beratende Warning statt eines Blockers, da der Preflight vor dem Veröffentlichen laufen soll. REG-READY-GRANULARITY: Der Pass trägt eine Seriennummer — Batterien werden auf Item-Ebene (Einzelstück) registriert, daher ist eine fehlende Seriennummer ein Blocker. REG-READY-COMMODITY: Der Warencode (CN/TARIC) ist wohlgeformt, sofern die Kategorie einen trägt; Batterien tragen keinen Warencode, daher ist dies bei Batterien nur eine beratende Warning, nie ein Blocker. REG-READY-SEMANTIC: Bei Elektrofahrzeugbatterien, LV-Batterien und Industriebatterien über 2 kWh werden die Daten des Passes gegen das Batterie-Datenmodell der Kommission (Semantikpaket 1.0.0) geprüft, also gegen das Modell, mit dem das Registry Einreichungen validiert. Ein fehlender oder fehlerhafter Wert in den öffentlichen Informationen ist ein Blocker; eine Lücke in den zugangsbeschränkten Informationen (Batterieverordnung, Anhang XIII Nummern 2 bis 4) ist eine Warning. Eine fehlende Organisationskennung für das EU DPP Registry (eine Kontoeinstellung) oder eine nicht erkannte Batteriekategorie ist ebenfalls ein Blocker. Gerätebatterien, Starterbatterien und Industriebatterien bis einschließlich 2 kWh liegen außerhalb des Modells der Kommission und erhalten aus dieser Prüfung kein Finding.

ready ist nur true, wenn es null kritische Findings gibt; Warnings blockieren die Bereitschaft nie. Nur Batteriepässe in dieser Version — ein Nicht-Batterie-Pass liefert ready: true mit einer einzelnen REG-READY-SCOPE-Warning, da die formale Registry-Prüfung für andere Kategorien noch nicht modelliert ist. Nur lesend; zählt als ein v1-Passlesezugriff gegen das Tageslimit.

Pfad-Parameter

  • iderforderlich

    string (24 hex chars)

    Pass-ID.

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/passports/6650b2c3d4e5f6a7b8c9d0e1/registry-readiness \
  -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx"

Antwort

{
  "ready": false,
  "findings": [
    {
      "type": "missing_field",
      "severity": "critical",
      "target": "batteryUniqueIdentifier",
      "ruleId": "REG-READY-MANDATORY",
      "why": "A mandatory field that applies to this battery is missing.",
      "fix": "Provide batteryUniqueIdentifier before submitting to the registry."
    },
    {
      "type": "unverifiable_conditional",
      "severity": "warning",
      "target": "https://id.tracepass.eu/p/01/...",
      "ruleId": "REG-READY-LINK",
      "why": "This passport isn't published yet, so the registry link can't be checked live."
    }
  ]
}