ZulaGo für Ihre Software

Kfz-Zulassungs-API für Autohäuser und Softwareanbieter

Legen Sie Zulassungsaufträge direkt aus Ihrer Software an und verfolgen Sie die Bearbeitung bis zur Behördenentscheidung. ZulaGo übernimmt die elektronische Übermittlung über die Großkundenschnittstelle des Kraftfahrt-Bundesamts.

B2B-Zugang anlegen Tarife ansehen

Diese Aufgaben übernimmt die API

Aufträge anlegen und zuordnen

Übergeben Sie Zulassungsdaten aus Ihrem DMS, ERP oder eigenen Portal. Eine externe Referenz verbindet den ZulaGo-Auftrag mit Ihrem System. Ein Idempotency-Key verhindert, dass derselbe Auftrag bei einer wiederholten Anfrage doppelt angelegt wird.

Signatur und Rückfragen einbinden

Rufen Sie den Stand der Unterschriften und die Signaturlinks zu Ihren Aufträgen ab. Bei Rückfragen sehen Sie, was noch fehlt und welche Korrekturen möglich sind.

Status und Dokumente abrufen

Verfolgen Sie die Bearbeitung Ihrer Aufträge und laden Sie die zugehörigen amtlichen Dokumente herunter, sobald sie vorliegen.

Webhooks empfangen

Lassen Sie Ihr System über Statusänderungen, Signaturfortschritt und neue Dokumente informieren. Webhooks sind signiert; fehlgeschlagene Zustellungen werden mit wachsendem Abstand wiederholt.

Die API unterstützt Neuzulassung, Tageszulassung, Ummeldung, Wiederzulassung und Abmeldung. Welche Vorgänge für Ihren Zugang verfügbar sind, klären wir bei der Einrichtung. Für die Einreichung müssen die nötigen Fahrzeugunterlagen vorliegen. Über die Zulassung entscheidet die zuständige Behörde.

Vom Auftrag zur Behördenentscheidung

Ihr System legt einen Auftrag mit externer Referenz und den erforderlichen Daten und Einwilligungen an.
Der Kunde bestätigt seine Identität und unterschreibt, soweit der Vorgang das erfordert. Vor der Einreichung prüft ZulaGo, ob alle Angaben, Unterschriften und Zahlungsfreigaben vorliegen.
ZulaGo reicht den Antrag elektronisch ein. Ob Sie dabei den Großkundenzugang von ZulaGo oder einen eigenen KBA-Zugang nutzen, vereinbaren wir bei der Einrichtung.
Ihr System erhält Statusmeldungen und verfügbare Dokumente. Die Rückmeldung zeigt, ob der Vorgang abgeschlossen ist, eine Rückfrage vorliegt oder die Behörde den Antrag abgelehnt hat.

Statusmeldungen per Webhook

Beispiele für verfügbare Ereignisse:

order.status_changed
order.completed
order.rejected
order.needs_attention
order.signature_changed
order.documents_added

Prüfen Sie die HMAC-Signatur und den Zeitstempel auf Ihrer Serverseite. Planen Sie wiederholte Zustellungen ein. Der Integrationsleitfaden beschreibt Ereignisformat, Signaturprüfung und Wiederholungsregeln.

Vor der Anbindung: mit Testaufträgen prüfen

Mit einem Test-API-Key prüfen Sie die Anbindung und die übergebenen Daten in Ihrem Firmenkonto. Testaufträge werden nicht beim KBA eingereicht. Sie lösen auch keine echten Signaturen, Zahlungen, E-Mails oder Druckaufträge aus.

Der Testzugang bildet den Behörden- und Signaturablauf nicht vollständig nach. Bevor Sie echte Aufträge einreichen, richten wir mit Ihnen den Live-Zugang ein und klären die nötigen Verträge und Freigaben.

Einen Auftrag abrufen

Die Basisadresse lautet https://zulago.de/api/v1. Das Beispiel zeigt den Abruf eines einzelnen Auftrags. Ersetzen Sie die Beispiel-ID durch eine Auftrags-ID aus Ihrem Firmenkonto.

# Synthetische Auftrags-ID; API-Key sicher aus Ihrer Umgebung laden.
curl 'https://zulago.de/api/v1/orders/10000000-0000-4000-8000-000000000001' \
  -H "Authorization: Bearer $ZULAGO_API_KEY"

Dokumentation und Zugang

Diese Übersicht ist öffentlich. Die ausführliche technische Referenz, OpenAPI-Datei und der Integrationsleitfaden stehen registrierten B2B-Nutzern nach Anmeldung zur Verfügung.

API und Webhooks sind tarifabhängig. Die öffentliche B2B-Preisliste zeigt Grundgebühren, Servicepreise und zusätzliche Vorgangskosten. Individuelle Vereinbarungen können abweichen.

Zur geschützten Dokumentation Integration besprechen