wemalo connect rest api

Die Dokumention zur Schnittstelle wemalo connect REST API befindet sich hier: connect-api.wemalo.com



Gebindefunktion

Anlegen der Gebinde

Über den Produktstamm können für ein Produkt beliebig viele Gebinde eingetragen werden.
Dazu kann über das Einheiten-Tab die Gebindeeinheiten eingesehen und hinzugefügt werden. Eine Gebindeeinheit besteht aus einem Namen (wird bei Umlagerung, Pick und Pack angezeigt) und einer Menge (wie viel Stück in einer Einheit sind). Außerdem können Dimensionen (Höhe/Breite/Länge und Gewicht) hinterlegt werden, da dies Auswirkungen auf Abrechnungen haben könnte (sofern für Pick-Kategorieren eingesetzt werden).

Als mögliche Gebindeeinheitstypen stehen Karton, Griffeinheit und Palette zur Verfügung. Aus technischer Sicht gibt es allerdings keine Unterscheidung.

Mit Hilfe eines Barcodes kann ein für die Gebindeeinheit spezifischer Barcode hinterlegt werden, der bei Wareneingang, Umlagerung, Pick & Pack akzeptiert wird.

Gebinde-Upload

Über den Mandantenstamm können Gebinde per CSV-Datei hochgeladen werden. Bzgl. Aufbau der CSV-Datei siehe Inline-Hilfe in wemalo.

Integration in Abrechnungen

In der Gruppe Versand können Gebinde für die Abrechnung aktiviert werden.

Integration Anlieferung und Wareneingang

Über ein DropDown kann die Gebindeeinheit gewählt werden. Die Gesamtsumme wird entsprechend der gewählten Einheit und der eingegebenen Menge berechnet und angezeigt.

Wird der spezifische Gebindebarcode gescannt, so wird das dazugehörige Gebinde bereits vorausgewählt.

Beispiel: wenn eine Gebindeeinheit mit 6 Stück gewählt wurde und die Menge 2 eingetragen worden ist, wird als Gesamtstückzahl 12 ausgegeben.

Integration Umlagerung

In der MDE-Ansicht wird nach Scan des Produktes und Eingabe der Menge ein Vorschlag zur Entnahme der Ware als Gebinde angezeigt.

Integration Picken

Beim Picken bekommt der Mitarbeiter nach dem Scan des Produktes ein DropDown zur Auswahl des Gebindes angezeigt. Sobald ein Gebinde gewählt worden ist, springt die Anzeige auf die Mengeneingabe und der Picker kann damit fortfahren. Es wird überprüft, dass die eingegeben Menge multipliziert mit der Gebindemenge (in dem obigen Beispiel 6) nicht die zu pickende Menge übersteigt.

Beispiel: das Gebinde hat eine hinterlegte Stückzahl von 6 und als Menge wurde 2 eingetragen. Die Gesamtstückzahl beträgt somit 12. Sollten weniger als 12 gepickt werden, wird der Picker mit einer entsprechenden Fehlermeldung am Fortfahren gehindert. Zu jeder Zeit bekommt der Picker die berechnete Gesamtstückzahl ausgegeben.

Integration Packen

Der Packer kann nach dem Scan des Produkt-Barcode das Gebinde auswählen und die Scan-Anzahl wird entsprechend der Gebindemenge umgerechet. Wenn der Gebindebarcode gescannt wird, geschieht die Wahl des Gebindes automatisch.



Gebinde-Management über REST

Anlegen/bearbeiten von Gebinden: http://connect-api.wemalo.com/#api-Product-addUnit
Laden der verfügbaren Gebinde-Einheiten: http://connect-api.wemalo.com/#api-Product-getUnits

Außerdem: beim Anlegen eines WE-Auftrages kann in der Position die ID der Gebinde-Einheit eingetragen werden: http://connect-api.wemalo.com/#api-GoodsReceipt-addGoodsReceipt
Dort gibt es jetzt den Parameter „productUnitId“.

Beispiel:

Für ein Produkt wird eine Gebinde-Einheit „Vorteilspack 5 Stück“ angelegt. Diese Gebindeeinheit beinhaltet 5 Stück des besagten Produktes.
Bei der Übermittlung des Wareneinganges kann diese Gebinde-Einheit mit einer Stückzahl angegeben werden, z.B. 2 Stück.
In dem Fall erwartet wemalo 10 Stück des Produktes (2 mal das Gebinde mit 5 Stück => 2*5=10).



Versandkostenmatrix

Mit Hilfe der Versandkostenmatrix werden die Versandkosten je Paket nach Empfängerland, Gewicht und Versanddienstleister im Mandantenstamm hinterlegt, um bei der Abrechnungsgenerierung exakte Versandpreise ermitteln zu können.

Vorlage je Mandant

Im Mandantenstamm kann unter Abrechnung->Versandkostenmatrix eine Vorlage je Versanddienstleister heruntergeladen werden. Dem Benutzer werden dabei alle Versanddienstleister angezeigt, die für den Mandanten eingerichtet worden sind.

Vorlage auf Lagerebene

Auf Lagerebene kann eine Vorlage hinterlegt werden, die für Versendungen eingesetzt wird, die nicht über den Mandanten definiert worden sind.

Spezifikation

MatchingID;Dispatcher;Product;Comments;Country;Country DE;Country Code;ZIP;BasePrice;KiloPrice;Weight;Price
  • Die Werte werden mit einem Semikolon voneinander getrennt.
  • Es ist auf die richtige Reihenfolge zu achten und die Datei muss als UTF-8 kodiert werden.
  • Es gibt eine Datei pro Versanddienstleister.
  • Damit wemalo bei der Preisermittlung ein Profil einem Eintrag in der CSV-Datei zuordnen kann, wird die Matching-ID benötigt. Diese beinhaltet eine Kombination aus Dienstleister, Produkt und optionale Zusatzleistungen (wie z.B. Nachname).
  • Die Spalte Dispatcher beinhaltet den Versanddienstleister (sollte für eine komplette Datei immer identisch sein). In der Spalte Product wird das Versandprodukt eingetragen.
  • In der Spalte Comments kann ein aussagekräftige Name für die Preislistenposition hinterlegt werden. In der Abrechnung wird die Eintragung in dieser Spalte mit in die Preisberechnung aufgenommen.
  • Die Spalten Country, Country DE und Country Code beschreiben das Empfängerland (englische und deutsche Bezeichnung, sowie der internationale Matching-Code).
  • ZIP beinhaltet die Postleitzahl (in der ersten Version der Matrix nicht verwendet).
  • Über BasePrice kann ein Basis-Preis eingetragen werden, der anhand KiloPrice je Kilo erweitert wird. In der ersten Umsetzungsversion der Matrix wird das nicht angewendet.
  • Die beiden für die Preisermittlung relevanten Spalten sind Weight und Price. Weight gibt dabei die Gewichtsgrenze an, bis zu der die jeweilige Zeile relevant ist. Die Vorlage ist so aufgebaut, dass jede Kombination aus Versandprodukt und Land mit den Gewichten 1KG bis 40KG aufgelistet wird. Wiegt ein Paket 39,5 KG, so wird der Preis für 40KG verwendet. Wiegt es 38,9KG, ist der Preis bei 39KG ausschlaggebend usw. In der Spalte Price wird der Versandpreis in Euro angegeben, wobei die Eingabe von . als Trennzeichen für Nachkommastellen zu bevorzugen ist (aber nicht zwingend erforderlich).

Matrix erstellen

Um eine Matrix für einen Mandanten zu erstellen, kann auf eine Vorlage aufgebaut werden. Dazu können pro Lager Vorlagen je Versanddienstleister hinterlegt werden. Über den Mandanten kann zusätzlich eine auf die für den Mandanten eingerichteten Versandprofilen zugeschnittene Vorlagendatei heruntergeladen werden.

Übersicht der bisher hinterlegten Versandmatrizen

Anzeige einer hinterlegten Matrix als HTML-Ansicht

 

Download als CSV


Ansicht nach CSV-Export

Versandprofil

  • Im Versandprofil kann eingestellt werden, ob das Profil in der Generierung der Preise berücksichtigt werden soll.

Matrix anwenden

  • Im Bereich Versand in der Preisliste muss dazu die Option „Versandkosten“ aktiviert werden.