Morgennebel über einem Fuhrparkhof: eine lange Reihe Transporter und Kombis vor einem Bürogebäude

Für Flottenbetreiber

Reservierungen in Serie, jeder Vorgang nachvollziehbar.

Mit der Kennzeichen API reservieren Flottenbetreiber Wunschkennzeichen für viele Fahrzeuge auf einmal — per Sammelabfrage über mehrere Zulassungsbezirke, mit Status je Vorgang per Webhook.

Kostenlos registrieren Preise ansehen

Selbst registrieren · Freischaltung von Hand · Sandbox-Abfragen kostenlos

FuhrparkUmstellung

Beispiel

3/7

reserviert

Umstellung Fuhrpark

Stand je Fahrzeug, ohne Nachzählen

3 reserviert2 läuft2 wartet

FZG-041K9D3XAReserviert
FZG-0427F3K92Reserviert
FZG-043Läuft
FZG-044Läuft

FZG-042 · reserviert

PIN 7F3K92

Beispiel

Zweimal gesendet, einmal reserviert.

Jeder Auftrag trägt einen eigenen Schlüssel. Derselbe Schlüssel liefert denselben Vorgang zurück, statt einen zweiten anzulegen. Wird derselbe Schlüssel mit anderem Inhalt gesendet, lehnt die Schnittstelle ab.

Ihr Zeichen · FZG-042Reservierungs-PIN · 7F3K92

reserved

Jeder Auftrag trägt einen eigenen Schlüssel. Idempotency-Key: fzg-042

1. Aufruf201, neu
2. Aufruf201, derselbe
anderer Inhalt409 Conflict

POST /v1/reservations

Nach der Reservierung geht ein Ereignis an Ihren Webhook. customerReference ist Ihr eigenes Zeichen, etwa die Fahrzeugnummer.

Vorher und nachher

120 Fahrzeuge, ein Durchlauf, kein Nachzählen.

Ein abgebrochener Durchlauf kostet keine zweite Behördengebühr.

Ohne Schnittstelle

4 Schritte

Nach einem Abbruch beginnt die Liste von vorn

Den Gesamtstand kennt, wer zuletzt daran gearbeitet hat

1234

Kombinationen in einer Tabelle, der Stand in einer zweiten

Doppelte Reservierungen, doppelte Behördengebühr

Kombinationen in einer Tabelle, der Stand in einer zweiten
01
Nach einem Abbruch beginnt die Liste von vorn
02
Doppelte Reservierungen, doppelte Behördengebühr
03
Den Gesamtstand kennt, wer zuletzt daran gearbeitet hat
04

Mit der Kennzeichen API

4 Schritte

Sammelabfrage prüft die Kombinationen je Bezirk

Je Fahrzeug eine Reservierung mit eigenem Idempotency-Key

Statuswechsel laufen als Ereignisse ein

Abbruch? Denselben Durchlauf erneut starten — nichts entsteht doppelt

1
Sammelabfrage prüft die Kombinationen je Bezirk
01
2
Je Fahrzeug eine Reservierung mit eigenem Idempotency-Key
02
3
Statuswechsel laufen als Ereignisse ein
03
4
Abbruch? Denselben Durchlauf erneut starten — nichts entsteht doppelt
04

Jeder Vorgang mit Status — im Dashboard und per Webhook.

Abfragen und erfolgreiche Reservierungen stehen als Nutzungsdaten bereit und lassen sich einer Kostenstelle zuordnen.

Umstellung Fuhrpark

Stand je Fahrzeug im Dashboard

Beispiel

3 reserviert2 läuft2 wartetvon 7 Fahrzeugen

Beispiel

FZG-040Reserviert4Q8M2Treservation.updated
FZG-041ReserviertK9D3XAreservation.updated
FZG-042Reserviert7F3K92reservation.updated
FZG-043Läuft—reservation.updated
FZG-044Läuft—reservation.updated
FZG-045Wartet—reservation.updated
FZG-046Wartet—reservation.updated

Jeder Statuswechsel kommt als Ereignis in Ihr System. Sie zählen nicht nach, Sie bekommen gemeldet.

Rechenbeispiel

Was eine Umstellung von 120 Fahrzeugen kostet.

120 Reservierungen in einem Monat, je drei Prüfungen. Stellen Sie nur einmal im Jahr um? Der Vertrag ist mit 14 Tagen Frist zum Monatsende kündbar.

Fehlversuche kosten nichts
Behördengebühr ohne Aufschlag
Bei 360 von 399 Bezirken erst bei der Zulassung fällig

Behördengebühr nicht enthalten — ohne Aufschlag, bei 360 von 399 Bezirken erst bei der Zulassung fällig.

Reservierungen im Monatje 3 Prüfungen je Reservierung120

1300

Je Kennzeichen

5,13 €

netto, ohne Behördengebühr

Im Monat

615,00 €

Grundgebühr je Kennzeichen: 0,83 €

Grundgebühr · fest im Monat99,00 €
Prüfungen · 360 × 0,10 €36,00 €
Reservierungen · 120 × 4,00 €480,00 €

Fehlversuche kosten nichts.

Zum Preisrechner →

Der Ablauf

Der Ablauf in drei Schritten.

Schritt 01
Idempotent beauftragen
fzg-042
2× gesendet1× RES-4K7Q-2M9X
Beispiel
Jeder Auftrag trägt einen Idempotency-Key. Derselbe Schlüssel liefert denselben Vorgang zurück, statt einen zweiten anzulegen — ein abgebrochener Durchlauf lässt sich gefahrlos wiederholen.
Idempotency-Key
Schritt 02
Status je Vorgang empfangen
reservation.updated
reserved7F3K92
Beispiel
Jeder Statuswechsel kommt als Ereignis in Ihr System. Sie zählen nicht nach, Sie bekommen gemeldet.
Webhookreservation.updated
Schritt 03
Verbrauch mitlesen
GET/v1/usage
Kostenstelle
Fuhrpark Nord
42 Abfragen
6 Reserv.
Beispiel
Abfragen und erfolgreiche Reservierungen stehen als Nutzungsdaten bereit und lassen sich einer Kostenstelle zuordnen.
GET/v1/usage

Was Sie davon haben

Konkret für Flottenbetreiber.

Reservierungen in Serie, jeder Vorgang nachvollziehbar.

01 / 04
Wiederholbare Durchläufe ohne doppelte Behördengebühr
Abbruch? Denselben Durchlauf erneut starten — nichts entsteht doppelt.
02 / 04
Vollständiger Stand je Fahrzeug, ohne Nachzählen
Jeder Statuswechsel kommt als Ereignis in Ihr System. Sie zählen nicht nach, Sie bekommen gemeldet.
03 / 04
Mehrere Zulassungsbezirke in einem Durchlauf
Die Sammelabfrage prüft die Kombinationen je Bezirk.
04 / 04
Nutzungsdaten für die Zuordnung auf Kostenstellen
Legen Sie je Kostenstelle einen eigenen Schlüssel an. Die Nutzungsdaten stehen je Schlüssel bereit.

Einwände und Fragen

Was vor dem Start gefragt wird.

Antwort nicht dabei? Schreiben Sie uns — wir melden uns in der Regel innerhalb eines Werktags.

Frage stellen

Warum gibt es keinen Endpunkt für 100 Reservierungen auf einmal?

Damit jede Reservierung eine eigene Nummer, einen eigenen Status und eine eigene Rechnungszeile hat. Die Prüfung vieler Kombinationen läuft dagegen gesammelt.

Unsere IT hat keine Zeit für Webhooks.

Dann fragen Sie den Stand ab: GET /v1/reservations/:id. Webhooks sind der bequemere Weg, aber keine Pflicht.

Wir brauchen die Kosten je Kostenstelle.

Legen Sie je Kostenstelle einen eigenen Schlüssel an. Die Nutzungsdaten stehen je Schlüssel bereit.

Was verhindert doppelte Reservierungen?

Der Idempotency-Key. Wiederholen Sie denselben Auftrag mit demselben Schlüssel, erhalten Sie denselben Vorgang zurück. Wird derselbe Schlüssel mit verändertem Inhalt gesendet, antwortet die Schnittstelle mit HTTP 409 statt einen zweiten Vorgang anzulegen.

Gibt es einen Endpunkt, der viele Reservierungen auf einmal anlegt?

Nein, und das ist Absicht. Reservierungen entstehen als einzelne, nachvollziehbare Vorgänge mit eigener Nummer. Für die Prüfung vieler Kombinationen gibt es dagegen eine Sammelabfrage.