Wie finde ich den passenden Weg, um zwei Programme zu verbinden?
Wähle den Weg anhand der verfügbaren Funktionen, der benötigten Aktualität und der Regeln für Änderungen.
CSV überträgt Daten in einer Datei. Eine API bietet einen beschriebenen Zugriff auf Funktionen oder Datensätze eines Programms. Ein Webhook meldet ein Ereignis an eine andere Anwendung. Diese Wege schließen sich nicht aus: Eine Datei kann den Anfangsbestand liefern, ein Webhook spätere Änderungen melden und eine API die dazugehörigen Daten abrufen.
Schreibe zunächst auf, welche Information wo entsteht, wer sie bearbeitet und wie aktuell sie im Ziel sein muss. Prüfe danach, ob beide Programme die benötigten Felder und Aktionen unterstützen. Eine vorhandene Schnittstelle allein beantwortet diese Fragen noch nicht.
Wann reicht ein CSV-Import für den Datenaustausch?
CSV reicht häufig, wenn Daten in überschaubaren Abständen als klar definierter Bestand oder als Änderungsliste übertragen werden sollen.
Lege Spaltennamen, Zeichenkodierung, Trennzeichen, Datumsformate und eindeutige Datensatz-IDs fest. Prüfe, ob der Import neue Einträge anlegt, vorhandene aktualisiert oder einen Bestand ersetzt. Ohne diese Regel kann derselbe Import doppelte Datensätze erzeugen oder Werte überschreiben.
Microsoft dokumentiert für Excel, dass beim Öffnen von CSV-Dateien Standardeinstellungen zur Interpretation verwendet werden. Datumswerte und Kennungen mit führenden Nullen brauchen deshalb besondere Aufmerksamkeit. CSV lässt sich auch automatisiert verarbeiten; die Datei ist aber noch kein Abgleichmechanismus. Quelle: Microsoft Support, TXT und CSV importieren (https://support.microsoft.com/de-de/excel/get-started/import-or-export-text-txt-or-csv-files).
Wann ist eine API-Anbindung sinnvoll?
Eine API ist sinnvoll, wenn unterstützte Datensätze oder Aktionen gezielt und wiederholt zwischen Anwendungen gelesen oder geschrieben werden müssen.
Prüfe dafür die Dokumentation beider Programme: Welche Felder sind erreichbar, welche Berechtigungen werden benötigt und welche Begrenzungen gelten? Auch Tarif, Version und verfügbare Endpunkte können den möglichen Ablauf bestimmen. Ein fertiger Verbinder auf einer Automatisierungsplattform kann den Einstieg erleichtern, muss aber dieselben fachlichen Anforderungen erfüllen.
Die Anbindung muss Antworten auswerten, statt jeden abgeschlossenen Aufruf als Erfolg zu behandeln. MDN zeigt am Beispiel der Fetch-API, dass auch eine HTTP-Fehlerantwort einen Antwortwert liefert und der Status ausdrücklich geprüft werden muss. Quelle: MDN, Fetch verwenden (https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API/Using_Fetch).
Was bringt ein Webhook gegenüber einer regelmäßigen Abfrage?
Ein Webhook kann die Verarbeitung bei einem Ereignis anstoßen, statt dass deine Anwendung ständig nach Änderungen fragen muss.
Der sendende Dienst übermittelt beispielsweise eine Benachrichtigung, dass ein Datensatz verändert wurde. Ob alle benötigten Daten enthalten sind oder anschließend per API abgerufen werden müssen, hängt vom Anbieter ab. Ein Webhook bedeutet auch nicht automatisch, dass der gesamte Folgeprozess sofort abgeschlossen ist.
Die Empfangsstelle muss die Herkunft nach den Vorgaben des Anbieters prüfen. Stripe beschreibt hierfür unter anderem signierte Ereignisse. Prüfe außerdem die dokumentierten Wiederholungen und die Reihenfolge der Zustellung. Je nach System ist ein ergänzender regelmäßiger Abgleich sinnvoll, um unbemerkte Lücken zu erkennen. Quelle: Stripe, Webhooks (https://docs.stripe.com/webhooks).
Wie verhindere ich, dass sich zwei Programme gegenseitig überschreiben?
Lege für jedes Feld fest, welches System den maßgeblichen Wert führt und wie Konflikte gelöst werden.
Als Planungsbeispiel kann das CRM die Kundenadresse führen, während ein Projektsystem den Bearbeitungsstatus verwaltet. Dann werden diese Felder in jeweils festgelegter Richtung übertragen. Eine beidseitige Synchronisation aller Felder ist deutlich anspruchsvoller: Du brauchst Regeln für gleichzeitige Änderungen, leere Werte, Löschungen und archivierte Datensätze.
Ordne Datensätze über stabile Kennungen zu und halte die Verbindung der IDs beider Systeme fest. Ein ähnlicher Name ist kein sicherer Schlüssel. Kläre auch, wie der Ablauf seine eigenen Änderungen erkennt, damit diese keine endlose Folge neuer Aktualisierungen auslösen.
Was passiert bei doppelten Ereignissen oder einer gestörten Verbindung?
Die Verbindung sollte Wiederholungen erkennen, Fehler protokollieren und fehlgeschlagene Vorgänge kontrolliert nachholen können.
Stripe dokumentiert ausdrücklich, dass Webhook-Ereignisse mehrfach ankommen können und ihre Zustellung nicht zwingend in Entstehungsreihenfolge erfolgt. Die konkreten Zusagen anderer Anbieter müssen gesondert geprüft werden. Ein Verarbeitungsnachweis anhand geeigneter Ereignis- oder Vorgangskennungen kann verhindern, dass eine Wiederholung dieselbe Folgeaktion erneut auslöst.
Unterscheide vorübergehende Ausfälle von ungültigen Daten oder fehlenden Berechtigungen. Zeige den letzten erfolgreichen Abgleich und offene Fehler einer zuständigen Person. Eine Wiederholung darf nicht blind alte Werte über neuere schreiben. Quelle für das Anbieterbeispiel: Stripe, Webhooks (https://docs.stripe.com/webhooks).
Was sollte ich vor dem Start einer automatischen Synchronisation testen?
Teste den vollständigen Ablauf mit neuen, geänderten, doppelten und fehlerhaften Datensätzen, bevor du ihn für den Betrieb freigibst.
Prüfe insbesondere: - Bleibt die Zuordnung beim erneuten Übertragen desselben Datensatzes erhalten? - Werden leere Felder, Sonderzeichen und führende Nullen richtig behandelt? - Was passiert bei Änderungen in beiden Systemen? - Wie werden Archivierung und Löschung behandelt? - Lässt sich ein fehlgeschlagener Vorgang sicher nachholen? - Wer erkennt eine unterbrochene Verbindung und entscheidet über die Korrektur?
Beginne mit einem abgegrenzten Datenfluss. Halte Zuständigkeiten und Grenzen fest, bevor du weitere Felder hinzunimmst. Für eine Planung mit KUP Solutions helfen die Namen der Programme, ihre Dokumentationen, ein anonymisierter Beispieldatensatz und die gewünschten Bearbeitungsregeln.