Was eine Schnittstelle ist: erklärt ohne Vorkenntnisse

Jede Anfrage an eine Schnittstelle läuft nach demselben Muster ab, gleich ob es um eine Kundenadresse oder um eine Lagerbuchung geht. Wenn Sie dieses Muster einmal gesehen haben, können Sie in einer Besprechung mit dem Systemanbieter mitreden, ohne selbst Technik zu betreiben. Wichtig ist vor allem der letzte Schritt: Auf jede Anfrage folgt eine Antwort mit einem Statuszeichen, und dieses Statuszeichen entscheidet darüber, ob die Anbindung stillschweigend danebenliegt oder einen Fehler sichtbar macht.

In der Praxis sieht eine Anfrage samt Antwort so aus wie im folgenden Beispiel. Sie müssen das nicht schreiben können — es hilft aber, es einmal gesehen zu haben, weil in Angeboten und Dokumentationen genau diese Bestandteile auftauchen: Adresse, Absicht, Zugangsschlüssel, gewünschtes Format, Statuszeichen und Datenpaket.

Zwei Dinge sind an diesem Beispiel wichtig. Erstens der Zeitstempel: Eine Antwort bleibt eine Momentaufnahme, und die Frage, wie alt ein Wert sein darf, gehört fachlich geklärt, nicht technisch. Zweitens die Nummer 200 in der Antwortzeile — das Statuszeichen für erfolgreich. Kommt stattdessen 401, fehlt der Ausweis; bei 403 ist der Ausweis gültig, aber die Rechte reichen nicht; bei 404 existiert der Datensatz nicht; bei 429 wurden zu viele Anfragen gestellt; ab 500 liegt der Fehler im Zielsystem. Diese Zahlen sind branchenüblich und begegnen Ihnen in jeder Dokumentation wieder.

Zwei Fragen werden hier häufig vermischt. Die erste lautet: Wer stellt die Anfrage? Das ist der Ausweis. Die zweite lautet: Was darf dieser Fragende? Das sind die Rechte. Der Ausweis wird meist über einen Zugangsschlüssel geführt, eine lange Zeichenkette, die das andere System vergibt. In größeren Systemen kommt ein Verfahren zum Einsatz, bei dem der Schlüssel zeitlich begrenzt gilt und regelmäßig erneuert wird — für Ihre Planung bedeutet das lediglich, dass die Erneuerung automatisch ablaufen muss und nicht an einer Person hängen darf.

Die Rechte sind der Punkt, an dem Vorhaben tatsächlich scheitern. Ein Zugang, der ausschließlich lesen darf, eignet sich für Auswertungen und für die Auswertung von Kennzahlen, aber nicht für automatische Buchungen. Umgekehrt gehört ein Zugang mit Vollrechten nicht in eine Anbindung, die nur Adressen abgleichen soll. Für jede Anbindung sollte ein eigener technischer Zugang mit genau den benötigten Rechten eingerichtet werden — nicht der Zugang eines Mitarbeiters. Verlässt diese Person den Betrieb und wird ihr Konto gesperrt, steht sonst über Nacht der Datenaustausch.

Eine Schnittstelle ist kein fertiges Bauteil, sondern ein gepflegtes. Anbieter erweitern Felder, ändern Strukturen und schalten alte Stände ab. Damit bestehende Anbindungen davon nicht überrascht werden, wird die Schnittstelle versioniert: In der Adresse taucht eine Kennung wie v1 oder v2 auf, oder die Version wird in der Anfrage mitgegeben. Solange Sie eine feste Version ansprechen, bleibt Ihre Anbindung stabil, auch wenn der Anbieter parallel eine neue Version bereitstellt.

Interessant ist deshalb weniger, ob versioniert wird, sondern wie mit Abschaltungen umgegangen wird. Seriöse Anbieter kündigen das Ende einer Version mit Frist an, veröffentlichen eine Änderungsübersicht und stellen einen Umstiegsleitfaden bereit. Fehlt das, tragen Sie das Risiko: Eine Anbindung, die jahrelang lief, hört an einem Dienstagmorgen ohne Vorwarnung auf zu arbeiten. Deshalb gehören Ankündigungsfrist und Änderungsübersicht in die Vertragsunterlagen und nicht in ein Telefonat.

Zwischen der Aussage, ein System sei offen, und einer tatsächlich nutzbaren Schnittstelle liegen im Alltag Welten. Bitkom weist darauf hin, dass fehlende Verbindungen zwischen vorhandenen Systemen zu den häufig genannten Hürden der Digitalisierung im Mittelstand gehören (Bitkom). Die folgenden Anzeichen lassen sich ohne technische Prüfung erkennen und sagen mehr aus als die Formulierung im Angebot.

Der letzte Punkt verdient Nachdruck. Eine Zusage ohne Dokumentation verschiebt die Klärung in die Umsetzung, also in die Phase, in der jede Stunde bezahlt wird. Wenn ein Systemwechsel ohnehin ansteht, ist die Anbindbarkeit ein Auswahlkriterium wie Preis und Funktionsumfang — und einer der Gründe, warum die Ablösung von Altsystemen oft günstiger ausfällt als der Versuch, ein geschlossenes System nachträglich zu öffnen.

Nicht jedes System im Mittelstand hat eine nutzbare Schnittstelle, gerade ältere Branchenlösungen nicht. Das bedeutet nicht das Ende des Vorhabens, verändert aber den Weg. Der einfachste Ausweichweg ist der geplante Dateiaustausch: Das System legt in festen Abständen einen Export ab, ein zweites Programm holt die Datei, prüft sie und übergibt die Daten weiter. Das ist unelegant, aber robust — und für Stammdaten, Preislisten oder Buchungsstapel häufig völlig ausreichend.

Der zweite Weg ist ein lesender Zugriff auf die Datenbank des Systems, ausdrücklich mit Zustimmung des Herstellers. Ohne diese Zustimmung ist davon abzuraten: Der Zugriff kann Gewährleistungsansprüche berühren, und ein Systemupdate kann die Datenstruktur ohne Vorwarnung ändern. Der dritte Weg — die Nachahmung von Bildschirmeingaben, also ein Programm, das eine Oberfläche wie ein Mensch bedient — ist der teuerste. Er funktioniert, bis der Hersteller ein Feld verschiebt. Als Übergangslösung mit begrenzter Laufzeit hat er seinen Platz, als Dauerlösung selten.

Unabhängig vom gewählten Weg gilt dieselbe Anforderung: Jeder Austausch braucht eine Protokollierung, eine Wiedervorlage für Fehlerfälle und einen benannten Zuständigen. Ein Datenaustausch, der niemandem gehört, fällt irgendwann aus und wird erst bemerkt, wenn eine Auswertung nicht mehr stimmt. Diese Betriebsfragen behandeln wir unter Prozessautomatisierung — sie entscheiden über den Nutzen stärker als die Wahl der Technik. Rechtliche Fragen, etwa zu Aufbewahrung und Auftragsverarbeitung, sollten im Einzelfall fachlich geprüft werden; die elektronische Rechnungsstellung im Geschäftsverkehr zwischen Unternehmen ist in Deutschland seit 2025 mit Empfangspflichten verbunden (Umsatzsteuergesetz) und ein häufiger Anlass, Systeme erstmals ernsthaft zu verbinden.