Feed-Lieferung: SFTP oder URL, Zeitpläne und Schutzmechanismen

Die Artikel-CSV ist die verlässliche Quelle Ihres Katalogs: Was in der Datei steht, wird veröffentlicht, was sich ändert, wird aktualisiert, und was verschwindet, wird aus den Portalen entfernt. Diese Seite erklärt, wie Sie sie übermitteln und was Portal Hero tut, damit ein schlechter Tag der Datei nicht zu einem schlechten Verkaufstag wird. Das Spaltenformat finden Sie in der vollständigen Spezifikation.

Zwei Möglichkeiten der Übermittlung

Per SFTP. Wir geben Ihnen einen Benutzernamen und ein Passwort für sftp.portalhero.pro und Sie schreiben die Datei in den Ordner upload mit dem Namen item_feed.csv. Der Zugriff ist netzwerkbeschränkt: Wir benötigen die IP oder die IPs, von denen aus Sie die Datei hochladen, um sie zur Zugriffsliste hinzuzufügen. Wenn Sie den Server oder den Anbieter wechseln, informieren Sie uns vorher; das ist die häufigste Ursache für „Ich habe die Datei hochgeladen und es wird nicht aktualisiert“.

Per URL. Sie veröffentlichen die Datei unter einer URL und Portal Hero lädt sie bei jeder Ausführung herunter. Wenn die URL eine Authentifizierung erfordert, teilen Sie uns die Header mit, die wir in der Anfrage senden müssen. Das ist die bequemste Option, wenn Ihr ERP oder Ihr Shop bereits einen Feed generiert.

In beiden Fällen wird die Datei überschrieben: Es müssen keine Inkremente gesendet oder Änderungen gemeldet werden.

Wann sie verarbeitet wird

Die Synchronisierung wird mehrmals täglich ausgeführt, zu den Zeiten, die Sie bei der Anmeldung wählen. Üblich ist es, sie direkt nach der Generierung der Datei durch Ihr System zu planen und, wenn Ihr Bestand schnell rotiert, sie mittags und nachmittags zu wiederholen. Jede Ausführung vergleicht die Datei mit dem Veröffentlichten und berührt nur das, was sich geändert hat, sodass ein großer Katalog durch häufige Synchronisierung nicht länger dauert.

Was passiert, wenn die Datei fehlerhaft ankommt

Ein leerer, in der Mitte abgeschnittener oder mit verschobenen Spalten versehener Feed darf Ihren Katalog nicht löschen. Bevor eine Änderung angewendet wird, prüft jede Ausführung drei Dinge:

1. Dass die Datei gültig ist: erwartete Kopfzeile, korrekte Kodierung und korrektes Trennzeichen.
2. Dass das Volumen kohärent ist: Wenn die Anzahl der Artikel im Vergleich zur vorherigen Ausführung schlagartig sinkt, wird die Synchronisierung angehalten und wir benachrichtigen Sie, anstatt Anzeigen zu entfernen.
3. Dass jede Zeile veröffentlichbar ist: Zeilen mit Fehlern werden einzeln verworfen, mit ihrem Grund, ohne die übrigen zu blockieren.

Wenn eine Ausführung angehalten wird, bleiben Ihre Anzeigen unverändert, bis die nächste korrekte Datei eintrifft.

Wo Sie das Ergebnis sehen

Im Dashboard finden Sie das Ergebnis jeder Ausführung: erstellte, aktualisierte und entfernte Artikel pro Portal sowie die Details der verworfenen Zeilen. Wenn etwas nicht stimmt, schreiben Sie uns mit der Uhrzeit der Ausführung und wir prüfen es gemeinsam mit Ihnen.