Anwendungsfall · Autohandel
Fahrzeugzulassung API für Autohäuser
Anträge aus DMS oder CRM anlegen und Status, Dokumente sowie Gebühren dem Verkaufsauftrag zuordnen.
Zulassung für Dritte
Ein Autohaus lässt für seine Kunden zu: Der Käufer ist Halter (holder_id), wird einmalig verifiziert und signiert die Vollmacht über den Signaturlink. Eigene Bestandsfahrzeuge — etwa Tageszulassungen — laufen dagegen als Eigenzulassung ohne holder_id und ohne Signatur.
Zuordnung zum Verkaufsauftrag
Das Backend legt den Antrag aus dem Verkaufsauftrag an, speichert die Antrags-ID und übergibt den Signaturlink an die signierende Person.
status enthält den Antragsstatus, next_action die nächste Aktion. Dokumente und Gebühren werden nach Abschluss über die Antrags-ID abgerufen.
Vorgänge im Autohaus
| Situation | Code | Integrationshinweis |
|---|---|---|
| Neufahrzeug erstmals zulassen | NZ | Fahrzeug-, Halter-, Versicherungs- und Kennzeichendaten aus dem Verkaufsprozess übernehmen. |
| Fahrzeug für einen Tag zulassen | TZ | Als eigenen Geschäftsvorfall behandeln, nicht als Option einer NZ. |
| Gebrauchtwagen umschreiben | UG | registration.holder_change mit true oder false senden. |
| Stillgelegtes Fahrzeug wieder zulassen | WZ / WG | Zwischen gleichem und neuem Halter unterscheiden. |
| Fahrzeug außer Betrieb setzen | AB | Abmeldeergebnis anschließend über die Dokumentenressource abrufen. |
Empfohlener Integrationsablauf
- 01
Auftrag vorbereiten
Prüfen Sie Geschäftsvorfall und Halterkonstellation, bevor Sie personenbezogene Daten übertragen.
- 02
Antrag anlegen
Nutzen Sie Ihre Auftragsnummer als
external_referenceund einen eindeutigenIdempotency-Key. - 03
Signatur einholen
Übergeben Sie
next_action.urlüber einen geschützten Kanal an den Halter oder Vertretungsberechtigten. - 04
Status abrufen
Rufen Sie den Antragsstatus mit wachsendem Polling-Intervall ab.
- 05
Unterlagen archivieren
Listen Sie Dokumente und Gebühren nach Abschluss und speichern Sie nur die tatsächlich benötigten Dateien.
API-Schlüssel gehören ins Backend
DMS, CRM oder Verkaufsportal sprechen über Ihren Server mit der API. Ein dz_live_…-Schlüssel darf weder in Browser-JavaScript noch in einer mobilen App ausgeliefert werden. Erstellen und rotieren Sie Schlüssel in der geschützten Schlüsselverwaltung des Dashboards.