Appearance
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.
| Feld | Bedeutung |
|---|---|
| Bezeichnung | Name 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. |
| Datei | Dateiname, bei „Beginnt mit“ der Anfang des Namens. ReadySync nimmt dann die neueste passende Datei. |
| Datei im ZIP-Archiv | Optional. 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, Zeichensatz | wie beim ERP-Export. CSV, TXT, JSON, XML und BMEcat werden gelesen. Dazu Dealavo-Preisreport für das Repricing. |
| Schlüsselspalte in der Quelle | Spalte, ü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-Export | Gegenstück im ERP-Export, etwa EAN-Nummer. |
| Ersatzspalte im ERP-Export | Optional. Wird verwendet, wenn die erste Spalte leer ist oder in der Quelle nichts findet, etwa eine zweite EAN. |
| Vergleich | EAN/GTIN vergleicht nur Ziffern, führende Nullen sind egal (EAN-13 = GTIN-14). Text ignoriert Groß- und Kleinschreibung. |
| Spalten übernehmen | Optional. 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 fehlt | Warnen: 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.
- Feld Lieferzeit, Quelle: eigene Bestandsspalte.
- 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“):
| Spalte | Inhalt |
|---|---|
| Marke, Produktname, Bezeichnung, Farbe, Herstellernummer, Warengruppe | Stammdaten |
| Kurzbeschreibung | Teasertext |
| Beschreibung | HTML aus Teaser, Highlights, emotionalem und technischem Langtext |
| Highlights, Beschreibung technisch, Merkmale | Einzelteile als HTML; „Merkmale“ ist eine Tabelle aller technischen Eigenschaften |
| Eigenschaften | Paare „Merkmal: Wert“, getrennt durch „|“, für das Feld Eigenschaften |
| Ausstattung | Ausstattungsmerkmale als Liste „Merkmal: Wert“ |
| EPREL-Nummer, EPREL-Link, Energieeffizienzklasse | Energieangaben; der Link zeigt auf den öffentlichen EPREL-Eintrag |
| Bilder, Hauptbild | Produktbilder, Hauptbild zuerst, für die Felder Bilder (alle) bzw. Bild 1 |
| Energielabel, Datenblatt, Maßzeichnungen, Bedienungsanleitung | weitere Dateien von Prodanet |
| Zubehör-GTINs, Stand | Zubehö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.