Einrichtung UPS WorldShip

Wemalo unterstützt den Export von Versanddaten für UPS Worldship als XML-Datei. Dazu werden die folgenden Daten benötigt:

  • UPS Mandantennummer
  • Produkt (in WorldShip BillingOption, z.B. PP)
  • Methode (in Worldship ServiceType, z.B. ST)
  • Zölle und Steuern zu Lasten von
  • Transport zu Lasten von

Beispiel-Export einer XML-Datei:

<?xml version="1.0" encoding="UTF-8"?>
<OpenShipments xmlns="x-schema:OpenShipments.xdr">
 <OpenShipment ProcessStatus="" ShipmentOption="">
 <ShipTo>
 <CompanyOrName>Test-Spediteur</CompanyOrName>
 <Attention>Test Z.2</Attention>
 <Address1>TestStr. 10-13</Address1>
 <Address2>1. OG rechts</Address2>
 <CountryTerritory>DE</CountryTerritory>
 <CityOrTown>Wiesbaden</CityOrTown>
 <Telephone>0049-123456789</Telephone>
 <StateProvinceCounty/>
 <PostalCode>11111</PostalCode>
 </ShipTo>
 <ShipFrom>
 <CompanyOrName>Johannes Neumann</CompanyOrName>
 <Attention>-</Attention>
 <Address1>Dr.-Raber-Str. 4</Address1>
 <CountryTerritory>DE</CountryTerritory>
 <CityOrTown>Hagenow</CityOrTown>
 <Telephone>0</Telephone>
 <PostalCode>19230</PostalCode>
 </ShipFrom>
 <ShipmentInformation>
 <ShipperNumber>test1234</ShipperNumber>
 <ServiceType>ST</ServiceType>
 <BillingOption>PP</BillingOption>
 <NumberOfPackages>1</NumberOfPackages>
 <DescriptionOfGoods>Textilien</DescriptionOfGoods>
 </ShipmentInformation>
 <Package>
 <Weight>1</Weight>
 <PackageType/>
 <Reference1>12121</Reference1>
 <Reference2>sasasa</Reference2>
 </Package>
 </OpenShipment>
</OpenShipments>



Shopify

Die REST-Api von Shopify ist in wemalo-connect integriert und verbindet Wemalo mit dem Shopsystem Shopify.

Einstellungen in Shopify

Für die Anbindung werden ein API Key, Passwort und die URL benötigt.

Unter Apps > Manage prive apps > Generate API credentials kann der API-Zugang eingerichtet werden.
Als App-Name können Sie z.B. wemalo-connect vergeben. Nach der Key-Generierung benötigen wir den API Key, das Passwort sowie die genaue URL. Unter „Example URL“ steht ein zusammengebauter Link mit den benötigen Informationen. Diesen Link muss uns zur Verfügung gestellt werden. Hier ein Beispiel:
Die benötigten Zugriffsberechtigungen sind hier zu sehen:
api einrichten
Die benötigten Zugriffsberechtigungen umfassen derzeit folgende Anforderungen:

Unterstützte Aktionen

  • Laden von Produktstammdaten
  • Laden von Aufträgen
  • Übermittlung von versendeten Paketen
  • Übermittlung von Beständen

Produktstammdaten

  • Produkte, bei denen requires_shipping nicht gesetzt worden ist, werden nicht geladen.
  • Alle anderen auf „aktiv“ gesetzten Produkte/Varianten werden synchronisiert. Dabei werden SKU, EAN, Gewicht, Name, Produktgruppe und Hersteller ausgetauscht.
  • Bitte beachten: die SKU (auch in Varianten) muss eindeutig / unique sein.

Achtung: Ein bekannter Fehler seitens Shopify ist, dass Shopify bei der Anlage neuer Produkte, die duplizierten worden sind, keine neue externe ID vergibt. Das neu erstellte/duplizierte Produkt erhält somit die selbe externe ID. Aus diesem Grund ist es nicht möglich, neue Produkte durch die Funktion „Duplizieren“ zu erstellen, da eine neue, einmalige externe ID notwendig ist, um neue Produkte an wemalo zu übertragen.

Aufträge

  • Aufträge mit dem financial_status paid und fulfillment_status unshipped werden geladen und das Tag Wemalo_Download gesetzt.
  • Auftragskopfdaten, Lieferadresse und Positionen werden synchronisiert.
  • Über das Notizfeld kann eine Pickinfo angegeben werden.
  • Um den korrekten Versanddienstleister zu ermitteln, fragt Wemalo den Namen des gewählten Dienstleisters ab. Zum Matchen muss dieser in Wemalo bei den zu verwendenden Profilen als externe ID hinterlegt werden.
  • Es werden nur Positionen an Wemalo übermittelt, bei denen „requires_shipping“ gesetzt worden ist.
  • Achtung: sobald ein Auftrag an Wemalo übermittelt wurde, werden keine weiteren Änderungen am Auftrag an Wemalo übergeben.

Übermittlung von Paketen/Trackingnummern

  • Trackingnummer wird zusammen mit Versanddienstleister an Shopify zurück übertragen.
  • Dadurch ändert sich der fulfillment_status automatisch.

Übermittlung von Beständen

  • Damit ein Bestand von Wemalo übermittelt werden kann, muss die Inventory Policy aktiviert worden sein.
  • Wemalo übermittelt keine negativen Bestand, wenn unvollständige Aufträge vorliegen, die nicht bedient werden können. Ansonsten können die Varianten in Shopify nicht mehr aufgerufen werden.
  • Es werden nur kommissionierbare Bestände zurückgemeldet. D.h. Ware auf Sperrlager oder bereits gepickte Ware wird nicht als verfügbarer Bestand an Shopify übertragen.

Location-ID herausfinden

  • Im Shop auf Settings/Einstellungen (unten links) gehen, dann auf den Bereich Locations klicken.
  • Anschließend die Standard-Location auswählen.
  • Die Location-ID ist anschließend in der Adresszeile im Browser zu sehen (z.B. 1112222122).

Sollte die Location-ID nicht korrekt sein, kann seitens wemalo eine versteckte Location-ID ermittelt werden. Dies geschieht über den REST-Call.




Auto-Bericht Übersicht

Auto-Berichte dienen zur automatischen Berichtserstellung mit anschließendem E-Mail-Versand. Dabei kann i.d.R. zwischen einem Datenexport als CSV- oder Excel-Export unterschieden werden. Es gibt allerdings auch Auto-Berichte, die eine E-Mail mit einer Nachricht und ohne Anhang versenden (siehe Tagesabschluss).

Bei Auto-Berichten können ein oder mehrere E-Mail-Empfänger hinterlegt werden. Mehrere Empfänger werden dabei mit einem Komma getrennt eingetragen.




Auto-Bericht Tagesabschluss

Über den Auto-Bericht Tagesabschluss kann eine Statistik über die durchgeführten Aktionen am aktuellen Tag erstellt werden. Die Statistik wird per E-Mail an einen oder mehreren Empfängern versendet.
Über Berichte->Auto Berichte kann der Auto-Bericht hinterlegt werden.
tagesabschluss

  • Über Start-Stunde kann eingestellt werden, wann der Tagesabschluss erstellt werden soll
  • Mit Hilfe von „Stellplatznamen“ kann gefiltert werden, welche Stellplätze als „Refurbished“ dienen. Dabei können kommasepariert mehrere Stellplätze angegeben werden.
  • Unter Merkmal-Code wird er Code des Mandanten-Merkmals eingetragen, der bei der Berechnung der einzelnen Werte verwendet wird.
  • Unter Empfänger-E-Mail können ein oder mehrere (dann mit , getrennt) eingetragen werden

Das Ergebnis des Tagesabschlusses sieht dann zum Beispiel so aus:

Outgoing new: 1
Outgoing from stock: 82
All returns: 39
Ingoing new: 22
Refurbishment: 50

  • Outgoing new => Versendete Artikel mit dem gesetzten Merkmal-Code
  • Outgoing from stock => alle anderen Merkmale
  • All returns => die Summe der vereinnahmten Ware
  • Ingoing new => Summe Wareneingang am aktuellen Tag
  • Refurbishmeht => Summe Umlagerungen (mit Duplikatserkennung) auf Stellplätze, die mit dem „Stellplatznamen“ beginnen und nicht das gesetzt Merkmal-Code hatten bei der Umlagerung



Aufbau der CSV-Datei für Versanddienstleister

Mit Hilfe von CSV-Dateien werden DHL, GLS und DPD angebunden.

Trennzeichen

Die Einträge werden mit einem | getrennt.

Kopfdaten

Die Kopfzeile besteht aus:

Sendungs Ref-Nr. Abs. Ref-Nr. Abs. Bemerkung Mand. Ref-Nr. Verfahren Teilnahme Kostenstelle Produkt Serviceliste NN Währung TVWährung Empf. Ref-Nr. Empf. Name1 Empf. Name2 Empf. Name3 Empf. PLZ Empf. Ort Empf. Ortsteil Empf. Strasse Empf. Hausnr. Empf. Tel Empf. Fax POOL_EMPF_EMAIL POOL_EMPF_GEBDATUM POOL_EMPF_AUSWEISNR POOL_EMPF_AUSWEISART POOL_EMPF_AUSWEISBEH POOL_EMPF_MINDESTALTER POOL_EMPF_MA_ORT POOL_EMPF_MA_STADTTEIL POOL_EMPF_MA_STRASSE POOL_EMPF_NACHNAME POOL_EMPF_VORNAME POOL_EMPF_VERTRAG_ID POOL_EMPF_STAATSANGEHOERIGKEIT POOL_EMPF_ZUSAETZLICHEABFRAGE POOL_EMPF_ANTWORT POOL_EMPF_IDP_CONF Empf. An.-Partner Empf. Bemerkung UST-IdNr. Empf. Land POOL_EMPF_ZOLLBEZIRK Gewicht Sendungsanzahl Zoll-Warenart POOL_WORKSTATION POOL_ZOLL_MRNNUMBER Vorausverf. Nat. POOL_V_VORAUSVERF_NAT_TERMIN Unzustellbarkeitsanzeige POOL_AVISE POOL_V_VORAUSVERF_INT POOL_V_VORAUSVERF_INT_TERMIN POOL_V_VORAUSVERF_INT_TRANSP POOL_EPACK_VORAUS POOL_IDENTEXPRESS POOL_TAUSCH_ABWEICHENDERETADDR POOL_TAUSCH_TAUSCHTYP POOL_TAUSCH_PRUEFUNGTYP POOL_TAUSCH_LEISTUNGATTR POOL_SHIPMENT_ID POOL_EXWORKS POOL_CONTENTS POOL_VERWENDUNGSZWECK POOL_VORDATE POOL_SENDUNGSINHALTDHL POOL_RECHNUNGSARTDHL POOL_RECHNUNGSNUMMERDHL POOL_RECHNUNGSDATUMDHL POOL_UNTERZEICHNERDHL POOL_ZOLLTARIFDHL POOL_RECHNUNGSBEMDHL POOL_EXPORTARTDHL POOL_EXPORTGRUNDDHL POOL_RECHNUNGSPOSITIONENDHL POOL_EXTRADATA POOL_ADDITIONAL_1 POOL_ADDITIONAL_2 POOL_ADDITIONAL_3 Zollinhaltserklärung

Die Kopfdaten werden in der Standard-Konfiguration nicht mit ausgegeben.

Inhalt

Der Inhalt kann folgendermaßen aussehen:

121212 asas 1 101 EUR EUR 1KuAbw8 Johannes Neumann 21465 Reinbek Borsigstrasse 24 0 Johannes Neumann DE 2.5 1 0 1 Testprodukt|1124.0Testprodukt|1124.0

Zu beachten ist hier die letzte Spalte: auch diese kann für die Zollinhaltserklärung wiederum das | Zeichen als Trennsymbol enthalten.

Anwendung

Die CSV-Dateien stehen für DHL Easylog, DPD Delisprint und GLS Gepard zur Verfügung. Für die Anbindung an UPS Worldship wird eine XML-Datei generiert. DPD, DHL und Internetmarke sind darüber hinaus direkt über den jeweiligen Webservice angebunden. Zusätzlich hält Wemalo eine Anbindung an Shipcloud bereit, in der alle gängigen Versanddienstleister in einer Schnittstelle enthalten sind.

Beispiel

Sendungs Ref-Nr.|Abs. Ref-Nr.|Abs. Bemerkung|Mand. Ref-Nr.|Verfahren|Teilnahme|Kostenstelle|Produkt|Serviceliste|NN Währung|TVWährung|Empf. Ref-Nr.|Empf. Name1|Empf. Name2|Empf. Name3|Empf. PLZ|Empf. Ort|Empf. Ortsteil|Empf. Strasse|Empf. Hausnr.|Empf. Tel|Empf. Fax|POOL_EMPF_EMAIL|POOL_EMPF_GEBDATUM|POOL_EMPF_AUSWEISNR|POOL_EMPF_AUSWEISART|POOL_EMPF_AUSWEISBEH|POOL_EMPF_MINDESTALTER|POOL_EMPF_MA_ORT|POOL_EMPF_MA_STADTTEIL|POOL_EMPF_MA_STRASSE|POOL_EMPF_NACHNAME|POOL_EMPF_VORNAME|POOL_EMPF_VERTRAG_ID|POOL_EMPF_STAATSANGEHOERIGKEIT|POOL_EMPF_ZUSAETZLICHEABFRAGE|POOL_EMPF_ANTWORT|POOL_EMPF_IDP_CONF|Empf. An.-Partner|Empf. Bemerkung|UST-IdNr.|Empf. Land|POOL_EMPF_ZOLLBEZIRK|Gewicht|Sendungsanzahl|Zoll-Warenart|POOL_WORKSTATION|POOL_ZOLL_MRNNUMBER|Vorausverf. Nat.|POOL_V_VORAUSVERF_NAT_TERMIN|Unzustellbarkeitsanzeige|POOL_AVISE|POOL_V_VORAUSVERF_INT|POOL_V_VORAUSVERF_INT_TERMIN|POOL_V_VORAUSVERF_INT_TRANSP|POOL_EPACK_VORAUS|POOL_IDENTEXPRESS|POOL_TAUSCH_ABWEICHENDERETADDR|POOL_TAUSCH_TAUSCHTYP|POOL_TAUSCH_PRUEFUNGTYP|POOL_TAUSCH_LEISTUNGATTR|POOL_SHIPMENT_ID|POOL_EXWORKS|POOL_CONTENTS|POOL_VERWENDUNGSZWECK|POOL_VORDATE|POOL_SENDUNGSINHALTDHL|POOL_RECHNUNGSARTDHL|POOL_RECHNUNGSNUMMERDHL|POOL_RECHNUNGSDATUMDHL|POOL_UNTERZEICHNERDHL|POOL_ZOLLTARIFDHL|POOL_RECHNUNGSBEMDHL|POOL_EXPORTARTDHL|POOL_EXPORTGRUNDDHL|POOL_RECHNUNGSPOSITIONENDHL|POOL_EXTRADATA|POOL_ADDITIONAL_1|POOL_ADDITIONAL_2|POOL_ADDITIONAL_3|Zollinhaltserklärung
121212|||asas|1|||101||EUR|EUR|1KuAbw8||Johannes Neumann||21465|Reinbek||Borsigstrasse|24||||||00||||||Johannes Neumann||||||||||DE||2.5|1||0||||||||||||1||||||||||||||||||||||“Testprodukt|1124.0Testprodukt|1124.0″

Beispiel 2

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81
Sendungs Ref-Nr. Abs. Ref-Nr. Abs. Bemerkung Mand. Ref-Nr. Verfahren Teilnahme Kostenstelle Produkt Serviceliste NN Währung TVWährung Empf. Ref-Nr. Empf. Name1 Empf. Name2 Empf. Name3 Empf. PLZ Empf. Ort Empf. Ortsteil Empf. Strasse Empf. Hausnr. Empf. Tel Empf. Fax POOL_EMPF_EMAIL POOL_EMPF_GEBDATUM POOL_EMPF_AUSWEISNR POOL_EMPF_AUSWEISART POOL_EMPF_AUSWEISBEH POOL_EMPF_MINDESTALTER POOL_EMPF_MA_ORT POOL_EMPF_MA_STADTTEIL POOL_EMPF_MA_STRASSE POOL_EMPF_NACHNAME POOL_EMPF_VORNAME POOL_EMPF_VERTRAG_ID POOL_EMPF_STAATSANGEHOERIGKEIT POOL_EMPF_ZUSAETZLICHEABFRAGE POOL_EMPF_ANTWORT POOL_EMPF_IDP_CONF Empf. An.-Partner Empf. Bemerkung UST-IdNr. Empf. Land POOL_EMPF_ZOLLBEZIRK Gewicht Sendungsanzahl Zoll-Warenart POOL_WORKSTATION POOL_ZOLL_MRNNUMBER Vorausverf. Nat. POOL_V_VORAUSVERF_NAT_TERMIN Unzustellbarkeitsanzeige POOL_AVISE POOL_V_VORAUSVERF_INT POOL_V_VORAUSVERF_INT_TERMIN POOL_V_VORAUSVERF_INT_TRANSP POOL_EPACK_VORAUS POOL_IDENTEXPRESS POOL_TAUSCH_ABWEICHENDERETADDR POOL_TAUSCH_TAUSCHTYP POOL_TAUSCH_PRUEFUNGTYP POOL_TAUSCH_LEISTUNGATTR POOL_SHIPMENT_ID POOL_EXWORKS POOL_CONTENTS POOL_VERWENDUNGSZWECK POOL_VORDATE POOL_SENDUNGSINHALTDHL POOL_RECHNUNGSARTDHL POOL_RECHNUNGSNUMMERDHL POOL_RECHNUNGSDATUMDHL POOL_UNTERZEICHNERDHL POOL_ZOLLTARIFDHL POOL_RECHNUNGSBEMDHL POOL_EXPORTARTDHL POOL_EXPORTGRUNDDHL POOL_RECHNUNGSPOSITIONENDHL POOL_EXTRADATA POOL_ADDITIONAL_1 POOL_ADDITIONAL_2 POOL_ADDITIONAL_3 Zollinhaltserklärung
121212 asas 1 101 EUR EUR 1KuAbw8 Johannes Neumann 21465 Reinbek Borsigstrasse 24 0 Johannes Neumann DE 2.5 1 0 1 Testprodukt|1124.0Testprodukt|1124.0