Schnittstellen für Flottensoftware: APIs für E-Flotten richtig planen

Schnittstellen verbinden Flottensoftware mit anderen betrieblichen Datenquellen und Anwendungen. Eine API ist dafür ein definierter technischer Zugang, über den Systeme bestimmte Informationen lesen oder verändern können. Für deine E-Flotte zählt, welche Daten tatsächlich verfügbar sind, wie zuverlässig sie übertragen werden und wer Fehler im laufenden Betrieb bearbeitet.

Die Angabe „API vorhanden“ reicht als Anforderung nicht aus. Eine Schnittstelle kann beispielsweise Fahrzeugstammdaten liefern, ohne Ladezustände oder Abrechnungsdaten bereitzustellen. Beschreibe deshalb zuerst den gewünschten Arbeitsablauf und danach die dafür benötigten Felder, Zugriffsrechte und Aktualisierungen.

Zeichne den Datenfluss vor der technischen Umsetzung

Notiere für jeden Anwendungsfall Quelle, Ziel und Richtung der Übertragung. Soll ein Fahrzeugstamm in die Flottensoftware übernommen werden? Sollen bestätigte Ladevorgänge in eine Auswertung fließen? Oder soll ein geänderter Status in einem anderen Arbeitsbereich sichtbar werden?

Für jedes Feld muss klar sein, welches System die maßgebliche Information enthält. Wenn zwei Systeme dieselbe Kostenstelle ändern dürfen, benötigst du eine Regel für Konflikte. Ohne diese Regel kann eine technisch erfolgreiche Übertragung fachlich falsche Daten erzeugen.

Beginne mit einem überschaubaren Datenfluss. Definiere den erwarteten Nutzen, etwa das Vermeiden einer wiederholten manuellen Eingabe. Die Grundlagen für geeignete Fahrzeugkennungen findest du im Beitrag zu Fahrzeugstammdaten in Flottensoftware.

Vereinbare Inhalt und Aktualität gemeinsam

Eine Schnittstellenbeschreibung sollte die verfügbaren Objekte und Felder nennen. Zusätzlich brauchst du die Bedeutung von Zeitstempeln, Einheiten, Status und leeren Werten. Kläre, ob alle Fahrzeuge unterstützt werden und ob Daten nur für bestimmte Zeiträume verfügbar sind.

Die wichtigsten Fragen für den fachlichen Entwurf sind:

• Welche Felder werden tatsächlich bereitgestellt?

• Welche eindeutigen Kennungen verbinden Fahrzeug und Vorgang?

• Wie schnell stehen neue oder geänderte Daten zur Verfügung?

• Werden Änderungen übertragen oder nur aktuelle Gesamtbestände?

• Wie werden gelöschte beziehungsweise deaktivierte Einträge erkennbar?

• Wie lange lassen sich vergangene Daten abrufen?

• Welche Mengen- oder Abrufgrenzen sind zu berücksichtigen?

Wähle die Aktualisierung nach dem Zweck. Ein monatlicher Bericht benötigt einen vollständigen Abschlussstand. Eine kurzfristige Dispositionsentscheidung kann ein deutlich engeres Zeitfenster verlangen. Ein häufiger Abruf macht eine selten aktualisierte Quelle nicht aktueller.

Plane Unterbrechungen und Wiederholungen ein

Eine Verbindung kann unterbrochen werden, während ein Vorgang bereits verarbeitet wurde. Deshalb muss die Integration erkennen können, ob eine erneute Übertragung denselben Vorgang betrifft. Stabile Kennungen und dokumentierte Wiederholungsregeln sind dafür wichtig.

Der technische Begriff „idempotent“ beschreibt bei HTTP-Methoden, dass mehrfach identische Anfragen dieselbe beabsichtigte Wirkung auf dem Server haben wie eine einzelne Anfrage. Die Regeln dazu sind in RFC 9110 beschrieben. Eine solche Eigenschaft muss für den konkreten Übertragungsschritt geprüft werden; sie folgt nicht allein aus dem Wort API. Quelle: HTTP-Regeln zu wiederholbaren Anfragen.

Definiere außerdem, wie fehlgeschlagene Datensätze erneut verarbeitet werden. Das Betriebsteam braucht eine verständliche Fehlerliste mit Kennung, Zeitpunkt, Ursache und nächstem Schritt. Eine technische Fehlermeldung ohne zugehörigen Geschäftsvorgang lässt sich im Fuhrpark nur schwer bearbeiten.

Praxisbeispiel: Ein Ladeimport nach Verbindungsabbruch

Fiktives Integrationsbeispiel: Ein regelmäßiger Abruf überträgt 80 bestätigte Ladevorgänge. Nach dem 50. Vorgang bricht die Verbindung ab. Beim nächsten Versuch liefert die Quelle erneut denselben Bestand.

Die Integration muss die bereits übernommenen Vorgänge erkennen und die übrigen ergänzen. Anschließend enthält das Ziel genau die 80 erwarteten Vorgänge. Die Verarbeitung dokumentiert, welche Kennungen bereits vorhanden waren und welche neu übernommen wurden.

Im nächsten Test wird ein vorhandener Vorgang fachlich korrigiert. Nun muss zusätzlich feststehen, ob die aktuelle Version ersetzt, ergänzt oder als Korrektur geführt wird. Ein Verfahren, das nur Dubletten verhindert, löst diese zweite Aufgabe noch nicht. Beide Fälle gehören in die Abnahme.

Arbeitshilfe: Sieben Fragen für die Schnittstellen-Abnahme

Lass dir den vorgesehenen Ablauf mit anonymisierten Beispieldaten zeigen. Prüfe dabei nicht nur die erfolgreiche Übertragung, sondern auch typische Störungen.

1. Kommen alle vereinbarten Felder mit verständlicher Bedeutung an?

2. Werden Daten nach einem Abbruch vollständig nachgeliefert?

3. Erzeugt ein wiederholter Lauf keine unerwünschten Dubletten?

4. Werden Korrekturen und deaktivierte Einträge richtig behandelt?

5. Sind fehlende und veraltete Daten sichtbar?

6. Ist der technische Zugriff auf den nötigen Umfang begrenzt?

7. Gibt es benannte Zuständigkeiten für Betrieb und Änderungen?

Halte das Ergebnis als Abnahmeprotokoll fest. Eine neue Schnittstellenversion oder eine veränderte Feldbedeutung kann den Datenfluss beeinflussen. Vereinbare deshalb, wie Änderungen angekündigt, getestet und freigegeben werden.

Sichere den laufenden Betrieb ab

Für den Betrieb braucht ihr einen sichtbaren letzten Erfolgszeitpunkt, eine Information über ausstehende Datensätze und einen verantwortlichen Kontakt. Entscheide, welcher Ausfall sofort bearbeitet werden muss und welcher bis zum nächsten Arbeitstag warten kann.

Technische Zugänge benötigen ebenso klare Berechtigungen wie menschliche Nutzer. Hinweise zur Aufteilung findest du unter Rollen und Rechte im Flottenmanagement. Für einen dateibasierten Übergabeprozess ergänzt der Leitfaden zum Datenexport aus Flottensoftware die Prüfung.

Bei StromNow für Flotten kannst du deinen Bedarf an Ladeorganisation und Abrechnung besprechen. Bring den gewünschten Datenfluss mit und kläre die verfügbaren Anbindungen für deinen konkreten Einsatz.