DHL-Plugin for NopCommerce 3.60, 3.70, 3.80 Installation: Achtung: Das Plugin erstellt eine neue Tabelle DHLShippingRecord in der Datenbank, bei Deinstallation des Plugins wird die Tabelle ebenfalls gelöscht. Wir empfehlen daher ein Backup der Datenbank vor Installation und vor einer Deinstallation vorzunehmen. 1. Zip-Archiv öffnen und in entsprechendes NopCommerce-Version Verzeichnis navigieren und den kompletten Inhalt in den /Plugins Ordner der NopCommerce-Installation kopieren. 2. Im Admin-Backend Konfiguration Plugins Lokale Plugins Installieren 3. Konfigurieren Deinstallation: 1) Konfiguration -> Plugins -> Lokale Plugins -> DHL Plugin -> Uninstall Configuration: AppID / App-Token = muss unter http://entwickler.dhl.de erstellt werden. Cig Benutzername = Benutzername des DHL-Geschäftskundenportals Cig Passwort = Passwort DHL-Geschäftskundenportal Benutzername und Passwort Sendungsverfolgung = Benutzername Sendungsverfolgung (Im DHL-GKP unter Meine Daten Verfolgen ), muss ebenfalls durch DHL freigeschaltet sein (ZT-Kennung mit DASS-Aufschaltung) Strasse/Hausnummer/Stadt/PLZ = Ihre Versandadresse Country Code = Bitte im Two-Letter-Codeformat angeben (DE,US,EN...) Firmenname/Kontakt E-Mail/Name des Kontakt/Kontakt Telefon = Ihre Firmendaten aktiviere Sandbox-Modus = Sandbox-Modus für Versand und Tracking aktivieren Hinweis: Für die Aktivierung des Sandbox-Modus werden Zugangsdaten zum DHL-
Entwicklerportal (https://entwickler.dhl.de) benötigt. Die Zugangsdaten zum DHL-Entwicklerportal werden dann bei Cig-Username/Passwort und Benutzername/Passwort Sendungsverfolgung gesetzt. Endpunkt-Adresse Sandbox = wenn keine eigene URL von DHL beantragt wurde, https://cig.dhl.de/services/sandbox/soap Endpunkt-Adresse Produktiv = https://cig.dhl.de/services/production/soap EKP = die ersten 10 Stellen Ihrer Abrechnungsnummer bzw. Ihre DHL-Kundenummer. Die Abrechnungsnummer setzt sich wir folgt zusammen: Der DHL-Produktcode entspricht der Auswahl unter Manage Shipment Create Shipment Pakettyp und muss nicht weiter berücksichtigt werden. Da unter einer EKP (DHL Kundennummer) mehrere Verträge verwaltet werden können, wird hiermit der zu verwendende Vertrag ausgewählt Die Partner-ID (Teilnehmernummer) kann für Paket, Weltpaket und Express unterschiedlich sein Standard Partner-ID festlegen = Falls nicht mehrere Verträge oder Paketdienste verwendet werden. kann hier eine Standard Partner-ID festgelegt werden. Wenn nichts gesetzt wird muss eine manuelle Eingabe beim Anlegen eines Versandauftrags erfolgen. DHL E-Mail-Benachrichtigungen aktivieren = Wenn aktiviert wird der Empfänger automatisch von DHL über eine erfolgreich erstellte Sendung informiert. Dazu muss der Empfänger bei der Bestellung über Ihren NopCommerce-Shop eine E-Mail Adresse angegeben haben. Label (PDF) in Datenbank speichern = Wenn aktiv, wird das Versandlabel nach Abruf durch Manage Shipment Shipments Get Label in der Datenbank gespeichert. Label (PDF) in Dateisystem speichern = Wenn aktiv, wird das Versandlabel nach Abruf durch Manage Shipment Shipments Get Label im Dateisystem des Webservers gespeichert. Der Dateisystem Pfad lautet dann z.b ~/DHL_Labels. Bankdaten aktivieren = Wenn z.b. Nachnahme als Service gebucht wurde werden die gesetzten Daten für die Überweisung auf das angegebene Konto verwendet. DHL Scheduled Task Das Plugin installiert automatisch einen Zeitplandienst um den Sendungsstatus der erstellten Versandaufträge zu aktualisieren.
Der DHL Tracking Task kann im Admin-Backend unter System Zeitplandienst (Scheduled Task) konfiguriert werden. Standardmäßig ist er aktiviert und wird alle 60 Minuten ausgeführt. Hinweis: Bitte beachten Sie das max. pro Tag (zwischen 0:00 und 23:59 Uhr) 1.000 Abfragen mit insgesamt 10.000 Sendungen abgerufen werden können. Übersicht verfügbare DHL-
Produkte/Kombinationen * diese Services werden standardmäßig für die Abrechnungsnummer aufgeschalten ** für die Transportversicherung wird immer der Versicherungsbetrag angegeben *** der maximale Nachnahmewert hängt vom Zielland ab How To Use? Admin Area DHL Business Bestellungen Übersicht Manage Shipment Manage Shipment 1) Gewünschte Einstellungen setzen (entsprechende Services müssen bei DHL-Geschäftskunden freigeschaltet sein) Wichtig: Gewicht des Pakets in KG (mit Komma trennen, max. 2 Nachkommastellen)
2) Bei Betätigen von Create Shipment wird der Versandauftrag an DHL versendet und das Versandlabel in Form einer PDF im Browser geöffnet. Shipments Select Shipment Versandauftrag selektieren für evtl. Änderungen Label ist nur aktiv wenn das Versandlabel erfolgreich erstellt wurde, gleiches gilt für Retoure, Export und Cash-On-Delivery-Labels Update Shipment Versandauftrag aktualisieren Delete Shipment Versandauftrag löschen Get Label from DHL und Get Export Docs Falls bei Create Shipment das automatische Öffnen und speichern fehlschlägt, kann über Get Label from DHL ein erneuter Versuch gestartet werden. Get Trackingstatus Durch Betätigen kann der aktuelle Sendungsstatus unabhängig vom DHL Tracking Task Scheduler manuell abgerufen werden.