Verbinde WEMALO mit PlentyMarkets
1. WAS WEMALO KANN / Verfügbare Calls unserer Schnittstelle
- Produktstammdaten laden
- SKU
- Artikelname
- Dimensionen
- Gewicht
- GTIN 13
- Aufträge abholen
- Rechnungsempfänger
- Lieferanschrift
- Artikelpositionen
- Lieferschein
- Rechnung
- Versandprofil
- Statusänderungen adäquat zum Fulfillment-Prozess
- Bestandsübertragung
- physischer Bestand
- Bestandsbuchung in die zugewiesene LagerID
- Übermittlung von Inventur Buchungen: Ein- sowie Ausgangsbuchungen
- Übermittlung von Retouren Buchungen: Nachvollziehbar durch Auftragsverknüpfung
- Übermittlung der Tracking-ID nach Versendung
2. Vorbereitung & Einrichtung in plentymarkets
2.1 Benutzerkonto für REST-API
- Melde Dich in Deinem plentymarkets System an und öffne den Bereich Einrichtung
- Klicke unter Einstellungen -> Benutzer auf den MenüpunktKonten
- Klicke auf die Schaltfläche “Neu”, um ein neues Benutzerkonto anzulegen
- 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.
- 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
- 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
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.
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.
- 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.
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
-ÜBERSICHT-
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.
Nachzulesen hier:
https://knowledge.plentymarkets.com/auftraege/grundeinstellungen#200
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.)