Katalog- und Datenübertragung per SFTP

Bei Unite erfolgt die Katalogübertragung über das sichere Dateiübertragungsprotokoll SFTP (Secure File Transfer Protocol). Die Übertragung per SFTP ist einfach, verschlüsselt und wird durch eine Vielzahl von freien Programmen unterstützt.

Sobald Sie den Onboarding-Prozess begonnen haben, erhalten Sie von uns einen SFTP-Account zur Übermittlung Ihrer Katalogdaten. Für die Übertragung benötigen Sie einen FTP-Client (z. B. FileZilla oder WinSCP), die Serveradresse und Ihre persönlichen Zugangsdaten.

Passwort für SFTP-Account generieren 

  1. Melden Sie sich in der Katalogverwaltung an.

  1. Wählen Sie im linken Menü den Punkt ‚SFTP-Einstellungen‘ . 

Screenshot der Katalogverwaltung mit hervorgehobener Option ‚SFTP-Einstellungen‘ im linken Menü.
Screenshot zeigt die Katalogverwaltung und den Zugang zu den ‚SFTP-Einstellungen‘.
  1. Im unteren Bereich der Seite finden Sie die ‚Account Einstellungen‘. Klicken Sie dort auf ‚Neues Passwort generieren‘.

Screenshot des Bereichs ‚Account Einstellungen‘ in der Katalogverwaltung mit Option zur Generierung eines neuen SFTP-Passworts.
Screenshot zeigt, wie im Bereich ‚Account Einstellungen‘ der Katalogverwaltung ein neues SFTP-Passwort erstellt werden kann.

Wichtig:

  • Kopieren oder notieren Sie sich das Passwort sofort – es wird danach nicht erneut angezeigt.

  • Sie können jederzeit ein neues Passwort generieren. Das alte verliert dann automatisch seine Gültigkeit.

  • Bitte vermeiden Sie die Verwendung des ‚@‘-Zeichens, da dies zu Verbindungsproblemen führen kann. Enthält das generierte Passwort ein ‚@‘, erstellen Sie bitte ein neues.

Zugriffsprobleme?

  • Möglicherweise sind Sie mit einer falschen Rolle angemeldet. Dies kann auftreten, wenn Sie die Katalogverwaltung zusätzlich als Kunde nutzen oder mehrere verknüpfte Accounts besitzen. Nutzen Sie in dem Fall die Funktion ‚Benutzer wechseln‘. 

Screenshot der Katalogverwaltung, der zeigt, wie man die Rolle wechselt, indem man oben rechts auf das runde Symbol mit den Initialen klickt und anschließend die Option ‚Benutzer wechseln‘ auswählt.
Screenshot der Katalogverwaltung zeigt, wo die Funktion ‚Benutzer wechseln‘ zu finden ist.
  • Falls Ihr Konto noch nicht von FTP auf SFTP umgestellt wurde, wenden Sie sich an unseren Technical Support unter support@unite.eu.

Verbindung zum SFTP-Server herstellen

Zugangsdaten

Einstellung

Wert

Übertragungsprotokoll

SFTP

Serveradresse

sftp.unite.services

Hinweis: Bei einigen SFTP-Clients muss zusätzlich das Übertragungsprotokoll angegeben werden: sftp://sftp.unite.services

Portnummer

22

Benutzername

Wird Ihnen beim Onboarding mitgeteilt und ist in der Katalogverwaltung unter ‚SFTP-Einstellungen‘ einsehbar

Passwort

Siehe Abschnitt ‚Passwort für Ihren SFTP-Account generieren‘ auf dieser Seite

Verbindung über einen FTP-Client einrichten

Für die Datenübertragung per SFTP wird ein FTP-Client benötigt. Wir empfehlen die Nutzung von FileZilla oder WinSCP.

FileZilla

Eine kurze Anleitung ist unter FileZilla Client Tutorial (DE) zu finden. 

Folgen Sie diesen Schritten:

  1. Installieren Sie FileZilla auf Ihrem Computer.

  1. Tragen Sie in der Quickconnect -Werkzeugleiste folgendes ein:

  • Address: sftp.unite.services 

  • User: Ihr SFTP Benutzername

  • Password: Ihr SFTP Passwort (siehe ‚Passwort für Ihren SFTP-Account generieren‘)  

  • Port: 22

  1. Klicken Sie auf ‚Quickconnect um die Verbindung herzustellen.

WinSCP

Folgen Sie diesen Schritten:

  1. Installieren Sie WinSCP auf Ihrem Computer.

  1. Tragen Sie auf der Anmeldeseite folgende Werte ein:

  • Protokoll: SFTP

  • Serveradresse: sftp.unite.services

  • Portnummer: 22 

  • Ihr SFPT Benutzername und Ihr SFTP Passwort (siehe ‚Passwort für Ihren SFTP-Account generieren‘)

Vorgabe zur Dateibenennung

Bitte halten Sie sich bei der Benennung Ihrer Dateien an diese Vorgabe, um Ihre Dateien richtig zu benennen. Ihre Katalog-ID teilen wir Ihnen während des Onboardings mit.

Dateityp

Format

Benennung

Beispiel

Katalogdateien

.xml, .zip, .rar

<KatalogID>_catalog.<ext>

12345_catalog.xml

CSV-Dateien (Produkt- & Kategoriedaten)

.csv, .txt

products_<KatalogID>deu.<ext>
categories
<KatalogID>_deu.<ext>

products_12345_deu.csv

Lagerstände

.csv

availability-data-catalog-<KatalogID>.csv

availability-data-catalog-12345.csv

Mediendateien (Bilder, PDFs)

.zip, .rar

images.<ext>
pdf.<ext>

images.zip

Conditionsfiles (optional)

.csv

<KatalogID>_pricefile.csv
<KatalogID>_deliverytime.csv
<KatalogID>_weee_number.csv
<KatalogID>_tariffnumber.csv
<KatalogID>_returncondition.csv

12345_pricefile.csv

12345_deliverytime.csv

Katalogdateien per SFTP übermitteln

Zu einem Katalog gehören in der Regel unterschiedliche Dateien:

  • Katalogdatei (XML oder CSV)

  • Conditionsfiles (optional)

  • Lagerstände (optional)

  • Bilder, Datenblätter und Sicherheitsdatenblätter

Um Ihren Katalog hochzuladen, legen Sie bitte alle Katalogdateien (einschließlich Mediendateien, optionaler Conditionsfiles und Lagerstände) in den jeweiligen SFTP-Unterordner.

Sollten diese Ordner nicht vorhanden sein, erstellen Sie diese bitte manuell gemäß unserer Vorgabe zur Dateibenennung: 

Dateityp

SFTP Unterordner

Katalogdateien (XML/CSV)

/catalog/<KatalogID>/

Conditionsfiles (optional)

/catalog/<KatalogID>/

Lagerstände (optional)

/catalog/<KatalogID>/

Mediadaten (Bilder, Datenblätter)

/catalog/media/

Bitte beachten Sie folgende wichtige Hinweise:

  • Der SFTP-Server dient ausschließlich dem Datenaustausch.

  • Ein vollständiger Erst-Upload dieser Dateien ist erforderlich.

  • Bei späteren Aktualisierungen genügt die Übermittlung der geänderten Dateien. Unveränderte Dateien werden automatisch beibehalten.

  • Wenn Sie Kataloge erneut hochladen oder aktualisieren, ist keine Information an Unite erforderlich.

  • Änderungen an bestehenden Ordnernamen dürfen nur nach Rücksprache mit Unite erfolgen, da sonst die automatisierte Verarbeitung gestört wird.

  • Falls Uploads fehlschlagen, finden Sie diese zur Überprüfung im Ordner ‚unprocessable‘.

Technical Support

Bei Fragen zur technischen Implementierung wenden Sie sich an support@unite.eu.

War dieser Artikel hilfreich?