TracePass
Loslegen
Pässe

Irrtümlich erfasstes Ergebnis des EU DPP Registry zurücknehmen

Löscht ein mit `POST /api/v1/passports/{id}/registration` erfasstes Ergebnis; der Pflicht-Query-Parameter `environment` sagt, welches. Im EU DPP Registry selbst ändert sich dadurch nichts: Korrigiert wird, was TracePass zum Pass festhält. Die Rücknahme wird protokolliert.

DELETE/api/v1/passports/{id}/registration
OpenAPI 3.1 herunterladen
DELETE/api/v1/passports/{id}/registration

Irrtümlich erfasstes Ergebnis des EU DPP Registry zurücknehmen

Löscht ein mit `POST /api/v1/passports/{id}/registration` erfasstes Ergebnis; der Pflicht-Query-Parameter `environment` sagt, welches. Im EU DPP Registry selbst ändert sich dadurch nichts: Korrigiert wird, was TracePass zum Pass festhält. Die Rücknahme wird protokolliert.

**`environment=acceptance`** entfernt den erfassten Test aus der Acceptance-Umgebung (`registryAcceptanceTest`).

**`environment=production`** setzt den Pass auf „vorbereitet“ zurück: `placeOnMarketStatus`, `placedOnMarketAt`, `registrationId` und `registrationMode` werden geleert, die eingefrorene Adresse (`registryUpi`) und die Vorbereitung bleiben, und die Parteien des Wirtschaftsakteurs werden entsperrt. Zurücknehmen lässt sich nur eine Erfassung mit `registrationMode: "website"`, nie eine Registrierung, die ein Register nach EN 18222 bestätigt hat.

Gibt es keine solche Erfassung zum Zurücknehmen, antwortet der Aufruf mit **409** `nothing_to_undo`. **Nur in Bezahlplänen** (`402` auf Free). OAuth-Aufrufer müssen für einen Admin oder Owner handeln. Gibt den Pass nach der Rücknahme zurück. Zählt als ein v1-Schreibvorgang.

Pfad-Parameter

  • iderforderlich

    string (24 hex chars)

    Pass-ID.

Query-Parameter

  • environmenterforderlich

    "production" | "acceptance"

    Welches erfasste Ergebnis zurückgenommen wird.

    e.g. production

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 -X DELETE \
  "https://app.tracepass.eu/api/v1/passports/6650b2c3d4e5f6a7b8c9d0e1/registration?environment=production" \
  -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx"

Antwort

{
  "passport": {
    "_id": "6650b2c3d4e5f6a7b8c9d0e1",
    "status": "published",
    "registryUpi": "https://id.tracepass.eu/01/04012345000016/21/A1B2C3",
    "registrationPreparedAt": "2027-02-26T09:12:00.000Z",
    "registrationPreparedVia": "form"
  }
}

Verwandte Endpoints