Integrationen zwischen Geschäftssystemen richtig testen, bevor es live geht

Um eine Integration zwischen Geschäftssystemen zu testen, führen Sie jeden echten Ablauf von Anfang bis Ende mit realistischen Datensätzen durch, prüfen, ob in beiden Systemen am Ende dieselben Daten stehen, und unterbrechen die Verbindung anschliessend bewusst, um zu sehen, wie sie sich erholt. Machen Sie das zuerst in einer Testumgebung, wiederholen Sie nach der Freigabe einen kurzen Kurztest in der Produktion und halten Sie die Prüfungen schriftlich fest, damit sie sich bei jeder Änderung an einem der Systeme wiederholen lassen. Dieser Leitfaden liefert Ihnen die Reihenfolge, die Checkliste und die Stellen, an denen Integrationen üblicherweise scheitern.
Er richtet sich an Gründer:innen, Inhaber:innen und Teams, die einen Shop, ein CRM, ein ERP, ein Buchhaltungswerkzeug oder eine interne Anwendung verbinden und sicher sein wollen, dass alles funktioniert, bevor Kundschaft oder Mitarbeitende darauf angewiesen sind. Für den grössten Teil davon müssen Sie nicht entwickeln können.
Kurz zusammengefasst
- Ein Integrationstest prüft die Übergabe zwischen Systemen, nicht jedes System für sich. Beide können einzeln einwandfrei laufen und beim Datenaustausch trotzdem scheitern.
- Testen Sie ganze Geschäftsabläufe (Bestellung bis Rechnung, neue Kundin bis CRM) mindestens fünfmal mit unterschiedlichen Datensätzen und vergleichen Sie danach die Daten in beiden Systemen.
- Provozieren Sie Fehler bewusst: Zeitüberschreitungen, abgelaufene Zugänge, doppelte Nachrichten, Anfragelimiten und Ausfälle.
- Halten Sie die Prüfungen als Checkliste fest, damit eine Person oder ein Skript sie nach jeder Änderung wiederholen kann.
- Erfahrene Fachleute bringen am meisten, wenn sie früh auf den Testplan schauen, dann sind Korrekturen am günstigsten.
Was ein Integrationstest tatsächlich prüft
Ein Integrationstest prüft, wie sich zwei oder mehr Komponenten verhalten, sobald sie verbunden sind. Ein Schweizer Lernmodul zu Teststufen beschreibt ihn als Prüfung des Zusammenspiels von Komponenten nach deren Integration, mit dem Ziel, Fehler an den Schnittstellen oder im kombinierten Verhalten zu finden, die auftreten können, even when the individual component tests found no defects. Ein typischer Fall: Beide Systeme funktionieren, aber das eine sendet ein Datum in einem Format und das andere liest es in einem anderen.
Betriebswirtschaftlich stellen Sie drei Fragen:
- Löst das richtige Ereignis in System A die richtige Aktion in System B aus?
- Kommen die Daten vollständig, korrekt und ohne Dubletten an?
- Was passiert, wenn dazwischen etwas schiefgeht?
Das ist etwas anderes als die Prüfung, ob Ihr Webshop eine Bestellung entgegennimmt oder ob Ihr Buchhaltungswerkzeug eine Rechnung erstellt. Das sind Tests der einzelnen Teile. Beim Integrationstest geht es um die Nahtstelle.
Der Unterschied zu Komponenten-, System- und Abnahmetests
Die Begriffe werden oft vermischt, deshalb die Kurzfassung. Deloitte’s description of the four levels ist eine gute Referenz:
| Teststufe | Was geprüft wird | Wer sie üblicherweise durchführt |
|---|---|---|
| Komponententest | Jede Komponente funktioniert gemäss ihrem Entwurf | Entwickler:innen |
| Integrationstest | Zusammenspiel zwischen integrierten Komponenten oder Systemen | Entwickler:innen, mit fachlichem Input |
| Systemtest | Das gesamte System gegen funktionale und nicht funktionale Anforderungen | Testteam |
| Abnahmetest (UAT) | Fachanwender:innen bestätigen, dass das System die fachlichen Anforderungen erfüllt und freigabebereit ist | Die Personen, die damit arbeiten werden |
Das International Software Test Institute ordnet den Integrationstest nach dem Komponententest und vor dem System- und Abnahmetest ein und hält fest, dass beim Abnahmetest vor dem Start echte Nutzer:innen beteiligt sind.
Eine Einschränkung für kleine Teams: Die Grenze zwischen Integrationstest und Systemintegrationstest, der auch externe Systeme wie einen Zahlungsanbieter einschliesst, ist even when the individual component tests found no defects. Verschwenden Sie keine Energie auf die Bezeichnung. Entscheiden Sie, von welchen Verbindungen Ihr Geschäft abhängt, und testen Sie jede einzelne davon.
Schritt 1: Jede Verbindung und den dahinterliegenden Ablauf auflisten
Bevor Sie irgendetwas testen, zeichnen Sie eine Übersicht auf einer Seite. Notieren Sie pro Verbindung:
- die beiden Systeme und die Datenrichtung (einseitig oder in beide Richtungen)
- das Geschäftsereignis, das sie auslöst (eine bezahlte Bestellung, ein neuer Lead, eine Bestandsänderung)
- was danach passieren soll (eine Rechnung, ein CRM-Eintrag, ein Versandetikett)
- wer es merkt, wenn es nicht klappt, und wie schnell
Diese Übersicht wird zu Ihrem Testplan. Sie bringt auch die Verbindungen ans Licht, für die sich niemand zuständig fühlt. Viele kleine Unternehmen entdecken dabei eine alte Zapier-Verknüpfung oder ein Skript, das eine ehemalige Mitarbeiterin gebaut hat und das immer noch Geld oder Kundendaten bewegt.
Wo es schiefgeht: Teams testen die Verbindung, die sie gerade gebaut haben, und vergessen die umliegenden. Eine neue Shop-Integration kann die Daten verändern, die Ihr ERP erhält, und damit eine Auswertung zerstören, an die niemand gedacht hat.
Schritt 2: Die Feldzuordnung Feld für Feld prüfen
Die meisten Integrationsfehler stecken in der Zuordnung, also darin, welches Feld in System A welches Feld in System B füllt. Prüfen Sie pro Feld vier Punkte:
- Richtige Zuordnung. Der Firmenname der Kundin landet nicht im Feld für den Kontaktnamen.
- Passende Datentypen. Ein Datum, das im einen System als Tag-Monat-Jahr und im anderen als Monat-Tag-Jahr geschrieben wird, vertauscht stillschweigend Tag und Monat bei jedem Datum mit einem Tag von 12 oder tiefer. Es gibt keine Fehlermeldung. Die Daten sind einfach falsch.
- Pflichtwerte. Wenn das Zielsystem ein Feld verlangt, etwa eine Mehrwertsteuernummer oder eine Postleitzahl, legen Sie fest, was passiert, wenn die Quelle es leer lässt.
- Längenbegrenzungen. Eine Adresse mit 60 Zeichen, die in ein Feld mit 40 Zeichen gepresst wird, wird ohne Warnung abgeschnitten.
Prüfen Sie ausserdem Beträge, Währungen und Zeitzonen. Die Schweiz bringt eigene Tücken mit: Adressen in vier Landessprachen, Umlaute und Akzente in Namen sowie CHF und EUR, die in einem Shop oft nebeneinander existieren. Schicken Sie eine Kundin namens «Müller-Béguin» mit einem langen Strassennamen durch die ganze Kette und schauen Sie, was herauskommt.
Schritt 3: Die zentralen Abläufe durchgängig durchspielen
Jetzt testen Sie die Geschäftsabläufe, nicht einzelne Aufrufe. Ein sinnvolles Set für die meisten kleinen Unternehmen:
- Neuer Kunde im CRM erscheint in der Buchhaltung
- Bestellung im Shop erzeugt einen Auftrag oder eine Rechnung im ERP
- Zahlungsstatus wird zurück in den Shop gemeldet
- Bestandsänderung im ERP aktualisiert den Shop
Spielen Sie jeden Ablauf mit mehreren unterschiedlichen Datensätzen von Anfang bis Ende durch. Eine häufig zitierte Checkliste empfiehlt mindestens fünf Durchläufe pro Ablauf mit unterschiedlichen Daten, und das ist eine vernünftige Untergrenze: Ein Durchlauf zeigt, dass es funktionieren kann, fünf zeigen langsam, ob es für eine normale Kundin, eine Kundin mit langem Namen, eine ausländische Adresse, eine rabattierte Bestellung und eine Rückerstattung funktioniert.
Prüfen Sie bei jedem Durchlauf:
- Der Auslöser hat ausgelöst.
- Die Daten sind mit korrekten Werten angekommen.
- Der Datensatz ist mit der richtigen Kundin oder Bestellung verknüpft, ohne Dublette.
- Folgeaktionen wurden ausgelöst, etwa eine E-Mail, eine Aufgabe oder eine Statusänderung.
- Beide Systeme zeigen danach denselben Stand.
Halten Sie fest, was Sie eingegeben und was Sie gesehen haben. Was Sie nicht belegen können, können Sie später nicht wiederholen.
Ein durchgerechnetes Beispiel
Nehmen wir an, Sie betreiben einen Zürcher Onlineshop, der mit einem ERP verbunden ist. Testbestellung 1: eine normale Schweizer Kundin, Kartenzahlung, ein Artikel. Testbestellung 2: ein Kunde in Deutschland mit Rabattcode und zwei Artikeln. Testbestellung 3: eine Bestellung mit einer sehr langen Lieferadresse. Testbestellung 4: eine stornierte Bestellung. Testbestellung 5: eine Teilrückerstattung. Öffnen Sie danach jeweils Shop und ERP nebeneinander und vergleichen Sie Summen, Mehrwertsteuer, Adresse, Status und Bestand. Eine einzige Abweichung bei der Mehrwertsteuer in Bestellung 2 ist genau der Fehler, der ohne diesen Schritt erst Monate später im Quartalsabschluss auffällt.
Schritt 4: Absichtlich kaputtmachen
Der reibungslose Weg ist die einfache Hälfte. Echte Integrationen verbringen ihr Leben mit langsamen Servern, abgelaufenen Zugangsdaten und Nachrichten, die zweimal ankommen. Testen Sie diese Fälle:
- Zeitüberschreitungen und Ausfälle. Schalten Sie das empfangende System während eines Durchlaufs für zehn Minuten ab. Stellt der Sender die Daten in eine Warteschlange und versucht es erneut, oder gehen sie verloren?
- Ablauf der Anmeldung. Tokens und API-Schlüssel laufen ab. Erneuert die Integration sie selbst, und wird jemand benachrichtigt, wenn das nicht gelingt?
- Doppelte Nachrichten. Systeme senden eine Nachricht oft erneut, wenn keine Antwort kommt. Dieselbe Bestellung zweimal zu senden darf nicht zwei Rechnungen erzeugen. Fachleute nennen das Idempotenz: Eine wiederholte Aktion führt zum gleichen Ergebnis wie eine einmalige.
- Anfragelimiten. Wenn Sie 5'000 Produkte auf einmal importieren, beginnt das andere System dann, Anfragen abzulehnen, und was passiert mit dem Rest?
- Fehlerhafte Daten. Senden Sie einen fehlerhaft aufgebauten Datensatz. Er sollte mit einer klaren Meldung abgelehnt werden und nicht den ganzen Stapel zum Absturz bringen.
- Heikle Daten. Prüfen Sie, dass Personendaten nicht in Protokollen oder Fehlermeldungen auftauchen. Nach Schweizer Datenschutzrecht ist das relevant, verwenden Sie in Testsystemen also anonymisierte oder erfundene Kundendaten statt einer Kopie Ihrer echten Kundenliste.
Jeder dieser Fälle sollte in einem von zwei Ergebnissen enden: Die Integration erholt sich von selbst, oder eine namentlich bestimmte Person wird informiert. Das schlechteste Ergebnis ist Stille.
Schritt 5: Testumgebung nutzen und eine Abnahme unter realen Bedingungen
Die meisten Zahlungs-, Versand- und Cloud-Anbieter stellen eine Testumgebung bereit, oft Sandbox genannt, in der nichts wirklich belastet oder versendet wird. Nutzen Sie sie für alles oben Genannte und machen Sie danach einen abschliessenden Abnahmedurchlauf mit den Personen, die mit dem Ergebnis leben müssen: der Person, die Rechnungen verbucht, und der Person, die Bestellungen packt.
Manche Anbieter formalisieren das. Das integrator test script for attended point-of-sale terminals von SIX Payment Services verlangt von Integrierenden, die beschriebenen Tests durchzuführen und zu unterschreiben, Abweichungen mit Testnummer zu dokumentieren und das Skript samt zugehörigen Belegen zur Abnahme einzureichen. Der öffentliche Verkehr in der Schweiz macht es bei Datenschnittstellen genauso: Die Branche veröffentlicht ein baseline test protocol for connecting a VDV 453/454 interface. Die Lehre gilt für jedes Unternehmen: Ein unterschriebenes, nummeriertes Testprotokoll macht aus «es schien zu funktionieren» einen Nachweis.
Führen Sie nach dem Start einen kurzen Kurztest in der Produktion durch, eine Handvoll echter, aber harmloser Transaktionen, um zu bestätigen, dass Produktionsschlüssel, URLs und Berechtigungen stimmen. Test- und Produktionseinstellungen unterscheiden sich, und genau hier geht «gestern lief es noch» meist kaputt.
Schritt 6: Automatisieren, was Sie wiederholen werden
Integrationen sind mit dem Start nicht fertig. Ein Anbieter aktualisiert eine API, ein Feld wird umbenannt, ein neuer Produkttyp kommt dazu. Jede Änderung ist ein Grund, Ihre Tests erneut durchzuführen, und das ist nur dann günstig, wenn die Tests automatisiert sind.
Die offizielle Anleitung von Postman hält fest, dass Integrationen manually, on a schedule with notifications, or in a CI/CD pipeline nach Code-Übergaben getestet werden können. CI/CD bedeutet, dass die Tests bei jeder Codeänderung automatisch laufen. Dieselbe Anleitung zeigt, wie Sie Antwortcodes, Kopfzeilen und Inhalte prüfen, Anfragen in Sammlungen ordnen, die einen Ablauf abbilden, und mit einer Erstellungsanfrage gefolgt von einer Abrufanfrage bestätigen, dass der Datensatz tatsächlich existiert. Sie beschreibt auch, wie Sie mit Umgebungen dieselbe Testreihe gegen unterschiedliche URLs oder Einstellungen laufen lassen, was sich sauber auf Test und Produktion übertragen lässt.
Ein praktischer Rhythmus für ein kleines Team:
- bei jeder Codeänderung: die automatisierten Ablauftests
- jede Nacht oder jede Woche: ein geplanter Durchlauf mit Alarm bei Fehlern
- nach jeder Ankündigung eines Anbieters: eine manuelle Durchsicht der betroffenen Zuordnung
Deloitte ergänzt einen organisatorischen Punkt, den man übernehmen sollte: In jeder Testphase sollten Entwicklung, Test und Fachbereich in Kontakt bleiben, damit Fehler innerhalb vereinbarter Fristen behoben werden, fachliche Fragen beantwortet werden und über den Fortschritt Deloitte’s description of the four levels wird. Für ein Unternehmen mit zehn Personen kann das so einfach sein wie eine gemeinsame Liste offener Fehler und ein wöchentlicher Austausch von fünfzehn Minuten.
Eine Checkliste für Integrationstests zum Wiederverwenden
Kopieren Sie diese in Ihr Projektwerkzeug und haken Sie sie pro Verbindung ab.
Vorbereitung
- Verbindungsübersicht geschrieben: Systeme, Richtung, Auslöser, zuständige Person
- Testumgebung nutzt erfundene oder anonymisierte Daten
- Zugangsdaten und Berechtigungen für Test und Produktion bestätigt
Daten
- Jedes Feld zugeordnet und auf Typ, Format und Länge geprüft
- Pflichtfelder bei leeren Werten sauber behandelt
- Daten, Zeitzonen, Währungen und Mehrwertsteuer überprüft
- Sonderzeichen und lange Werte getestet
Abläufe
- Jeder zentrale Ablauf mindestens fünfmal mit unterschiedlichen Datensätzen durchgespielt
- Keine Dubletten, korrekte Verknüpfungen, Folgeaktionen ausgelöst
- Beide Systeme zeigen denselben Endstand
Fehlerfälle
- Zeitüberschreitung, Ausfall und erneute Versuche getestet
- Doppelte Nachrichten führen zu einem einzigen Ergebnis
- Abgelaufene Zugangsdaten lösen einen Alarm aus
- Anfragelimiten und fehlerhafte Daten sauber behandelt
- Keine Personendaten in Protokollen oder Fehlermeldungen
Freigabe
- Ergebnisse festgehalten und von einer Person aus dem Fachbereich freigegeben
- Kurztest in der Produktion bestanden
- Protokolle zeigen, was gesendet und empfangen wurde und welcher Fehler auftrat
- Tests zur Wiederholung eingeplant und eine Person für Alarme benannt
Wann erfahrene Unterstützung sinnvoll ist
Bei einer einfachen Verbindung zwischen zwei gut dokumentierten Werkzeugen können Sie das meiste selbst durchführen. Der Aufwand wächst mit der Zahl der Systeme, mit massgeschneiderter oder veralteter Software im Spiel und mit den Kosten eines Fehlers, etwa bei Zahlungen, Lagerbeständen oder Kundendaten. Drei Anzeichen sprechen dafür, eine erfahrene Entwicklerin beizuziehen: Die Integration betrifft Geld oder rechtlich relevante Aufzeichnungen, eines der Systeme hat keine Testumgebung, oder frühere Korrekturen zerstören immer wieder etwas anderes.
Am günstigsten ist diese Unterstützung in der Planungsphase, wenn Verbindungsübersicht und Testplan entstehen, denn ein falsches Datenmodell lässt sich vor dem Bau weit leichter korrigieren als danach.
Ampersand ist ein kleines Zürcher Studio, das Systemintegrationen und API-Anbindungen für Shop, CRM und ERP baut, und jedes Projekt wird von erfahrenen Entwickler:innen geführt, von der ersten Beratung bis zur Übergabe. Diese Kontinuität soll Neuschriebe mitten im Projekt und Abhängigkeitsfallen vermeiden, und unser Ziel ist, dass Sie betreiben können, was wir bauen, ohne an uns gebunden zu sein. Wenn Sie eine Integration bauen, migrieren oder betreiben lassen möchten, finden Sie auf der Seite mit Preisen und Leistungen von Ampersand Angebote für eine einzelne Verbindung, eine ganze Integrationslandschaft und laufende Überwachung. Unser Plan «Run & monitor» kostet 750 CHF pro Monat.
Häufige Fehler, die Sie vermeiden sollten
- Nur den reibungslosen Weg testen. Der erste echte Ausfall wird dann zum eigentlichen Test.
- Einen einzigen sauberen Beispieldatensatz verwenden. Echte Daten sind unordentlich, lang und voller Ausnahmen.
- Echte Kundendaten in Testsysteme kopieren. Verwenden Sie erfundene oder anonymisierte Datensätze.
- Niemand ist für Alarme zuständig. Ein Protokoll über erneute Versuche, das niemand liest, schützt niemanden.
- Den Start als Abschluss betrachten. Wiederholen Sie die Tests, sobald sich eines der Systeme ändert.
- Nichts schriftlich festhalten. Wenn die Ergebnisse nur im Kopf einer Person stecken, beginnt die nächste Änderung bei null.
Häufige Fragen
Wie oft soll ich jeden Integrationsablauf testen?
Spielen Sie jeden zentralen Ablauf mindestens fünfmal mit unterschiedlichen Datensätzen durch: einen Standardfall, einen mit Sonderzeichen, einen mit Rabatt, eine Stornierung und eine Rückerstattung. Ein Durchlauf zeigt, dass der Ablauf funktionieren kann. Mehrere unterschiedliche Durchläufe zeigen, ob er für die Kundschaft hält, die Sie tatsächlich haben.
Was ist der Unterschied zwischen Integrationstest und Abnahmetest?
Der Integrationstest prüft, ob verbundene Systeme Daten korrekt austauschen, und ist weitgehend technisch. Beim Abnahmetest bestätigen Fachanwender:innen, dass das System die fachlichen Anforderungen erfüllt und freigabebereit ist. Führen Sie die Integrationstests zuerst durch, damit nicht die Nutzer:innen diejenigen sind, die fehlerhafte Daten entdecken.
Brauche ich besondere Werkzeuge, um Integrationen zwischen Geschäftssystemen zu testen?
Für eine erste Runde genügen eine Tabelle mit Testfällen und ein Vergleich beider Systeme nebeneinander. Sobald Sie die Tests häufig wiederholen, kann ein Werkzeug zum Testen von APIs wie Postman Anfragesammlungen nach Zeitplan oder in einer CI/CD-Pipeline ausführen und Sie bei Fehlern benachrichtigen.
Was soll ich nach dem Start testen?
Führen Sie einen kurzen Kurztest in der Produktion mit einigen echten, aber harmlosen Transaktionen durch, um Schlüssel, URLs und Berechtigungen zu bestätigen, und lassen Sie danach die automatisierten Prüfungen weiterlaufen. Wiederholen Sie die vollständigen Ablauftests, sobald eines der Systeme aktualisiert wird oder sich eine Zuordnung ändert.
Quellen
- even when the individual component tests found no defects
- Deloitte’s description of the four levels
- International Software Test Institute
- integrator test script for attended point-of-sale terminals
- baseline test protocol for connecting a VDV 453/454 interface
- manually, on a schedule with notifications, or in a CI/CD pipeline
Sprechen Sie mit uns
Haben Sie ein Projekt, das dieses Thema berührt?
Ein kostenloses 10-Minuten-Gespräch ist der schnellste Weg, um herauszufinden, ob wir das richtige Studio dafür sind.
Kostenloses 10-Min-Gespräch buchenWeiterlesen
Weitere Artikel.
Sprint Planning für Startups: So planen Sie Sprints, die halten
So plant ein Startup-Team einen Sprint: Backlog vorbereiten, Ziel setzen, Arbeit an der echten Kapazität bemessen und typische Planungsfehler vermeiden.
Artikel lesenCheckliste für den Projektstart: Was vor dem ersten Tag geklärt sein muss
Praktische Checkliste für den Start von Softwareprojekten: Was vor, während und nach dem Kickoff zu klären ist, und wie Sie sie an Ihr Vorhaben anpassen.
Artikel lesenPrompt Engineering Schulung: Was Ihr Team wirklich lernen sollte
Was eine gute Prompt-Engineering-Schulung vermittelt, wie Sie das Format wählen, Daten nach Schweizer Regeln schützen und wann Prompts zu automatisierten Abläufen werden.
Artikel lesen