Versandschnittstelle zu DHL Versenden: Unterschied zwischen den Versionen

Aus e-vendo Wiki
Wechseln zu: Navigation, Suche
Zeile 114: Zeile 114:
 
==Arbeitsfluss==
 
==Arbeitsfluss==
  
 
+
{{greybox|konfig belegvorgaben versandsysteme-dhlversenden-paketdialog.png|400|Auswahl der Paketart|*Wird ein Lieferschein gebucht, erscheint (sofern die Option ''Dialog zum Bearbeiten der Paketdaten anzeigen'' gesetzt ist) der Dialog zur Wahl der Paketart. Hier werden Service und Paketart anhand von Beleginformationen anhand des Ziellandes und der konfigurierten Paketarten automatisch vorbelegt.<br>
*Wird ein Lieferschein gebucht, erscheint (sofern die Option ''Dialog zum Bearbeiten der Paketdaten anzeigen'' gesetzt ist) der Dialog zur Wahl der Paketart.
+
*Die Paketart selbst ist abhängig von der Steuerart des Empfängers und dem Absenderland.<br>
 
+
<br>
:[[image:konfig belegvorgaben versandsysteme-dhlversenden-paketdialog.png|verweis=]]
+
{{beispiel|Absender in Deutschland, Empfänger hat die Steuerart ''EU ohne UStID''<br>
 
 
:*Hier werden Service und Paketart anhand von Beleginformationen automatisch vorbelegt.
 
:*Die Paketart selbst ist abhängig von der Steuerart des Empfängers und dem Absenderland.
 
<div style="margin-left:20px;">{{beispiel|Absender in Deutschland, Empfänger hat die Steuerart ''EU ohne UStID''<br>
 
 
> Europakaket
 
> Europakaket
 
<hr>
 
<hr>
 
Absender in Österreich, Empfänger hat die Steuerart ''Inland''<br>
 
Absender in Österreich, Empfänger hat die Steuerart ''Inland''<br>
> Paket Austria}}</div>
+
> Paket Austria}}
:*Liegt ein internationaler Versand vor, müssen im Dialogfenster die Felder ''Export-Type'', ''Beschreibung'' und ''Place of Commital'' ausgefüllt werden.<br>Zusätzlich müssen die im Beleg vorhandenen Artikel Zolltarifnummern haben. Diese werden im {{link|Artikelverwaltung - Reiter Zusatzinformation|Reiter ''Zusatzinformation''}} der Artikelverwaltung hinterlegt.
+
*Handelt es sich um einen internationalen Versand, müssen im Dialogfenster die Felder ''Export-Type'', ''Beschreibung'' und ''Place of Commital'' ausgefüllt werden. Diese Felder können in der Versandsysteme-Konfiguration (siehe oben) vorbelegt werden. Der Kasten ''internationale Sendungen'' wird entsprechend auch nur bei solchen angezeigt.<br>
:*Das Gewicht der Sendung wird standardmäßig als Summe aus den {{link|Artikelverwaltung - Reiter Zusatzinformation|Gewichten}} (Feld ''Produktgewicht'') der einzelnen Positionen gebildet, kann im Dialog aber überschrieben werden.
+
*Zusätzlich müssen die im Beleg vorhandenen Artikel Zolltarifnummern haben. Diese werden im {{link|Artikelverwaltung - Reiter Zusatzinformation|Reiter ''Zusatzinformation''}} der Artikelverwaltung hinterlegt, können aber auch nach dem Bestätigen des Paketauswahl-Dialoges eingetragen (und bei Bedarf in der Datenbank gespeichert) werden.<br>
*Wird dieser bestätigt, werden die benötigten Daten an DHL geschickt.
+
*Das Gewicht der Sendung wird standardmäßig als Summe aus den {{link|Artikelverwaltung - Reiter Zusatzinformation|Gewichten}} (Feld ''Produktgewicht'') der einzelnen Positionen gebildet, kann im Dialog aber überschrieben werden.}}
*Sofern keine Hindernisse auftreten, sendet DHL eine Trackingnummer zurück; e-vendo trägt diese in den Beleg ein.
 
*Im Anschluss öffnet sich der Acrobat Reader und zeigt den von DHL generierten Paketschein an, welcher gedruckt werden kann.
 
 
 
  
 +
{{greybox|konfig belegvorgaben versandsysteme-dhlversenden-paketdialog-services.png|400|Wahl der Services|*Je nach Paketart und konfigurierten Services werden diese im Reiter ''Services'' dargestellt und sind hier wählbar.<br>
 +
*Wird der Paketarten-Dialog bestätigt, werden die benötigten Daten an DHL gesendet.
 +
*Sofern keine Hindernisse auftreten, sendet DHL eine Trackingnummer zurück. e-vendo trägt diese in den Lieferschein ein.
 +
*Sofern in der Arbeitsplatzkonfiguration die Option ''Vor dem PDF-Druck Druckdialog anzeigen'' gesetzt ist, öffnet sich im Anschluss ein PDF-Reader und zeigt den von DHL generierten Paketschein an, welcher gedruckt werden kann. Alternativ (wenn die genannte Option nicht gesetzt ist) wird der Paketschein direkt gedruckt.
 +
<br>
 
{{info|Sofern der Ausdruck des Versandlabels nicht durchgeführt werden kann, können diese Labels bis zu 60 Tage nach deren Generierung über das Modul {{link|Versandlabel drucken (PDF)|Versandlabel drucken (PDF)}} nachgedruckt werden.
 
{{info|Sofern der Ausdruck des Versandlabels nicht durchgeführt werden kann, können diese Labels bis zu 60 Tage nach deren Generierung über das Modul {{link|Versandlabel drucken (PDF)|Versandlabel drucken (PDF)}} nachgedruckt werden.
 
<hr>
 
<hr>
 
Im Lieferschein kann über {{button-inline|Vorgang}} die Option ''Versanddaten an DHL schicken'' gewählt werden, um die Versanddaten erneut an DHL zu senden. Dabei öffnet sich wieder der Paketdialog und kann erneut ausgefüllt werden.<br>
 
Im Lieferschein kann über {{button-inline|Vorgang}} die Option ''Versanddaten an DHL schicken'' gewählt werden, um die Versanddaten erneut an DHL zu senden. Dabei öffnet sich wieder der Paketdialog und kann erneut ausgefüllt werden.<br>
{{wichtig|Bei diesem Vorgang wird ein neues Label erstellt.}}}}
+
{{wichtig|Bei diesem Vorgang wird ein neues Label erstellt.}}}}}}

Version vom 8. August 2017, 14:20 Uhr

Die Versandschnittstelle zu DHL Versenden stellt die Weiterentwicklung von DHL EasyLog und DHL Intraship dar und wird diese ablösen.



Einrichtung

Die Konfiguration der Schnittstelle zu DHL Versenden ist filialspezifisch, muss also in jeder Filiale, die mit diesem System arbeiten muss, eingerichtet werden. Um dies zu erleichtern, kann die Konfiguration kopiert werden (siehe unten).

Zusätzlich zu den in der Versandsysteme-Konfiguration vorgenommenen Einstellungen muss einer Versandart noch das Versandsystem DHL-Versenden zugewiesen werden.

Ebenfalls sollte in der Arbeitsplatzkonfiguration der PDF-Druck konfiguriert werden.

Einstellungen zum Layout des Versandlabels finden im Portal von DHL Versenden statt.


Konfiguration der Versandsysteme

Reiter Konfiguration

Konfig belegvorgaben versandsysteme-dhlversenden-konfig.png


Konfiguration kopieren

Da DHL Versenden wie erwähnt filialspezifisch konfiguriert werden muss, kann hier die Konfiguration und Servicematrix aus einer anderen Filiale kopiert werden.
Sollen die über DHL Versenden versandten Pakete filialspezifisch ausgewertet werden, empfiehlt sich die Nutzung unterschiedlicher Teilnehhmernummern (siehe unten).
Versandsystem DHL Versenden aktivieren
Aktiviert die Schnittstelle.
Dialog zum Bearbeiten der Paketdaten anzeigen
Wird diese Option aktiviert, wird bei jedem Buchen eines Lieferscheines der Dialog über die Paketartauswahl und -konfiguration eingeblendet:
Konfig belegvorgaben versandsysteme-dhlversenden-paketdialog.png
Wird diese Option nicht gesetzt, nutzt e-vendo die für den Lieferschein passende Paketart.


Debug
Diese Optionen sind vorrangig für den Support der Schnittstelle relevant.
Sandbox aktivieren
Aktiviert die Sandobx-Umgebung und leitet damit alle Anfragen an diese weiter.
Live-Accounts sind nicht mit der Sandbox kompatibel.
Für jede verschickte Sendung einen Antwortdialog einblenden
Wird diese Option gesetzt, wird bei jeder Sendung (also immer beim Buchen eines Lieferscheines mit einer Versandart, die DHL Versenden als Versandsystem hinterlegt hat) ein Antwortdialog ausgegeben.
Konfig belegvorgaben versandsysteme-dhlversenden-antwortdialog.png

Verbindung testen

Führt einen Anmeldeversuch an der DHL-Plattform durch und stellt die Ergebnisse in einem Popup dar.
Templ info-blk.png
Diese Funktion steht lediglich in der DHL-Sandbox zur Verfügung. Ein Verbindungstest in der Produktivumgebung führt zu Fehlermeldungen.


Authentifizierungsdaten
An dieser Stelle werden die von DHL zur Verfügung gestellten Daten für die Authentifizierung mit der Schnittstelle eingetragen.
DHL-Benutzername
Der von DHL für die Schnittstelle vergebene Benutzername; im Allgemeinen handelt es sich hierbei um eine Nummer.
DHL-KundenNr.
Die von DHL vergebene Kundennummer. Hierbei handelt es sich um eine zehnstellige Zahl.
DHL-Passwort
Das Passwort für die Verwendung der Schnittstelle.
DHL-TeilnehmerNr.
Mit der Teilnehmernummer lässt sich das DHL-Konto quasi in verschiedene Teile splitten, die unabhängig voneinander ausgewertet werden können.
In dieses Feld muss mindestens 01 eingetragen werden. Eine zweite Filiale kann bspw. den Wert 02 enthalten.


Vorbelegung

Hier können Vorbelegungen für den Paketdialog vorgenommen werden. Diese können trotzdem im Dialog selbst noch bearbeitet werden.

Allgemein
Default-Gewicht
Lässt den Nutzer ein Standardgewicht festlegen, welches immer in den Paketdatendialog eingetragen wird, wenn der Beleg selbst kein Gewicht hat.
Das Default-Gewicht gilt hier als Fallback, welcher dann herangezogen wird, wenn keine Position im Beleg ein Gewicht besitzt. Sobald bereits eine der Belegpositionen ein Gewicht hat, wird das Default-Gewicht ignoriert.
Internationale Sendungen
In diesem Kasten kann eine Voreinstellung für internationale Sendungen definiert werden; es empfiehlt sich also, den am häufigsten auftretenden Exporttyp und dessen weitere Daten hier festzulegen.
Die in die einzelnen Felder einzufügenden Daten können beim DHL-Betreuer erfragt werden.


Reiter Services

Konfig belegvorgaben versandsysteme-dhlversenden-services.png


In diesem Reiter werden vertikal die für DHL Versenden verfügbaren Paketarten dargestellt, während auf der horizontalen Achse spezielle Funktionen der einzelnen Paketarten verzeichnet sind.

Wird für eine Paketart keine Checkbox angezeigt, bedeutet dies, dass diese spezifische Kombination nicht von DHL angeboten wird.

Sollen angebotene Funktionen (also diejenigen, bei denen eine Checkbox vorhanden ist) angeboten werden, so muss die entsprechende Checkbox aktiviert (also mit einem Haken versehen) werden.

Templ info-blk.png
Da sich die Schnittstelle zu DHL Versenden noch in Entwicklung befindet, sind die derzeit unterstützten Funktionen über der Tabelle notiert.

Aktuell sind die folgenden Services realisiert:

  • Nachnahme
  • Sperrgut
  • Versandbestätigung
  • Packstation

Der Service DHL Express wird seitens DHL mit der Migration zu dieser Schnittstelle durch DHL Taggleich ersetzt.


Arbeitsfluss

Vorlage:Greybox

Vorlage:Greybox