Verbinde WEMALO mit PlentyMarkets

1. WAS WEMALO KANN / Verfügbare Calls unserer Schnittstelle

Unsere Schnittstelle überträgt verschiedene Daten.
  1. Produktstammdaten laden
    • SKU
    • Artikelname
    • Dimensionen
    • Gewicht
    • GTIN 13
  2. Aufträge abholen
    • Rechnungsempfänger
    • Lieferanschrift
    • Artikelpositionen
    • Lieferschein
    • Rechnung
    • Versandprofil
  3. Statusänderungen adäquat zum Fulfillment-Prozess
  4. Bestandsübertragung
    • physischer Bestand
    • Bestandsbuchung in die zugewiesene LagerID
  5. Übermittlung von Inventur Buchungen: Ein- sowie Ausgangsbuchungen
  6. Übermittlung von Retouren Buchungen: Nachvollziehbar durch Auftragsverknüpfung
  7. Übermittlung der Tracking-ID nach Versendung

2. Vorbereitung & Einrichtung in plentymarkets

2.1 Benutzerkonto für REST-API

Zur Übertragung der Daten verwenden wir die REST-Schnittstelle von plentymarkets. Wir benötigen von Dir daher ein Benutzerkonto mit der Zugangsrolle “REST-API”. Um ein Benutzerkonto anzulegen, gehe bitte wie folgt vor:
  1. Melde Dich in Deinem plentymarkets System an und öffne den Bereich Einrichtung
  2. Klicke unter Einstellungen -> Benutzer auf den MenüpunktKonten
  3. Klicke auf die Schaltfläche “Neu”, um ein neues Benutzerkonto anzulegen
  4. Es öffnet sich ein neues Fenster, bitte gebe folgende Daten ein:
    • Benutzername: Frei wählbarer Benutzername
    • Realer Name: Name zur besseren Zuordnung im plenty-System, frei wählbar.
    • Zugang: Wähle REST-API, somit hat der Benutzer lediglich Zugriff auf die API.
    • Passwort: Ein frei wählbares Passwort, welches Du uns anschließend zur Verfügung stellst, damit wir WEMALO mit Deinem plenty-System verbinden können.
Die folgende Abbildung zeigt ein Beispielbild-2.1
Beispielbild-2.1
Nachdem Du den neuen Benutzer gespeichert hast, erscheint dieser in der Benutzerübersicht in Deinem plentymarkets-System. Klicke anschließend auf den neu angelegten Benutzer, um diesen für die nächsten Schritte weiter zu bearbeiten.
  1. Klicke auf Berechtigungen und setzte folgende Einstellungen:
    • Sichtbare Auftragsstatus: Alle
    • Setzbare Auftragsstatus: Alle
    • Mandanten (Shops): Wähle den/die Mandant/en, für die Artikel und Aufträge an YouSellWeSend übertragen werden sollen
  2. Klicke auf Menü und REST-API Rechte verwalten (im oberen Bereich der Seite) und setzte dort ebenfalls folgende Einstellungen / Berechtigungen:
    • Artikel
    • Aufträge
    • CRM
    • Markierung
    • Stammdaten
    • Warenbestände
Nachzulesen hier: https://knowledge.plentymarkets.com/schnelleinstieg/schnelleinstieg-basiseinstellungen#200 https://knowledge.plentymarkets.com/basics/admin-aufgaben/benutzer-verwalten#40

Zur Anbindung Deines plentymarkets-System benötigen wir folgende Daten von Dir:

-BEACHTE-
Der Zugriff auf einige Daten erfordert die vorherige Einrichtung, wie in den nächsten Kapiteln beschrieben. Bitte fahre daher mit den folgenden Abschnitten ab 2.2 fort.

  • plentymarkets-ID: Findet sich oben rechts neben dem Profilfoto.
  • plentymarkets-URL: URL zum Backend-Shop. Zu finden mit einem Klick auf die plentymarkets-ID im oberen Bereich des plentymarkets-Backend.
  • username: Benutzername des soeben angelegten Benutzerkonto.
  • password: Passwort zu dem soeben angelegten Benutzerkonto.
  • warehouse ID: Einstellungen -> Waren -> Lager -> Lager wählen -> Einstellungen -> Lager ID
  • storageLocationId: die ID des Standard-Lagerplatzes in plentymarkets. Standorte -> Standort wählen -> Einstellungen -> Standort ID wird angezeigt.

2.2 Einrichtung eines Lagers

Um einen Fulfillment-Bereich für unsere Lagerhaltung zu definieren, lege ein neues Lager für WEMALO an.

→ Einrichtung→Waren→Lager → Neues Lager

Als Lagertyp empfehlen wir Vertrieb, da nicht auszuschließen ist, dass ansonsten Auswirkungen auf die Verfügbarkeit und den Netto-Warenbestand die Folge ist.

-BEACHTE-
Bei “Logistik-Typ” muss zwingend “Eigenes Lager” ausgewählt werden.

Wenn mehrere Läger in plentymarkets angelegt werden oder bereits vorhanden sind, beachte bitte den Abschnitt 2.6 Automatische Lagerauswahl in Aufträgen.

Das neu angelegte Lager erscheint automatisch in der Lagerliste der Navigation. Dort findet sich die Lager-ID, die wir im Setup benötigen.

Die folgende Abbildung zeigt ein Beispielbild-2.2.

Beispielbild-2.2

2.3 Artikeleinstellungen

Nach der Erstellung eines Artikels, kann in den Artikel-Einstellungen eine Hauptlager Zuordnung vorgenommen werden. Hier empfehlen wir, das soeben neu angelegte Lager auszuwählen.

Beispielbild-2.3
Folgende Felder der Artikeldetails sind erforderlich:
  • Variantenname (der Name setzt sich aus Name1 und Variantenname zusammen).
  • Varianten Nummer (entspricht der SKU und muss eindeutig sein).
  • GTIN 13 (einmalig und eindeutig zu vergeben. Dient dem Lager als Barcode).
  • Verfügbarkeit: aktiv.
  • Maße: Gewicht brutto, Länge/Breite/Höhe.
-FEATURE- Auf Wunsch lassen sich mit Hilfe von Tags auch nur ausgewählte Produkte übertragen. Dafür muss zunächst ein Tag für den Bereich “Variante” angelegt und anschließend entsprechende Produkte mit dem Tag gekennzeichnet werden. → Einrichtung→ Einstellungen→ Tags.

Nachzulesen hier: https://knowledge.plentymarkets.com/basics/arbeiten-mit-plentymarkets/tags#preamble

-BEACHTE-
Artikel haben im neu angelegten Lager zunächst keinen Warenbestand. Nach Wareneingang werden die gebuchten Positionen an das plenty-Lager übermittelt. Sie sind nun in der Lage Aufträge durch WEMALO erfüllen zu lassen.
Wenn plentymarkets nicht ebenfalls zur eigenen Lagerhaltung verwendet wird, überträgt WEMALO Artikelbestände an plentymarkets standardmäßig auf Stellplatz 0.

2.4 Einrichtung von Ereignisaktionen.

Das Grundprinzip von Ereignisaktionen in plentymarkets ist leicht: Bestimmte Ereignisse im System lösen bestimmte Aktionen aus Diese sind notwendig, um zu gewährleisten dass beispielsweise eine von WEMALO versendete Bestellung automatisiert in den Status “Versendet” in plentymarkets gesetzt und der Bestand somit korrekt ausgebucht wird.

Die Konfiguration der Ereignisaktionen findest du in plentymarkets unter:
→ Einrichtung→Aufträge→Ereignisse.

Wähle im unteren Bereich “Neues Ereignis” aus und anschließend “Neue Ereignis-Aktion erstellen”. Wähle als Ereignis “Auftragsänderung→Paketnummer” aus und vergebe einen beliebigen Namen, der später lediglich der besseren Zuordnung im System dient. Wenn sich dieses Ereignis ausschließlich auf Aufträge des WEMALO Lagers beziehen soll, definiere bitte einen Filter “Senderlager” und wählen das entsprechende Lager aus.

Nachdem ein Ereignis erstellt wurde, muss dieses einer Aktion zugeordnet werden.
Klicke dafür auf “Aktion +” und wählen “Auftrag→Warenausgang buchen” aus.

Sobald eine Sendungsnummer zum Auftrag übertragen wird, bucht plentymarkets nun automatisch den Warenausgang und setzt den Auftrag auch in plentymarkets in den Status “versendet”.

Nachzulesen hier:
https://knowledge.plentymarkets.com/automatisierung/ereignisaktionen

2.5 Einrichtung von Status

Der Prozessfortschritt einer Bestellung wird in plentymarkets nach Status gegliedert. Für die Synchronisation ist es notwendig, dass die entsprechenden Status in plentymarkets und WEMALO übereinstimmend sind.

2.5.1 Offene Aufträge

Standardmäßig werden neue Aufträge im Status 5 (Freigabe Versand) abgerufen. Es kann jedoch alternativ auch ein eigener Status definiert werden. Nach erfolgter Übermittlung des Auftrags an WEMALO wird der Status auf 5.1 (Abwicklung extern) gesetzt. Ab diesem Zeitpunkt (Status 5.1) werden im Auftrag gemachte Änderungen nicht mehr zu WEMALO übertragen, Änderungen an Auftragspositionen oder auch den Kundendaten werden somit nicht berücksichtigt.

2.5.2 Fehlerhafte Aufträge

Führen Aufträge aufgrund von fehlerhaften Eingaben o.ä. zu einer Fehlermeldung, werden diese durch einen entsprechenden Status gekennzeichnet:
Sollten Adressdaten fehlerhaft sein, wird der Status 6.2 gesetzt.
Bei nicht genügend Ware wird der Status 6.3 gesetzt.

2.5.3 Stornierte Aufträge

Standardmäßig werden stornierte Aufträge in plentymarkets in den Status 8.0 gesetzt. Nach erfolgreicher Übermittlung an unser System setzt WEMALO den Status auf 8.8.

Falls die entsprechende Bestellung noch nicht im Lager bearbeitet wurde, wird der Auftrag storniert und die bestellten Artikel wieder dem Bestand zugeführt. Sollte sich die Bestellung allerdings bereits in Bearbeitung befinden, ist eine Stornierung nicht mehr möglich. (Achtung: Status 8.8 wird derzeit trotzdem gesetzt…)

2.5.4 Retournierte Aufträge

WEMALO ist in der Lage, Retouren auf einem vom Kunden vordefinierten Feld zu übermitteln. Standardmäßig werden bei plentymarkets der Status 9.0 für Retouren verwendet. Aufgrund dessen empfehlen wir für Retouren, die über WEMALO abgewickelt werden, den Status 9.0.1 zu verwenden um besser differenzieren zu können welche Plattform/Dienstleister die entsprechende Buchung getätigt hat.

2.5.5 Versendete Aufträge

Sobald WEMALO einen Auftrag versandfertig bearbeitet hat, wird dieser in plentymarkets mit der Trackingnummer des Dienstleisters gekennzeichnet. Dabei wird sowohl die Trackingnummer als auch der Versanddienstleister übermittelt. 
Beispielbild-2.5

-ÜBERSICHT- 

Beispielbild-2.5

2.6 Automatische Lagerauswahl in Aufträgen

Wenn mehrere Läger in plentymarkets angelegt sind, ist eine Einstellung für die automatische Lagerauswahl in Aufträgen notwendig.

Wenn mehrere Läger in plentymarkets angelegt sind, ist eine Einstellung für die automatische Lagerauswahl in Aufträgen notwendig.

→Einrichtung→Aufträge→Einstellungen.

Wir empfehlen die Einstellung b) in Abhängigkeit des Hauptlagers des Artikels, um das Lager anhand der Einstellung des Artikels zuzuordnen. Aufträge mit Artikeln, dessen Hauptlager das angelegte WEMALO Lager ist, werden somit automatisch dem richtigen Lager zugeordnet, wodurch eine korrekte Reservierung und das Ausbuchen von Beständen gewährleistet ist.

Beispielbild-2.6

3. Zu Beachten/ Häufige Fehler/ Nice to Know

Bei individuell vergebenen Status ist es ratsam, die Nummerierungen zu vertiefen statt sie numerisch fortzusetzen um eine Skalierbarkeit zu erhalten und nachträgliche weitere Status hinzufügen zu können. (z.B. 9.01 anstatt 9.1; 9.02 anstatt 9.2 usw.)

Nach oben scrollen