TracePass
Loslegen
Pässe

Upload-Datei für das EU DPP Registry zu Batteriepässen erstellen

Erstellt die XML-Datei, die der Wirtschaftsakteur auf der Website des EU DPP Registry hochlädt (DPP Registration → upload a file), für die von Ihnen genannten Batteriepässe, bis zu 100 pro Aufruf. Die Registrierung ist eine eigene Handlung des Wirtschaftsakteurs mit seinem eigenen EU Login; TracePass bereitet die Datei vor und reicht sie nie ein.

POST/api/v1/registry/upload-file
OpenAPI 3.1 herunterladen
POST/api/v1/registry/upload-file

Upload-Datei für das EU DPP Registry zu Batteriepässen erstellen

Erstellt die XML-Datei, die der Wirtschaftsakteur auf der Website des EU DPP Registry hochlädt (DPP Registration → upload a file), für die von Ihnen genannten Batteriepässe, bis zu 100 pro Aufruf. Die Registrierung ist eine eigene Handlung des Wirtschaftsakteurs mit seinem eigenen EU Login; TracePass bereitet die Datei vor und reicht sie nie ein.

Nur Pässe, die bestehen würden, kommen hinein. Das Registry lehnt die ganze Datei wegen eines fehlerhaften Eintrags ab, daher kommt jeder andere Pass in excluded mit seinem reason zurück: not_found, not_battery, not_published, registered_in_production, registration_in_progress (wird gerade an ein Register nach EN 18222 gesendet), readiness_blocked (die blockierenden Befunde stehen in details), invalid_upi, duplicate_upi (dieselbe Adresse wie ein anderer Pass in der Datei) oder over_limit (nach dem 100.). included listet die Pässe in der Datei, jeden mit seiner Adresse.

Die Adresse jedes aufgenommenen Passes wird im Pass eingefroren (registryUpi) und die Vorbereitung festgehalten (registrationPreparedVia: "file"). Speichern Sie xml unter filename und laden Sie die Datei unverändert hoch: Der Name verwendet nur die Zeichen, die das Registry akzeptiert. Eine Vorbereitung ist keine Registrierung: Erfassen Sie die Antwort des Registry für jeden Pass mit POST /api/v1/passports/{id}/registration.

Die Antwort ist JSON statt reinem XML, damit sie sich unter Idempotency-Key wiederholen lässt und die Ausschlüsse enthält. Nur in Bezahlplänen (402 auf Free). OAuth-Aufrufer müssen für einen Admin oder Owner handeln. Zählt einen v1-Schreibvorgang pro aufgenommenem Pass.

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

  • Idempotency-Key

    string

    UUID v4.

Body-Felder

  • passportIdserforderlich

    string[] (24 hex chars each, 1–100)

    Die Pässe für die Datei. Pässe, die nicht bestehen würden, kommen in excluded zurück, statt den Aufruf scheitern zu lassen.

    e.g. ["6650b2c3d4e5f6a7b8c9d0e1", "6650b2c3d4e5f6a7b8c9d0e2"]

Anfrage

curl -sS -X POST \
  https://app.tracepass.eu/api/v1/registry/upload-file \
  -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 5a8d2f17-9c4e-4b3a-8e61-0f2c7d9b4e35" \
  -d '{ "passportIds": ["6650b2c3d4e5f6a7b8c9d0e1", "6650b2c3d4e5f6a7b8c9d0e2"] }'

Antwort

{
  "xml": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n…",
  "filename": "acme-batteries-dpp-registry-batch-2026-11-06.xml",
  "included": [
    {
      "id": "6650b2c3d4e5f6a7b8c9d0e1",
      "upi": "https://id.tracepass.eu/01/04012345000016/21/A1B2C3"
    }
  ],
  "excluded": [
    {
      "id": "6650b2c3d4e5f6a7b8c9d0e2",
      "reason": "readiness_blocked",
      "details": [
        "Required field \"Battery Carbon Footprint — Total\" has no value."
      ]
    }
  ]
}

Verwandte Endpoints