VibeFox DHL Packstation for PrestaShop — Hilfe

Anforderungen

PrestaShop: 8.0 bis 9.x. Die Themes Classic und Hummingbird werden unterstützt.

PHP: 8.0 oder neuer. Das Modul lässt sich auf älteren PHP-Versionen nicht installieren.

DHL API key: die Liste der Standorte stammt von der kostenlosen DHL Location Finder API. Registrieren Sie sich im DHL-Entwicklerportal (developer.dhl.com), legen Sie eine App an, fügen Sie die API „Location Finder - Unified“ hinzu und kopieren Sie den API-Schlüssel der App. Für diese API ist kein DHL-Geschäftsvertrag nötig. Ohne den Schlüssel wird der Versanddienstleister im Bestellvorgang ausgeblendet. Beachten Sie das Anfragelimit Ihrer DHL-App: Jede neue Suche nach PLZ oder Ort ist eine API-Anfrage.

VibeFox license key: wird auf vibefox.net gekauft. Ein Schlüssel funktioniert auf einer Domain.

Installation

1. Gehen Sie im Back Office zu Modules > Module Manager und klicken Sie auf Upload a module. Wählen Sie die ZIP-Datei des Moduls.

2. Wenn der Upload abgeschlossen ist, klicken Sie auf Configure, oder suchen Sie später VibeFox DHL Packstation in der Modulliste und klicken Sie auf Configure.

3. Geben Sie Ihren VibeFox-Lizenzschlüssel in License key im Lizenzblock oben auf der Seite Configure ein und klicken Sie auf Activate (siehe Lizenzschlüssel).

4. Fügen Sie den DHL-API-Schlüssel ein, klicken Sie auf Save und dann auf Test API key. Wählen Sie die Standorttypen und geben Sie die Länderpreise ein (siehe Konfiguration).

Bei der Installation erstellt das Modul den Versanddienstleister DHL Packstation mit dem Text der Lieferzeit Delivery to a DHL Packstation or post office. Der Versanddienstleister ist aktiviert, allen Kundengruppen und den Zonen von Deutschland und Österreich (den Ländern der Standard-Preisliste) zugeordnet. Sie können Zonen, Kundengruppen, Lieferzeit, Logo und Größenlimits unter Shipping > Carriers ändern. Legen Sie die Preise dort nicht fest: Der Preis kommt immer vom Modul.

Konfiguration

Alle Einstellungen befinden sich auf der Modulseite: Modules > Module Manager > VibeFox DHL Packstation > Configure. Jeder Abschnitt hat seinen eigenen Button Save, der die ganze Seite speichert. Wenn ein Feld einen Fehler hat (eine ungültige oder negative Zahl, Min weight (kg) größer als Max weight (kg), ein Name mit mehr als 64 Zeichen), wird nichts gespeichert und der Fehler oben angezeigt. Jedes Speichern leert den Standort-Cache.

Warnhinweise über den Einstellungen zeigen an, wenn der Versanddienstleister nicht gefunden wurde, wenn die Gewichtseinheit des Shops (International > Localization, Local units) dem Modul nicht bekannt ist (Gewichte werden dann als kg gelesen; verwenden Sie kg, g, lb oder oz), wenn der DHL-API-Schlüssel leer ist, wenn kein Standorttyp aktiviert ist und wenn Ländereinträge für Preise nicht im Format CC:PRICE vorliegen (diese Einträge werden ignoriert).

Allgemein

Kundengruppen, Zonen und Größenlimits des Versanddienstleisters werden unter Shipping > Carriers eingestellt. Die folgenden Einstellungen gelten für alle Zonen.

Enable/Disable: schaltet den Versanddienstleister ein oder aus. Das ist derselbe Schalter wie der Status des Versanddienstleisters unter Shipping > Carriers.

Name: der Name des Versanddienstleisters, der dem Kunden angezeigt wird. Standard: DHL Packstation. Pflichtfeld, höchstens 64 Zeichen.

Tax: die Steuerregel des Versanddienstleisters oder No tax. PrestaShop schlägt diese Steuer auf die unten stehenden Preise auf. Bei No tax sind die Preise endgültig.

DHL Location Finder API

DHL API key: der „API Key“ Ihrer App auf developer.dhl.com. Ohne ihn wird der Versanddienstleister im Bestellvorgang ausgeblendet. Nach dem Speichern bleibt das Feld leer und zeigt Saved - leave empty to keep it. Geben Sie einen neuen Wert nur ein, wenn Sie ihn ändern möchten.

Remove the saved API key: aktivieren Sie dieses Kästchen und speichern Sie, um den gespeicherten Schlüssel zu löschen.

Connection test: der Button Test API key sucht mit dem gespeicherten Schlüssel nach Standorten nahe 53113 Bonn und leert den Standort-Cache. Speichern Sie die Einstellungen zuerst. Angezeigt wird, wie viele Standorte gefunden wurden, ob DHL den Schlüssel abgelehnt hat (401/403) oder ob die API nicht korrekt geantwortet hat (Details im Debug-Protokoll).

Abholstandorte

Im Bestellvorgang sieht der Kunde die Standorte nahe seiner Liefer-PLZ und kann nach einer anderen PLZ oder einem anderen Ort suchen.

Location types: welche DHL-Standorte der Kunde wählen kann: Packstation (parcel locker), Post Office (Postfiliale) und DHL Parcel Shop (Paketshop). Standardmäßig alle drei. Ist keiner ausgewählt, wird der Versanddienstleister ausgeblendet. Für eine Packstation muss der Kunde seine DHL-Postnummer eingeben.

Search radius (meters): der Radius um die gesuchte PLZ oder den gesuchten Ort. Standard: 5000. Ganze Zahl; Werte unter 100 oder über 25000 m (das DHL-Maximum) werden auf diese Grenze gesetzt.

Max results: die maximale Anzahl der Standorte, die je Suche angezeigt werden. Standard: 20. Ganze Zahl; DHL erlaubt bis zu 50, größere Werte werden auf 50 reduziert.

Shipping address: verwendet den gewählten Standort als Lieferadresse der Bestellung. Standardmäßig aktiviert. Adresszeile 1 wird zum Beispiel „Packstation 105“ (oder „Postfiliale 502“ bei einer Post Office oder einem Parcel Shop), Zeile 2 „Postnummer“ mit der Nummer, dazu PLZ, Ort und Land des Standorts, damit gedruckte Etiketten der Bestellung an den richtigen Ort gehen. Name, Firma und Telefon kommen aus der Adresse des Kunden. Die neue Adresse wird nur von der Bestellung verwendet und erscheint nicht im Adressbuch des Kunden.

Preise (der Abschnittstitel zeigt die Standardwährung Ihres Shops)

Country prices: der Preis je Zielland in der Standardwährung des Shops, ohne Steuer, Format CC:PRICE, getrennt durch Kommas oder Zeilenumbrüche. Standard: DE:4.99, AT:5.99. Auch ein Dezimalkomma funktioniert (DE:4,99).

Other countries: der Preis für ein Zielland, das nicht in Country prices steht. Standard: 5.99. Lassen Sie das Feld leer, um den Versanddienstleister für diese Länder auszublenden.

Calculation: Per order berechnet den Preis einmal. Per item (price x quantity) multipliziert ihn mit der Anzahl der Artikel im Warenkorb.

Free shipping from: die Zwischensumme des Warenkorbs (Produkte, die versendet werden müssen, nach Rabatten, vor Steuern), ab der dieser Versand kostenlos ist. Leer lassen, wenn er nie kostenlos sein soll.

Verfügbarkeit

Min weight (kg): das minimale Warenkorbgewicht. Produktgewichte werden aus Ihrer Gewichtseinheit umgerechnet. 0 bedeutet kein Limit.

Max weight (kg): der Versanddienstleister wird ab diesem Warenkorbgewicht ausgeblendet. Standard: 31.5, weil eine Packstation Pakete bis 31,5 kg annimmt. 0 bedeutet kein Limit.

Minimum subtotal: den Versanddienstleister nur anzeigen, wenn die Zwischensumme des Warenkorbs (Produkte, die versendet werden müssen, nach Rabatten, vor Steuern) mindestens diesen Wert erreicht. Leer lassen, um ihn immer anzuzeigen.

Ignore shipping zones: wenn aktiviert, wird der Versanddienstleister mit jeder aktiven Zone verknüpft (auch mit später erstellten Zonen) und für die Länder unten angeboten, oder für alle Länder, wenn die Liste leer ist. Wenn Sie es wieder ausschalten, erhält der Versanddienstleister die Zonen zurück, die er vorher hatte.

Countries (ignore zones): die Zielländer für diesen Modus. Strg/Cmd + Klick, um mehrere Länder auszuwählen. Wird nur mit Ignore shipping zones verwendet.

Erweitert

Debug log: schreibt API-Anfragen und Schritte des Bestellvorgangs in logs/vfd_dhlp_debug.log.php im Modulordner. Die Datei kann nicht über das Web geöffnet werden. API-Fehler werden immer protokolliert, auch wenn dies ausgeschaltet ist. Der API-Schlüssel, die Postnummer und Kundenadressen werden nie geschrieben.

Log: zeigt die Größe und die neuesten Einträge des Debug-Protokolls. Klicken Sie auf Clear log, um es zu leeren.

Remove data on uninstall: wenn aktiviert, löscht die Deinstallation des Moduls die Einstellungen, den Versanddienstleister, zwischengespeicherte Suchen und Protokolle. Die gewählten Standorte bleiben in den Bestellungen erhalten. Ist es ausgeschaltet, bleibt alles für eine erneute Installation erhalten.

So funktioniert es im Bestellvorgang

Im Schritt Lieferung fragt PrestaShop das Modul nach dem Preis für DHL Packstation. Es zählen nur physische Produkte: Virtuelle Produkte haben kein Gewicht und sind nicht in der Zwischensumme enthalten. Das Modul prüft, ob ein API-Schlüssel und mindestens ein Standorttyp festgelegt sind, die erlaubten Länder (mit Ignore shipping zones), das Warenkorbgewicht und die minimale Zwischensumme. Dann nimmt es den Preis für das Zielland (oder den Preis für andere Länder) und wendet den kostenlosen Versand an, wenn die Zwischensumme hoch genug ist. Der Preis wird in Ihrer Standardwährung berechnet und in der Warenkorbwährung des Kunden angezeigt.

Wenn Sie den Versanddienstleister unter Shipping > Carriers bearbeiten, nachdem er Bestellungen hat, speichert PrestaShop ihn als neue Version des Versanddienstleisters. Das Modul übernimmt die neue Version automatisch.

Das Modul erstellt keine DHL-Sendungen, druckt keine Etiketten und verfolgt keine Pakete. Verwenden Sie das DHL-Geschäftskundenportal oder ein Etikettentool: Mit aktiver Option Shipping address enthält die Bestellung bereits die Packstation-Adresse und die Postnummer. Das Modul berechnet keine Live-Tarife von DHL und zeigt keine Karte. Eine manuelle Eingabe einer Packstation-Nummer gibt es nicht.

Abholstellen

Wenn der Kunde DHL Packstation auswählt, erscheint unter dem Versanddienstleister ein Auswahlfeld. Die DHL-Standorte nahe der Liefer-PLZ und dem Lieferort werden geladen. DHL wird nur für den ausgewählten Versanddienstleister abgefragt. Der Kunde kann eine andere PLZ oder einen anderen Ort eingeben und auf Search klicken. Die Standorte werden nach Typ gruppiert (Packstation, Post Office, Parcel Shop) und nach Entfernung sortiert. Wird nichts gefunden, sieht der Kunde No DHL locations found near "…". Try another postcode or city.

Für eine Packstation muss der Kunde die DHL Postnummer eingeben, seine 6-12-stellige DHL-Kundennummer aus der DHL-App oder dem DHL-Konto. Für andere Standorte ist sie optional. Die Auswahl wird sofort im Warenkorb gespeichert. Bei Continue prüft der Server sie erneut: Der Standort muss eines der DHL-Suchergebnisse im Lieferland sein. Ohne Standort sieht der Kunde Please choose a DHL Packstation or post office for delivery. und kann nicht fortfahren. Eine fehlende oder ungültige Postnummer wird genauso gemeldet.

Suchergebnisse werden 12 Stunden zwischengespeichert. Eine leere oder fehlgeschlagene Suche wird 10 Minuten zwischengespeichert, damit der Bestellvorgang bei jedem Aktualisieren nicht auf DHL warten muss. Das Zeitlimit der API beträgt 12 Sekunden. Ist die DHL-API nicht erreichbar, sieht der Kunde DHL locations cannot be loaded right now. Please try again later or choose another shipping method. Ein bereits vom Kunden gewählter Standort wird weiterhin akzeptiert.

Wenn die Bestellung aufgegeben wird, werden der Standort (ID, Typ, Nummer, Name, Adresse) und die Postnummer mit der Bestellung gespeichert. Ist Shipping address aktiviert, wird die Lieferadresse der Bestellung durch die Adresse des Standorts ersetzt. Der Standort wird auf der Bestellbestätigungsseite, unter Order history and details im Kundenkonto sowie in der Bestellbestätigungs-E-Mail und der E-Mail über neue Bestellungen des Moduls Mail alerts angezeigt; dabei werden dem Namen des Versanddienstleisters die Bezeichnungen DHL pickup location und DHL Postnummer hinzugefügt.

Auf der Bestellseite im Back Office zeigt der Block DHL pickup location den Standort, seinen Typ und seine ID sowie die Postnummer. Klicken Sie auf Change, suchen Sie nach PLZ oder Ort, wählen Sie einen anderen Standort, ändern Sie die Postnummer und klicken Sie auf Save location. Sie können auch nur die Postnummer ändern. Jede Änderung fügt der Bestellung eine private Nachricht hinzu: DHL pickup location changed to: …. Ist Shipping address aktiviert, wird auch die Lieferadresse der Bestellung aktualisiert. Den Standort zu ändern erfordert die Berechtigung, Bestellungen zu bearbeiten; der Zugriff auf die Modulseiten ist nicht nötig. Wurden aus einem Warenkorb mehrere Bestellungen erstellt, gehört der Standort nur zur ersten Bestellung; Change bei einer anderen Bestellung desselben Warenkorbs zeigt The DHL location of this cart belongs to another order of the same cart - nothing was changed.

Lizenzschlüssel

Das Modul funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox DHL Packstation ist der erste Block auf Modules > Module Manager > VibeFox DHL Packstation > Configure, oberhalb der Einstellungen. Geben Sie den Schlüssel in License key ein und klicken Sie auf Activate. Danach zeigt der Block den maskierten Schlüssel, den Status (zum Beispiel das Datum, bis zu dem die Lizenz gültig ist, und Ihre Domain) sowie die Schaltflächen Check now zum erneuten Prüfen des Status, Change key zum Eingeben eines anderen Schlüssels und Remove key zum Entfernen des Schlüssels aus diesem Shop. Darunter stehen die Zeile Product: presta-shipping-dhl-packstation und der Link Manage licenses and domains in your account, der Ihr vibefox.net-Konto öffnet. Nur Mitarbeiter mit der Berechtigung Configure für das Modul können den Schlüssel ändern. Die Texte des Blocks folgen der Sprache des Back Office (Englisch und Russisch sind enthalten).

Wird der Schlüssel nicht akzeptiert, nennt der Block den Grund, zum Beispiel Key not found, This key belongs to another product, Domain limit reached oder License expired on mit einem Datum. Nachdem sich die Shop-Adresse geändert hat oder nachdem Sie in Ihrem Konto einen Domain-Platz freigegeben haben, klicken Sie auf Check now. Kann der Lizenzserver nicht erreicht werden, arbeitet das Modul mit dem zuletzt bekannten Status weiter.

Ein Schlüssel funktioniert auf einer Domain: der Domain des Hauptshops, auch bei einem Multistore-Setup. Das Entfernen des Schlüssels aus dem Shop gibt seinen Domain-Platz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.

Ohne einen aktiven Schlüssel wird der Versanddienstleister DHL Packstation Kunden im Bestellvorgang nicht angezeigt und es wird kein Tarif berechnet. Das Frontend des Shops weiß nicht, dass Sie im Back Office angemeldet sind, daher wird der Versanddienstleister auch für Sie ausgeblendet: Sie können das Modul vor dem Kauf eines Schlüssels einrichten, aber im Bestellvorgang nicht testen. Ein Hinweis erscheint unter Modules > Module Manager auf dem Tab Alerts. Bestehende Bestellungen sind davon nicht betroffen.

Läuft eine Lizenz ab, arbeitet das Modul weiter, aber Updates und Support erfordern eine Verlängerung. Der Status wird automatisch erneut geprüft, während Sie im Back Office arbeiten: einmal täglich in den ersten 14 Tagen nach Eingabe des Schlüssels, danach einmal pro Woche. Ein Cron-Job ist nicht nötig. Das Deinstallieren des Moduls entfernt immer den Lizenzschlüssel und den Lizenzstatus. Reset dieses Moduls löscht keine Daten, daher bleiben der Schlüssel und der Status erhalten.

Fehlerbehebung

DHL Packstation erscheint nicht im Bestellvorgang: prüfen Sie, ob die Lizenz aktiv ist und Enable/Disable eingeschaltet ist. Prüfen Sie unter Shipping > Carriers, ob der Versanddienstleister die Zone des Landes und die Kundengruppe des Kunden abdeckt (oder schalten Sie Ignore shipping zones ein und prüfen Sie Countries (ignore zones)). Prüfen Sie, ob der DHL API key eingetragen ist, mindestens ein Standorttyp ausgewählt ist, das Zielland einen Preis hat (oder Other countries gesetzt ist) und die Regeln für Gewicht und Zwischensumme es nicht ausblenden. Produkte können auf der Produktseite außerdem auf bestimmte Versanddienstleister beschränkt sein.

Es werden keine Standorte angezeigt: klicken Sie auf Test API key. Lehnt DHL den Schlüssel ab (401/403), prüfen Sie den Schlüssel und ob Ihre App die API „Location Finder - Unified“ hat. Schalten Sie Debug log ein, laden Sie den Bestellvorgang neu und sehen Sie im Feld Log auf der Modulseite nach. Prüfen Sie, ob das Anfragelimit Ihrer DHL-App nicht erreicht ist.

Keine Standorte in der Nähe einer Adresse: erhöhen Sie Search radius (meters) oder Max results, oder lassen Sie den Kunden nach einer anderen PLZ oder einem anderen Ort suchen. Eine Packstation ohne Nummer in den DHL-Daten wird nicht aufgeführt.

Der Kunde sieht „Enter your postcode or city to see DHL locations near you.“: die Lieferadresse hat keine PLZ und keinen Ort. Der Kunde kann eines davon in das Suchfeld eingeben.

Auf der Bestellseite meldet Change „Please choose a DHL location of the search - nothing was changed.“: suchen Sie nach PLZ oder Ort und wählen Sie einen Standort aus den Ergebnissen. Hat die Bestellung noch keinen Standort, muss vor dem Speichern der Postnummer einer gewählt werden.

Die Seite meldet, dass der Versanddienstleister DHL Packstation nicht gefunden wurde: der Versanddienstleister wurde unter Shipping > Carriers gelöscht. Setzen Sie das Modul unter Modules > Module Manager per Reset zurück, um ihn neu zu erstellen. Der Reset behält den Ein-/Aus-Status eines bestehenden Versanddienstleisters.

Deinstallation

Gehen Sie zu Modules > Module Manager, öffnen Sie das Menü neben VibeFox DHL Packstation und wählen Sie Uninstall. Der Lizenzschlüssel, der Lizenzstatus und der Standort-Cache werden immer entfernt. Ist Remove data on uninstall aktiviert, wird der Versanddienstleister gelöscht (Bestellungen behalten ihren Verlauf), und die Einstellungen, das Protokoll sowie die Standorte von Warenkörben ohne Bestellung werden entfernt. Ist es ausgeschaltet, wird der Versanddienstleister nur deaktiviert und alle Einstellungen bleiben erhalten. Eine erneute Installation des Moduls stellt den vorherigen Status des Versanddienstleisters wieder her. Die gewählten Standorte bleiben immer in den Bestellungen erhalten.

DHL und Packstation sind Marken ihrer jeweiligen Inhaber. Dieses Modul ist weder mit DHL verbunden noch von DHL empfohlen.