Grundlagen
Eigenzulassung und Zulassung für Dritte
Die zwei Einreichungswege der API: eigene Fahrzeuge zulassen oder als Dienstleister für Kunden.
Zwei Wege, ein Endpunkt
Jeder Antrag läuft über einen von zwei Wegen. Bei der Eigenzulassung lassen Sie Fahrzeuge auf das eigene Unternehmen zu — als Fuhrpark, Leasinggesellschaft oder Händler mit eigenem Bestand. Bei der Zulassung für Dritte reichen Sie als Dienstleister für Ihre Privat- oder Gewerbekunden ein, etwa als Autohaus für den Fahrzeugkäufer.
Beide Wege verwenden denselben Endpunkt. Die API erkennt den Weg an der Halterangabe: mit holder_id gilt submission_mode: third_party, ohne Halterangabe company.
| Eigenzulassung (company) | Zulassung für Dritte (third_party) | |
|---|---|---|
| Halter | Ihr Unternehmen oder ein hinterlegter Vertragspartner | Ihr Kunde, referenziert über holder_id |
| holder_id | Nicht erforderlich | Erforderlich (außer bei AB) |
| Halterverifizierung | Entfällt | Erforderlich — außer mit eigenem KBA-Großkundenzugang |
| Signatur je Antrag | Entfällt | Ihr Kunde signiert die Vollmacht über den Signaturlink |
| payment.iban | Aus dem Dashboard-Konto | Im Request erforderlich (außer bei AB und HA) |
Eigenzulassung
Senden Sie den Antrag ohne holder_id. Halterdaten, Bankverbindung und Wirtschaftszweig kommen aus Ihrem Dashboard-Konto; mit contract_partner_id ist stattdessen der konfigurierte Vertragspartner Antragsteller und Halter.
Eine Signatur je Antrag entfällt: Als eigener KBA-Großkunde reichen Sie ohne Vollmacht ein, als Vertragspartner deckt die im Konto hinterlegte Dauervollmacht Ihre Anträge ab. Der Antrag läuft nach der Anlage direkt in die Verarbeitung; signature.required ist false oder die Signatur gilt sofort als erbracht.
Zulassung für Dritte
Legen Sie Ihren Kunden als Halter an (POST /api/v1/holders), verifizieren Sie ihn und übergeben Sie die holder_id im Antrag. Die Halterverifizierung entfällt nur, wenn Sie mit eigenem KBA-Großkundenzugang einreichen und die Halterdaten selbst prüfen.
Ihr Kunde erhält den Signaturlink und signiert die Vollmacht digital; mit einem Signaturprofil steuern Sie Absendername und Logo dieser Signaturanfrage. Die IBAN für die Kfz-Steuer gehört in den Request, da sie das Konto des Kunden ist.