Was tun, wenn Mergado den Eingabefeed nicht herunterladen kann#

Wenn Mergado Ihren Eingabefeed nicht herunterladen kann, wird das Projekt nicht neu generiert und im Ausgabefeed bleiben ältere Daten. In den meisten Fällen liegt die Ursache nicht bei Mergado, sondern darin, dass der Server mit Ihrem Feed die Anfrage zum Herunterladen ablehnt oder nicht beantwortet. Dieser Artikel hilft Ihnen herauszufinden, was passiert, und zeigt Ihnen den Weg zur Lösung – idealerweise so, dass Sie die Ursache selbst finden und nicht auf eine Antwort des Supports warten müssen.

Die Vorgehensweise gilt sowohl für den Eingabefeed des Projekts als auch für Dateien, die die Regel Data File Import (Datendatei-Import) herunterlädt.

Wie Sie herausfinden, was genau passiert ist#

Raten Sie nicht nur danach, dass „das Projekt nicht funktioniert“. Mergado protokolliert jeden Versuch, den Feed herunterzuladen:

1. Öffnen Sie in Mergado das Projekt, bei dem das Problem aufgetreten ist.
2. Wechseln Sie zur Seite History (Historie).
3. Filtern Sie in der Spalte Event type (Ereignistyp) nach Product import (Produktimport) bzw. nach Scheduled product import (geplanter Produktimport), wenn das Projekt automatisch neu generiert wird.

Sie sehen die Anzahl der fehlgeschlagenen Versuche und die zugehörige Meldung. Bei den häufigsten Fehlern (401, 403, 404, 500, 502, 503 und 504) ist die Meldung konkret und verrät direkt, was passiert ist – fahren Sie in diesem Fall mit der Tabelle unten fort. Sehen Sie nur die allgemeine Meldung „Unknown error“ (Unbekannter Fehler), wechseln Sie direkt zum Abschnitt Was bedeutet „Unknown error“.

Was die einzelnen Fehler bedeuten#

WAF (Web Application Firewall) ist ein Sicherheitsfilter, der Anfragen an Ihre Website prüft und verdächtige blockiert. Sie ist oft Teil des Hostings oder von Diensten wie Cloudflare und blockiert manchmal versehentlich auch das automatisierte Herunterladen des Feeds.

Was bedeutet „Unknown error“#

Bei den übrigen Fehlern zeigt die History keine konkrete Beschreibung, sondern nur die allgemeine Meldung „Unknown error“. Das betrifft vor allem:

• 429 Too Many Requests – Der Server begrenzt die Anzahl der Anfragen und der Feed-Download hat nicht mehr ins Limit gepasst.
• Timeout – Der Server hat gar nicht geantwortet, oder der Verbindungsaufbau hat zu lange gedauert.
• Zertifikats-/SSL-Fehler – Der Server hat ein ungültiges, abgelaufenes oder nicht vertrauenswürdiges Zertifikat.

Den genauen Code und Grund erkennen Sie in diesem Fall in der History nicht – ihn sieht nur unser technischer Support. Bevor Sie ihm schreiben, versuchen Sie, die Ursache selbst zu überprüfen – in den meisten Fällen finden Sie sie, ohne auf eine Antwort warten zu müssen:

1. Testen Sie den Download des Feeds so, wie Mergado ihn sieht. Mergado lädt den Feed nicht über einen Browser herunter, sondern automatisiert über das Tool curl mit der Kennung (User-Agent) MergadoBot. Dieselbe Anfrage können Sie selbst senden. Führen Sie im Terminal (macOS, Linux, Windows 10 und neuer) Folgendes aus:

   Copy

   curl -I -A "MergadoBot" "https://adresse-ihres-feeds"

   • In der ersten Zeile der Antwort sehen Sie den HTTP-Code (zum Beispiel HTTP/2 200, 403, 429 oder 503). Daran erkennen Sie die Ursache, auch wenn die History nur „Unknown error“ anzeigt.
   • Die Antwort enthält den Header cf-mitigated: challenge → Cloudflare blockiert den Feed; gehen Sie nach der Anleitung für Cloudflare vor.
   • Der Befehl gibt nichts zurück oder endet erst nach langer Zeit → Das entspricht einem Timeout.
   • Der Befehl endet mit einem Zertifikatsfehler → Es handelt sich um einen SSL-Fehler; lassen Sie das Zertifikat bei Ihrem Hosting erneuern.

   Der Test läuft von Ihrer IP-Adresse aus, nicht von der IP-Adresse von Mergado. Erhalten Sie 200, kann Mergado den Feed aber trotzdem nicht herunterladen, blockiert der Server höchstwahrscheinlich direkt die IP-Adresse von Mergado – prüfen Sie das im Log (nächster Schritt) oder bei Ihrem Hosting.

2. Prüfen Sie das Access-/Error-Log Ihres Hostings (in der Administration Ihres Hostings – anders als in unserer History sehen Sie dort den tatsächlichen HTTP-Status). Suchen Sie darin anhand der History den Zeitpunkt des fehlgeschlagenen Versuchs und achten Sie auf Anfragen von der IP-Adresse 81.31.39.112.

   • Die Anfrage ist dort gar nicht zu finden → Sie wurde gestoppt, bevor sie Ihre Anwendung erreicht hat (Firewall, WAF, Netzwerkebene) → Das entspricht einem Timeout.
   • Die Anfrage ist dort und Sie sehen einen konkreten Code (zum Beispiel 429) → Sie kennen die genaue Ursache, ohne auf uns warten zu müssen. Bei Fehler 429 bitten Sie den Serveradministrator oder Ihr Hosting, das Limit für die IP-Adresse von Mergado zu erhöhen.

3. Vergleichen Sie den Zeitpunkt des letzten erfolgreichen und des ersten fehlgeschlagenen Eintrags in der History. So können Sie das Problem einer konkreten Änderung zuordnen – einer neuen Sicherheitsregel, der Aktivierung von Cloudflare, einer Hosting-Migration oder einer Zertifikatserneuerung.

Wenn Sie die Ursache auch auf diese Weise nicht finden, schreiben Sie uns an mergado@mergado.cz – fügen Sie den Link zum Projekt, die Adresse des Feeds und den Zeitpunkt bei, zu dem das Problem aufgetreten ist. Erst nach dieser Überprüfung ermitteln wir für Sie den Code und den genauen Grund in der Administration.

Sonderfall: Früher hat es funktioniert und jetzt nicht mehr, ohne dass ich etwas geändert habe#

Das kommt häufiger vor, als man denkt, und ist fast nie ein Fehler auf der Seite von Mergado. Typische Ursachen:

• Ihr Hosting hat neue Sicherheitsregeln eingeführt. Ein realer Fall: Ein großer tschechischer Hoster hat eine neue Regel zur Erkennung verdächtiger Kommunikation eingeführt und dabei versehentlich auch die Kommunikation von Mergado als riskant eingestuft. Damit hat er das Herunterladen von Feeds bei allen Onlineshops auf seinen Servern blockiert, bis wir ihn darauf hingewiesen haben.
• Sie haben Cloudflare aktiviert oder dessen Einstellungen haben sich geändert.
• Das Zertifikat ist abgelaufen.
• Sie haben das Hosting migriert oder die IP-Adresse des Servers hat sich geändert und die Whitelist ist dort nicht mehr vorhanden.
• Das Passwort oder der Hash in der Adresse des Feeds hat sich geändert, zum Beispiel nach einem Update des Onlineshops.

So erkennen Sie es: Suchen Sie in der History des Projekts den letzten erfolgreichen Download und vergleichen Sie ihn mit dem ersten fehlgeschlagenen. Der Zeitpunkt, an dem es nicht mehr funktioniert hat, ist die wertvollste Information für Sie und für Ihr Hosting.

Vorgehensweise#

1. Testen Sie den Feed so, wie Mergado ihn herunterlädt – mit dem Befehl curl -I -A "MergadoBot" "https://adresse-ihres-feeds" (ausführlicher im Abschnitt Was bedeutet „Unknown error“). Den Feed nur im Browser zu öffnen, reicht nicht aus: Der Browser kann den Feed laden, auch wenn der Server automatisierte Downloads blockiert.
2. Sehen Sie in der History des Projekts nach, welcher Fehler sich wiederholt. Handelt es sich um eine konkrete Meldung (401, 403, 404, 500, 502, 503 oder 504), suchen Sie sie in der Tabelle oben. Handelt es sich um „Unknown error“, gehen Sie nach dem Abschnitt Was bedeutet „Unknown error“ vor.
3. Prüfen Sie die IP-Adress-Whitelist. Mergado lädt den Eingabefeed von der Adresse 81.31.39.112 herunter. Wenn Sie Erweiterungen verwenden, fügen Sie auch deren IP-Adressen hinzu.
4. Stellen Sie sicher, dass der Feed nicht auf mehrere Arten gleichzeitig geschützt ist. Die Kombination aus Whitelist und Hash in der Adresse ist eine häufige Fehlerquelle, typischerweise bei Feeds aus Shoptet.
5. Wenn Sie Cloudflare verwenden, richten Sie eine Ausnahme nach der separaten Anleitung ein. Die IP-Adresse nur auf die Whitelist zu setzen, reicht dort nicht aus.
6. Schreiben Sie Ihrem Hosting, wenn nichts von dem oben Genannten geholfen hat. Geben Sie an, dass es sich um einen legitimen automatisierten Download eines Produktfeeds handelt, und bitten Sie um die Freigabe der IP-Adresse 81.31.39.112. Fügen Sie den Zeitpunkt bei, ab dem das Herunterladen nicht mehr funktioniert hat.
7. Kontaktieren Sie unseren Support, wenn Sie sich nicht sicher sind. Schreiben Sie an mergado@mergado.cz und fügen Sie den Link zum Projekt, die Adresse des Feeds und den Zeitpunkt bei, zu dem das Problem aufgetreten ist.

FAQ#

Bedeutet ein Fehler beim Herunterladen, dass ich die Daten im Ausgabefeed verliere?#

Nein. Wenn der Download fehlschlägt, behält Mergado die Daten aus dem letzten erfolgreichen Import – sofern es bereits einen gab. Der Ausgabefeed bleibt verfügbar, enthält aber ältere Informationen, bis der Download wieder gelingt. Wurde der Feed noch kein einziges Mal heruntergeladen (zum Beispiel bei einem neu angelegten Projekt), gibt es im Ausgabefeed noch keine Daten.

Warum wird mein Feed nicht heruntergeladen, obwohl er im Browser funktioniert?#

Der Browser und Mergado greifen unterschiedlich auf den Feed zu. Mergado lädt den Feed automatisiert über das Tool curl mit der Kennung MergadoBot herunter. Der Browser kann JavaScript und Sicherheitsabfragen verarbeiten, ein automatisierter Download nicht. Der Server kann den Zugriff außerdem nach IP-Adresse unterscheiden, und Ihre ist eine andere als die von Mergado. Am häufigsten stecken eine IP-Adress-Whitelist, eine WAF oder Cloudflare dahinter. Zuverlässiger als der Browser ist daher der Test mit curl, der im Abschnitt Was bedeutet „Unknown error“ beschrieben ist.

Gilt das Gleiche für die Regel Data File Import?#

Ja. Die Regel Data File Import lädt die Datei auf die gleiche Weise herunter wie den Eingabefeed, daher sind auch die Ursachen und Lösungen dieselben.

Wie finde ich heraus, ob mich mein Hosting blockiert?#

Ein zuverlässiges Anzeichen ist ein Timeout-Fehler, bei dem der Server gar nicht antwortet, obwohl der Test mit curl und der Kennung MergadoBot von Ihrem Computer aus normal durchläuft. Hat das Problem außerdem von einem Tag auf den anderen ohne Ihr Zutun begonnen, ist eine Blockierung durch das Hosting sehr wahrscheinlich. Wenden Sie sich an dessen Support.

Warum sehe ich in der History nur „Unknown error“ und keinen konkreten Code?#

Die History zeigt eine konkrete Beschreibung nur bei den häufigsten Fehlern (401, 403, 404, 500, 502, 503 und 504). Andere Fehler, zum Beispiel 429, ein Timeout oder ein Problem mit dem Zertifikat, werden dort allgemein als „Unknown error“ angezeigt – den genauen Code sieht in diesem Moment nur unser Support. Wie Sie die Ursache selbst überprüfen, erfahren Sie im Abschnitt Was bedeutet „Unknown error“.

Muss ich nach der Lösung etwas tun, damit das Projekt neu generiert wird?#

Mergado versucht bei jeder weiteren Neugenerierung automatisch, den Feed herunterzuladen. Wenn Sie das Ergebnis sofort prüfen möchten, starten Sie die Neugenerierung im Projekt manuell.