Lorixen.
DE

Wenn ein Anbieter seine Schnittstelle ändert: Ein Phasenplan für die Portalwartung

Kurz gesagt: Fremdanbieter ändern ihre Schnittstellen regelmäßig: Felder kommen hinzu, alte Versionen werden abgeschaltet, Anmeldeverfahren wechseln. Ein Portal, das darauf nicht vorbereitet ist, fällt irgendwann aus, meist zu einem ungünstigen Zeitpunkt. Ein Phasenplan mit fünf Stufen verhindert das: Ankündigungen sammeln, Auswirkungen bewerten, Änderung in einer Testumgebung bauen, kontrolliert umstellen und danach beobachten. Dieser Plan ist der eigentliche Inhalt eines guten Wartungsvertrags für Portale mit Anbindung an Buchhaltung oder Zahlung. Ob Ihr Anbieter Änderungen ankündigt und wie früh, steht in der jeweiligen Dokumentation, die wir als Quelle verlinken.

Warum Schnittstellen nicht stillstehen

Anbieter wie Buchhaltungssoftware, Zahlungsdienste oder Versandunternehmen entwickeln ihre Produkte weiter. Das hat Folgen für alle, die per Schnittstelle andocken. Typische Anlässe sind neue Pflichtfelder, etwa wegen gesetzlicher Vorgaben, ein neues Anmeldeverfahren, geänderte Antwortformate oder die Abschaltung einer alten Version. Manche Änderungen sind lange vorher bekannt, andere kommen mit kurzer Frist. Beides ist normal, nur eine fehlende Reaktion ist es nicht.

Phase 1: Beobachten

Wer nicht weiß, dass etwas kommt, kann nicht planen. Legen Sie fest, wer folgende Quellen verfolgt:

  • Entwicklerseiten und Änderungsprotokolle der Anbieter
  • Hinweis-Mails an die hinterlegte Entwickleradresse (nicht an eine Person, die gegangen ist)
  • Statusseiten der Dienste
  • Hinweise der Branchenverbände und Ihrer Kanzlei bei fachlichen Änderungen

Wichtig ist eine gemeinsame Adresse, die mehrere Personen lesen. Ein erfundenes, aber typisches Beispiel: Die Ankündigung einer Abschaltung geht an die Mailadresse eines ehemaligen Mitarbeiters und wird erst bemerkt, wenn die Anbindung nicht mehr antwortet.

Phase 2: Bewerten

Jede Ankündigung wird mit drei Fragen eingeordnet.

  1. Betrifft sie uns? Nutzt das Portal die betroffene Funktion überhaupt?
  2. Bis wann? Gibt es ein verbindliches Datum, und was passiert danach genau?
  3. Wie groß ist der Aufwand? Geht es um ein Feld, um einen Austausch der Anmeldung oder um einen Umbau?

Aus den Antworten entsteht eine Einstufung: gering (Anpassung im Rahmen der Wartung), mittel (eigener kleiner Auftrag), groß (Projekt mit Zeitplan). Halten Sie sie schriftlich fest.

Phase 3: Bauen und testen

Die Änderung wird nicht am laufenden Portal vorgenommen. Dazu gehören eine Testumgebung mit Testzugang beim Anbieter, falls dieser einen anbietet, und automatisierte Tests für die wichtigsten Abläufe, zum Beispiel "Rechnung anlegen" und "Kontakt ändern". Prüfen Sie nicht nur den Normalfall, sondern auch Fehlerfälle: Was passiert, wenn der Anbieter nicht antwortet oder eine unerwartete Antwort liefert?

Phase 4: Umstellen

Gute Umstellungen sind unspektakulär. Drei Vorgehen haben sich bewährt:

Vorgehen Wann es passt
Umschalter Neue und alte Version laufen parallel, ein Schalter wechselt
Stufenweise Zuerst wenige Kunden, dann alle
Wartungsfenster Kurze Sperre außerhalb der Stoßzeit, nur bei kleinen Portalen

Wählen Sie den Zeitpunkt nicht kurz vor Monatsende, wenn Rechnungen und Abschluss anstehen. Und halten Sie einen Rückweg bereit: Die alte Fassung bleibt einsatzbereit, bis die neue sich bewährt hat.

Phase 5: Beobachten und dokumentieren

Nach der Umstellung gilt eine Woche erhöhte Aufmerksamkeit. Prüfen Sie Fehlerzähler, offene Warteschlangen und Stichproben im Buchhaltungssystem. Danach wird die Änderung dokumentiert: Was wurde geändert, warum, wann, wer hat getestet. Die Dokumentation spart beim nächsten Mal Zeit, und sie ist die Grundlage, wenn der Dienstleister wechselt.

Was in einen Wartungsvertrag gehört

  • Wer beobachtet die Anbieter, und wie oft?
  • Welche Anpassungen sind im Pauschalpreis enthalten, welche werden separat angeboten?
  • Reaktionszeiten bei Ausfällen der Anbindung, getrennt nach Werktagen und Wochenende
  • Berichtspflicht: eine kurze Mitteilung bei jeder relevanten Ankündigung
  • Zugriff auf Testkonten der Anbieter, die auf Ihren Namen laufen

Ein pauschales "Wir halten alles aktuell" ist zu vage. Verlangen Sie Beispiele, was dazugehört und was nicht.

Kleine Maßnahmen mit großer Wirkung

Auch ohne großen Vertrag helfen zwei Dinge. Erstens ein einfacher täglicher Test, der meldet, wenn die Anbindung eine Fehlermeldung zurückgibt, bevor ein Kunde es merkt. Zweitens eine Seite im Portal, auf der das Büro sieht, ob die Verbindung zu Buchhaltung und Zahlung gerade funktioniert. Beides kostet wenig und erspart viel Suchen.

Ein erfundenes Beispiel zur Einordnung

Ein Möbelhändler in Graz hat ein Bestellportal, das jede Rechnung an die Buchhaltung übergibt. Der Anbieter der Buchhaltung kündigt an, dass die bisherige Anmeldung der Schnittstelle in einigen Monaten abgeschaltet wird. In Phase 2 stuft der Dienstleister das als mittel ein, weil die Anmeldung an einer einzigen Stelle des Portals sitzt. In Phase 3 wird sie in einer Testumgebung ausgetauscht, in Phase 4 läuft sie zwei Wochen parallel, in Phase 5 werden die Rechnungen einer Woche stichprobenartig verglichen. Weil das Datum früh bekannt war, entsteht weder Hektik noch Aufpreis für Eilzuschläge.

Wenn eine Ankündigung zu spät kommt

Es passiert trotzdem, dass ein Anbieter kurzfristig etwas ändert oder ein Fehler auftritt. Für diesen Fall brauchen Sie einen Notweg: Das Portal speichert Vorgänge, die nicht übergeben werden konnten, und das Büro kann sie bis zur Reparatur von Hand erfassen. Das Büro sollte dafür eine kurze Anleitung haben und wissen, an wen es sich wendet. So wird aus einem Ausfall eine Unannehmlichkeit.

Wer im Betrieb Bescheid wissen sollte

Damit der Plan nicht an einer Person hängt, benennen Sie im Betrieb eine Ansprechperson für das Portal und eine Vertretung. Beide kennen die Anbieter, die angebunden sind, wissen, wo die Zugangsdaten verwaltet werden, und können dem Dienstleister auf Rückfrage schnell antworten. Ein kurzes Treffen pro Quartal genügt, um offene Ankündigungen durchzugehen.

Häufige Fragen

Wie häufig ändern sich Schnittstellen?

Das ist je nach Anbieter verschieden. Lesen Sie dessen Dokumentation zu Versionen und Abkündigungen und fragen Sie, wie weit im Voraus angekündigt wird.

Können wir Änderungen einfach ignorieren?

Kurzfristig ja, aber ab dem Abschaltdatum funktioniert die Anbindung nicht mehr. Planen Sie Anpassungen lieber früh und klein als spät und dringend.

Wer zahlt für erzwungene Anpassungen?

Das regelt der Vertrag. Klären Sie vor dem Start, ob Änderungen bei Fremdanbietern als Wartung oder als Zusatzauftrag gelten.

Wenn Ihr Portal mit Buchhaltung oder Zahlung verbunden ist und Sie einen verlässlichen Wartungsplan wünschen, gestalten wir ihn gemeinsam mit Ihnen: Wartung besprechen.

Quellen

WhatsAppTermin buchen