DHL Easylog: Unterschied zwischen den Versionen

Aus Mauve System3 Handbuch
Zur Navigation springen Zur Suche springen
 
(82 dazwischenliegende Versionen von 5 Benutzern werden nicht angezeigt)
Zeile 2: Zeile 2:
 
__TOC__
 
__TOC__
  
In diesem Artikel finden Sie die Beschreibung der '''Easylog'''-Schnittstelle. Informationen zu '''Intraship''' finden sie [[DHL Intraship|hier]].
+
Die Easylog-Schnittstelle ist Mitte 2021 entfernt worden, da die DHL diese Schnittstelle nicht mehr unterstützt.<br>
 
 
== Einstellungen ==
 
 
 
Den Dialog '''DHL-Einstellungen''' erreichen Sie über den Menüpunkt '''Ware/M-DHL/Einstellungen'''.
 
 
 
[[Bild:DHLEinstellungen.png|frame|none|DHL Einstellungen]]
 
 
 
 
 
Hier nehmen Sie die grundlegenden Einstellungen für die DHL-Easylog-Schnittstelle vor.
 
 
 
* Im Bereich '''Easylog''' geben Sie die Pfade für den Export und den Import der Dateien an.
 
** In den '''Importpfad''' schreibt '''Mauve System3''' die Paketdaten, die über die Pollingschnittstelle von Easylog importiert werden sollen.
 
** Im '''Exportpfad''' erwartet Mauve System3 die von Easylog exportierten Daten mit den erzeugten Paketnummern.
 
* Informationen zum Bereich '''Intraship''' finden Sie im Artikel [[DHL Intraship]].
 
* '''Standort''' Wenn Ihre Easylog-Schnittstelle so eingerichtet ist, dass standortspezifische Teilnahmen verwendet werden müssen (d.h. derselbe Easylog-Mandant in verschiedenen Easylog-Installationen verwendet werden soll) müssen Sie sich die [[DHL Standorteinstellungen]] durch den '''Mauve System 3''' Support einrichten lassen.
 
* Im Bereich '''Mandanten''' geben Sie die mandantenspezifischen Informationen ein
 
** '''Mandant''' Der [[Referenzlisten#Mandanten|System3-Mandant]], dessen DHL-Einstellungen aktuell bearbeitet werden. Beim Wechseln des Mandanten werden die Einstellungen automatisch gespeichert.
 
** '''Absender-Referenznummer''' - Die in Easylog hinterlegte Absender-Referenznummer. Diese finden Sie in Easylog unter dem Menüpunkt '''Daten/Stammdatenverwaltung''' im Bereich '''Absenderadressen'''.
 
** '''Mandant-Referenznummer''' - Die in Easylog hinterlegte Mandant-Referenznummer. Diese finden Sie in Easylog unter dem Menüpunkt '''Daten/Stammdatenverwaltung''' im Bereich '''Mandanten'''.
 
** '''Kundennummer/EKP''' - Hier geben Sie die DHL-EKP-Nummer ein. ''Diese Einstellung ist nur für [[DHL Intraship]] notwendig.''
 
** '''Verfahren und Teilnahmen''' - Geben Sie hier die von der DHL für Sie freigeschalteteten Verfahren mit den zugehörigen Teilnahme-Nummern an.
 
** '''Standardgewicht'''
 
*** '''Inland''' - Wenn Sie hier einen anderen Wert als 0 angeben, wird im nationalen Verfahren immer dieses Gewicht an Easylog übergeben.
 
*** '''Ausland''' - Wenn Sie hier einen anderen Wert als 0 angeben, wird in den internationalen Verfahren immer dieses Gewicht an Easylog übergeben.
 
* Im Bereich '''Abholaufträge''' können Sie die [[DHL Abholaufträge#Einstellungen|DHL Abholaufträge konfigurieren]]
 
* Im Bereich '''Track and Trace''' geben Sie den Benutzernamen und das Passwort für Track and Trace an.
 
 
 
== Definition von Versandarten für Easylog ==
 
 
 
# Wählen Sie den Menüpunkt '''Referenzlisten/Versandart''' aus.
 
# Legen Sie dort eine neue [[Referenzlisten#Versandart|Versandart]] an.
 
# Wählen Sie für diese einen [[DHL-Service]] aus.
 
# Weisen Sie zusätzlich '''DHL Easylog''' als Versandsoftware zu.
 
# Wenn Sie eine individuelle Teilnahme, z.B. die  <code>09</code> für diese Versandart angeben möchten, dann tragen Sie <code>@TEILNAHME=09@</code> in das Feld '''Zusatzdaten''' ein.<br>In aller Regel müssen Sie keine individuelle Teilnahme definieren, dann wird die Teilnahme aus dem zugeordneten Verfahren genommen.
 
 
 
== Paketscheine bei Easylog anfordern ==
 
Wenn aus der Belegliste, dem Modul M-Itemcheck oder aus dem Beleg (F8) heraus der Paketscheindruck angestoßen wird, erzeugt Mauve System3 einen Paketscheindatensatz, der von Easylog über das Importverzeichnis (Pollingverzeichnis) aufgenommen wird. Nach Prüfung der Daten wird ein Versandaufkleber ausgedruckt.
 
 
 
Falls Easylog in einer Netzwerkversion betrieben wird, damit an mehr als einem Arbeitsplatz Paketscheine ausgedruckt werden können, empfiehlt sich folgendes Vorgehen:
 
 
 
Auf allen Arbeitsplätzen werden identische lokale (Import-)Verzeichnisse angelegt, z.B. C:\polling. Dieses Verzeichnis wird in Easylog als Pollingverzeichnis konfiguriert. Der lokale Easylog-Client schaut dann in "seinem" Pollingverzeichnis nach Paketscheinanforderungen und erzeugt lokal einen Paketschein, sobald eine Anforderung vorliegt. Da die Pollingverzeichnisse stets den gleichen Namen haben, läßt sich eine Erweiterung des Rechnerparks ohne weitere Änderungen in Easylog leicht vornehmen.
 
 
 
== Paketnummern aus Easylog-Export einlesen ==
 
 
 
Damit die von Easylog erzeugten Paketnummern in '''Mauve System3''' eingelesen werden können, muss Easylog so eingestellt werden, dass es die Sendungen beim Abschluß exportiert.
 
Dazu wählen Sie in Easylog den Menüpunkt '''System/Grundeinstellungen''' aus. Es wird der Dialog '''Grundeinstellungen''' angezeigt.
 
Wählen Sie dort den Reiter '''Export abgeschlossener Sendungen''' aus.
 
[[Bild:EasylogExportAbgeschlossenerSendungen.png|none|thumb|Easylog-Dialog: Export abgeschlossener Sendungen|300px]]
 
Haken Sie die Checkbox '''Export der Sendungen beim Sendungsabschuß''' an.
 
Wählen Sie als '''Dateityp''' das Format '''Text mit Trennzeichen''' aus.
 
Als '''Exportverzeichnis''' geben Sie das Verzeichnis an, welches Sie in den M-DHL-Einstellungen als Easylog-Exportverzeichnis definiert haben.
 
 
 
Wechseln Sie dannach zum Reiter '''Exportdatei-Einstellungen'''.
 
[[Bild:EasylogExportDateiEinstellungen.png|none|thumb|Easylog-Dialog: Exportdatei-Einstellungen|300px]]
 
Haken Sie die Checkbox '''Zeilenende-Zeichen in Exportdatei ersetzen''' an.
 
Geben Sie in das Textfeld '''Zeilenende-Zeichen eingeben oder auswählen''' das Zeichen '''~''' (Tilde) ein.
 
 
 
 
 
Nachdem Sie die Sendungen in Easylog abgeschlossen haben, können Sie die Paketnummern der von Easylog verarbeiteten Paketscheine in Mauve System3 einlesen. Dazu klicken Sie auf den Menüpunkt '''Ware/M-DHL/Paketnummern importieren (Easylog)'''.
 
 
 
Das in den DHL-Einstellungen als Easylog-Exportpfad angegebene Verzeichnis wird nach Dateien, die der Maske '''ELSendEx*.txt''' entsprechen, durchsucht.
 
 
 
Wenn die Aktualisierung der Paketscheine abgeschlossen ist, wird eine Meldung ausgegeben. Treten während der Aktualisierung Fehler auf, wird diese abgebrochen und die Fehlermeldung angezeigt.
 
 
 
 
 
== Datenübergabeformat Mauve System3-Easylog ==
 
 
 
Format: Textdatei mit Trennzeichen
 
 
 
{|  border="1" cellpadding="5" cellspacing="0"
 
|'''Nr'''
 
|'''Easylog-Feldname''' (aus Pollingschnittstelle)
 
|'''Bezeichnung in der Easylog-Oberfläche'''
 
|'''Bemerkung'''
 
|-
 
|1
 
|POOL_REFNR
 
|Sendungs Ref.-Nr.
 
|Paket-Referenznummer (BelegNr + '~' + PaketscheinID, z.b. '000001-B~123') > Extrem wichtig zu beachten!
 
|-
 
|2
 
|POOL_V_ABS_REFNR
 
|Abs. Ref-Nr.
 
|aus DHL-Mandant
 
|-
 
|3
 
|POOL_V_MAND_REFNR
 
|Mand. Ref-Nr.
 
|aus DHL-Mandant
 
|-
 
|4
 
|POOL_V_VERFAHREN
 
|Verfahren
 
|aus Versandservice
 
|-
 
|5
 
|POOL_V_TEILNAHME
 
|Teilnahme
 
|aus DHL-Mandant
 
|-
 
|6
 
|POOL_V_PRODUKT_CN
 
|Produkt
 
|aus Versandservice
 
|-
 
|7
 
|POOL_V_EXTRASLST
 
|Serviceliste
 
|aus Versandservice, Beleg
 
|-
 
|8
 
|POOL_V_NN_WAEHRUNG
 
|NN Währung
 
|aus Beleg
 
|-
 
|9
 
|POOL_WERT_WAEHRUNG
 
|TV Währung
 
|aus Beleg
 
|-
 
|10
 
|POOL_EMPF_NAME1
 
|Empf. Name1
 
|aus Adresse
 
|-
 
|11
 
|POOL_EMPF_NAME2
 
|Empf. Name2
 
|aus Adresse
 
|-
 
|12
 
|POOL_EMPF_NAME3
 
|Empf. Name3
 
|aus Adresse
 
|-
 
|13
 
|POOL_EMPF_PLZ
 
|Empf. PLZ
 
|aus Adresse
 
|-
 
|14
 
|POOL_EMPF_ORT
 
|Empf. Ort
 
|aus Adresse
 
|-
 
|15
 
|POOL_EMPF_STRASSE
 
|Empf. Strasse
 
|aus Adresse
 
|-
 
|16
 
|POOL_EMPF_HAUSNR
 
|Empf. Hausnr.
 
|aus Adresse
 
|-
 
|17
 
|POOL_EMPF_LANDCODE
 
|Empf. Land
 
|aus Adresse, ISO 3166 A2
 
|-
 
|18
 
|POOL_GEWICHT
 
|Empf. Gewicht
 
|aus Beleg
 
|-
 
|19
 
|POOL_V_ZOLL_WARENLISTE
 
|Zollinhaltserklärung
 
|aus Details-Dialog beim Paketscheindruck
 
|-
 
|20
 
|POOL_CONTENTS
 
|Inhalt
 
|Inhalt des Paketes für DHL EUROPACK-Sendungen aus Details-Dialog beim Paketscheindruck
 
|-
 
|21
 
|POOL_VERWENDUNGSZWECK
 
|Verwendungszweck
 
|Verwendungszweck für Beleglose Nachnahme aus Details-Dialog beim Paketscheindruck
 
|-
 
|22
 
|POOL_EMPF_TEL
 
|Empf. Tel.
 
|Telefonnummer aus Kommunikation
 
|-
 
|23
 
|POOL_EMPF_FAX
 
|Empf. Fax.
 
|Faxnummer aus Kommunikation
 
|-
 
|24
 
|POOL_EMPF_EMAIL
 
|Empf. Email.
 
|E-Mail-Adressse aus Kommunikation
 
|-
 
|25
 
|POOL_EMPF_BEMERKUNG oder POOL_VERWENDUNGSZWECK
 
|Auftragsnummer
 
|aus Beleg
 
|-
 
|26
 
|POOL_EMPF_REFNR
 
|Empf. Ref-Nr.
 
|''Kundennummer'' aus Adressen
 
|-
 
|27
 
|POOL_EMPF_ORTTEIL
 
|Ortsteil des Empfängers
 
|''Ortsteil'' aus Adressen
 
|-
 
|28
 
|POOL_EMPF_BEMERKUNG oder POOL_VERWENDUNGSZWECK
 
|Belegnummer
 
|''BelegNr'' aus Beleg
 
|-
 
|29
 
|POOL_EMPF_BEMERKUNG oder POOL_VERWENDUNGSZWECK
 
|Artikelnummer(n) des Belegs
 
|''ArtikelNr'' aus Artikel<br>''Diese Funktion steht erst ab Release 1.8.4. zur Verfügung''.
 
|-
 
|30
 
|
 
|
 
|
 
|}
 
 
 
== Konfiguration der Import-Schnittstelle in Easylog ==
 
 
 
Um eine Vorlagendatei für die Easylog-Pollingschnittstelle zu erzeugen, weisen Sie einem Beleg eine DHL-[[Referenzlisten#Versandart|Versandart]] zu. Drucken Sie dannach für diesen Beleg einen Paketschein aus. Es wird eine Textdatei, die der Maske '''DHL_*.txt''' entspricht im Easylog-Importpfad angelegt.
 
 
 
Wechseln Sie dannach ins Easylog. Wählen Sie dort den Menüpunkt '''System/Pollingeinstellungen'''. Es wird der Dialog '''Polling-Übersicht''' angezeigt.
 
 
 
[[Bild:EasylogPollingUebersicht.png|none|thumb|Easylog: Polling-Übersicht(Version 6.1.0.18)|240px]]
 
 
 
Wählen Sie dort die Konfiguration aus, die Sie bearbeiten möchten, oder legen Sie eine neue Konfiguration an.
 
 
 
Es wird der Dialog '''Polling-Einstellungen''' angezeigt.
 
 
 
[[Bild:EasylogPollingEinstellungen.png|none|thumb|Easylog: Polling-Einstellungen (Version 6.1.0.18)|240px]]
 
 
 
# Geben Sie eine '''Bezeichnung''' für die Pollingkonfiguration an.
 
# Wählen Sie als '''Datenquelle''' '''ASCII Zeichengetr Datei (*.*)'''.
 
# Wählen Sie die Checkbox '''Platzhalter (Counter) benutzen''' an.
 
# Wählen Sie die durch Klick auf den Button '''...''' die erzeugte Textdatei als '''Datei''' aus. Diese besitzt den Namen ''DHL_001.TXT'' .
 
# Dannach wird nur ein Feld in der Liste '''Quelldatenfelder''' angezeigt. Damit die Felder in der Übergabedatei von Easylog richtig erkannt werden, muss diesem das verwendete Trennzeichen mitgeteilt werden. Dabei sollten Sie auch noch weitere Details einstellen:<br>Dazu klicken Sie auf den Button '''Optionen'''.
 
## Es wird der Dialog '''Konfiguration der Polling - Datenquelle''' angezeigt.<br>[[Bild:EasylogKonfigurationPollingDatenquelle.png|none|frame|Easylog: Konfiguration der Polling - Datenquelle (Version 6.1.0.18)]]
 
## Tragen Sie unter Landkennung '''ISO-Länderkennzeichen (alp.2)''' ein.
 
## Als Gewichtseinheit wählen Sie '''kg''', als Dezimaltrennzeichen ''',''',  als Datumsformat '''dd.mm.yy'''.
 
## Als Wert-Trennzeichen geben Sie ''';''' ein
 
## Als Feld-Trennzeichen  geben Sie '''|''' ein.
 
## Verlassen Sie den Dialog über '''Speichern'''
 
# Dannach werden die Felder in der Übergabedatei richtig erkannt.
 
# Weisen Sie im Dialog '''Polling-Einstellungen''' die entsprechenden Felder gemäß der o.a. Tabelle zu.
 
# Wenn Sie den Dialog '''Polling-Einstellungen''' über '''Speichern''' verlassen, wird der Dialog '''Platzhalter-Konfiguration''' angezeigt. Geben Sie dort in das Feld '''Dateiname''' den Text ''DHL_*.TXT'' ein.
 
  
 +
Verwenden Sie für den Paketscheindruck für die DHL am besten die [[DHL Geschäftskundenversand API]].<br>
 +
Alternativ steht auch [[DHL Versenden]] zur Verfügung.
  
 +
<br style="clear:both" />
  
 
----
 
----
 
:''Siehe auch:  
 
:''Siehe auch:  
 +
:'' [[M-DHL]]
 
:'' [[Einrichtung von Paketdiensten]]
 
:'' [[Einrichtung von Paketdiensten]]
 
:'' [[Paketdienste]]
 
:'' [[Paketdienste]]
:'' [http://www.dhl.de/dhl?xmlFile=1225 Easylog]
 
 
  
[[Category:Module]]
 
 
[[Category:Mauve System3]]
 
[[Category:Mauve System3]]
 +
[[Category:Paketdienste]]

Aktuelle Version vom 12. Oktober 2021, 15:54 Uhr

Module.png


Die Easylog-Schnittstelle ist Mitte 2021 entfernt worden, da die DHL diese Schnittstelle nicht mehr unterstützt.

Verwenden Sie für den Paketscheindruck für die DHL am besten die DHL Geschäftskundenversand API.
Alternativ steht auch DHL Versenden zur Verfügung.



Siehe auch:
M-DHL
Einrichtung von Paketdiensten
Paketdienste