Informationen, die YouSellWeSend bereitgestellt werden müssen

username – Backend-User mit entsprechenden Rechten (siehe Setup in plentymarkets)

password – Passwort zum entsprechenden User

URL – URL zum Backend-Shop

plentyID – Kann oben rechts neben dem Profilbild entnommen werden

warehouseID – ID des angelegten (YSWS-)Lagers

storageLocationID – ID des Standard-Lagerplatzes in plentymarkets

Wo sich diese Informationen finden lassen

Wie du plentymarkets für die Anbindung mit der YouSellWeSend-Software am besten einrichtest, kannst du hier nachlesen.

Status Definitionen

Der Prozess-Fortschritt 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.

1. Offene Aufträge
   Standardmäßig wird der 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 derzeit nicht zu wemalo übertragen.
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.
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…)
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 YouSellWeSend abgewickelt werden, den Status 9.0.1 zu verwenden um besser differenzieren zu können welche Plattform/Dienstleister die entsprechende Buchung getätigt hat.
5. Versendete Aufträge
   Sobald YouSellWeSend 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.
   Soll ein Warenausgang zudem über plentymarkets gesteuert werden, muss eine “Ereignis-Aktion” definiert werden (siehe 3.4)

Der Beitrag Anbindung an plentymarkets erschien zuerst auf WEMALO Help.

Mandant in wemalo anlegen 

Der Mandant wird in wemalo in gewohnter Weise angelegt. Für die weitere Einrichtungen des Mandanten in wemalo-connect müssen die Mandanten-ID und die Lager-ID bekannt sein.

User in wemalo-connect anlegen

Ein neuer Shop-User wird in wemalo-connect angelegt und mit dem zuvor angelegten Mandanten in wemalo anhand der Mandanten-ID verknüpft. Zusätzlich wird die Lager-ID hinterlegt.

Die Anlage eines REST-Keys ist notwendig!

weclapp-Schnittstelle einrichten

Die weclapp-Schnittstelle wird im Bereich „Generic REST Interfaces“ angelegt. Diese Interfaces benutzen die REST-Schnittstelle von wemalo, um mit dem Backend zu kommunizieren. Die Anlage eines Rest-Tokens ist allerdings nicht notwendig.

Durch Klick auf den Button „Neuer Eintrag“ kann eine neue Schnittstelle definiert werden. Nach Auswahl des Systems, kann über den Button „System-Template“ die Konfiguration des Systems geladen werden. Am Beispiel weclapp werden Key-Value-Paare für das Hinterlegen der benötigten Einstellungen (URL, Token, weclapp-ID etc.) geladen. Eine Übersicht der benötigten Einstellungen folgt im nächsten Unterkapitel.

Darüber hinaus können die wemalo-Instanz (zuvor durch Verlinkung von wemalo und der Mandanten-ID eingerichtet) und das Synchronisationsintervall gewählt werden.

Es muss über Einstellungen->Grundeinstellungen->Lager, ein Lager angelegt werden.
Sobald dies geschehen ist können sie über die Bearbeiten Funktion (Stift-Symbol) das Lager öffnen und die Warehouse-ID in der Browserleiste am ende sehen (entityId=XXXX).
Diese wird in den weclapp-Einstellungen benötigt.

weclapp-Einstellungen

Folgende Einstellungen müssen vom Kunden bereitgestellt werden:

• Token: hier muss der Token aus dem weclapp Shop eingetragen werden, (Meine Einstellungen->API Token) der erstellt werden muss.
• url: die URL zur API Schnittstelle von weclapp. (Shop-URL/webapp/api/v1)
  Beispiel: https://<kunde>.weclapp.com/webapp/api/v1
• (weclappId: 1)
• (storageLocationId: 1)
• warehouseId: die ID des Lagers in weclapp.

Folgende Einstellung werden von uns vorgenommen:

• extendedLog: hier muss true eingetragen werden, um ein erweitertes Logging zu aktivieren.

Abos

Die folgenden Abos können aktiviert/deaktiviert werden:

• serviceLoadProducts: laden von Produktstammdaten aus weclapp und Übermittlung an wemalo.
• serviceLoadGoodsOrders: laden von WA-Aufträgen von weclapp und Übermittlung an wemalo.
• servicePushPackages: zurückmelden von versendeten Paketen von wemalo an weclapp.
• servicePushInventoryBookings: Übermittlung von Inventurbuchungen (Ein- und Ausbuchungen).
• servicePushIncomingBookings: Übermittlung von Wareneingangsbuchungen
• servicePushSentBookings: Übermittlung von Warenausgangsbuchungen.
• servicePushReturnBookings: Übermittlung von Retourenbuchungen.

Produktstammdaten

Anmerkungen

Folgende Tätigkeiten müssen manuell im weclapp erledigt werden um dort den Auftrag zum Abruf bereitstellen zu können.

Um eine Lieferung eines Auftrages erfolgreich zu erstellen, muss der Auftrag durch manuelles klicken bestätigt werden. Die Auftragsbestätigung im Status ORDER_CONFIRMATION_PRINTED kann der Kunde manuell oder über eine Massenaktion erstellen. Wenden Sie sich für Rückfragen bitte an den weclapp Support.

Die Versendung der Lieferung und die Erstellung der Rechnung muss auch hier durch ein manuelles klicken bestätigt werden. Der Bestand wird erst aktualisiert, wenn die Lieferung versendet wurde.

Die Retoure des Auftrages kann erst generiert werden, wenn die Lieferung versendet wurde.

Die Waren aus den Retouren kann man in das Lager zurückbuchen, indem man in weclapp unter dem Punkt Wareneingänge und Workflow “Alle Positionen ins Lager buchen” auswählt.

Der Beitrag weclapp erschien zuerst auf WEMALO Help.