Fremde Systeme sauber anbinden

Eine API-Integration ist ein alltäglicher Auftrag mit sehr großer Bandbreite. Am einen Ende steht eine gut dokumentierte REST-Schnittstelle mit Testzugang, an der man binnen kurzer Zeit angebunden ist. Am anderen Ende steht die Schnittstelle einer älteren Unternehmenssoftware, deren Beschreibung aus einem PDF von vor fünfzehn Jahren besteht und für die es keinen Ansprechpartner mehr gibt. Beides kommt vor, beides ist lösbar, nur eben mit sehr unterschiedlichem Aufwand.

Die eigentliche Arbeit liegt selten im Abrufen der Daten, sondern in der Zuordnung der Felder und in den Sonderfällen. Beide Seiten kennen Artikel, Kunden und Aufträge, nur selten in derselben Form: hier Bruttopreise, dort Nettopreise mit Preisgruppe; hier Varianten, dort einzelne Artikelnummern; hier ein Adressfeld, dort fünf. Dazu die Fälle, die in keinem Konzept stehen: Ein Auftrag wird storniert, nachdem er übertragen wurde. Eine Lieferung geht in zwei Paketen raus. Ein Artikel bekommt nachträglich eine neue Nummer.

Technisch läuft der Austausch deshalb von Anfang an im Hintergrund und nicht während jemand auf eine Seite wartet. Das hat zwei Folgen, die im Betrieb zählen: Ist die Gegenstelle langsam oder nicht erreichbar, hängt nicht die eigene Anwendung daran, und ein Fehler führt nicht zu Datenverlust, sondern zu einem Auftrag, der später erneut versucht wird. Wichtig ist dabei die Regel, dass ein zweiter Versuch nichts doppelt anlegt; daran scheitern selbstgebaute Lösungen am häufigsten.

Der Zugriff auf jede Gegenstelle wird gekapselt: eine Klasse je System, mit klarer Schnittstelle nach innen, in der Anmeldung, Fehlerbehandlung, Wiederholungen und Protokollierung an einer Stelle liegen. Der Rest der Anwendung muss dann nicht wissen, ob dahinter REST, SOAP oder GraphQL steckt. Das zahlt sich spätestens dann aus, wenn die Gegenseite ihre Schnittstelle umstellt, denn dann ist genau eine Klasse betroffen. Nach dem gleichen Muster bekommt auch ein vorgegebenes Austauschformat im B2B-Geschäft eine eigene Übersetzungsschicht, damit seine Besonderheiten nicht im ganzen System auftauchen.

Zum Lieferumfang gehört immer eine Übersicht mit Protokoll: was läuft, was hängt, was lässt sich erneut anstoßen, welcher Wert wurde wann übertragen. Im Alltag lautet die häufigste Frage nicht „funktioniert die Anbindung?", sondern „warum steht dort dieser Preis?". Sollen mehrere Systeme über eine gemeinsame Mitte verbunden werden statt einzeln, ist Middleware der passende Zuschnitt; geht es um eine Anbindung innerhalb eines Shops, steht das unter Shopware API-Integration.

Die Zusammenarbeit läuft standardmäßig zu 100 % remote und damit ortsunabhängig, direkt mit Auftraggebern, als Verstärkung für Agenturen und über IT-Vermittler. Entwickelt wird gegen die Testzugänge der beteiligten Systeme. Weil dabei in aller Regel echte Kunden- und Auftragsdaten fließen, gehört ein Auftragsverarbeitungsvertrag nach Art. 28 DSGVO zum Auftrag. Gearbeitet wird aus dem eigenen Büro im kontorworx-Coworking-Space in Rheine, persönliche Termine vor Ort sind nach Absprache möglich, etwa zum Auftakt mit der IT-Abteilung und dem Anbieter der Gegenstelle.