Versandschnittstelle zu UPS: Unterschied zwischen den Versionen

Aus e-vendo Wiki
Wechseln zu: Navigation, Suche
Zeile 1: Zeile 1:
 +
''UPS-WorldShip™'' ist eine Software, welche Ihnen das Versenden von Paketen mit ''UPS'' erleichtert. Diese Software wird direkt von ''UPS'' angeboten. Das e-vendo-System hilft Ihnen beim einfachen Übertragen der Daten zur UPS-Software.
 +
 +
 
__TOC__
 
__TOC__
  
UPS-WorldShip™ ist eine Software, welche Ihnen das Versenden von Paketen mit UPS erleichtert. Diese Software wird direkt von UPS angeboten. Das e-vendo-System hilft Ihnen beim einfachen Übertragen der Daten zur UPS-Software.
 
  
 
== Voreinstellungen ==
 
== Voreinstellungen ==
Installieren Sie die UPS-Software. Öffnen Sie in e-vendo das Modul Konfiguration ERP in der Navigationsgruppe Spezialmodule III und klicken Sie auf Versandart. Erstellen Sie, falls noch nicht vorhanden, einen Eintrag UPS und ordnen Sie dieser Versandart das Versandsystem UPS zu. Auf den verschiedenen Reitern können Sie weitere Einstellungen vornehmen.
 
Öffnen Sie die Globalen Systemvorgaben über das Modul Konfiguration ERP und aktivieren Sie den Reiter Versandsysteme.
 
  
[[Image: versand_ups_konfiguration_erp.jpg]]
+
Installieren Sie die UPS-Software.
 +
 
 +
Legen Sie einen Ordner zur Übergabe der Pollingdaten an. Sollen von mehreren Arbeitsplätzen aus Pollingdateien für die UPS-Software bereitgestellt werden, so muss dieser Ordner von allen diesen Arbeitsplätzen aus über den gleichen Pfad erreicht werden können. Legen Sie ggf. auf allen Arbeitsplätzen ein entsprechendes Netz-Laufwerk an, welches stets über den gleichen Laufwerksbuchstaben erreicht wird.
 +
 
 +
 
 +
== Konfiguration ERP ==
 +
 
 +
=== Versandart einrichten ===
 +
 
 +
Legen Sie im e-vendo über [[Konfiguration_ERP_-_Versandart|Spezialmodule III - Konfiguration ERP - Versandart]] eine Versandart für den UPS-Versand an und hinterlegen Sie dieser Versandart das Versandsystem ''UPS''.  Auf den verschiedenen Reitern können Sie weitere Einstellungen vornehmen.
 +
 
 +
 
 +
=== Schnittstelle aktivieren ===
 +
 
 +
Aktivieren Sie die Schnittstelle über [[Globale_Systemvorgaben_-_Versandsysteme|Konfiguration ERP - Globale Systemvorgaben - Versandsysteme]].
 +
 
 +
 
 +
[[Image: versand_ups_konfiguration_erp.jpg|verweis=]]
 +
 
 +
 
 +
Aktivieren Sie die Checkbox '''installiert''' und tragen Sie die Verzeichnisse für die Übergabe (s.o.) und für die Konfigurationsdatei ein. Mit Hilfe der Such-Buttons können diese Verzeichnisse ausgewählt werden.
 +
 
 +
Hinweis:
 +
Nutzen Sie das e-vendo System als SAAS in der Terminalserverumgebung der e-vendo AG,
 +
so wird das Verzeichnis für die Konfigurationsdatei bereits voreingestellt.
 +
Diese Einstellung darf durch Sie nicht verändert werden.
 +
 
 +
Im unteren Bereich können Sie weitere individuelle Einstellungen vornehmen:
 +
 
 +
;automatischer Trackingimport nach jedem Export
 +
:Nach jedem Export von Paketdaten prüft e-vendo, ob in dem festgelegten Verzeichnis eine Abschlussdatei von ''WorldShip'' vorliegt. Ist das der Fall, so wird diese Datei sofort importiert und verarbeitet. D. h., die darin enthaltenen Trackingnummern werden den entsprechenden Lieferscheinen zugeordnet.
 +
:Unabhängig von dieser Einstellung können Sie auch die Trackingdaten manuell importieren.
 +
;Dialog zum Bearbeiten der Paketdaten anzeigen
 +
:Vor dem Export von Paketdaten wird ein Dialog angezeigt, in welchem einige Daten vor der Übergabe an ''WorldShip'' geändert werden können.
 +
;bei NN Rechnungsbetrag nehmen statt Lieferscheinbetrag
 +
:Im Standard wird bei Nachnahme der Gesamtbetrag des Lieferscheins an ''WorldShip'' übergeben (wichtig bei Teillieferungen). Ist diese Checkbox aktiviert, so wird statt dessen der Rechnungsbetrag übergeben.
 +
 
 +
 
 +
=== Konfigurationsdatei anpassen ===
 +
 
 +
In der Konfigurationsdatei muss im Abschnitt ''[IdentDatei]'' der Pfad für das Installationsverzeichnis von ''WorldShip'' einzutragen (Eintrag ''XMLSchema='').
 +
 
 +
Weiterhin sind entsprechend den in der Konfiguartionsdatei enthaltenen Anweisungen für alle ''Paketarten'' die entsprechenden Abschnitte zu konfigurieren.
 +
 
 +
Ebenfalls angepasst werden müssen bei Bedarf die Abschnitte ''[EU-Mitglieder]'' und ''[Waehrungen]'' entsprechend den Einstellungen des ERP.
 +
 
 +
Für das automatische Ausziffern der Bankbelege bei Nachnahme-Sendungen ist es wichtig, dass auf den Überweisungsträgern der richtige Verwendungszweck gedruckt wird. Dazu muss der entsprechende Eintrag in der INI-Datei unter ''[Verwendungszweck]'' aktiviert werden.
 +
 
 +
 
 +
== Konfiguration des WorldShip ==
 +
 
 +
Aktivieren Sie im ''WorldShip'' über das Menü '''Aktivitäten''' - '''Auto-Import''' den Auto-Import. Stellen Sie hier das '''Übergabeverzeichnis''' ein, welches auch im e-vendo hinterlegt wurde.
 +
 
 +
 
 +
== Verwendung der Schnittstelle ==
 +
 
 +
=== Sendungen aus dem ERP exportieren ===
 +
 
 +
Wird im e-vendo ein Warenausgang gebucht, für den eine Versandart mit hinterlegtem Versandsystem ''UPS'' verwendet wird, so wird eine Pollingdatei im Übergabeverzeichnis erzeugt.
 +
 
 +
Der Dateiname für diese Pollingdatei lautet ''Poll_UPS_XXXX.xml'', wobei für ''XXXX'' die Belegnummer des Fakturabeleges verwendet wird.
 +
 
 +
Ist in der Konfiguration im e-vendo die Checkbox ''Dialog zum Bearbeiten der Paketdaten anzeigen'' aktiviert, dann erscheint im Zuge des Buchens des Lieferscheins folgender Dialog:
 +
 
 +
 
 +
[[Image: SchnittstelleUPS2.jpg|verweis=]]
 +
 
 +
 
 +
In diesem Dialog können z.B. eine andere Service- und/oder Paketart gewählt und weitere Einstellungen festgelegt werden. Klicken Sie auf den Button ''Datei erstellen'', um die Einstellungen zu übernehmen und die Pollingdatei zu erstellen.
 +
 
 +
Ist in der Konfiguration im e-vendo die Checkbox ''Dialog zum Bearbeiten der Paketdaten anzeigen'' nicht aktiviert, so wird die Pollingdatei mit den Standardeinstellungen erstellt.
 +
 
 +
 
 +
=== Verarbeitung im WorldShip ===
 +
 
 +
Die von e-vendo exportierte Datei wird von ''WorldShip'' umbenannt und erhält die Endung ''xxx''. Nach der Verarbeitung entsteht eine Datei mit gleichem Namen, aber der Endung ''Out''. Diese Datei enthält die Trackingnummer (bei UPS: Kontrollnummer), die zur Sendungsverfolgung benutzt werden kann. Diese Nummer wird beim Import der Trackinnummern in den Lieferschein eingetragen. Eine Verarbeitung durch das ERP erfolgt nur, wenn in der Antwortdatei als Status "Processed" angegeben ist. Sonst findet sich unter ''<ProcessMessage> <Error>'' eine Fehlernachricht.
 +
 
 +
 
 +
=== Trackingnummernimport ===
  
Im Bereich UPS-Versandsoftware "WorldShip" aktivieren Sie das Feld installiert und tragen die Verzeichnisse für die Übergabe und für die Konfigurationsdatei ein. Im unteren Bereich können Sie weitere individuelle Einstellungen vornehmen.
+
Für den Trackingnummernimport werden die in WorldShip erstellten Out-Dateien benötigt.
In der UPS-Software müssen jetzt noch die notwendigen Einstellungen für das Polling vorgenommen werden.
 
  
== Versanddaten erstellen ==
+
Ist in der Konfiguration im e-vendo die Checkbox ''automatischer Trackingimport'' bei jedem Export aktiviert, so wird beim Ablegen einer Pollingdatei im Übergabeverzeichnis geprüft, ob dort von WorldShip erstellte Out-Dateien bereitliegen. Ist das der Fall, so werden diese Dateien sofort importiert.
Nach dem Buchen eines Lieferscheins (WA) mit der Versandart UPS öffnet sich ein neues Fenster, in welchem Sie die benötigten Daten eingeben können. Wählen Sie die gewünschte Serviceart und Paketart aus. Das Gesamtgewicht berechnet sich aus den Gewichten der einzelnen Artikel, kann aber auch manuell geändert werden.  
 
  
[[Image: SchnittstelleUPS2.jpg]]
+
Um den Trackingnummernimport manuell zu starten, klicken Sie in der Navigationsgruppe ''Spezialmodule II'' auf den Eintrag Trackingnummernimport.
  
Nachdem alle Optionen korrekt eingestellt sind, bestätigen Sie dies durch Klick auf den Button ''Datei erstellen''. Damit sind alle notwendigen Daten an die UPS-Software übergeben worden.
+
Beim Trackingnummernimport werden die von ''WorldShip'' gelieferten Trackingnummern den entsprechenden Lieferschein-Belegen zugeordnet. Die Trackingnummer wird dabei im WA-Beleg im Reiter ''Belegstatus'' eingetragen.

Version vom 2. Mai 2014, 12:06 Uhr

UPS-WorldShip™ ist eine Software, welche Ihnen das Versenden von Paketen mit UPS erleichtert. Diese Software wird direkt von UPS angeboten. Das e-vendo-System hilft Ihnen beim einfachen Übertragen der Daten zur UPS-Software.



Voreinstellungen

Installieren Sie die UPS-Software.

Legen Sie einen Ordner zur Übergabe der Pollingdaten an. Sollen von mehreren Arbeitsplätzen aus Pollingdateien für die UPS-Software bereitgestellt werden, so muss dieser Ordner von allen diesen Arbeitsplätzen aus über den gleichen Pfad erreicht werden können. Legen Sie ggf. auf allen Arbeitsplätzen ein entsprechendes Netz-Laufwerk an, welches stets über den gleichen Laufwerksbuchstaben erreicht wird.


Konfiguration ERP

Versandart einrichten

Legen Sie im e-vendo über Spezialmodule III - Konfiguration ERP - Versandart eine Versandart für den UPS-Versand an und hinterlegen Sie dieser Versandart das Versandsystem UPS. Auf den verschiedenen Reitern können Sie weitere Einstellungen vornehmen.


Schnittstelle aktivieren

Aktivieren Sie die Schnittstelle über Konfiguration ERP - Globale Systemvorgaben - Versandsysteme.


Datei:Versand ups konfiguration erp.jpg


Aktivieren Sie die Checkbox installiert und tragen Sie die Verzeichnisse für die Übergabe (s.o.) und für die Konfigurationsdatei ein. Mit Hilfe der Such-Buttons können diese Verzeichnisse ausgewählt werden.

Hinweis:
Nutzen Sie das e-vendo System als SAAS in der Terminalserverumgebung der e-vendo AG,
so wird das Verzeichnis für die Konfigurationsdatei bereits voreingestellt.
Diese Einstellung darf durch Sie nicht verändert werden.

Im unteren Bereich können Sie weitere individuelle Einstellungen vornehmen:

automatischer Trackingimport nach jedem Export
Nach jedem Export von Paketdaten prüft e-vendo, ob in dem festgelegten Verzeichnis eine Abschlussdatei von WorldShip vorliegt. Ist das der Fall, so wird diese Datei sofort importiert und verarbeitet. D. h., die darin enthaltenen Trackingnummern werden den entsprechenden Lieferscheinen zugeordnet.
Unabhängig von dieser Einstellung können Sie auch die Trackingdaten manuell importieren.
Dialog zum Bearbeiten der Paketdaten anzeigen
Vor dem Export von Paketdaten wird ein Dialog angezeigt, in welchem einige Daten vor der Übergabe an WorldShip geändert werden können.
bei NN Rechnungsbetrag nehmen statt Lieferscheinbetrag
Im Standard wird bei Nachnahme der Gesamtbetrag des Lieferscheins an WorldShip übergeben (wichtig bei Teillieferungen). Ist diese Checkbox aktiviert, so wird statt dessen der Rechnungsbetrag übergeben.


Konfigurationsdatei anpassen

In der Konfigurationsdatei muss im Abschnitt [IdentDatei] der Pfad für das Installationsverzeichnis von WorldShip einzutragen (Eintrag XMLSchema=).

Weiterhin sind entsprechend den in der Konfiguartionsdatei enthaltenen Anweisungen für alle Paketarten die entsprechenden Abschnitte zu konfigurieren.

Ebenfalls angepasst werden müssen bei Bedarf die Abschnitte [EU-Mitglieder] und [Waehrungen] entsprechend den Einstellungen des ERP.

Für das automatische Ausziffern der Bankbelege bei Nachnahme-Sendungen ist es wichtig, dass auf den Überweisungsträgern der richtige Verwendungszweck gedruckt wird. Dazu muss der entsprechende Eintrag in der INI-Datei unter [Verwendungszweck] aktiviert werden.


Konfiguration des WorldShip

Aktivieren Sie im WorldShip über das Menü Aktivitäten - Auto-Import den Auto-Import. Stellen Sie hier das Übergabeverzeichnis ein, welches auch im e-vendo hinterlegt wurde.


Verwendung der Schnittstelle

Sendungen aus dem ERP exportieren

Wird im e-vendo ein Warenausgang gebucht, für den eine Versandart mit hinterlegtem Versandsystem UPS verwendet wird, so wird eine Pollingdatei im Übergabeverzeichnis erzeugt.

Der Dateiname für diese Pollingdatei lautet Poll_UPS_XXXX.xml, wobei für XXXX die Belegnummer des Fakturabeleges verwendet wird.

Ist in der Konfiguration im e-vendo die Checkbox Dialog zum Bearbeiten der Paketdaten anzeigen aktiviert, dann erscheint im Zuge des Buchens des Lieferscheins folgender Dialog:


SchnittstelleUPS2.jpg


In diesem Dialog können z.B. eine andere Service- und/oder Paketart gewählt und weitere Einstellungen festgelegt werden. Klicken Sie auf den Button Datei erstellen, um die Einstellungen zu übernehmen und die Pollingdatei zu erstellen.

Ist in der Konfiguration im e-vendo die Checkbox Dialog zum Bearbeiten der Paketdaten anzeigen nicht aktiviert, so wird die Pollingdatei mit den Standardeinstellungen erstellt.


Verarbeitung im WorldShip

Die von e-vendo exportierte Datei wird von WorldShip umbenannt und erhält die Endung xxx. Nach der Verarbeitung entsteht eine Datei mit gleichem Namen, aber der Endung Out. Diese Datei enthält die Trackingnummer (bei UPS: Kontrollnummer), die zur Sendungsverfolgung benutzt werden kann. Diese Nummer wird beim Import der Trackinnummern in den Lieferschein eingetragen. Eine Verarbeitung durch das ERP erfolgt nur, wenn in der Antwortdatei als Status "Processed" angegeben ist. Sonst findet sich unter <ProcessMessage> <Error> eine Fehlernachricht.


Trackingnummernimport

Für den Trackingnummernimport werden die in WorldShip erstellten Out-Dateien benötigt.

Ist in der Konfiguration im e-vendo die Checkbox automatischer Trackingimport bei jedem Export aktiviert, so wird beim Ablegen einer Pollingdatei im Übergabeverzeichnis geprüft, ob dort von WorldShip erstellte Out-Dateien bereitliegen. Ist das der Fall, so werden diese Dateien sofort importiert.

Um den Trackingnummernimport manuell zu starten, klicken Sie in der Navigationsgruppe Spezialmodule II auf den Eintrag Trackingnummernimport.

Beim Trackingnummernimport werden die von WorldShip gelieferten Trackingnummern den entsprechenden Lieferschein-Belegen zugeordnet. Die Trackingnummer wird dabei im WA-Beleg im Reiter Belegstatus eingetragen.