Projekt

Allgemein

Profil

Wiki »


Wunschpaket Oxid Modul

Dokumentation

ab Modul Version: 2.1.0
Shopversion: OXID ab 4.7/5.0

1. Funktionsumfang

Dieses Modul ermöglicht Ihren Kunden einen zeitlich unabhängigen und örtlich flexiblen Empfang von Paketen. Dabei integriert das Modul die Suche nach Packstationen und Filialen (in Deutschland) in Ihren Shop und ermöglicht Ihren Kunden Pakete wann und wo Sie möchten zu empfangen.

Folgende Services bietet das Modul DHL Wunschpaket:

  • Suche nach Filialen und Packstationen
  • Angabe eines Wunschtags bzw. einer Wunschzeit
  • Angabe eins Wunschorts oder -nachbars

  

2. Support

Der First-Level-Support wird von DHL und der Second-Level-Support von mediaopt übernommen. Daher bitten wir Sie, Ihre Support-Anfrage an DHL zu richten. Nutzen Sie dafür die folgende E-Mail-Adresse: shopsoftware@deutschepost.de.

3. Installation

Vor einer Neuinstallation sichern Sie bitte die Daten Ihres Shops. Sollten Sie ein Update vornehmen wollen und das Modul zuvor individuell angepasst haben, sichern Sie bitte Ihre Änderungen. 
Sollten Sie Bedenken bezüglich der Installation des Moduls haben, lassen Sie diese von fachkundigem Personal vornehmen; gerne unterstützen wir Sie dabei. Dieses Modul wurde für die OXID Shop Editionen CE, PE, EE unter den o.g. Versionen entwickelt. Folgen Sie der Anleitung für einen problemlosen Betrieb. Sollte es Unklarheiten in den Installationsanweisungen geben, freuen wir uns über Ihr Feedback (support@mediaopt.de).

3.1 Dateien kopieren

  • Stellen Sie eine Verbindung z.B. via FTP zu Ihrem Webserver her.
  • Kopieren Sie den Inhalt des Verzeichnisses copy_this in das Stammverzeichnis ihres Shops.

Neu: Ab Version 2.1.0 unterstützt das Modul neben dem Azure Thema auch das Flow-Theme.

3.2 Modul aktivieren

Aktivieren Sie das Modul über die OXID Modulverwaltung.
 

Im Normalfall befindet sich in der Datei /modules/functions.php die folgende Zeile:

require_once __DIR__ . '/mo/mo_empfaengerservices/bootstrap.php';

Sollte diese Zeile nicht existieren, fügen Sie diese hinzu.

3.3 Schreibrechte für die Logdatei

Zur Ablauf- und Fehlerdiagnostik protokolliert das Modul Ereignisse in Dateien mit dem Präfix "mo_emfpaengerservices" im Ordner "/log". Stellen Sie daher bitte sicher, dass diese Dateien erstellt und bearbeitet werden können. Die Dateiberechtigungen können bspw. mit einem FTP-Client verwaltet werden.

3.4 Eintragen des API-Schlüssels für Google Maps

Siehe Google Maps-Einstellungen.

3.5 Gewählte Wunschpaketservices in Bestätigungsmail anzeigen

In der E-Mail zur Bestellbestätigung werden die Wunschpaket-Informationen standardmäßig entfernt.
Die Informationen werden in die Smarty-Variablen moEmpfaengerservicesPreferredTime, moEmpfaengerservicesPreferredLocation, moEmpfaengerservicesPreferredNeighbour bzw. moEmpfaengerservicesPreferredDay geschrieben.
Bei Bedarf können die Informationen hiermit in das gewünschte E-Mailtemplate wieder eingebunden werden.

4. Konfiguration

Die Angabe der DHL Kundennummer (EKP) ist erforderlich, um das DHL-Wunschpaket gemäß den Gegebenheiten in Ihrer Region anbieten zu können.

Damit das Modul eingesetzt werden kann, muss ein gültiger API-Schlüssel für Google Maps vorliegen (vgl. Google Maps-Einstellungen).
Außerdem muss, da dieses Modul für Packstationen und Filialen vorgesehen ist, eine Lieferung nach Deutschland möglich sein.

4.1 Standortsuche

  • Maximale Trefferanzahl: Hier können Sie die maximale Anzahl an Treffern eines Suchergebnisses auswählen.
  • API-Schlüssel: Dieses Modul nutzt Google Maps um die Suchergebnisse darzustellen. Daher ist es erforderlich, einen API-Schlüssel für Google Maps zu erzeugen und diesen unter dem Punkt "Standortsuche" einzutragen. Weitere Informationen zur Erzeugung eines solchen Schlüssels finden Sie unter dem folgenden Link: https://developers.google.com/maps/documentation/javascript/get-api-key?hl=de#key
  • Sofern Sie Ihren Kunden den Direktversand an Postfilialen oder Paketshops anbieten möchten, beachten Sie bitte folgenden Passus der Leistungsbeschreibung von DHL Paket (Anlage zum Geschäftskundenvertrag): „Der Absender stellt sicher, dass er berechtigt ist, der DHL die E-Mail-Adressen seiner Kunden zum Zwecke der Paketankündigung zu übergeben.

4.2 Wunschpaket

Hier können Angaben zu Uhrzeiten und Aufpreisen gemacht werden.

Berechnung angezeigter Wunschtage im Frontend

Der Wunschtagliegt zum Zeitpunkt der physischen Übergabe der Sendung an DHL mindestens zwei und maximal 6 Werktage in der Zukunft und darf kein Sonn- oder Feiertag sein.

Cut-off time
Die Cut-off time bestimmt den Zeitpunkt, zu dem eine Sendung noch am selben Tag physisch bei DHL eingeliefert resp. von DHL abgeholt werden kann. Wurde die Cut-off time zum Zeitpunkt der Bestellung im Shop überschritten, wird dieser Tag bei der Berechnung des ersten möglichen Wunschtages nicht berücksichtigt. Der frühstmögliche angezeigte Wunschtag im Frontend ist somit vor der Cut-off time der Bestelltag + zwei Werktage, nach der Cut-off time der Bestelltag + drei Werktage.

Bearbeitungszeit
Wurde im Backend eine Bearbeitungszeit (preparation time for deliveries) zwischen einem und drei Werktagen eingestellt, verschiebt sich der Tag der physischen Übergabe an DHL um die Anzahl der hier konfigurierten Werktage. Von diesem Übergabetag ausgehend liegen die im Frontend angezeigten Werktage mindestens zwei und maximal 6 Werktage in der Zukunft. Die Voreinstellung der Bearbeitungszeit ist 0.

Ausgeschlossene Tage zur physischen Übergabe an DHL
Im Backend besteht die Möglichkeit, standardmäßig bestimmte Wochentage für die physische Übergabe des Pakets an DHL auszuschließen, falls beispielsweise samstags nie eine Abholung oder Einlieferung stattfindet. An den optional auszuwählenden Werktagen findet also (zusätzlich zu Sonn- und Feiertagen) keine Übergabe von Paketen an DHL statt. Diese Angabe wird in die Berechnung der angezeigten Wunschtage im Frontend einbezogen.

Lieferzeit
Die zu den Artikeln in Shopware hinterlegte Lieferzeit findet keinen Eingang in die Berechnung des frühestmöglichen Wunschtages. Besonders hohe Lieferzeiten können jedoch bewirken, dass die Wunschtag-Option nicht angeboten werden kann.

Werktage
Als Werktage gelten die Tage von Montag bis Samstag, Sonntage und bundesweite Feiertage werden bei der Bearbeitungszeit und der Berechnung möglicher Wunschtage übersprungen.

Frontend
Die Darstellung im Frontend beginnt mit dem ersten möglichen Wunschtag und umfasst die darauffolgenden vier Tage; Sonn- und Feiertage werden hier nicht angezeigt.

4.3 Absenderdaten für CSV-Export

Hier können Sie die Absenderdaten für den CSV-Export aus Ihrem System eintragen. Die Sendungsdaten können Sie zur Weiterverarbeitung auf der DHL Geschäftskundenportal importieren.

4.4.  Verfahrens- und Teilnahmenummern

Verfahren: dieses bezeichnet DHL Produkte, die für den Versand genutzt werden. Nähere Informationen zum Thema DHL Produkte finden Sie hier.

Teilnahme-Nummer: diese ermöglicht die Untergliederung von Abrechnungen nach Standorten, Saisongeschäft oder unterschiedlichen Konditionen. Auch der umweltfreundliche Versand mit GoGreen wird als separate Teilnahme hinterlegt. Die Teilnahme ist 2-stellig numerisch von 00 bis 99 oder alphanumerisch von AA bis ZZ. Sie wird vom DHL Vertrieb vergeben. Zu jedem DHL Produkt (Verfahren) kann ein Händler ein oder mehrere Teilnahmen verwenden. Es empfiehlt sich daher, dass die Anzahl der Teilnahmen bei der Konfiguration der Schnittstelle variabel zu halten.

4.5 Ausschluss von Zahl- und Versandarten

Da ein an eine Packstation oder Filiale adressiertes Paket nur von DHL zugestellt werden kann, kann man Versandarten ausschließen, falls die Lieferadresse eine Packstation oder Filiale ist. Dazu hakt man das jeweilige Kontrollkästchen ab. Analogerweise kann man auch Zahlarten ausschließen. Wir empfehlen, bei Verwendung des Wunschpaket Plugins die Zahlarten "Nachnahme" und "Vorauskasse" zu deaktivieren, da "Nachnahme" mit Wunschort und Packstation nicht kompatibel und "Vorauskasse" nicht mit dem Wunschtag kompatibel ist.

Hinweis: Versandkostenregeln können Produkte und Kategorien zugeordnet werden.
Ohne eine manuelle Zuordnung von Produkten oder Kategorien, werden implizit alle Produkte und Kategorien einer Versandkostenregel zugeordnet.
Um den Ausschluss von Versandarten für das DHL Wunschpaketmodul sicherzustellen, sollte jeder Versandkostenregel, welche ausschließlich zum Versand via DHL gehört, mindestens ein Produkt oder eine Kategorie zugeordnet sein.

4.6 Separate Deaktivierbarkeit

Alle Services lassen sich einzeln aktivieren resp. deaktivieren. So können Sie sicherstellen, dass bspw. sensible Bestellungen bei der Zustellung in die richtigen Hände gelangen oder große Warensendungen nicht an Packstationen versendet werden.

4.7 Logging

Jeder auftretende Fehler wird in Logdateien protokolliert (Loglevel: ERROR). Falls sie zusätzliche Informationen benötigen, können Sie das Loglevel INFO wählen. Für die Fehlerbehebung empfiehlt sich das Loglevel DEBUG anzuheben. Diese Logdateien können Sie selbstverständlich herunterladen indem Sie auf den Namen der Logdatei klicken.

4.8 Tracking

Bitte beachten Sie, dass das Plugin zu Reportingzwecken ein Tracking-Pixel enthält.
Das Pixel trackt die Shop-URL und zählt die gebuchten Wunschpaketservices.
Hiermit werden keine personenbezogenen und personenbeziehbare Daten erhoben oder verarbeitet.
Um den jeweiligen Tracking-Mechanismus zu deaktivieren, muss der Inhalt der Datei  "views/blocks/base_js.tpl" bzw. "views/blocks/head_meta_robots.tpl" durch [{$smarty.block.parent}] ersetzt werden.

4.9 E-Mails mit Informationen zu ausgewählten Wunschpaket-Features

Standardmäßig werden die Informationen zu Wunschtag, Wunschzeit, Wunschort und Wunschnachbar in versendeten E-Mails nicht dargestellt. Sie können allerdings über die Variable moEmpfaengerservicesPreferredTime, moEmpfaengerservicesPreferredLocation, moEmpfaengerservicesPreferredNeighbour bzw. moEmpfaengerservicesPreferredDay in das entsprechende E-Mail-Template integriert werden.

5. CSV-Export

Beim CSV-Export werden die ausgewählten Bestellungen als CSV-Datei exportiert, die dann im Geschäftskundenportal importiert werden kann.
Die Sendungsdaten in der CSV-Datei enthalten, wenn möglich, eine Abrechnungsnummer.
Diese Abrechnungsnummer setzt sich aus der EKP, einer Verfahrens- und einer Teilnahmenummer zusammen.
Die EKP wird global gesetzt; Verfahrens- und Teilnahmenummern werden mit Versandarten verknüpft.
Dies wird über "Erweiterungen > Module > DHL Wunschpaket (zu Hause + Standorte) > Einstell." konfiguriert.
Wenn eine Bestellung abgeschlossen wird, wird die konfigurierte EKP sowie die mit der gewählten Versandart verknüpfte Verfahrens- bzw. Teilnahmenummer in die Bestellung übernommen.
Diese Informationen können nachträglich über "Bestellungen verwalten > Bestellungen > DHL Wunschpaket" geändert werden.
Wenn einer Bestellung die Information über EKP, Verfahrens- oder Teilnahmenummer fehlen, wird diese ergänzt, sofern eine EKP konfiguriert bzw. eine Verfahrens- oder Teilnahmenummer mit der Versandart verknüpft ist.

6. OXID 6

Die Migration zu OXID 6 ist nicht abgeschlossen. Wenn dieses Modul mit OXID 6 verwendet wird, werden Warnungen generiert, die durch umbenannte Klassen verursacht werden. Da OXID 6 über eine Kompatibilitätsschicht verfügt, die die früheren Klassennamen den aktuellen Klassennamen zuordnet, kann diese Warnung vernachlässigt werden. Wenn die Warnungen dem Benutzer nicht gemeldet werden, funktioniert dieses Modul daher für OXID 6.

Wenn Sie auf das Umschreiben von überschreibbaren Funktionen angewiesen sind, vergewissern Sie sich, dass die Datei bootstrap.php nach dem Überschreiben aus modules / functions.php benötigt wird.

7. Datenschutz-Grundverordnung (EU-DSGVO)

Im Rahmnen der Erfassung der Lieferadresse speichert das Wunschpaket-Modul personenbezogene Daten zum Wunschnachbarn oder Wunschort in einem Kommentarfeld an der jeweiligen Bestellung.
Im Frontend wird vom Eingabefeld Wunschnachbar zum Standardshopware-Datenschutztext verlinkt, ggf. ist dort eine Ergänzung erforderlich.