Schnittstellen, die Daten zuverlässig abgleichen

In den meisten Unternehmen arbeiten mehrere Systeme nebeneinander: ein Onlineshop, eine Warenwirtschaft, eine Buchhaltung, oft ein CRM und dazu Tabellen, die irgendwann jemand angelegt hat. Jedes System ist für sich sinnvoll. Teuer wird es an den Übergängen, dort wo Daten von Hand übertragen, kopiert oder per E-Mail weitergereicht werden.

Eine Schnittstelle ersetzt diese Übergänge durch einen festen, automatischen Ablauf. Sie holt Daten aus einem System, prüft sie, bringt sie in das Format des Zielsystems und schreibt sie dort hinein. Dabei hält sie fest, was übertragen wurde und was nicht. So entsteht eine Kette, in der eine Bestellung, ein Bestand oder eine Rechnung nur einmal erfasst wird.

Wir entwickeln solche Schnittstellen in PHP, meist mit Symfony oder Laravel, und binden die Systeme über ihre offiziellen Programmierschnittstellen (APIs) an. Wo ein System keine API hat, arbeiten wir mit Dateiexporten, Datenbankzugriff oder Webhooks. Welcher Weg der richtige ist, klären wir am Anfang, nicht nach der ersten Panne.

Die meisten Anfragen betreffen wiederkehrende Kombinationen. Jede davon hat ihre eigenen Stolperstellen, und die kennen wir aus der Praxis. Die folgenden Beispiele zeigen, was wir üblicherweise abgleichen. Ihre Kombination kann anders aussehen, das Vorgehen bleibt dasselbe.

Die wichtigste Frage bei jeder Schnittstelle ist nicht technisch. Sie lautet: Welches System ist für welche Daten führend? Wenn der Preis im Shop und in der Warenwirtschaft geändert werden kann, gewinnt irgendwann die falsche Änderung. Deshalb legen wir vor dem ersten Code fest, woher jede Information kommt und in welche Richtung sie fließt.

Daraus entsteht eine Feldzuordnung: Welches Feld im Quellsystem entspricht welchem im Zielsystem, was passiert mit Werten, die es nur auf einer Seite gibt, und wie werden Sonderfälle wie Varianten, Staffelpreise oder mehrere Lieferadressen behandelt. Diese Zuordnung schreiben wir auf. Sie ist später die Grundlage für Tests und für jede Änderung.

Jede Schnittstelle trifft irgendwann auf Daten, die nicht passen: eine Artikelnummer, die es im Zielsystem nicht gibt, eine Adresse ohne Postleitzahl, eine API, die kurz nicht antwortet. Entscheidend ist, was dann passiert. Eine schlechte Schnittstelle bricht still ab. Eine gute hält fest, welcher Datensatz nicht übertragen wurde und warum, versucht es bei vorübergehenden Fehlern später erneut und meldet sich, wenn ein Mensch eingreifen muss.

Deshalb bekommen unsere Schnittstellen ein Protokoll, eine Warteschlange für fehlgeschlagene Übertragungen und eine Benachrichtigung per E-Mail oder in Ihren Chat. Sie sehen, was durchgelaufen ist, und müssen nicht darauf warten, dass ein Kunde sich über eine fehlende Bestellung beschwert.

Viele Anfragen beginnen nicht bei null. Es gibt eine Schnittstelle, die ein früherer Dienstleister oder ein ehemaliger Mitarbeiter gebaut hat, und sie funktioniert meistens. Wir lesen uns in den bestehenden Code ein, dokumentieren, was er tut, und beheben die Ursachen der Abbrüche. Danach entscheiden Sie mit uns, ob sich eine Überarbeitung lohnt oder ob ein Neubau günstiger ist.

Oft hängt eine alte Schnittstelle an einer veralteten PHP-Version oder an einer API, die der Anbieter abschalten will. Dann gehört sie in den größeren Zusammenhang der Software-Modernisierung, weil sie sonst beim nächsten Update des Servers stehen bleibt.

Nicht jede Verbindung braucht eigenen Code. Für einfache Abläufe, etwa eine neue Bestellung als Nachricht an das Lager oder ein Formular als Kontakt ins CRM, reicht oft ein Workflow-Werkzeug wie n8n. Wir sagen Ihnen ehrlich, wo das genügt und wo eine programmierte Schnittstelle stabiler und günstiger im Betrieb ist. Mehr dazu unter Prozessautomatisierung mit n8n.