Skip to content

Zusatzquellen ​

Mit Zusatzquellen ergänzen Sie den ERP-Export um weitere Dateien, zum Beispiel:

  • die Bestandsliste eines Lieferanten oder Großhändlers,
  • eine Verfügbarkeitsdatei mit Lieferterminen,
  • einen Content-Feed mit Beschreibungen und Bildadressen.

ReadySync lädt jede Zusatzquelle einmal je Import und ordnet ihre Zeilen über eine Schlüsselspalte den Artikeln aus dem ERP zu. Danach stehen ihre Spalten im Mapping neben den ERP-Spalten.

Einrichten ​

Verbindung öffnen → Tab Produktimport → Abschnitt Zusatzquellen → Zusatzquelle hinzufügen.

FeldBedeutung
BezeichnungName der Quelle. Ihre Spalten heißen im Mapping „Bezeichnung: Spalte“, also etwa „Lieferant A: Bestand“.
AbrufÜber den ERP-Zugang: Die Datei liegt auf demselben FTP/SFTP-Server wie der ERP-Export. Eigener Zugang: eigener FTP-, FTPS- oder SFTP-Server. Per URL: Abruf über HTTP oder HTTPS, optional mit Benutzer und Passwort oder mit Zugangsdaten als URL-Parameter (z. B. api_key). Diese Parameter stehen nicht in der URL selbst und erscheinen nie im Protokoll.
DateiDateiname, bei „Beginnt mit“ der Anfang des Namens. ReadySync nimmt dann die neueste passende Datei.
Datei im ZIP-ArchivOptional. ZIP-Lieferungen erkennt ReadySync am Inhalt und entpackt sie selbst. Enthält das Archiv mehrere Dateien, steht hier der Name der richtigen, Platzhalter * und ? sind erlaubt, etwa *.csv.
Format, Trennzeichen, Zeichensatzwie beim ERP-Export. CSV, TXT, JSON, XML und BMEcat werden gelesen. Dazu Dealavo-Preisreport für das Repricing.
Schlüsselspalte in der QuelleSpalte, über die zugeordnet wird, etwa EAN. Darunter optional weitere Schlüsselspalten, etwa EAN 2, EAN 3: Ein Artikel wird dann auch über diese Werte gefunden. Die Hauptspalte hat Vorrang.
Passende Spalte im ERP-ExportGegenstück im ERP-Export, etwa EAN-Nummer.
Ersatzspalte im ERP-ExportOptional. Wird verwendet, wenn die erste Spalte leer ist oder in der Quelle nichts findet, etwa eine zweite EAN.
VergleichEAN/GTIN vergleicht nur Ziffern, führende Nullen sind egal (EAN-13 = GTIN-14). Text ignoriert Groß- und Kleinschreibung.
Spalten übernehmenOptional. Leer übernimmt alle Spalten der Quelle.
Wiederverwenden (Minuten)Optional. So lange nutzen alle Importe dieser Verbindung denselben Download, statt die Datei neu zu laden. Gedacht für große Dateien, die sich nur ein paarmal am Tag ändern. Ändern Sie URL, Datei oder Zugangsdaten, lädt ReadySync sofort neu. Standard beim Dealavo-Preisreport 60 Minuten, sonst 0 (jedes Mal neu). Ist der Download eines Dealavo-Preisreports abgelaufen, lädt ReadySync ihn in einem eigenen Schritt vor dem Import neu. Die Importdatei wird erst danach abgeholt. Im Job-Protokoll steht dann „Zusatzquelle … vorab geladen, der Import startet im nächsten Schritt.“
Wenn die Quelle fehltWarnen: Der Import läuft weiter, die Spalten der Quelle bleiben leer. Abbrechen: Der Import stoppt.

Zu jeder Quelle gibt es zusätzlich die Spalte „Bezeichnung: _zugeordnet“. Sie enthält 1, wenn der Artikel in der Quelle gefunden wurde, sonst ist sie leer.

Im Mapping verwenden ​

Der Mapping-Editor zeigt die Spalten der Zusatzquellen in der Vorschau mit an. Sie verwenden sie wie jede andere Spalte: als Quelle eines Feldes, in einer Summe oder in einer Bedingung.

Beispiel Lieferzeit mit Vorrang: Eigenes Lager zuerst, dann der Lieferant, sonst lange Lieferzeit.

  1. Feld Lieferzeit, Quelle: eigene Bestandsspalte.
  2. Transformation Mehrere Schritte:
    • Bestand größer 0 → „1-3 Werktage“
    • Wenn Spalte „Lieferant A: Bestand“ gefüllt ist → „2-4 Werktage“
    • sonst → „10-14 Werktage“

Die Reihenfolge der Schritte legt den Vorrang fest. Eine 0 zählt in Bedingungen standardmäßig als leer.

Gut zu wissen ​

  • Die Zusatzquellen werden bei jedem Import gelesen, auch beim Delta-Import. Ein Delta-Import aktualisiert aber nur die Artikel in der Delta-Datei. Ändert sich nur der Bestand beim Lieferanten, braucht es einen Vollimport, etwa per Zeitsteuerung alle paar Stunden.
  • Kommt ein Schlüssel in der Quelle mehrfach vor, gilt die erste Zeile. Das Protokoll nennt die Zahl der Dubletten.
  • Das Protokoll des Imports zeigt je Quelle, wie viele Zeilen sie hatte und wie viele Artikel zugeordnet wurden.

Prodanet ProductData API ​

Statt einer Datei kann eine Zusatzquelle die Herstellerinhalte von Prodanet abrufen: Texte, Merkmale, Bilder, Energielabel, Datenblatt und EPREL-Nummer. ReadySync fragt dabei je Importabschnitt die GTINs dieses Abschnitts einzeln ab. Eine Datei gibt es nicht.

Einrichten: Abruf Prodanet ProductData API wählen und Access-Key, App-Key und Service-Key eintragen. Die Schlüssel stellt Prodanet bereit. Als passende Spalte im ERP-Export die EAN-Spalte angeben, optional eine Ersatzspalte, etwa eine abweichende Prodanet-EAN.

Die Quelle liefert diese Spalten, jeweils mit der Bezeichnung davor (z. B. „Prodanet: Beschreibung“):

SpalteInhalt
Marke, Produktname, Bezeichnung, Farbe, Herstellernummer, WarengruppeStammdaten
KurzbeschreibungTeasertext
BeschreibungHTML aus Teaser, Highlights, emotionalem und technischem Langtext
Highlights, Beschreibung technisch, MerkmaleEinzelteile als HTML; „Merkmale“ ist eine Tabelle aller technischen Eigenschaften
EigenschaftenPaare „Merkmal: Wert“, getrennt durch „|“, für das Feld Eigenschaften
AusstattungAusstattungsmerkmale als Liste „Merkmal: Wert“
EPREL-Nummer, EPREL-Link, EnergieeffizienzklasseEnergieangaben; der Link zeigt auf den öffentlichen EPREL-Eintrag
Bilder, HauptbildProduktbilder, Hauptbild zuerst, für die Felder Bilder (alle) bzw. Bild 1
Energielabel, Datenblatt, Maßzeichnungen, Bedienungsanleitungweitere Dateien von Prodanet
Zubehör-GTINs, StandZubehör und Zeitstempel der Prodanet-Daten

Im Mapping:

  • Beschreibung ← „Prodanet: Beschreibung“, bei Bedarf mit Bedingung, damit ein eigener Text Vorrang hat.
  • Eigenschaften ← „Prodanet: Eigenschaften“. Fehlende Eigenschaftsgruppen und Werte legt ReadySync in Shopware an, vorhandene Eigenschaften des Artikels bleiben.
  • Zusatzfelder ← „Prodanet: EPREL-Nummer“ oder „Prodanet: EPREL-Link“.
  • Bilder (alle) ← „Prodanet: Bilder“, auch zusammen mit „Prodanet: Energielabel“. Die Bilder werden beim Bilderimport geladen.

Gut zu wissen:

  • Prodanet-Bilder kommen standardmäßig nur zu Artikeln, die im Shop noch keine Bilder haben. Der Bilderimport ersetzt die Galerie eines Artikels; von Hand gepflegte Bilder bleiben so erhalten. Mit dem Schalter in der Quelle lässt sich das ändern.
  • Auch hier gilt: Ein Delta-Import fragt nur die Artikel der Delta-Datei bei Prodanet ab. Neue Prodanet-Inhalte für unveränderte Artikel kommen mit dem nächsten Vollimport.
  • Merkmale, die ein eigenes Feld brauchen (etwa die Energieeffizienzklasse für ein Zusatzfeld), tragen Sie unter „Merkmale als eigene Spalten“ ein. Sie erscheinen dann als „Prodanet: Merkmal: Energieeffizienzklasse“.
  • Die Nutzungsbedingungen von Prodanet beschränken, wo die Inhalte erscheinen dürfen. Prüfen Sie das vor der Ausgabe an Marktplätze oder Preisvergleiche.

ReadySync Dokumentation · Impressum