1. Was Wemalo kann / Verfügbare Calls unserer Schnittstelle
Unsere Schnittstelle überträgt verschiedene Daten.
- 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
| Variable | Nutzen |
|---|---|
| downloadOrderId | we import Order with this id(id is Status in Shop) |
| setOrderDownloadedId | after import Order we change status to this id in shop |
| setOrderSentId | we set this status in shop after order send in Wemalo |
| setCancelOrderId | we set cancel status after oder in wemalo canceld |
| setPartialOthersId | here we set default is(status if customer not decided which id is) in code 6.1 |
| setPartialAddressId | we set partial address if order in wemalo partial is |
| setPartialGoodsId | we set partial id in shop |
2. Vorbereitung & Einrichtung in PlentyONE
2.1 Benutzerkonto für REST-API
Zur Übertragung der Daten verwenden wir die REST-Schnittstelle von PlentyONE. Wir benötigen von Dir daher ein Benutzerkonto mit der Zugangsrolle “REST-API”. Um ein Benutzerkonto anzulegen, gehe bitte wie folgt vor:
- Melde Dich in Deinem PlentyONE System an und öffne den Bereich Einrichtung
- Klicke unter Einstellungen -> Benutzer auf den Menüpunkt Konten
- 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, zum Beispiel Wemalo
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
Nachdem Du den neuen Benutzer gespeichert hast, erscheint dieser in der Benutzerübersicht in Deinem PlentyONE-System. Klicke anschließend auf den neu angelegten Benutzer, um diesen für die nächsten Schritte weiter zu bearbeiten.
- 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 Wemalo übertragen werden sollen
- Klicke auf Menü und REST-API Rechte verwalten (im oberen Bereich der Seite) und setzte dort ebenfalls folgende Einstellungen / Berechtigungen:2
- Artikel
- Aufträge
- CRM
- Markierung
- Stammdaten
- Warenbestände
Nachzulesen hier:
https://knowledge.plentyone.com/de-de/manual/main/willkommen/schnelleinstieg.html
Zur Anbindung Deines PlentyONE-System benötigen wir folgende Daten von Dir:
- PlentyONE-ID – Findet sich oben rechts neben dem Profilfoto
- PlentyONE-URL – URL zum Backend-Shop. Zu finden mit einem Klick auf die
PlentyONE-ID im oberen Bereich des PlentyONE-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 PlentyONE. Standorte ->
Standort wählen -> Einstellungen -> Standort ID wird angezeigt.
2.2 Einrichten eins Lagers
Um einen Fulfillment-Bereich für unsere Lagerhaltung zu definieren, lege ein neues Lager
für das “YSWS-Fulfillment” 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.
Wenn mehrere Läger in PlentyONE 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.
Das neu angelegte Lager erscheint automatisch in der Lagerliste der Navigation. Dort findet sich die Lager-ID, die wir im Setup benötigen.
Nachzulesen hier:
https://knowledge.plentyone.com/de-de/manual/main/warenwirtschaft/warenwirtschaft.html
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.
Nachzulesen hier:
https://knowledge.plentyone.com/de-de/manual/main/willkommen/schnelleinstieg-artikelkatalog.html
Folgende Felder der Artikeldetails sind für YSWS erforderlich:
- Variantenname – (der Name bei YSWS 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
- Variantenname – (der Name bei YSWS setzt sich aus Name1 und Variantenname
→ Einrichtung → Einstellungen → Tags
Nachzulesen hier:
https://knowledge.plentyone.com/de-de/manual/main/business-entscheidungen/tags.html
2.4 Einrichtung von Ereignisaktionen
Das Grundprinzip von Ereignisaktionen in PlentyONE 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 PlentyONE gesetzt und der Bestand somit korrekt ausgebucht wird.
Die Konfiguration der Ereignisaktionen findest du in PlentyONE 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 PlentyONE nun automatisch den Warenausgang und setzt den Auftrag auch in PlentyONE in den Status “versendet”.
Sobald eine Sendungsnummer zum Auftrag übertragen wird, bucht PlentyONE nun automatisch den Warenausgang und setzt den Auftrag auch in PlentyONE in den Status “versendet”.
Nachzulesen hier:
https://knowledge.plentyone.com/de-de/manual/main/automatisierung/ereignisaktionen.html
2.5 Einrichtung von Status
Der Prozessfortschritt einer Bestellung wird in PlentyONE nach Status gegliedert. Für die Synchronisation ist es notwendig, dass die entsprechenden Status in PlentyONE 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ücksichtig.
- 2.5.2 Fehlerhafte Aufträge
- Führen Aufträge aufgrund von fehlerhaften Eingaben o.ä. zu einerFehlermeldung, 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 PlentyONE 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 PlentyONE 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 PlentyONE mit der Trackingnummer des Dienstleisters gekennzeichnet. Dabei wird sowohl die Trackingnummer als auch der Versanddienstleister übermittelt.
2.6 Automatische Lagerauswahl in Aufträgen
Wenn mehrere Läger in PlentyONE 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 YSWS-Fulfillment-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.plentyone.com/de-de/manual/main/auftraege/grundeinstellungen.html
3. Zu beachten / Häufige Fehler
Bei individuell vergebenem 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.)