Software-Schnittstellen für Automatisierung prüfen

Eine Software kann im Alltag gut funktionieren und trotzdem schwer zu automatisieren sein. Der entscheidende Punkt ist nicht nur, ob der Anbieter das Wort „API“ nennt. Vor einem Projekt sollten Sie klären, welche Daten und Aktionen wirklich erreichbar sind, wie eine Verbindung ausgelöst wird und welche Rechte, Grenzen und Folgekosten gelten.

Diese Prüfung trennt eine belastbare Schnittstelle von einer Funktion, die nur in einer Produktvorführung überzeugend wirkt.

Beginnen Sie mit dem gewünschten Ablauf

Formulieren Sie zuerst den konkreten Vorgang. „CRM und Buchhaltung verbinden“ ist noch zu breit. Besser ist zum Beispiel:

1. Ein freigegebenes Angebot erhält den Status „angenommen“.
2. Die Kundendaten und Positionen werden an das Zielsystem übertragen.
3. Das Zielsystem bestätigt die Anlage mit einer eindeutigen ID.
4. Bei einem Fehler erhält eine verantwortliche Person eine verständliche Meldung.
5. Ein erneuter Versuch erzeugt keinen doppelten Datensatz.

Aus diesem Ablauf ergeben sich die technischen Fragen. Welche Daten müssen gelesen werden? Welche dürfen geschrieben werden? Welches Ereignis startet die Übertragung? Wie wird das Ergebnis zurückgemeldet? So vermeiden Sie, eine Schnittstelle allein nach ihrer Existenz zu bewerten.

API, Webhook und Export erfüllen verschiedene Aufgaben

Eine API stellt Funktionen oder Daten für andere Programme bereit. Eine maschinenlesbare Beschreibung kann die Prüfung deutlich erleichtern. Die OpenAPI-Spezifikation beschreibt dafür eine standardisierte, sprachunabhängige Schnittstellenbeschreibung für HTTP-APIs. Eine vorhandene OpenAPI-Datei ist hilfreich, beweist aber noch nicht, dass alle für Ihren Ablauf nötigen Funktionen freigeschaltet sind.

Ein Webhook meldet ein Ereignis aktiv an ein anderes System, etwa wenn sich ein Auftragsstatus ändert. Ohne Webhook muss eine Automatisierung häufig regelmäßig nach Änderungen fragen. Das kann langsamer sein und unnötige Anfragen erzeugen.

Ein CSV- oder Excel-Export ist dagegen meist eine Momentaufnahme. Er kann für regelmäßige Übergaben ausreichen, wenn ein täglicher oder wöchentlicher Rhythmus genügt. Für sofortige Rückmeldungen, Schreibzugriffe oder eine zuverlässige Zuordnung über Systemgrenzen hinweg reicht ein manueller Export oft nicht.

Die sieben Prüfbereiche

1. Benötigte Objekte und Aktionen

Listen Sie die konkreten Objekte auf: Kunden, Kontakte, Aufträge, Rechnungen, Dateien oder Statuswerte. Prüfen Sie für jedes Objekt getrennt, ob es gelesen, angelegt und geändert werden kann. Manche APIs erlauben nur das Lesen oder decken nur einen Teil des Produktes ab.

2. Auslöser und Aktualität

Klären Sie, ob passende Webhooks vorhanden sind, welche Ereignisse sie abdecken und ob verlorene Meldungen erneut zugestellt werden. Falls nur regelmäßige Abfragen möglich sind, bestimmen Sie ein sinnvolles Intervall und prüfen Sie, wie Änderungen seit der letzten Abfrage erkannt werden.

3. Anmeldung und Berechtigungen

Fragen Sie nach dem vorgesehenen Anmeldeverfahren und nach fein abgestuften Rechten. Ein technischer Zugang sollte nur die Funktionen erhalten, die der Ablauf benötigt. Prüfen Sie auch, wer Zugangsdaten erneuern kann und was beim Ausscheiden einer zuständigen Person geschieht.

4. Limits und Datenmengen

Viele Dienste begrenzen Anfragen oder Verarbeitung. Bei Microsoft Power Automate gelten beispielsweise sowohl Plattformgrenzen als auch eigene Limits einzelner Konnektoren; bei Überschreitung können Anfragen mit dem Status 429 gedrosselt werden. Das erläutert Microsoft in seiner Dokumentation zu Limits und Drosselung. Die konkreten Werte müssen Sie jedoch beim tatsächlich eingesetzten Produkt und Tarif prüfen.

Rechnen Sie anhand Ihres Ablaufs: Wie viele Vorgänge entstehen an einem normalen Tag und bei einer Spitze? Wie viele Schnittstellenaufrufe benötigt ein Vorgang? Gibt es Sammelabfragen oder Seitenbegrenzungen?

5. Fehler, Wiederholungen und Duplikate

Eine gute Verbindung braucht mehr als den Erfolgsfall. Legen Sie fest, wie Zeitüberschreitungen, ungültige Daten und vorübergehende Ausfälle behandelt werden. Für schreibende Vorgänge sollte geprüft werden, ob eine eindeutige Vorgangskennung Wiederholungen ohne Dubletten ermöglicht.

6. Testzugang und Dokumentation

Bitten Sie um aktuelle technische Dokumentation und, wenn möglich, eine Testumgebung. Prüfen Sie dort mindestens einen vollständigen Ablauf mit gültigen Daten, einen fachlichen Fehler und einen erneuten Versuch. Eine öffentlich sichtbare API-Dokumentation kann von den Rechten Ihres gebuchten Kontos abweichen.

7. Vertrag, Tarif und Betrieb

Klären Sie, ob API, Webhooks oder zusätzliche Aufrufmengen im vorgesehenen Tarif enthalten sind. Fragen Sie nach angekündigten Änderungen, Versionswechseln und Supportwegen. Bestimmen Sie intern, wer Fehlermeldungen prüft und wer fachliche Änderungen freigibt.

Eine kleine Machbarkeitsprobe vor dem Gesamtprojekt

Wählen Sie einen typischen Vorgang und einen problematischen Sonderfall. Übertragen Sie nur die nötigsten Felder und protokollieren Sie Ergebnis, Laufzeit und Fehlermeldung. Diese Probe zeigt früh, ob Datenfelder zusammenpassen, Berechtigungen reichen und der Anbieter wichtige Funktionen tatsächlich bereitstellt.

Ein mögliches Prüfergebnis lautet nicht nur „machbar“ oder „nicht machbar“. Es kann auch heißen: täglich per Export ausreichend, nur mit zusätzlichem Konnektor sinnvoll, oder erst nach einer Prozessanpassung zuverlässig.

Wenn mehrere Systeme beteiligt sind, hilft ein Überblick über Automatisierung bei KDS. Für eine weitergehende Anwendung oder Integrationslösung finden Sie den passenden Rahmen unter individuelle Systeme. Senden Sie KDS über das Kontaktformular den gewünschten Ablauf, die Produktnamen und vorhandene Schnittstellendokumentation. Eine schriftliche Ersteinschätzung ist ohne Telefontermin möglich.