Den Verwertungsnachweis vom Entwurf bis zur Zustellung

Der Nachweis wird oft als letzter Schritt behandelt: Fahrzeug ist verwertet, also Papier ausfüllen. Bei einer Prüfung stellt sich dann die Frage, wer freigegeben hat, wann ausgestellt wurde und ob der Halter das Dokument überhaupt erhalten hat — und ein Ausdruck ohne diese Kette beantwortet keine davon.

Deshalb ist der Nachweis hier kein Formular, sondern eine Folge von Ereignissen mit getrennten Verantwortlichkeiten: Entwurf, Freigabe durch eine benannte Person, Vorbereitung des Vordrucks, Ausstellung und Zustellung. Jede Stufe ist einzeln belegt.

Was dieser Fall voraussetzt

• Ein Fall, in dem das Fahrzeug als Altfahrzeug festgestellt ist. Ohne Statusfeststellung fehlt dem Nachweis die Grundlage.
• Einen anerkannten ausstellenden Standort. Der Entwurf nennt ihn in issuerFacilityId; Aussteller und handelnde Person leitet der Server aus der Anmeldung ab, nicht aus dem Aufruf.
• Eine zeichnungsberechtigte Person. Die Freigabe wird einer Person zugerechnet, nicht dem Betrieb allgemein.
• Eine Entscheidung über den Weg. Elektronisch oder als deutscher Papiernachweis — beide haben ihren eigenen Aufruf.

Der Ablauf

Die Tabelle nennt je Stufe den zuständigen Aufruf und das, was danach vorliegt. Die Begründung, warum die Stufe nicht übersprungen werden kann, steht darunter.

Warum jede Stufe nötig ist

1. Den Entwurf anlegen. POST /compliance/cases/{id}/certificates nimmt legalProfile und issuerFacilityId — das Regelwerk und den ausstellenden Standort. Ein Entwurf ist noch kein Nachweis — genau deshalb gibt es ihn.
2. Freigeben. POST /compliance/certificates/{id}/approve trägt approvedAt und eine Attestkennung. Diese Stufe ist der Kern der Prüfbarkeit: Sie weist die Person aus, die freigegeben hat. Ein System gibt nichts frei, und entsprechend verlangt der Vertrag hier eine angemeldete Person, die ihre Anmeldung erneut bestätigt hat; ein API-Schlüssel allein genügt nicht.
3. Den Vordrucksatz vorbereiten. POST /compliance/certificates/{id}/prepare-print nimmt ein Ausgabeprofil und eine Satzkennung. Der amtliche Vordruck hat mehrere Durchschriften; welche Ausfertigung wohin geht, ist Teil der Pflicht und nicht eine Frage des Druckers.
4. Ausstellen. POST /compliance/certificates/{id}/issue-electronic trägt Signaturhülle und Serialisierungsfassung. Für den Papierweg gibt es mit POST /compliance/certificates/{id}/issue-de-paper einen eigenen Aufruf, der Ausstellungsort und die vier Originalausfertigungen festhält — zwei Wege, ein Zustand.
5. Zustellen. POST /compliance/certificates/{id}/deliveries trägt Empfänger, Medium und Zustellzeitpunkt. Die Zustellung ist selbst ein Ereignis, weil „ausgestellt" und „beim Halter angekommen" zwei verschiedene Tatsachen sind.

curl -X POST \
  -H 'Cookie: __Host-tapinomahub_session=<SITZUNG>' \
  -H 'X-CSRF-Token: <CSRF_TOKEN>' \
  -H 'X-Compliance-Organisation-Id: <ORGANISATION>' \
  -H 'If-Match: "<etag>"' \
  -H 'Idempotency-Key: freigabe-2026-09-12-017' \
  -H 'Content-Type: application/json' \
  -d '{"approvedAt":"2026-09-12T10:15:00Z","attestationId":"<attestationId>"}' \
  'https://api.tapinomahub.com/compliance/certificates/<id>/approve'

Was am Ende vorliegt

Am Ende liegt ein ausgestellter Nachweis vor, dessen Weg von der Freigabe über die Ausstellung bis zum Empfänger belegt ist. Bei einer Prüfung ist die Frage „wer hat das freigegeben" keine Recherche mehr, sondern ein Feld.

Wo das in der Dokumentation steht

Die verbindlichen Feldlisten, Fehlercodes und Beispielantworten stehen im OpenAPI-Vertrag dieser Fläche unter docs.tapinomahub.com (tapinoma-compliance). Alle Anwendungsfälle nach Fläche und Rolle geordnet: Übersicht der Anwendungsfälle.