Skroutz mit easySales verbinden: der vollständige Integrationsleitfaden

Warum Skroutz mit easySales verbinden

Skroutz ist der größte Marktplatz und die größte Preisvergleichsplattform in Griechenland, und dort zu verkaufen bedeutet, Angebote, Bestellungen und Rechnungen in Ordnung zu halten. easySales bringt Skroutz in ein einziges Dashboard neben Ihre übrigen Verkaufskanäle, sodass Sie einen Katalog und einen Bestellstrom verwalten, statt zwischen Bildschirmen zu wechseln.

Nach der Verbindung fließen Ihre Skroutz-Bestellungen in easySales ein – bereit zum Fakturieren, zum Verarbeiten mit Automatisierungs-Flows und zum Versenden. Ihr Katalog geht den umgekehrten Weg: easySales veröffentlicht Ihre Produkte auf Skroutz und hält deren Preise und Bestände aktuell, sodass Sie einen einzigen Katalog pflegen, statt jedes Skroutz-Listing von Hand zu bearbeiten.

Wie der Skroutz-Konnektor funktioniert

Skroutz ist eine hybride Integration – teils Feed, teils Live-API –, daher hilft es, die Aufteilung vor dem Start zu verstehen.

• Ihr Katalog geht über einen Produkt-Feed hinaus. easySales erstellt einen XML-Produkt-Feed mit Ihren Angeboten – Namen, Beschreibungen, Marken, EANs, Kategorien, Bildern, Preisen, MwSt., Bestand, Gewicht und Merkmalen – und aktualisiert ihn nach einem wiederkehrenden Zeitplan. Skroutz liest diesen Feed, um Ihre Listings zu erstellen und zu aktualisieren.
• Bestellungen kommen über einen Webhook herein. Skroutz übermittelt jede neue und aktualisierte Bestellung direkt an easySales, wo sie unter Bestellungen & Kunden → Bestellungen landet – bereit für Rechnungsstellung und Flows.
• Bestellaktionen gehen über Ihr Merchant-API-Token zurück. Das Token, das Sie in die Verbindung einfügen, erlaubt easySales, auf Ihre Skroutz-Bestellungen zu reagieren – sie anzunehmen oder abzulehnen, Sendungsverfolgungsdaten zu senden und Rechnungen an Skroutz hochzuladen.

Da die Katalogseite über einen Feed läuft, funktionieren ein paar Dinge anders als bei einem reinen API-Marktplatz. Änderungen, die Sie in easySales vornehmen, sind auf Skroutz nicht sofort sichtbar – sie werden mit der nächsten Feed-Aktualisierung übertragen. Und der Fluss ist stellenweise einseitig: easySales liest den Status Ihrer Angebote nicht von Skroutz zurück, und bestehende Skroutz-Listings werden nicht in easySales importiert.

Voraussetzungen – was Sie vor dem Start vorbereiten sollten

Einige Dinge müssen vor Ihrer ersten Synchronisierung bereitstehen.

Schritt 1 – Skroutz in easySales verbinden

Gehen Sie in easySales in der Seitenleiste zu Integrationen → Marktplätze, suchen Sie die Skroutz-Karte und klicken Sie darauf auf Verbinden. Das Skroutz-Einstellungsformular öffnet sich mit zwei Registerkarten: Haupteinstellungen (die Kernkonfiguration) und Zusätzliche Einstellungen (Synchronisierungsverhalten). Sie beginnen mit den Haupteinstellungen.

Legen Sie auf der Registerkarte Haupteinstellungen fest, wie easySales Ihren Feed erstellen, Ihre Angebote bepreisen und Ihre Bestellungen behandeln soll:

• Verbindungsname – eine von Ihnen gewählte Bezeichnung für diese Verbindung. Nur innerhalb von easySales sichtbar.
• Preisaufschlag – ein optionaler Prozentsatz, der beim Veröffentlichen eines neuen Angebots auf Skroutz zusätzlich zu Ihrem Produktpreis addiert wird. Er gilt für neu erstellte Angebote.
• Standard-Versandsteuer – der MwSt.-Satz, der auf die Versandposition Ihrer Skroutz-Bestellungen angewendet wird.
• Standard-Steuersatz – der Standard-MwSt.-Prozentsatz, der auf Ihre Angebote und Bestellungen angewendet wird. Setzen Sie ihn auf 0, wenn Sie kein MwSt.-Zahler sind.
• API Token – Ihr Skroutz-Merchant-API-Token. Lassen Sie es vorerst leer; Skroutz stellt es aus, nachdem Ihr Produkt-Feed validiert wurde, und Sie kommen zurück, um es einzufügen (siehe Schritt 4).
• Rechnungsserie – die standardmäßige Rechnungsserie, die importierten Skroutz-Bestellungen zugewiesen wird und die mit der in Ihrer Rechnungssoftware verwendeten Serie übereinstimmt.
• Standard-Pakettyp – ob Ihre Sendungen standardmäßig als Umschlag oder Paket gelten.
• Größenattribute und Farbattribute – die Produktmerkmale, die Skroutz als Größe und Farbe einer Variante liest. Diese Zuordnung ermöglicht es Skroutz, Ihre Varianten zu einer einzigen Familie zusammenzufassen (siehe Schritt 3).
• Von Angeboten ausgeschlossene Merkmale – alle Merkmale, die Sie nicht in Ihren Skroutz-Feed schreiben möchten.
• Die Merkmale in der Produktbeschreibung anzeigen und Produktdokumentation in der Landessprache – steuern, wie Merkmale und Produkttexte auf Skroutz erscheinen.
• Liefertage – die mit Ihren Angeboten veröffentlichte Bearbeitungszeit.
• Bestellung beim Erstellen des AWB abschließen und Versandoptionen – im Abschnitt zu Bestellungen weiter unten behandelt.

Klicken Sie auf Speichern, um die Verbindung zu erstellen.

Schritt 2 – Ihre Produkte listen und Ihre Feeds an Skroutz senden

Das Verbinden des Kontos bringt Ihren Katalog nicht von selbst auf Skroutz – Sie wählen aus, welche Produkte gelistet werden sollen.

Gehen Sie in der Seitenleiste zu Online-Shops → Produkte, wählen Sie die Produkte aus, die Sie auf Skroutz verkaufen möchten, und verwenden Sie in der Massenaktionsleiste die Aktion Angebot(e) hinzufügen auf und wählen Sie Ihre Skroutz-Verbindung. easySales erstellt für jedes Produkt ein Skroutz-Angebot, das in Ihrem Katalog damit verknüpft ist. Von da an läuft das Angebot in Ihrem Produkt-Feed mit, und sein Bestand und Preis bleiben an das Quellprodukt gebunden. Nur Angebote, die aktiv, synchronisiert und mit einem Katalogprodukt verknüpft sind, werden in den Feed geschrieben. Ihre veröffentlichten Angebote erscheinen unter Marktplätze → Angebote auf der Skroutz-Registerkarte, wo Sie sie überprüfen und bearbeiten können.

Wenn Sie die Verbindung speichern, generiert easySales zwei Feeds, die die Integration funktionsfähig machen. Beide erscheinen auf Ihrer Skroutz-Karte unter Integrationen → Marktplätze:

• Feed-URL – der XML-Produkt-Feed, den Skroutz liest, um Ihre Listings zu erstellen und zu aktualisieren.
• Orders URL – die Adresse, an die Skroutz Ihre Bestellungen übermittelt.

easySales registriert diese URLs nicht automatisch – Sie kopieren sie von Ihrer Skroutz-Karte und übergeben sie an Skroutz, und jede geht an eine andere Stelle in Ihrem Skroutz Merchants-Konto:

• Feed-URL – reichen Sie sie unter Services → XML file ein: validieren Sie Ihren Feed und verwenden Sie dann Send XML link. Das Team von Skroutz führt zusätzliche Prüfungen durch und schließt die Überprüfung ab.
• Orders URL – öffnen Sie auf Skroutz Services → Skroutz Marketplace und scrollen Sie nach unten zu Integration with the online store → Order webhooks: fügen Sie die URL in das Feld Webhook URL ein und aktivieren Sie Enable, damit Skroutz beginnt, Ihre Bestellungen an easySales zu übermitteln.

Die Inbetriebnahme ist ein operativer Schritt, der eine Weile dauern kann, statt sofort zu geschehen. Ein verbundener Feed ohne bisherige Bestellungen ist normal, solange Skroutz Ihren Feed noch onboardet.

Varianten zu einer Familie zusammenfassen

Wenn Sie ein Produkt in mehreren Größen oder Farben verkaufen, kann Skroutz die Varianten als ein einziges Familien-Listing anzeigen statt als separate Produkte. easySales erstellt diese Gruppierung vollständig aus Ihren eigenen Produktdaten – der Produktfamilie und ihren Merkmalen – plus einer kleinen Zuordnung, die Sie an der Verbindung festlegen. So greifen die Teile ineinander:

• Die Familie ergibt sich aus Ihrer Produktstruktur. Varianten, die zusammengehören, müssen in easySales ein Elternprodukt teilen (dieselbe Variantenfamilie). easySales überträgt dies automatisch, wenn die Produkte in Ihrem Quell-Shop bereits gruppiert sind; andernfalls legen Sie die Variante an jedem Angebot manuell oder per Excel-Import fest. Varianten, die kein Elternprodukt teilen, werden als eigenständige Listings an Skroutz gesendet, und das Familien-Listing übernimmt seinen Namen vom Elternprodukt.
• Die Größen- und Farbwerte werden aus den Merkmalen des Produkts gelesen. Die Größe jeder Variante – und ihre Farbe – stammt direkt aus den eigenen Merkmalen dieses Produkts, zum Beispiel einem Merkmal „
  ” mit dem Wert „
  ” oder einem Merkmal „
  ” mit dem Wert „
  ”. Sie geben sie nicht erneut für Skroutz ein; sie werden aus dem Produkt gezogen.
• Sie ordnen zu, welches Merkmal die Größe und welches die Farbe ist. Verwenden Sie auf der Registerkarte Haupteinstellungen der Verbindung Größenattribute, um easySales mitzuteilen, welches Merkmal die Größe enthält, und Farbattribute für die Farbe. Diese Zuordnung ist es, die Ihre Produktmerkmale in die Größen- und Farbdimensionen von Skroutz umsetzt.

Zwei Bedingungen entscheiden, ob tatsächlich eine Familie entsteht:

• Ein Größenattribut muss zugeordnet sein. Die Familie wird um die Größendimension herum aufgebaut – wenn Sie kein Größenattribut zugeordnet haben oder ein Produkt keinen Wert dafür hat, geht dieses Produkt stattdessen als eigenständiges Listing hinaus. Das alleinige Zuordnen eines Farbattributs erzeugt keine Familie; es fügt die Farbdimension nur zu Varianten hinzu, die bereits nach Größe gruppiert sind.
• Der Größen- oder Farbwert darf nicht im Angebotstitel stehen. Varianten in einer Familie teilen sich denselben Produktnamen, und die Größe befindet sich in ihrem eigenen Feld, schreiben Sie also nicht „
  ” oder „
  ” in den Titel – sonst kann Skroutz sie nicht sauber gruppieren.

Das Zuordnen des Attributs teilt easySales nur mit, welches Merkmal gelesen werden soll – Sie müssen dennoch den Wert dieses Merkmals bei jedem Produkt ausfüllen. easySales erfindet niemals eine Größe, daher wird ein Produkt, dessen Größenmerkmal leer ist, ohne Größe gesendet und tritt keiner Familie bei. Dies ist der häufigste Grund dafür, dass eine Größe in einem Skroutz-Feed fehlt. Wenn bei mehreren Produkten der Wert fehlt, füllen Sie ihn per Mass edit aus Ihrer Skroutz-Angebotsliste in großer Menge aus. Geben Sie bei einem Produkt, das tatsächlich keine Größe hat, den wörtlichen Wert One Size (auf Englisch) in diesem Merkmal ein – Skroutz erwartet genau diesen Text, und easySales sendet ihn unverändert. Sobald die Werte vorhanden sind, generiert easySales die Größenvarianten automatisch für Produkte, die bereits als Varianten gruppiert sind – keine zusätzliche Einrichtung.

Schritt 3 – Die Synchronisierung feinabstimmen

Die Registerkarte Zusätzliche Einstellungen steuert, wie easySales nach der Inbetriebnahme der Verbindung mit Skroutz synchronisiert.

• MPN senden – wählen Sie, was easySales als MPN (Herstellerteilenummer) des Produkts an Skroutz sendet. Es gibt vier Optionen: nichts senden, die SKU des Angebots, die Übergeordnete SKU (die SKU des Elternprodukts – praktisch für gruppierte Varianten, die eine gemeinsame MPN teilen sollen) oder den Wert eines bestimmten Merkmals. Wenn Sie Merkmal wählen, erscheint ein zweites Feld, in dem Sie über MPN-Merkmal auswählen festlegen, welches Merkmal gesendet werden soll.
• Angebote automatisch aktivieren, wenn Produkte Bestand haben – reaktiviert Angebote automatisch, sobald ein Produkt wieder mit einem Bestand über null verfügbar ist.

Schritt 4 – Ihr API-Token hinzufügen, sobald Skroutz den Feed validiert hat

Das ist der Teil, der Verkäufer ins Straucheln bringt, daher lohnt es sich, ihn klar hervorzuheben. Skroutz übergibt Ihnen ein Merchant-API-Token nicht im Voraus – es wird ausgestellt, nachdem der von Ihnen gesendete Produkt-Feed validiert wurde. Die Reihenfolge ist also:

1. Verbinden Sie Skroutz in easySales und listen Sie Ihre Angebote (Schritte 1–2).
2. Senden Sie Ihre Feed-URL und Orders URL an Skroutz.
3. Sobald Skroutz Ihren Feed freigibt, generieren Sie Ihr Merchant-API-Token in Ihrem Skroutz Merchants-Konto unter Products → API über Generate a new API token. Skroutz behält immer nur ein aktives Token, sodass das Generieren eines neuen jeden vorherigen Schlüssel ersetzt.
4. Öffnen Sie zurück in easySales Ihre Skroutz-Verbindung, fügen Sie das Token in das Feld API Token in den Haupteinstellungen ein und speichern Sie.

Bis das Token vorhanden ist, können Bestellungen zwar eingehen, aber easySales kann sie nicht annehmen oder Sendungsverfolgung und Rechnungen an Skroutz zurücksenden – diese Aktionen authentifizieren sich alle mit dem Token. Wenn Sie eingehende, aber nicht angenommene Bestellungen sehen, ist ein leeres API-Token das Erste, was Sie prüfen sollten.

Wie Skroutz-Bestellungen, Versand und Rechnungen funktionieren

Bestellungen sind der Teil von Skroutz, der eigenständig läuft. easySales ruft keine Bestellungen von Skroutz ab – Skroutz übermittelt jede Bestellung an Ihre Orders URL, sodass Skroutz die Lieferung steuert. easySales importiert jede einzelne, ordnet Produkte anhand der EAN zu und bepreist alles in Euro. Sobald Ihr API-Token vorhanden ist, nimmt easySales die Bestellung automatisch auf Skroutz an und reserviert ein Abholfenster beim Kurier. Die Einstellung Abholfenster verzögern entscheidet, welches Zeitfenster gebucht wird: standardmäßig aktiviert, nimmt sie das späteste verfügbare Fenster; schalten Sie sie aus, um das früheste zu buchen.

Da die Lieferung push-basiert ist, können Sie eine Bestellung, die einmal nicht bei easySales ankommt, selbst von Skroutz erneut senden: öffnen Sie diese Bestellung in Ihrem Skroutz Merchants-Konto und klicken Sie in ihrem Webhook-Panel auf New Request, um sie erneut zu übermitteln.

Der Versand funktioniert auf eine von zwei Arten, und Sie wählen pro Verbindung:

• Skroutz liefert das Etikett. Aktivieren Sie AWB vom Marktplatz anhängen, und easySales hängt den Versandbeleg an, den Skroutz für die Bestellung ausstellt, sodass Sie kein separates AWB erzeugen.
• Sie erzeugen das AWB. Erstellen Sie das Versandetikett wie gewohnt in easySales, und easySales sendet die Sendungsverfolgungsdaten an Skroutz zurück. Skroutz erkennt hierfür eine feste Gruppe von Kurieren – DPD, DHL, GLS, ACS, Speedex, ELTA und Geniki Taxydromiki –, verwenden Sie also einen davon, damit die Sendungsverfolgung auf Skroutz registriert wird.

Rechnungen werden ebenfalls zurückgesendet: wenn Sie eine Rechnung für eine Skroutz-Bestellung erstellen, lädt easySales das PDF automatisch zu Skroutz hoch. Bestellung beim Erstellen des AWB abschließen ist standardmäßig aktiviert, sodass easySales die Bestellung außerdem als abgeschlossen markiert, sobald ihr Versandetikett angehängt ist – schalten Sie es aus, wenn Sie diesen Status lieber selbst verwalten möchten.

Sie sind verbunden – wie geht es weiter

Wenn Bestellungen eintreffen, ist der nächste Schritt die Automatisierung: richten Sie unter In Bearbeitung → Flows Flows ein, um Rechnungen zu erstellen und Bestellungen zu verarbeiten, sobald sie eingehen. Behalten Sie Ihre Angebote unter Marktplätze → Angebote auf der Skroutz-Registerkarte im Auge, wo alle mit fehlgeschlagener Validierung gekennzeichnet werden – und wenden Sie sich an den Support, wenn etwas nicht stimmt.