Versandschnittstelle zu GLS: Unterschied zwischen den Versionen

Aus e-vendo Wiki
Wechseln zu: Navigation, Suche
Zeile 1: Zeile 1:
 +
''GLS Gepard connect'' ist eine Software, welche Ihnen das Versenden von Paketen mit GLS erleichtert. Diese Software wird direkt von GLS angeboten. Das e-vendo-System hilft Ihnen beim einfachen Übertragen der Daten zu GLS Gepard connect.
 +
 +
 
__TOC__
 
__TOC__
  
''GLS Gepard connect'' ist eine Software, welche Ihnen das Versenden von Paketen mit GLS erleichtert. Diese Software wird direkt von GLS angeboten. Das e-vendo-System hilft Ihnen beim einfachen Übertragen der Daten zu GLS Gepard connect.
 
  
 
== Voreinstellungen ==
 
== Voreinstellungen ==
 +
 
Installieren Sie die GLS-Software.
 
Installieren Sie die GLS-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, eine Versandart für den GLS-Versand, z. B. GLS, und ordnen Sie dieser Versandart das Versandsystem GLS zu.
 
Öffnen Sie die Globalen Systemvorgaben über das Modul Konfiguration ERP und aktivieren Sie den Reiter Versandsysteme.
 
  
[[Image: versand_gls_konfiguration_erp.jpg]]
+
Legen Sie einen Ordner zur Übergabe der Pollingdaten an. Sollen von mehreren Arbeitsplätzen aus Pollingdateien für die GLS-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.
 +
 
 +
Legen Sie innerhalb dieses Übergabeverzeichnisses einen weiteren Ordner zur Rückgabe der Trackindaten an e-vendo an.
 +
 
 +
 
 +
== Konfiguration ERP ==
 +
 
 +
=== Versandart einrichten ===
 +
 
 +
Legen Sie im e-vendo über [[Konfiguration_ERP_-_Versandart|Spezialmodule III - Konfiguration ERP - Versandart]] eine Versandart für den GLS-Versand an und hinterlegen Sie dieser Versandart das Versandsystem ''GLS''.  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_gls_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 Verzeichnung 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 GLS 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 GLS geändert werden können.
 +
;bei NN Rechnungsbetrag nehmen statt Lieferscheinbetrag
 +
:Im Standard wird bei Nachnahme der Gesamtbetrag des Lieferscheins an GLS übergeben (wichtig bei Teillieferungen). Ist diese Checkbox aktiviert, so wird statt dessen der Rechnungsbetrag übergeben.
 +
;Feldinfo zusätzlich zum Wert in der Exportdatei anzeigen
 +
:Ist diese Option aktiviert, so werden die Feldbezeichnungen zusammen mit den eigentlichen Werten in die Exportdatei übergeben (z. B. 3943_1 (ID-Nummer)).
 +
:Diese Option sollte nur für die Dauer der Einrichtung aktiv sein.
 +
 
 +
 
 +
=== Konfigurationsdatei anpassen ===
 +
 
 +
In der Konfigurationsdatei sind entsprechend den dort enthaltenen Anweisungen für alle ''Paketarten'' die entsprechenden Abschnitte zu konfigurieren.
 +
 
 +
Ebenfalls angepasst werden müssen bei Bedarf die Abschnitte ''[DPD-Landliste]'', ''[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.
 +
 
 +
Im Bereich ''[IdentDatei]'' müssen der Ordner und der Dateiname der Rückmeldedateien in folgender Form angegeben werden:
 +
:Name=''ordner\dateiname''
 +
Dieser Ordner muss ein Unterordner des Übergabeverzeichnisses sein (s.o.)
 +
 
 +
Beispiel:
 +
Name=tracking\Poll_DPD*.txt
 +
 
 +
 
 +
== Konfiguration des GLS Gepard Connect ==
 +
 
 +
Nach dem Einrichten des Absenders tragen Sie über die Systemeinstellungen den Dateipfad für die Auftragsdateien ein. Dieser Pfad muss mit dem im e-vendo festgelegten Übergabeverzeichnis übereinstimmen.
 +
 
 +
 
 +
=== Musterdatei im ERP erzeugen ===
 +
 
 +
Legen Sie einen im e-vendo einen Lieferschein mit einer Versandart an, welche das Versandsystem GLS verwendet.
 +
 
 +
Buchen Sie den Lieferschein und bestätigen Sie ggf. den Dialog zur Erfassung der Paketdaten durch Klick auf den Button ''Datei erstellen''. Sichern Sie die im Übergabeverzeichnis erzeugte Datei. Diese Musterdatei kann später zum Testen und für Änderungen am Importformat verwendet werden.
 +
 
 +
 
 +
=== Importassistent ===
 +
 
 +
Mit dem Importassistenten legen Sie fest, wie die durch e-vendo erzeugten Paketdaten importiert werden.
 +
 
 +
Starten Sie im GLS Gepard connect über das Menü '''Dienstprogramme''' den '''Importassistenten'''.
 +
 
 +
Legen Sie damit ein neues Importformat an:
 +
 
 +
;Schritt 1:
 +
:Wählen Sie als Dateiart ''Auftragsdaten für den Normalversand''.
 +
;Schritt 2:
 +
:Wählen Sie den Absender und die Quelldatei aus. Ersetzen Sie die im Dateinamen enthaltene Belegnummer durch den Platzhalter * (Poll_GLS_*.txt).
 +
;Schritt 3:
 +
:Legen Sie als Dateiformat ''ASCII, variable Satzlänge'' fest.
 +
;Schritt 4:
 +
:Wählen Sie als Trennzeichen das Semikolon aus (''59 --> ;'')
 +
:Ordnen Sie den Feldern die entsprechenden Positionen aus der Quelldatei zu. Bitte entnehmen Sie die korrekten Positionen der nachfolgenden Übersicht.
 +
;Schritt 5:
 +
:Damit ist das Importformat definiert. Schließen Sie die Erstellung des Formates durch Klick auf ''Fertig stellen'' ab.
 +
 
 +
 
 +
=== Feldzuordnung für den Import ===
 +
 
 +
=== Rückmeldeassistent ===
 +
 
 +
Über den Rückmeldeassistent definieren Sie den Speicherort und das Format für die durch den Tagesabschluss erstellte Rückmeldedatei.
 +
 
 +
Starten Sie den ''Rückmeldeassistenten'' über das Menü ''Dienstprogramme''.
 +
 
 +
;Schritt 1:
 +
:Wählen Sie die Versandart ''Normalversand''.
 +
;Schritt 2:
 +
:Geben Sie Pfad und Dateiname für die Rückmeldedatei an.
 +
:Der Ordner für die Rückmeldedatei muss ein Unterordner des Übergabeverzeichnisses sein.
 +
;Schritt 3:
 +
:Wählen Sie die Optionen
 +
::''ASCII, variable Satzlänge'' und
 +
::''Neue Daten an Datei anfügen, bestehende aktualisieren''.
 +
;Schritt 4:
 +
:Übergeben Sie aus dem Bereich KDPAKET die Felder ''ID_NR'' und ''PAKETNR'' in die Liste Rückmeldedatei (Reihenfolge beachten!)
 +
;Schritt 5:
 +
:Klicken Sie nur auf ''Weiter''.
 +
;Schritt 6:
 +
:Klicken Sie nur auf ''Weiter''.
 +
;Schritt 7:
 +
:Für beide Felder wird in Spalte Länge der Wert ''0'' benötigt. Die Spalte ''Format/Vorgabe'' bleibt leer.
 +
:Wählen Sie als Trennzeichen das Semikolon (''59 --> ;'') aus.
 +
:Klicken Sie auf ''Fertigstellen''.
 +
 
 +
 
 +
== Verwendung der Schnittstelle ==
 +
 
 +
=== Sendungen aus dem ERP exportieren ===
 +
 
 +
Wird im e-vendo ein Warenausgang gebucht, für den eine Versandart mit hinterlegtem Versandsystem GLS verwendet wird, so wird eine Pollingdatei im Übergabeverzeichnis erzeugt.
 +
 
 +
Der Dateiname für diese Pollingdatei lautet ''Poll_GLS_XXXX_Y.txt'', wobei für ''XXXX'' die Belegnummer und für ''Y'' die Versionsnummer verwendet des Fakturabeleges 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: SchnittstelleGLS.jpg|verweis=]]
 +
 
 +
In diesem Dialog können z.B. eine andere 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 GLS Gepard connect ===
 +
 
 +
Bei der Paketabwicklung wird den einzelnen Versandaufträgen jeweils eine Trackingnummer zugeteilt.
 +
 
 +
Führen Sie nach der Paketabwicklung einen Tagesabschluss durch, um die Rückmeldedatei zu erzeugen. Diese wird in dem konfigurierten Ordner abgelegt.
 +
 
  
Im Reiter '''GLS-Versandsoftware "GLS"''' 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.
+
=== Trackingnummernimport ===
In der GLS-Software müssen jetzt noch die notwendigen Einstellungen für das Polling vorgenommen werden.
 
  
== Versanddaten erstellen ==
+
Für den Trackingnummernimport werden die in GLS Gepard connect erstellten Rückmeldedateien benötigt.
Nach dem Buchen eines Lieferscheins (WA) mit der Versandart GLS wird eine Datei mit den entsprechenden Lieferscheindaten erstellt.
 
Wurde in der Konfiguration das Feld Dialog zum Bearbeiten der Paketdaten anzeigen aktiviert, öffnet sich vor dem Erstellen der Datei ein Dialog, in welchem Sie die zu übergebenden Daten bearbeiten können.
 
  
[[Image: SchnittstelleGLS.jpg]]
+
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 im Übergabeverzeichnis eine GLS-Rückmeldedatei bereitliegt. Ist das der Fall, so wird diese Datei sofort importiert.
  
Nachdem alle Optionen korrekt eingestellt sind, bestätigen Sie dies durch Klick auf den Button Datei erstellen.
+
Um den Trackingnummernimport manuell zu starten, klicken Sie in der Navigationsgruppe Spezialmodule II auf den Eintrag Trackingnummernimport.
Damit werden alle notwendigen Daten an GLS übergeben.
 
  
== Trackingnummer importieren==
+
Beim Trackingnummernimport werden die von GLS gelieferten Trackingnummern den entsprechenden Lieferschein-Belegen zugeordnet. Die Trackingnummer wird dabei im WA-Beleg im Reiter ''Belegstatus'' eingetragen.
Die Trackingnummern können automatisch (s. o.) oder manuell importiert werden. Für den manuellen Import klicken Sie unter Spezialmodule II auf Trackingnummernimport.
 
Die importierte Trackingnummer wird durch das System im Reiter Belegstatus des Lieferscheins eingetragen.
 

Version vom 30. April 2014, 15:14 Uhr

GLS Gepard connect ist eine Software, welche Ihnen das Versenden von Paketen mit GLS erleichtert. Diese Software wird direkt von GLS angeboten. Das e-vendo-System hilft Ihnen beim einfachen Übertragen der Daten zu GLS Gepard connect.



Voreinstellungen

Installieren Sie die GLS-Software.

Legen Sie einen Ordner zur Übergabe der Pollingdaten an. Sollen von mehreren Arbeitsplätzen aus Pollingdateien für die GLS-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.

Legen Sie innerhalb dieses Übergabeverzeichnisses einen weiteren Ordner zur Rückgabe der Trackindaten an e-vendo an.


Konfiguration ERP

Versandart einrichten

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


Schnittstelle aktivieren

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


Datei:Versand gls 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 Verzeichnung 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 GLS 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 GLS geändert werden können.
bei NN Rechnungsbetrag nehmen statt Lieferscheinbetrag
Im Standard wird bei Nachnahme der Gesamtbetrag des Lieferscheins an GLS übergeben (wichtig bei Teillieferungen). Ist diese Checkbox aktiviert, so wird statt dessen der Rechnungsbetrag übergeben.
Feldinfo zusätzlich zum Wert in der Exportdatei anzeigen
Ist diese Option aktiviert, so werden die Feldbezeichnungen zusammen mit den eigentlichen Werten in die Exportdatei übergeben (z. B. 3943_1 (ID-Nummer)).
Diese Option sollte nur für die Dauer der Einrichtung aktiv sein.


Konfigurationsdatei anpassen

In der Konfigurationsdatei sind entsprechend den dort enthaltenen Anweisungen für alle Paketarten die entsprechenden Abschnitte zu konfigurieren.

Ebenfalls angepasst werden müssen bei Bedarf die Abschnitte [DPD-Landliste], [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.

Im Bereich [IdentDatei] müssen der Ordner und der Dateiname der Rückmeldedateien in folgender Form angegeben werden:

Name=ordner\dateiname

Dieser Ordner muss ein Unterordner des Übergabeverzeichnisses sein (s.o.)

Beispiel:
Name=tracking\Poll_DPD*.txt


Konfiguration des GLS Gepard Connect

Nach dem Einrichten des Absenders tragen Sie über die Systemeinstellungen den Dateipfad für die Auftragsdateien ein. Dieser Pfad muss mit dem im e-vendo festgelegten Übergabeverzeichnis übereinstimmen.


Musterdatei im ERP erzeugen

Legen Sie einen im e-vendo einen Lieferschein mit einer Versandart an, welche das Versandsystem GLS verwendet.

Buchen Sie den Lieferschein und bestätigen Sie ggf. den Dialog zur Erfassung der Paketdaten durch Klick auf den Button Datei erstellen. Sichern Sie die im Übergabeverzeichnis erzeugte Datei. Diese Musterdatei kann später zum Testen und für Änderungen am Importformat verwendet werden.


Importassistent

Mit dem Importassistenten legen Sie fest, wie die durch e-vendo erzeugten Paketdaten importiert werden.

Starten Sie im GLS Gepard connect über das Menü Dienstprogramme den Importassistenten.

Legen Sie damit ein neues Importformat an:

Schritt 1
Wählen Sie als Dateiart Auftragsdaten für den Normalversand.
Schritt 2
Wählen Sie den Absender und die Quelldatei aus. Ersetzen Sie die im Dateinamen enthaltene Belegnummer durch den Platzhalter * (Poll_GLS_*.txt).
Schritt 3
Legen Sie als Dateiformat ASCII, variable Satzlänge fest.
Schritt 4
Wählen Sie als Trennzeichen das Semikolon aus (59 --> ;)
Ordnen Sie den Feldern die entsprechenden Positionen aus der Quelldatei zu. Bitte entnehmen Sie die korrekten Positionen der nachfolgenden Übersicht.
Schritt 5
Damit ist das Importformat definiert. Schließen Sie die Erstellung des Formates durch Klick auf Fertig stellen ab.


Feldzuordnung für den Import

Rückmeldeassistent

Über den Rückmeldeassistent definieren Sie den Speicherort und das Format für die durch den Tagesabschluss erstellte Rückmeldedatei.

Starten Sie den Rückmeldeassistenten über das Menü Dienstprogramme.

Schritt 1
Wählen Sie die Versandart Normalversand.
Schritt 2
Geben Sie Pfad und Dateiname für die Rückmeldedatei an.
Der Ordner für die Rückmeldedatei muss ein Unterordner des Übergabeverzeichnisses sein.
Schritt 3
Wählen Sie die Optionen
ASCII, variable Satzlänge und
Neue Daten an Datei anfügen, bestehende aktualisieren.
Schritt 4
Übergeben Sie aus dem Bereich KDPAKET die Felder ID_NR und PAKETNR in die Liste Rückmeldedatei (Reihenfolge beachten!)
Schritt 5
Klicken Sie nur auf Weiter.
Schritt 6
Klicken Sie nur auf Weiter.
Schritt 7
Für beide Felder wird in Spalte Länge der Wert 0 benötigt. Die Spalte Format/Vorgabe bleibt leer.
Wählen Sie als Trennzeichen das Semikolon (59 --> ;) aus.
Klicken Sie auf Fertigstellen.


Verwendung der Schnittstelle

Sendungen aus dem ERP exportieren

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

Der Dateiname für diese Pollingdatei lautet Poll_GLS_XXXX_Y.txt, wobei für XXXX die Belegnummer und für Y die Versionsnummer verwendet des Fakturabeleges 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:

SchnittstelleGLS.jpg

In diesem Dialog können z.B. eine andere 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 GLS Gepard connect

Bei der Paketabwicklung wird den einzelnen Versandaufträgen jeweils eine Trackingnummer zugeteilt.

Führen Sie nach der Paketabwicklung einen Tagesabschluss durch, um die Rückmeldedatei zu erzeugen. Diese wird in dem konfigurierten Ordner abgelegt.


Trackingnummernimport

Für den Trackingnummernimport werden die in GLS Gepard connect erstellten Rückmeldedateien 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 im Übergabeverzeichnis eine GLS-Rückmeldedatei bereitliegt. Ist das der Fall, so wird diese Datei sofort importiert.

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

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