Leitfaden Anbindung DPD

Zur Anbindung von Weamlo an den Cloud-Service DPD werden die nachfolgenden Daten benötigt:

  • UserCredentials CloudUserID
  • UserCredentials Token
  • falls noch nicht vorhanden, bitte bei ci@dpd.de erfragen – dauert ca. 1 Tag

In Wemalo werden Versandprofile unter Konfiguration->Versandprofile angelegt. Für DPD sollte dabei auch ein Versandaccount eingerichtet werden, bei dem die oben genannten Informationen hinterlegt werden. Anschließend können Versandprofile referenzierend auf den Account hinterlegt werden, z.B. für die unterschiedlichen Versand-Produkte des Anbieters.




Leitfaden Anbindung DHL

Zur Nutzung des DHL-Webservices Versenden werden die nachfolgenden Informationen benötigt:
  • Ihre EKP Nummer
  • Login und Passwort für das DHL Geschäftskundenportal. Bitte legen Sie dazu einen neuen Nutzer für uns an.
  • Das Produkt „Versenden“ muss bereits für Sie freigeschaltet sein. Bei Fragen dazu wenden Sie sich bitte direkt an Ihren DHL Kontakt.

In Wemalo werden Versandprofile unter Konfiguration->Versandprofile angelegt. Für DHL sollte dabei auch ein Versandaccount eingerichtet werden, bei dem die oben genannten Informationen hinterlegt werden. Anschließend können Versandprofile referenzierend auf den Account hinterlegt werden, z.B. für die unterschiedlichen Versand-Produkte des Anbieters.




Magento

Wemalo unterstützt die Magento Rest-Api in Magento 2.

Einrichtung

Dazu muss in Magento ein Rest-User angelegt werden, der über weitreichende Berechtigungen verfügt. Mindestens auf die folgenden Ressourcen greift Wemalo zu:

  • POST V1/shipment/track
  • POST V1/shipment
  • POST V1/order/{id}/invoice
  • GET V1/invoices?searchCriteria[filter_groups][0][filters][0][field]=order_id&searchCriteria[filter_groups][0][filters][0][value]={id}
  • GET V1/products/{sku}
  • GET V1/products?searchCriteria..
  • GET V1/orders?searchCriteria...
  • POST V1/invoices/%s/capture
  • POST V1/invoices/%s/emails
  • POST V1/shipment/{shipmentId}/emails
  • PUT V1/products/{sku}/stockItems/{id}
  • POST V1/orders/{salesOrderId}/comments

Benutzerrolle anlegen:

  • System -> Benutzerrollen -> Neue Rolle hinzufügen
  • Rollenname z.B. wemalo
  • Rollen-Ressourcen: Katalog, Shops, Datentransfer, Umsatz (Bestellungen, Rechnungen, Sendungen)

Benutzer anlegen:

  • System -> Alle Benutzer -> Neuen Benutzer anlegen
  • Benutzername, Vor- und Nachname und Passwort vergeben
  • Zuvor angelegte Benutzerrolle zuweisen
  • Benutzername und Passwort werden in der Datenaustausch-Konfiguration in wemalo benötigt

Integration einrichten:

  • System -> Integrationen -> Neue Integration hinzufügen
  • Nur Name vergeben und Berechtigungen analog Benutzerrolle setzen
  • freigeben und Token in der Datenaustausch-Konfiguration in wemalo hinterlegen

Auftragsstatus hinterlegen:

  • Shops -> Bestellstatus -> Neuen Status erstellen
  • Statuscode vendor, Statuslabel Fulfillment
  • Statuscode wemalo_ready, Statuslabel Bereit
  • Über „Status dem Zustand zuweisen“ hinterlegen, dass auf wemalo_ready bei Bezahleingang gewählt werden soll

Funktionsübersicht

  • laden von Produktstammdaten
  • laden von Kunden-Bestellungen (Achtung: sobald ein Auftrag an Wemalo übermittelt wurde, werden keine weiteren Änderungen am Auftrag an Wemalo übergeben.)
  • laden von Rechnungen
  • Übermittlung von versendeten Paketen und Trackingnummern
  • Übermittlung von Beständen
  • Ausführen von Rechnungserstellungen und E-Mail-Versand

Laden von Bestellungen

  • Alle Aufträge im Status wemalo_ready (muss neu in Magento angelegt werden) werden durch Wemalo heruntergeladen. Es wird anschließend ein Kommentar hinzugefügt und der Status auf vendor (ebenfalls neu anzulegen) geändert.
  • Achtung: sobald ein Auftrag an Wemalo übermittelt wurde, werden keine weiteren Änderungen am Auftrag an Wemalo übergeben.



Shopware

Shopware ist in wemalo-connect eingebunden und kann darüber zum Austausch von Daten mit Wemalo verwendet werden. In wemalo-connect ist dazu ein Shop-Account notwendig.

Die unterstützten Versionen und Funktionen sind in der Funktionsmatrix aufgeführt.

Shopware 6

Unsere Shopware App findest du im Shopware Store zum Download und zur Installation. Bitte komme nach der Aktivierung in deinem Shop auf unseren Support zu für eine vollständige Einrichtung.

Die Wemalo Connector App wurde speziell von der 4e software solution GmbH für ihre Fulfillment Software Wemalo entwickelt. Dabei lässt sich dank der App Dein Shopware-Shop innerhalb Sekunden an Wemalo und damit an Dein Fulfillmentlager anbinden. Mit der App werden automatisch Deine Bestellungen, Produkte und Bestände zu Wemalo übertragen. Gleichzeitig übergibt Wemalo nach Auftragsbearbeitung neben der Trackingnummer auch den Status „versendet“ an Deinen Shopware Shop, so dass Du immer genau weißt, wann Bestellungen mit welcher Sendungsnummer an Deine Kunden versendet worden sind. Retouren Deiner Kunden, die durch Dein Lager eingebucht werden, werden selbstverständlich ebenfalls zurück an Deinen Shop gemeldet, so dass Du einfach und problemlos Deine Kunden über Rücksendungen informieren kannst.

Neue Produkte, sowie Änderungen an bestehenden Produkte werden an Wemalo gemeldet und entsprechend im System angepasst. Updates und Änderungen zu Deinen Beständen bekommt Dein Shop über Wemalo mitgeteilt, sodass Überverkäufe der Vergangenheit angehören. Dein Shop hat damit lediglich den tatsächlichen Bestand aus Deinem Lager.

 

Highlights der App:

– Aktualisierung bestehender Produktinformation und Übertragung neuer Produkte
– automatisierte Übertragung von Trackingnummern aus Wemalo in Deinen Shopware Shop
– Dank Wemalo kannst Du auch mehrere Läger über eine App anbinden und bedienen
– Wemalo bietet Dir Schnittstellen zu allen gängigen Versanddienstleistern
– Übertragung von Retouren in Dein Shopsystem

Shopware 5

Einstellungen in Shopware

  • API-Nutzer in Shopware einrichten
  • API-Nutzer, API-Schlüssel und URL zur Rest-API von Shopware werden benötigt
  • Nach der initialen Einrichtung werden durch Wemalo alle Bestände auf 0 gesetzt!*1

Benutzer-Einstellung Shopware

Konfiguration in wemalo-connect

  • ein Shop-User muss eingerichtet werden
  • für die Schnittstelle Shopware müssen die Daten aus dem vorherigen Abschnitt eingegeben werden
  • Die Synchronisationszeit kann eingestellt werden. Wenn die Zeit auf 0 gesetzt wird, ist die Schnittstelle aus.
  • Die einzelnen Daten-Abos können aktiviert/deaktiviert werden
  • Bei jedem Daten-Abo wird festgehalten, wann das Abo zuletzt erfolgreich durchgelaufen ist
  • In der Schnittstelle wird angezeigt, wann die Schnittstelle zuletzt ausgeführt wurde

Produkte

  • Es werden alle aktiven Produkte geladen und an Wemalo übertragen.
  • Es werden dabei nur Produkte berücksichtigt, die sich seit der letzten erfolgreichen Produkt-Synchronisierung aktualisiert haben.
  • Die Produkt-ID wird in Wemalo als externe ID gespeichert und dient zum Matching der Produktstammdaten.
  • Die Artikelnummer aus Shopware wird an Wemalo als SKU übertragen.
  • Das Gewicht wird als Kilogramm eingelesen, Produktmaße als Zentimeter mit Nachkommastellen.
  • Bei Variantenartikel wird der zusätzliche Text in Shopware an den Namen in Wemalo gehängt. Es ist daher notwendig, dieses Feld z.B. mit der Farbe oder einem anderen Text zu füllen, damit im Lager zwischen den unterschiedlichen Varianten unterschieden werden kann.

Bestellungen

  • Bestellungen im Status „In Bearbeitung (Wartet)“ werden von Wemalo heruntergeladen und in den Status „Zur Lieferung bereit“ gesetzt.
  • Nach dem Versand werden Aufträge in den Status „Komplett ausgeliefert“ gesetzt.
  • Das Matching des zu verwendeten Versanddienstleisters geschieht über den Namen der hinterlegten Versandart, z.B. „Standard Versand“.
  • Achtung: sobald ein Auftrag an Wemalo übermittelt wurde, werden keine weiteren Änderungen am Auftrag an Wemalo übergeben.

Über wemalo-connect können Rechnungen als Base64 heruntergeladen werden. Dazu muss der Endpunkt bei „Rechnungen-Endpunkt“ in der Shopware-Konfiguration von wemalo-connect hinterlegt werden. Zusätzlich muss die Shopware-API um den hinterlegten Endpunkt erweitert werden.

wemalo geht davon aus, dass das base64-Dokument über {„data“: {„pdfDocument“:“base64…….“}} abgerufen werden kann.

Bestände

  • Über wemalo-connect werden aktuelle Produktbestände geladen und mit Shopware synchronisiert. Dabei werden nur kommissionierbare Bestände zurückgemeldet. D.h. Ware auf Sperrlager oder bereits gepickte Ware wird nicht als verfügbarer Bestand an Shopware übertragen.

Versendete Pakete

  • Der Trackingcode wird an die Bestellung in Shopware übergeben. Wird eine Bestellung in mehreren Paketen versendet, werden die Trackingnummern mit Semikolon getrennt eingetragen.
  • Anschließend wird der Auftrag als versendet markiert.

Retouren

  • In Wemalo kann ein Auftragsstatus hinterlegt werden, der für das abholen von angemeldeten Retouren verwendet wird (z.B. „Retoure anmelden“). Hat Wemalo eine Retoure geladen, wird der Status auf „Wemalo geholt“ gesetzt. Beide Status-ID sind nicht im Standard-Shopware vorhanden und müssen in Shopware neu hinterlegt werden.
  • Auch kann aktiviert werden, dass Retouren zurückgemeldet werden. Dazu muss auch das Abholen von Retouren aktiviert worden sein, da Wemalo die ID des Auftrags zum Zurückspielen der Retouren-Meldung benötigt. Eine entgegengenommene Retoure wird anhand eines weiteren neuen Status in Shopware abgebildet.

*1: Ausschließen von Produkten

Sollen Produkte nicht synchronisiert werden, müssen Sie der Kundengruppe WAPI (Wemalo API) zugeordnet werden. Dazu muss zunächst eine neue Kundengruppe in Shopware angelegt werden:

Anlegen von Kundengruppen

Anschließend muss die Kundengruppen den Produkten zugeordnet werden, die nicht von Wemalo abgerufen werden sollen:

Zuweisen von Kundengruppen

Bitte beachten: Die Zuweisung muss stattfinden, bevor Wemalo das Produkt lädt!

 

window.onload = function () { console.log('Dokument geladen'); sendReadyState(); } function sendReadyState() { window.parent.postMessage('sw-app-loaded', '*'); }