„Seit gestern synchronisiert nichts mehr“: geänderte Anbieter-API, abgelaufene Zugangsdaten

Montagmorgen: Die Bestellungen vom Wochenende sind nicht in der Warenwirtschaft, die Rechnungen nicht in der Buchhaltung, die Termine nicht im Kalender. Niemand hat am Freitag etwas umgestellt. Trotzdem steht die Verbindung, die seit zwei Jahren zuverlässig lief. Der Satz „Seit gestern synchronisiert nichts mehr“ hat fast immer eine Ursache außerhalb des Betriebs.

Die vier häufigsten Ursachen

1. Die Schnittstellenversion wurde abgeschaltet

Anbieter entwickeln ihre Schnittstellen weiter und schalten alte Versionen nach einer Frist ab. Shopify beschreibt das Verfahren genau: Alle drei Monate erscheint eine neue Version, jede stabile Version wird mindestens zwölf Monate unterstützt, mit mindestens neun Monaten Überschneidung. Fragt eine Anbindung eine nicht mehr unterstützte Version an, antwortet Shopify mit der ältesten noch unterstützten Version. Das Verhalten der Anbindung ändert sich dann, ohne dass jemand eine Zeile Code angefasst hat.

2. Ein Feld wurde umbenannt oder entfernt

Innerhalb eines Versionswechsels werden Felder als veraltet markiert und später entfernt. Liest die Anbindung ein Feld, das es nicht mehr gibt, erhält sie einen leeren Wert. Je nach Bauweise bricht sie dann ab oder, schlimmer, überträgt stillschweigend leere Daten.

3. Zugangsdaten sind abgelaufen

Viele Schnittstellen arbeiten mit Anmeldetoken, die nach einer bestimmten Zeit erneuert werden müssen. Andere nutzen Schlüssel, die an einen Benutzer gebunden sind. Verlässt dieser Mitarbeiter den Betrieb und wird sein Konto gelöscht, verliert die Verbindung ihren Zugang. Auch ein geändertes Passwort beim Anbieter oder ein neu eingeführter zweiter Anmeldefaktor kann eine Verbindung abschneiden.

4. Berechtigungen fehlen

Anbieter führen neue Berechtigungsstufen ein oder verlangen für bestimmte Daten eine zusätzliche Freigabe. Die Verbindung darf dann weiterhin Bestellungen lesen, aber keine Kundendaten mehr, oder sie darf lesen, aber nicht schreiben. Die Fehlermeldung dazu landet in einem Protokoll, das niemand liest.

Was Sie sofort prüfen können

1. Den Zeitpunkt eingrenzen: Wann kam die letzte erfolgreiche Übertragung an?

2. Im Protokoll der Anbindung die erste Fehlermeldung nach diesem Zeitpunkt suchen. Meldungen zu Anmeldung oder Berechtigung weisen auf Zugangsdaten hin, Meldungen zu unbekannten Feldern auf einen Versionswechsel.

3. Beim Anbieter nachsehen, ob es in den letzten Wochen Ankündigungen zu Versionen oder Berechtigungen gab.

4. Prüfen, ob der Benutzer, an den der Zugang gebunden ist, noch existiert und aktiv ist.

5. Nach der Reparatur die Lücke schließen: Alle Daten seit der letzten erfolgreichen Übertragung gezielt nachholen und prüfen, dass nichts doppelt ankommt.

Wie eine Verbindung aussieht, die nicht still ausfällt

Sie führt eine Liste aller Anbieter, der genutzten Versionen und der Ablaufdaten aller Zugänge. Sie nutzt eigene technische Zugänge statt persönlicher Konten. Sie prüft nach jedem Lauf, ob die erwartete Menge an Daten angekommen ist, und schlägt Alarm, wenn über einen festgelegten Zeitraum nichts übertragen wurde. Und sie behandelt leere Pflichtfelder als Fehler, nicht als gültigen Wert.

So wird aus „seit gestern“ ein „seit zehn Minuten, und wir wissen warum“. Das gilt für jede Verbindung, ob Stripe-Freischaltung, Formular ins CRM oder der Kassenexport an DATEV.

Damit ein solcher Ausfall nicht erst Tage später auffällt, überwacht unsere Schnittstellen-Wache bestehende Anbindungen und holt fehlende Übertragungen ohne Doppelverarbeitung nach.

Häufig gestellte Fragen

Warum funktioniert meine Schnittstelle plötzlich nicht mehr?

Meist hat sich beim Anbieter etwas geändert: Eine Schnittstellenversion wurde abgeschaltet, ein Feld entfernt, ein Zugang ist abgelaufen oder eine Berechtigung fehlt.

Wie oft ändern Anbieter ihre Schnittstellen?

Das ist je Anbieter verschieden. Shopify veröffentlicht alle drei Monate eine neue Version und unterstützt jede stabile Version mindestens zwölf Monate.

Was passiert, wenn meine Anbindung eine alte Shopify-Version nutzt?

Laut Shopify antwortet die Schnittstelle dann mit der ältesten noch unterstützten Version. Das Verhalten kann sich dadurch ändern, ohne dass die Anbindung angepasst wurde.

Warum sollte ein Zugang nicht an einen Mitarbeiter gebunden sein?

Weil die Verbindung ausfällt, sobald das Konto dieses Mitarbeiters gelöscht, gesperrt oder sein Passwort geändert wird. Technische Zugänge sind davon unabhängig.

Wie hole ich die Daten nach dem Ausfall nach?

Alle Daten seit der letzten erfolgreichen Übertragung gezielt erneut übertragen und dabei prüfen, dass nichts doppelt ankommt.

Übernehmen die Netzhandwerker Reparatur und Überwachung?

Ja. Wir finden die Ursache, holen fehlende Daten nach und überwachen die Verbindung dauerhaft. Schnittstelle anfragen →

Quellen

• Shopify: Versionierung der Schnittstellen

Die Angaben der Hersteller haben wir am 11. September 2026 an den verlinkten Seiten geprüft. Anbieter ändern ihre Dokumentation; maßgeblich ist jeweils der aktuelle Stand dort.

Verwandte Artikel

• Bezahlt, aber kein Zugang: Stripe-Webhooks fehlen, kommen doppelt oder in falscher Reihenfolge
• Anfrage abgeschickt, im CRM nie angekommen: Websiteformular und Kundenverwaltung
• SumUp DATEV Schnittstelle: Integration, Export und typische Fehler
• Überverkauf trotz Warenwirtschaft: Lagerbestand zwischen Shop, Amazon und eBay