Eine Integration klingt einfach. System A hat die Daten, System B braucht sie, und dazwischen sitzt eine API. Auf dem Whiteboard ist das ein einziger Pfeil.
In der Praxis versteckt sich hinter diesem Pfeil der größte Teil der Arbeit. Dieser Artikel zeigt, was eine Integration Sie tatsächlich kostet, warum Schätzungen für diese Art von Arbeit so oft danebenliegen und was Sie vor Projektbeginn tun können, damit die Zahl verlässlicher wird.
Wofür Sie bezahlen
Wenn wir eine Integration bauen, ist der Aufruf der API der kleinste Teil. Die Kosten entstehen bei allem, was darum herum liegt:
- Datenabgleich (Mapping). Ihr Kundendatensatz in einem System passt selten zum anderen. Felder haben andere Namen, Formate und Regeln. Jemand muss entscheiden, was jedes Feld bedeutet und was passiert, wenn es nicht passt.
- Authentifizierung. Schlüssel, Token und Berechtigungen müssen eingerichtet, sicher gespeichert und erneuert werden, ohne dass etwas ausfällt.
- Fehlerbehandlung. Netzwerke fallen aus. Dienste sind nicht erreichbar. Anfragen werden abgelehnt. Eine gute Integration weiß, was sie erneut versucht, was sie in eine Warteschlange stellt und was sie an eine Person meldet.
- Limits und Timing. Viele APIs begrenzen, wie oft Sie sie aufrufen dürfen. Einen großen Rückstau an Datensätzen zu übertragen ist eine andere Aufgabe, als jeweils eine Änderung zu synchronisieren.
- Überwachung. Sie müssen wissen, wann die Verbindung ausfällt, am besten bevor Ihre Kunden es merken.
- Compliance. Enthalten die Daten persönliche oder finanzielle Angaben, brauchen Sie womöglich Audit-Protokolle, Zugriffskontrollen und einen klaren Nachweis, wer was geändert hat. Hier treffen Integrationsarbeit und Compliance-Software aufeinander.
Keiner dieser Punkte erscheint im Diagramm mit dem einen Pfeil. Alle erscheinen im Aufwand.
Warum Schätzungen danebenliegen
Die meisten Schätzprobleme bei Integrationen haben dieselbe Ursache. Die Hälfte der Arbeit hängt von einem System ab, das Sie nicht kontrollieren.
Die Gegenseite ist unbekannt
Den eigenen Code können wir gut schätzen. In das System eines Anbieters können wir nicht hineinsehen. Die Dokumentation kann veraltet, unvollständig oder gar nicht vorhanden sein. Verhalten, das die Dokumentation auf eine Weise beschreibt, kann im Betrieb anders ausfallen. Solange niemand echte Aufrufe gegen den echten Dienst macht, ist ein Teil der Schätzung eine Vermutung.
Die Daten sind unordentlicher als erwartet
Beispieldatensätze sehen sauber aus. Echte Datensätze enthalten Dubletten, leere Felder, alte Formate und Werte, von denen sich niemand erinnert, sie angelegt zu haben. Diese Daten zu bereinigen und abzugleichen ist oft der größte Einzelposten, und er bleibt unsichtbar, bis man hinsieht.
Es gibt keine Testumgebung
Manche Dienste bieten eine Sandbox, in der Sie sicher testen können. Manche nicht, oder die Sandbox verhält sich anders als das Live-System. Ohne Sandbox dauern Tests länger und verlangen mehr Sorgfalt.
Der Umfang wächst an den Rändern
Aus „Bestellungen synchronisieren“ wird „Bestellungen, Erstattungen, Teilerstattungen und stornierte Bestellungen, die später wiederhergestellt wurden synchronisieren“. Jeder dieser Fälle ist nachvollziehbar. Zusammen können sie die Größe der Aufgabe verändern.
Die API ändert sich später
Anbieter aktualisieren ihre APIs und stellen alte Versionen ein. Eine Integration ist am Tag der Inbetriebnahme nicht fertig. Sie muss gepflegt werden, und diese laufenden Kosten gehören in den Plan.
So kommen Sie zu einer verlässlichen Schätzung
Sie können die Spanne deutlich eingrenzen, bevor eine Zeile Code geschrieben wird.
- Nennen Sie die Systeme und die Richtung der Daten. Welches System ist für welche Art von Datensatz die maßgebliche Quelle? Fließen die Daten in eine Richtung oder in beide?
- Teilen Sie echte Beispieldaten. Ein kleiner Export ohne sensible Angaben sagt uns mehr als eine Beschreibung.
- Prüfen Sie den API-Zugang früh. Klären Sie, ob Sie Zugangsdaten, eine Sandbox (falls es eine gibt) und die aktuelle Dokumentation bekommen.
- Listen Sie die Sonderfälle auf, die Sie schon kennen. Retouren, fehlgeschlagene Zahlungen, zusammengeführte Konten. Alles, was Ihr Team heute von Hand erledigt.
- Entscheiden Sie, was bei einem Fehler geschieht. Soll das System still erneut versuchen, jemanden alarmieren oder anhalten? Das ist ebenso eine geschäftliche wie eine technische Entscheidung.
- Notieren Sie Compliance-Vorgaben. Wenn ein Prüfer oder eine Aufsichtsbehörde Fragen zu diesen Daten stellen wird, sagen Sie das gleich zu Beginn.
Die passende Arbeitsweise wählen
Wie viel unbekannt ist, sollte mitbestimmen, wie Sie die Arbeit bezahlen. Wir bieten drei Arbeitsweisen an, und jede passt zu einem anderen Grad an Sicherheit.
| Arbeitsweise | Passt am besten, wenn |
|---|---|
| Festpreis für einen definierten Umfang | Die Systeme, Daten und Sonderfälle bekannt und schriftlich festgehalten sind |
| Ein Team im Monat | Es um mehrere Integrationen geht oder sich der Umfang mit dem Lernen weiter ändern wird |
| Ein monatliches Stundenkontingent mit zugesagter Reaktionszeit | Die Integration läuft und laufende Pflege braucht, wenn sich APIs ändern |
Ein Festpreis funktioniert nur gut, wenn der Umfang wirklich definiert ist. Ist das andere System noch ein Rätsel, führt eine erzwungene feste Zahl meist entweder zu einem Preis mit Puffer oder später zu einer schmerzhaften Änderung. Oft ist es besser, zuerst die Unbekannten zu klären und dann den Preis festzulegen.
Die Spanne für Ihr Projekt sehen
Unser Kostenschätzer gibt Ihnen in wenigen Minuten eine Preisspanne auf Grundlage unserer aktuellen Preisliste. Er zeigt die Baukosten, die monatlichen Kosten, den Aufwand nach Rolle, den Zeitplan und jede Annahme hinter der Zahl. Lesen Sie die Annahmen genau. Bei einer Integration sehen Sie dort, was bekannt ist und was nicht.
Wenn Sie es besprechen möchten: Atheron Network Labs ist jetzt offen für Projekte. Bringen Sie Ihre Liste der Systeme mit, und wir sagen Ihnen klar, wo das Risiko liegt.
