Okazii mit easySales verbinden: die vollständige Einrichtung
Okazii mit easySales verbinden: die Einstellungen der Verbindung, Ihre Feed-URL und ihre Einrichtung in Okazii, welche Angebote wirklich in den Feed kommen und wie Bestellungen, Rechnungen und AWBs zurücklaufen.
So funktioniert die Okazii-Integration
Okazii wird nicht so angebunden wie die meisten Marktplätze, und wer das früh weiß, erspart sich später viel Verwirrung.
Ihre Angebote werden nie zu Okazii übertragen. easySales erzeugt eine XML-Datei – den Feed – und veröffentlicht sie unter einer privaten Adresse. Okazii holt diese Datei nach eigenem Zeitplan ab und importiert, was darin steht. Das ist der einzige Weg, den Ihre Produkte, Preise und Bestände nehmen.
Bestellungen kommen auf dem umgekehrten Weg zurück, über die API von Okazii, mit einem Token aus Ihrem Okazii-Konto. easySales sendet außerdem zu jeder Bestellung die Rechnung und die AWB-Nummer zurück.
Die Einrichtung besteht also aus zwei Hälften: eine in easySales, eine im Okazii-Panel. Keine von beiden funktioniert ohne die andere.
Bevor Sie beginnen
Ein Okazii-Verkäuferkonto
Mit Zugang zur Shop-Verwaltung, denn die Hälfte dieser Einrichtung findet dort statt.
Ihr Okazii API Token
Im Okazii-Panel im Bereich der Shop-Verwaltung unter den API-Einstellungen. Kopieren Sie nur den numerischen Teil. Ohne ihn kann easySales keine einzige Bestellung lesen.
Verkaufsfertige Produkte
Jedes braucht einen Namen, eine SKU, mindestens ein Bild, einen Preis ab 0,10 und Bestand über null. Fehlt etwas, bleibt das Produkt aus dem Feed – siehe die Prüfungen weiter unten.
Eine Entscheidung zur Umsatzsteuer
Der Standard-Steuersatz in der Verbindung sagt easySales, ob Ihre Okazii-Preise Umsatzsteuer enthalten. Klären Sie das, bevor Sie speichern.
Schritt 1 — Okazii in easySales verbinden
Gehen Sie zu Konfiguration → Integrationen → Marktplätze, suchen Sie nach Okazii und öffnen Sie die Karte.
Füllen Sie das Formular auf der rechten Seite aus.
| Feld | Was hineingehört |
|---|---|
| Verbindungsname | Pflichtfeld. Ihr eigener Name für dieses Okazii-Konto. Bei mehr als einem Konto werden daraus die Reiter. |
| Neuer benutzerdefinierter Bestellstatus | Optional. Ein eigener Status, in den jede eingehende Okazii-Bestellung gesetzt wird. |
| Preisaufschlag | Pflichtfeld. Ein Prozentsatz, der beim Anlegen eines Angebots auf den Produktpreis aufgeschlagen wird. Er wird in diesem Moment im Angebot gespeichert, eine spätere Änderung ändert die Preise bereits bestehender Angebote also nicht. |
| Standard-Versandsteuer | Der Umsatzsteuersatz, der auf die Versandposition einer importierten Bestellung angewendet wird. |
| Standard-Steuersatz | Pflichtfeld, und wichtiger, als es aussieht – siehe unten. |
| Rechnungsserie | Pflichtfeld. Die Serie, die verwendet wird, wenn für eine Okazii-Bestellung eine Rechnung erstellt wird. Sie lässt sich pro Bestellung weiterhin ändern. |
| Standard-Pakettyp | Umschlag oder Paket, als Vorgabe auf den AWBs dieser Bestellungen. |
| Beschreibungstyp | Legt fest, ob der Feed Ihre Produktbeschreibung trägt oder eine, die aus den Merkmalen des Produkts erzeugt wird. Okazii akzeptiert kein HTML. |
| API Token | Pflichtfeld. Aus Ihrem Okazii-Konto, im Bereich der Shop-Verwaltung unter den API-Einstellungen – kopieren Sie nur den numerischen Teil. |
Der übrige Teil des Formulars steuert, wie Ihre Produkte im Feed beschrieben werden.
- Größenattribute und Farbattribute sagen easySales, welche Ihrer Produktmerkmale Größe und Farbe tragen, damit Varianten zu einem einzigen Okazii-Eintrag zusammengefasst werden statt zu mehreren.
- Merkmale in den Feed einfügen schreibt jedes Produktmerkmal in die Datei.
- Angebote automatisch aktivieren, wenn Produkte Bestand haben schaltet ein Angebot von selbst wieder ein, sobald das Produkt wieder auf Lager ist.
Schritt 2 — Ihre Feed-URL kopieren
Sobald die Verbindung gespeichert ist, zeigt die linke Spalte die Feed-URL. Sie sieht aus wie https://app.easy-sales.com/feed/12345/487213904/okazii.xml, und jedes verbundene Okazii-Konto hat seine eigene.
Sowohl URL neu generieren als auch Konto hinzufügen – für ein zweites Okazii-Konto mit eigenen Einstellungen und eigener Feed-URL – liegen im ⋮-Menü der Karte.
Schritt 3 — Okazii auf den Feed verweisen
Diese Hälfte findet im Okazii-Panel statt, dessen Oberfläche rumänisch ist.
- Öffnen Sie Meniu → Administrează Magazin („Menü → Shop verwalten“) oder Setări → Magazin → Administrare („Einstellungen → Shop → Verwaltung“).
- Gehen Sie zu Administrează articole → Import Produse („Artikel verwalten → Produktimport“) und wählen Sie Import Automat („Automatischer Import“).
- Fügen Sie Ihre Feed-URL in das Feld Adaugă URL-ul Feedului („Feed-URL hinzufügen“) ein.
- Setzen Sie den Haken bei Elimină din okazii produsele care nu apar în feed („Produkte, die nicht im Feed erscheinen, aus Okazii entfernen“).
- Speichern Sie mit Salvează Opțiunile („Optionen speichern“).
Schritt 4 — Ihre Angebote anlegen
Ein Okazii-Angebot entsteht aus einem Produkt, das Sie bereits in easySales haben. Öffnen Sie Produkte, wählen Sie die gewünschten Produkte aus und nutzen Sie Angebot(e) hinzufügen auf in der Werkzeugleiste – oder Angebot hinzufügen in einer einzelnen Zeile – und wählen Sie Okazii.
Welche Ihrer Angebote tatsächlich bei Okazii ankommen
Das ist die Frage hinter fast jedem „Okazii hat nur eine Handvoll meiner Produkte importiert“. Ein Angebot wird nur dann in die Feed-Datei geschrieben, wenn alle vier Punkte zutreffen:
| Bedingung | Wo Sie es sehen |
|---|---|
| Das Angebot ist Aktiviert | Der Status-Schalter in der Angebotszeile. |
| Das Angebot ist mit einem Produkt Verknüpft | Die Zeile Verknüpft unter dem Angebotsnamen. |
| Der Bestand dieses Produkts liegt über null | Die Zeile Bestand unter dem Angebotsnamen. |
| Das Angebot hat keinen blockierenden Fehler | Die Spalte Fehler. |
Alle vier sehen Sie auf einen Blick unter Marktplätze → Angebote → Okazii.
Ein Angebot, das die Prüfung nicht besteht, wird abgeschaltet, und der Grund steht in der Spalte Fehler.
| Fehler | Was zu beheben ist |
|---|---|
1000 Missing product name
|
Das Produkt hat keinen Namen. |
1001 Missing product sku
|
Das Produkt hat keine SKU. |
1004 Invalid product price
|
Der Verkaufspreis liegt unter 0,10. |
1005 Invalid images data
|
Die Bilder des Angebots liegen nicht in brauchbarer Form vor. Speichern Sie die Bilder am Produkt erneut. |
1006 Missing product images
|
Das Produkt hat überhaupt kein Bild. Das ist mit Abstand der häufigste Fall. |
Wie lange eine Änderung bis zur Anzeige braucht
easySales baut die Feed-Datei höchstens einmal pro Stunde neu auf, und normalerweise erst, nachdem Okazii die vorherige Version gelesen hat. Danach muss Okazii noch seinen eigenen Import ausführen. In der Praxis erscheint ein neu angelegtes Angebot meist, nachdem Okazii die Datei zweimal abgeholt hat – rechnen Sie also mit einigen Stunden statt mit einem sofortigen Ergebnis.
Kategorien
Die Kategorie des Angebots ist ein einfacher Text, der einmalig aus der ersten Kategorie des Produkts übernommen wird. easySales führt den Kategoriebaum von Okazii nicht, deshalb wird die Zuordnung Ihrer Kategorienamen zu den Okazii-Kategorien innerhalb von Okazii vorgenommen, unter Administrare Articole → Administrare Catalog („Artikelverwaltung → Katalogverwaltung“).
Um den Text zu ändern, den easySales sendet, bearbeiten Sie ihn in easySales – direkt am Angebot (Marktplätze → Angebote → Okazii → Bearbeiten) oder für viele auf einmal über Massenbearbeitung → Kategorie und Merkmale bearbeiten. Die Kategorie wird beim Anlegen des Angebots erfasst und danach nicht mehr aktualisiert; wenn Sie später die Kategorien des Produkts ändern, ändert sich der Inhalt des Feeds also nicht.
Bestellungen
Neue Okazii-Bestellungen werden etwa einmal pro Minute abgeholt, dazu kommt einige Male am Tag ein breiterer Nachholdurchlauf. Wenn Sie weiter zurückgreifen müssen, bietet die Verbindungsseite Optionen → Bestellungen synchronisieren, das einen Zeitraum von bis zu 30 Tagen akzeptiert.
| Was | Richtung | Wie |
|---|---|---|
| Produkte, Preise, Bestände | easySales → Okazii | Der XML-Feed, den Okazii abholt. |
| Bestellungen | Okazii → easySales | Die API von Okazii, mit Ihrem API Token. |
| Die Rechnung als PDF | easySales → Okazii | Wird automatisch gesendet, sobald die Rechnung erstellt ist. |
| Die AWB-Nummer | easySales → Okazii | Wird gesendet, wenn Sie das Versandlabel erstellen. Das Erstellen markiert die Bestellung in easySales zugleich als finalisiert. |
| Bestellstatus | nichts | Status werden nie zurückgesendet. |
| Bestehende Okazii-Einträge | nichts | Sie werden nie nach easySales importiert. |
Wenn keine Bestellungen mehr eintreffen
Wenn kein Fehlerbanner zu sehen ist und trotzdem nie Bestellungen ankommen, prüfen Sie zuerst das API Token in der Verbindung. Eine Verbindung, die gespeichert wurde, bevor das Token Pflicht wurde, sieht völlig normal aus – sie wird als verbunden angezeigt, der Feed läuft weiter –, aber es wird nie eine Bestellung abgeholt, und nichts weist Sie darauf hin.
Arbeiten Sie danach diese Liste für ein Produkt ab, das nicht auf Okazii ist:
- Ist das Angebot Aktiviert?
- Ist es mit einem Produkt Verknüpft?
- Hat dieses Produkt einen Bestand über null?
- Zeigt das Angebot einen Fehler?
- Ist die Feed-URL in Okazii die aktuelle?