Digitale Zulassung API für Fuhrparks und Leasing

Fuhrparks und Leasinggesellschaften lassen auf das eigene Unternehmen zu: Anträge ohne holder_id senden, Halterdaten und Bankverbindung kommen aus dem Dashboard-Konto, eine Signatur je Antrag entfällt. Nur wenn Fahrzeuge auf Dritte zugelassen werden, gilt der Weg der Zulassung für Dritte mit Halter und Signaturlink.

Speichern Sie zu jedem Fahrzeug die Antrags-ID und eine eigene external_reference, etwa Vertrags-, Bestell- oder Flottennummer.

Dokumente und Gebühren werden über die Antrags-ID zugeordnet. Mehrere Fahrzeuge sollten nicht in einem gemeinsamen Status zusammengefasst werden.

• Erzeugen Sie pro neuem Antrag einen Idempotency-Key und verwenden Sie ihn bei Retries unverändert.
• Nutzen Sie GET /api/v1/applications mit starting_after für regelmäßige, cursorbasierte Abgleiche.
• Werten Sie manual_review nicht als Fehler: Der Antrag wartet auf eine manuelle Prüfung und läuft danach weiter.
• Rufen Sie Dokumente und Gebühren über ihre Unterressourcen ab; leere Listen können während der Bearbeitung korrekt sein.
• Speichern Sie Cent-Beträge als Integer und ordnen Sie Gebührenpositionen über ihre IDs zu.

Prüfen Sie im Testmodus mindestens Bearbeitung, erfolgreichen Abschluss und Fehlschlag. Für den Produktivbetrieb verwenden Sie dz_live_… und POST /api/v1/applications. Vorhandene Testanträge können nicht in Produktivanträge umgewandelt werden.