Problembehandlung bei der Integration

Das Trennen und Neuinstallieren deiner Integration ist eine zuverlässige Lösung bei anhaltenden Verbindungsfehlern, Authentifizierungsproblemen und Situationen, in denen Bestellungen nicht mehr importiert werden und andere Schritte nicht geholfen haben. Stelle sicher, dass du genau weißt, was du dabei verlierst.

Schritte zum Zurücksetzen deiner Integration

1. Gehe in deinem Sendcloud-Konto zu Einstellungen > Integrationen.
2. Suche deine Integration in der Liste und klicke auf Trennen.
3. Installiere die Integration neu, indem du der Einrichtungsanleitung für deine Plattform folgst. Alle Installationsanleitungen findest du im Bereich Integrationen im Help Center.
4. Gehe nach der erneuten Verbindung zu Einstellungen > Integrationen > Konfigurieren und erstelle alle gelöschten Versandregeln neu.

Bevor du die Einstellungen deines Webshops prüfst, stelle sicher, dass dein Sendcloud-Konto vollständig eingerichtet ist. Ein unvollständiges Konto kann eine neue Verbindung stillschweigend blockieren. Sieh dir zunächst die Kontoeinrichtungsschritte am Anfang dieses Artikels an.

Wenn dein Konto korrekt eingerichtet ist, arbeite Folgendes durch:

Dein Webshop ist nicht öffentlich erreichbar
Sendcloud muss deinen Webshop über das Internet erreichen können, um eine Verbindung herzustellen. Wenn dein Shop im Wartungsmodus ist, hinter einem Passwort liegt oder noch nicht veröffentlicht wurde, schlägt die Verbindung fehl. Stelle sicher, dass dein Shop live und öffentlich erreichbar ist, bevor du ihn verbindest.

Dein SSL-Zertifikat ist ungültig oder abgelaufen
Auch wenn dein Shop im Browser korrekt lädt, blockiert ein ungültiges SSL-Zertifikat die API-Aufrufe von Sendcloud. Prüfe, ob dein Zertifikat gültig und bei deinem Hosting-Anbieter korrekt konfiguriert ist.

Ein Drittanbieter-Plugin oder eine App verursacht einen Konflikt
Sicherheits-Plugins, Caching-Plugins und Checkout-Erweiterungen sind die häufigsten Ursachen für Verbindungskonflikte. Um den Verursacher zu finden, deaktiviere deine zusätzlichen Plugins einzeln nacheinander – beginne mit Sicherheits-, Firewall- oder Caching-Plugins – und versuche nach jedem Schritt erneut, eine Verbindung herzustellen. Sobald die Verbindung funktioniert, hast du den Konflikt gefunden.

Die IP-Adressen von Sendcloud werden blockiert
Wenn dein Server oder deine Hosting-Umgebung eine Firewall oder eine IP-Zulassungsliste verwendet, kann es sein, dass Sendcloud blockiert wird. Füge die IP-Adressen von Sendcloud zu deiner Zulassungsliste hinzu: 

Die vollständige Liste wird auch gepflegt und aktualisiert unter: https://cdn.sendcloud.com/global-media/public-ips.txt 
Wenn dein Shop Cloudflare nutzt, können dessen Sicherheitseinstellungen Sendcloud ebenfalls blockieren. Lies unseren speziellen Leitfaden: Cloudflare blockiert Sendcloud – Fehlerbehebung.

Ein Caching-Proxy blockiert API-Aufrufe
Wenn du einen Caching-Proxy verwendest, stelle sicher, dass dieser die API-Anfragen von Sendcloud nicht blockiert oder zwischenspeichert. Bitte deinen Entwickler, die Cache-Einstellungen zu prüfen und sicherzustellen, dass die Sendcloud-Domain nicht blockiert ist.

Protokoll der fehlgeschlagenen Anfragen prüfen
Gehe in deinem Sendcloud-Konto zu Einstellungen > Integrationen > Protokoll fehlgeschlagener Anfragen. Verbindungsfehler werden hier mit einer Beschreibung protokolliert. Leite die Fehlermeldung an deinen Hosting-Anbieter oder Entwickler weiter, wenn du Hilfe bei der Auswertung benötigst.

Wenn deine Integration funktioniert hat und plötzlich ohne offensichtliche Änderungen aufgehört hat zu funktionieren, liegt die Ursache fast immer an etwas, das sich auf der Seite deines Webshops oder auf der Seite von Sendcloud verändert hat. Arbeite Folgendes durch, bevor du den Support kontaktierst.

Prüfe zuerst, ob es sich um ein Sendcloud-seitiges Problem handelt
Bevor du Zeit damit verbringst, deine Webshop-Einstellungen zu prüfen, schau auf die Statusseite von Sendcloud. Wenn ein aktiver Vorfall vorliegt, der Integrationen betrifft, kann es sein, dass dein Problem sich von selbst löst, sobald er behoben ist – du musst nichts unternehmen.

Überlege, was sich zuletzt geändert hat
Die große Mehrheit plötzlicher Integrationsausfälle wird durch eine Änderung ausgelöst, auch eine, die scheinbar nichts mit Sendcloud zu tun hat. Frage dich:

• Hast du kürzlich deine Webshop-Plattform, dein Theme oder Plugins aktualisiert?
• Hast du das Sendcloud-Plugin oder die App in deinem Webshop aktualisiert?
• Hat dein Hosting-Anbieter deinen Server migriert oder eine Konfiguration geändert?
• Hat sich die Domain oder URL deines Shops geändert?
• Hast du API-Schlüssel neu generiert oder Passwörter im Backend deines Webshops geändert?
• Hast du ein neues Sicherheits-Plugin installiert oder eine Firewall-Regel aktiviert?

Wenn eines davon zutrifft, ist diese Änderung höchstwahrscheinlich die Ursache. Prüfe das Protokoll der fehlgeschlagenen Anfragen (siehe den Abschnitt oben) auf den Fehler, der ungefähr zur gleichen Zeit aufgetreten ist.

Prüfe, ob dein Sendcloud-Plugin auf dem neuesten Stand ist
Eine veraltete Version des Sendcloud-Plugins in deinem Webshop ist eine häufige Ursache für plötzliche Ausfälle, besonders nach einem Plattform-Update. Gehe in deinem Webshop zum Plugin- oder App-Bereich und bestätige, dass du die neueste Version der Sendcloud-Integration verwendest.

Prüfe, ob deine API-Zugangsdaten noch gültig sind
Wenn API-Schlüssel oder Tokens in deinem Webshop – auch automatisch – neu generiert wurden, wird die Verbindung zu Sendcloud sofort unterbrochen. Gehe zu Einstellungen > Integrationen > Konfigurieren in deinem Sendcloud-Konto und überprüfe die Zugangsdaten. Wenn sie veraltet aussehen, verbinde die Integration mit den neuen Schlüsseln neu.

Protokoll der fehlgeschlagenen Anfragen prüfen
Gehe zu Einstellungen > Integrationen > Protokoll fehlgeschlagener Anfragen und suche nach dem Zeitpunkt, ab dem Fehler aufgetreten sind. Fehlercode und Beschreibung zeigen dir, was sich geändert hat. Ordne den Fehler dem entsprechenden Abschnitt in diesem Artikel zu.

Arbeite die folgenden Prüfpunkte der Reihe nach durch, bevor du den Support kontaktierst.

Neue Bestellungen können bis zu 4 Minuten brauchen, bis sie erscheinen
Sendcloud ruft neue Bestellungen ungefähr alle 4 Minuten ab. Wenn du gerade eine Testbestellung aufgegeben hast und sie noch nicht erscheint, warte ein paar Minuten und lade die Seite neu, bevor du davon ausgehst, dass etwas nicht stimmt.

Datumsfilter in Sendcloud prüfen
Standardmäßig zeigt die Ansicht für eingehende Bestellungen Bestellungen der letzten 7 Tage an. Wenn du nach älteren Bestellungen suchst, öffne den Datumsfilter und stelle einen größeren Zeitraum ein. Das ist der häufigste Grund, warum Bestellungen „fehlen".

Bestellungen, die älter als 30 Tage sind, werden nicht importiert
Wenn du deinen Webshop zum ersten Mal verbindest, importiert Sendcloud nur Bestellungen der letzten 30 Tage. Bestellungen, die vor diesem Zeitraum aufgegeben wurden, erscheinen nicht automatisch. Wenn du ältere Bestellungen importieren möchtest, kontaktiere den Support über dein Sendcloud-Konto.

Prüfe, ob deine Integration noch verbunden ist
Gehe zu Einstellungen > Integrationen und bestätige, dass dein Shop unter den verbundenen Integrationen aufgeführt ist. Wenn nicht, wurde die Verbindung unterbrochen und muss neu hergestellt werden. Siehe den Abschnitt unten zum Zurücksetzen deiner Integration.

Protokoll der fehlgeschlagenen Anfragen prüfen
Gehe zu Einstellungen > Integrationen > Protokoll fehlgeschlagener Anfragen. Wenn dort Fehler aufgelistet sind, notiere die Fehlermeldung – das ist der schnellste Weg, um zu diagnostizieren, was schiefläuft. Leite den Fehler bei Bedarf an deinen Hosting-Anbieter oder Entwickler weiter.

Ein Plugin sendet möglicherweise unvollständige Bestelldaten
Manche Plugins verändern oder entfernen Bestelldaten, bevor sie Sendcloud erreichen, wodurch Bestellungen lautlos übersprungen werden. Deaktiviere zusätzliche Plugins einzeln nacheinander, um herauszufinden, ob eines davon den Ablauf stört. Produkte, die in deinem Webshop als virtuell markiert sind, können ebenfalls dazu führen, dass Bestellungen übersprungen werden.

Dein Webshop ist möglicherweise nicht öffentlich erreichbar
Wenn dein Shop in den Wartungsmodus gewechselt ist oder die Verbindung nicht mehr erreichbar ist, werden Bestellungen nicht mehr importiert. Prüfe, ob dein Shop live und vom Internet aus erreichbar ist.

Wenn du in Sendcloud ein Label erstellst, sendet die Integration automatisch die Trackingnummer und den aktualisierten Bestellstatus an deinen Webshop zurück. Falls das nicht funktioniert, prüfe Folgendes.

Prüfe, ob deine Integration noch verbunden ist
Feedback kann nur gesendet werden, wenn die Verbindung zwischen Sendcloud und deinem Webshop aktiv ist. Gehe zu Einstellungen > Integrationen und bestätige, dass dein Shop unter den verbundenen Integrationen erscheint. Wenn die Verbindung unterbrochen war, werden Tracking-Updates für zwischenzeitlich versendete Bestellungen nicht rückwirkend gesendet – diese Bestellungen musst du manuell in deinem Webshop aktualisieren.

Protokoll der fehlgeschlagenen Anfragen prüfen
Gehe zu Einstellungen > Integrationen > Protokoll fehlgeschlagener Anfragen. Wenn Sendcloud versucht hat, Feedback zu senden, und dabei gescheitert ist, wird der Fehler hier mit einer Beschreibung aufgezeichnet. Das ist der schnellste Weg, um zu bestätigen, ob überhaupt ein Versuch unternommen wurde.

Prüfe, wann das Label erstellt wurde
Feedback wird in dem Moment gesendet, in dem das Label in Sendcloud erstellt wird. Wenn das Label erstellt wurde, während die Integration getrennt war, wurde für diese Bestellung kein Feedback gesendet. Aktualisiere in solchen Fällen den Bestellstatus manuell in deinem Webshop.

Das Feedback ist möglicherweise verzögert, nicht verloren
Wenn du eine große Anzahl von Bestellungen auf einmal verarbeitest, kann es sein, dass deine Webshop-Plattform die eingehenden Updates von Sendcloud drosselt, was zu einer kurzen Verzögerung führt, bevor Status und Trackingnummern erscheinen. Warte ein paar Minuten, bevor du davon ausgehst, dass das Feedback vollständig fehlgeschlagen ist.

Diese beiden Fehler sind die häufigsten authentifizierungsbezogenen Probleme bei allen Integrationen. Sie sehen ähnlich aus, haben aber unterschiedliche Ursachen.

401 — Sendcloud kann sich bei deinem Webshop nicht authentifizieren
Das bedeutet, dass Sendcloud abgewiesen wird, weil die verwendeten Zugangsdaten ungültig oder abgelaufen sind. Die häufigsten Ursachen sind:

• Die API-Schlüssel, die zur Verbindung deiner Integration verwendet wurden, sind abgelaufen oder wurden in deinem Webshop neu generiert, ohne sie in Sendcloud zu aktualisieren.
• In deinem Sendcloud-Konto ist keine Zahlungsmethode hinterlegt. Gehe zu Einstellungen > Finanzen und stelle sicher, dass eine Zahlungsmethode aktiv ist – eine unvollständige Abrechnungseinrichtung kann die Authentifizierung blockieren.

Um einen 401-Fehler zu beheben, generiere deine API-Schlüssel in deinem Webshop neu und trage sie in Sendcloud unter Einstellungen > Integrationen > Konfigurieren neu ein. Wenn das nicht hilft, trenne die Integration und installiere sie von Grund auf neu, um eine neue Verbindung herzustellen.

403 — Sendcloud wird aktiv blockiert
Das bedeutet, dass dein Server oder eine vorgelagerte Sicherheitsschicht die Anfragen von Sendcloud vollständig ablehnt. Die häufigsten Ursachen sind:

• Die IP-Adressen von Sendcloud werden durch die Firewall oder Hosting-Umgebung deines Servers blockiert. Füge sie zu deiner Zulassungsliste hinzu – die vollständige Liste findest du unter https://cdn.sendcloud.com/global-media/public-ips.txt.
• Cloudflare blockiert die Anfragen von Sendcloud über den Bot Fight Mode oder WAF-Regeln. Lies unseren speziellen Leitfaden: Cloudflare blockiert Sendcloud – Fehlerbehebung.
• Für Shopify: Das OAuth-Token, das bei der Installation verwendet wurde, ist abgelaufen oder die App-Berechtigungen haben sich geändert. Die Sendcloud-App in Shopify neu zu installieren generiert ein neues Token und behebt das Problem.

Prüfe zuerst das Protokoll der fehlgeschlagenen Anfragen
Gehe zu Einstellungen > Integrationen > Protokoll fehlgeschlagener Anfragen. Ein 401-Fehler erscheint als orders.apis.base.exceptions.AuthenticationError. Ein 403-Fehler erscheint als orders.apis.base.exceptions.AccessDenied oder als generischer Forbidden-Fehler. Das Protokoll zeigt dir, mit welchem Typ du es zu tun hast, bevor du Maßnahmen ergreifst.

Das Protokoll der fehlgeschlagenen Anfragen ist dein erster Anlaufpunkt bei jedem Integrationsproblem. Es zeichnet jedes Mal auf, wenn Sendcloud versucht hat, mit deinem Webshop zu kommunizieren, und dabei gescheitert ist – ob es darum geht, Bestellungen abzurufen, Tracking-Feedback zu senden oder die Verbindung zu prüfen. Wenn etwas mit deiner Integration nicht stimmt, findest du den Grund fast immer hier.

Wo du es findest
Gehe zu Einstellungen > Integrationen in deinem Sendcloud-Konto. Suche deine Integration in der Liste und klicke auf Anzeigen > Protokoll der Verbindungsprobleme (oder Protokoll fehlgeschlagener Anfragen, je nach Integrationstyp).

Was du siehst
Jeder Eintrag zeigt Datum und Uhrzeit der fehlgeschlagenen Anfrage, den Fehlercode und eine Beschreibung des Problems. Die neuesten Fehler erscheinen oben. Wichtige Dinge, auf die du achten solltest:

• Der Fehlercode (401, 403, 404, 500 usw.) zeigt die Kategorie des Problems an. Nutze den Abschnitt oben zu 401- und 403-Fehlern oder die entsprechende Plattform-Fehlerbehebungsanleitung am Ende dieses Artikels, um den Code einer Lösung zuzuordnen.
• Die Fehlerbeschreibung nennt oft die genaue Ursache, zum Beispiel: orders.apis.base.exceptions.AuthenticationError oder orders.apis.base.exceptions.NotFoundError. Kopiere diesen Text, wenn du den Support kontaktierst, da dies die Diagnose erheblich beschleunigt.
• Der Zeitstempel zeigt dir, wann das Problem begonnen hat. Wenn Fehler ab einem bestimmten Zeitpunkt auftreten, überlege, was sich ungefähr zu diesem Zeitpunkt geändert hat – ein Plugin-Update, eine Server-Migration, eine Passwortänderung oder ein WooCommerce-Update sind häufige Auslöser.

Wenn das Protokoll leer ist
Ein leeres Protokoll bedeutet nicht immer, dass alles funktioniert. Es kann bedeuten, dass Sendcloud deinen Webshop überhaupt nicht erreicht – die Anfrage kommt nicht einmal durch, um einen Fehler zu erzeugen. Wenn deine Bestellungen nicht mehr importiert werden und das Protokoll leer ist, gehe zurück zur Verbindungs-Checkliste oben und prüfe, ob dein Webshop öffentlich erreichbar ist und ob die IP-Adressen von Sendcloud nicht blockiert sind.

Was du mit dem Fehler machst
Die meisten Fehler im Protokoll sind behebbar – ordne den Fehlercode dem entsprechenden Abschnitt in diesem Artikel oder in der Fehlerbehebungsanleitung deiner Plattform zu. Wenn du die relevanten Schritte durchgearbeitet hast und der Fehler weiterhin besteht, öffne eine Support-Anfrage über dein Sendcloud-Konto und füge einen Screenshot des Protokolleintrags sowie den genauen Fehlertext bei. Das ist das Nützlichste, was du dem Support mitgeben kannst.