VibeFox DPD Pickup for PrestaShop — Hilfe

Anforderungen

PrestaShop: 8.0 bis 9.x.

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

DPD-Baltic-Zugangsdaten (Litauen, Lettland, Estland): Die Liste der Abholpunkte stammt aus dem Webservice von DPD Baltic. Sie benötigen den API-Benutzernamen und das Passwort, die DPD an seine Geschäftskunden ausgibt. Fragen Sie Ihren DPD-Kundenbetreuer oder den DPD-Kundenservice Ihres Landes. Ein Konto listet die Abholpunkte von Litauen, Lettland und Estland auf.

DPD Slowakei: Die öffentliche Paketshop-Suche von DPD Slowakei benötigt keine Zugangsdaten.

VibeFox-Lizenzschlüssel: 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 DPD Pickup in der Modulliste und klicken Sie auf Configure.

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

4. Wählen Sie Ihre DPD-API. Für DPD Litauen, Lettland oder Estland geben Sie den API-Benutzernamen und das Passwort ein. Prüfen Sie die Preise je Land und klicken Sie auf Save. Klicken Sie danach auf Refresh pickup points, um die Verbindung zu prüfen (siehe Konfiguration).

Bei der Installation legt das Modul den Versanddienstleister DPD Pickup Point mit dem Lieferzeittext DPD Pickup point or locker an. Der Versanddienstleister wird den Zonen Slowakei, Litauen, Lettland und Estland sowie allen Kundengruppen zugeordnet, ohne Steuerregel. Sie können Zonen, Kundengruppen, Lieferzeittext, Logo und Größenlimits unter Shipping > Carriers ändern. Legen Sie dort keine Preise fest: Der Preis stammt immer aus dem Modul.

Konfiguration

Alle Einstellungen befinden sich auf der Modulseite: Modules > Module Manager > VibeFox DPD Pickup > Configure. Jeder Abschnitt hat seine eigene Schaltfläche Save, die die gesamte Seite speichert. Jedes Speichern leert außerdem die zwischengespeicherten Listen der Abholpunkte.

Hinweise oben auf der Seite zeigen an, wenn Benutzername oder Passwort von DPD Baltic leer sind, wenn keine Preise festgelegt sind (in beiden Fällen wird der Versanddienstleister an der Kasse nicht angezeigt), wenn der Versanddienstleister gelöscht wurde und wenn die Gewichtseinheit des Shops (International > Localization, Local units) dem Modul unbekannt ist, sodass Produktgewichte als kg gelesen werden. Ein Wert, der keine Zahl ist, oder eine negative Zahl in einem Betrags- oder Gewichtsfeld wird nicht gespeichert: Das Feld wird leer, und ein Hinweis nennt es. Zeilen von Country prices, die nicht im Format CC:PREIS vorliegen, werden in einem Hinweis aufgelistet und ignoriert.

Allgemein

Enable/Disable: schaltet DPD Pickup ein oder aus. Dies ist derselbe Schalter wie der Status des Versanddienstleisters unter Shipping > Carriers.

Name: der Name des Versanddienstleisters, den der Kunde an der Kasse sieht. Standard: DPD Pickup Point. Pflichtfeld, höchstens 64 Zeichen.

Tax status: die Steuerregel des Versanddienstleisters, die auf den Versandpreis angewendet wird. None bedeutet keine Steuer. Die anderen Optionen zeigen Taxable mit dem Namen einer Steuerregel Ihres Shops.

Liste der DPD-Abholpunkte

Die Abholpunkte werden von DPD geladen und 24 Stunden zwischengespeichert.

DPD API: das DPD-Unternehmen, bei dem Ihr Konto besteht. Baltische Konten nutzen den Webservice ihres eigenen Landes.

API username (Baltic): Ihr Benutzername für den Webservice von DPD Baltic. Für DPD Slowakei nicht nötig. Wenn Sie ihn leeren, wird auch das gespeicherte Passwort gelöscht.

API password (Baltic): Ihr Passwort für den Webservice von DPD Baltic. Für DPD Slowakei nicht nötig. Nach dem Speichern bleibt das Feld leer und zeigt Saved - leave empty to keep it. Geben Sie nur dann einen neuen Wert ein, wenn Sie das Passwort ändern möchten.

Pickup points: Die Schaltfläche Refresh pickup points leert den Cache und lädt die Abholpunkte jetzt von DPD: Litauen, Lettland und Estland für die Baltic-API sowie eine Testsuche in Bratislava für DPD Slowakei. Sie zeigt je Land die Anzahl der Abholpunkte oder den Fehler an. Speichern Sie die Einstellungen vorher.

Preise

Die Versandkosten sind je Land fest, in der Standardwährung Ihres Shops, ohne Steuer. DPD-Preise werden nicht von der API abgefragt.

Country prices: eine Zeile je Land: CC:Preis, zum Beispiel EE:3.50. Ein Dezimalkomma wird akzeptiert. Standard: SK:3.50, LT:4.00, LV:4.00, EE:4.00.

Fallback cost: der Preis für Länder, die nicht unter Country prices stehen. Standard: 5.00. Lassen Sie das Feld leer, damit der Versanddienstleister nur in den aufgeführten Ländern angeboten wird.

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

Free shipping from: Der Versand ist kostenlos, wenn die Zwischensumme der Bestellung (nach Rabatten, vor Steuern) diesen Betrag erreicht. Lassen Sie das Feld leer, um es zu deaktivieren.

Verfügbarkeit

Der Versanddienstleister wird auch ausgeblendet, wenn DPD für die Adresse des Kunden keine Abholpunkte liefert oder die DPD-API nicht erreichbar ist, weil eine Bestellung ohne Abholpunkt nicht zugestellt werden kann.

Min weight (kg): das minimale Warenkorbgewicht. Produktgewichte werden aus der Gewichtseinheit Ihres Shops umgerechnet. Leer oder 0 bedeutet keine Grenze.

Max weight (kg): schwerere Warenkörbe sehen den Versanddienstleister nicht. Standard: 31.5. 0 bedeutet keine Grenze. Prüfen Sie die Paketlimits der DPD-Abholpunkte und Paketstationen in Ihrem Land. Ein Min weight (kg), der größer ist als Max weight (kg), wird abgelehnt, und es wird nichts gespeichert.

Minimum subtotal: zeigt den Versanddienstleister nur an, wenn die Zwischensumme der Bestellung (nach Rabatten, vor Steuern) mindestens diesen Betrag erreicht. Lassen Sie das Feld leer, um ihn immer anzuzeigen.

Ignore shipping zones: Wenn aktiviert, wird der Versanddienstleister allen Zonen zugeordnet und für die unten genannten Länder angeboten. Eine Zone, die Sie später anlegen, wird sofort zugeordnet. Wenn deaktiviert, wird der Versanddienstleister nur in seinen Zonen unter Shipping > Carriers angeboten. Beim Deaktivieren kehrt der Versanddienstleister zu den Zonen zurück, die er vorher hatte.

Countries: die Zielländer für diesen Modus. Lassen Sie das Feld leer für alle Länder. Wird nur mit Ignore shipping zones verwendet.

Auswahl des Abholpunkts

City order: zeigt zuerst die großen Städte (Tallinn, Riga, Vilnius, Bratislava und andere). Standardmäßig aktiviert.

City list width: die CSS-Breite der Städteliste, zum Beispiel 100% oder 300px. Standard: 100%.

Pickup point list width: die CSS-Breite der Liste der Abholpunkte, zum Beispiel 100% oder 400px. Standard: 100%.

Erweitert

Debug log: schreibt API-Anfragen und Schritte des Checkouts in logs/vfd_dpd_debug.log.php im Modulordner. Die Datei kann nicht über das Web geöffnet werden. API-Fehler werden immer protokolliert, auch wenn diese Option ausgeschaltet ist. Zugangsdaten werden nie protokolliert.

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

Remove data on uninstall: Wenn aktiviert, löscht die Deinstallation des Moduls die Modul-Einstellungen und den Versanddienstleister. Der in den Bestellungen gespeicherte Abholpunkt bleibt immer erhalten.

So funktioniert es an der Kasse

Im Versandschritt fragt PrestaShop das Modul nach dem Preis von DPD Pickup. Nur physische Produkte zählen: Virtuelle Produkte fügen kein Gewicht hinzu und sind nicht in der Zwischensumme enthalten. Das Modul prüft die Länder (mit Ignore shipping zones), das Warenkorbgewicht und die minimale Zwischensumme, ermittelt den Preis für das Land (oder den Ersatzpreis) und wendet den kostenlosen Versand an, wenn die Zwischensumme hoch genug ist. Danach lädt es die DPD-Abholpunkte für die Adresse. Liefert DPD keine, ist DPD nicht erreichbar oder fehlen die Baltic-Zugangsdaten, wird der Versanddienstleister ausgeblendet. Der Preis wird in der Standardwährung berechnet und danach in der Warenkorbwährung des Kunden angezeigt.

Eine Liste der Abholpunkte wird 24 Stunden zwischengespeichert, eine leere Liste 1 Stunde. Eine fehlgeschlagene Anfrage wird 5 Minuten lang gemerkt, sodass ein DPD-Ausfall die Kasse nie verlangsamt. Das Zeitlimit der API beträgt 15 Sekunden.

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

Das Modul fragt keine DPD-Preise ab, erstellt keine DPD-Sendungen, druckt keine Etiketten, erstellt keine Manifeste, bestellt keine Kurierabholungen, verfolgt keine Pakete und zeigt keine Karte an. Unterstützt werden nur der Webservice von DPD Baltic und die Paketshop-Suche von DPD Slowakei.

Abholpunkte

Wenn der Kunde DPD Pickup wählt, erscheinen unter dem Versanddienstleister eine Städteliste und eine Liste der Abholpunkte. Die Stadt aus der Adresse des Kunden ist vorausgewählt. Die Auswahl wird im Warenkorb gespeichert, sobald der Kunde sie trifft. Bei DPD Slowakei sieht der Kunde Enter your city and postcode to see the DPD pickup points nearby., bis die Adresse vollständig ist, danach die Punkte in der Nähe. Hat DPD für die Adresse keine Punkte, sieht der Kunde No DPD pickup points are available for this address right now. Please check the address or choose another shipping method.

Ein Abholpunkt ist erforderlich. Ohne ihn kann der Kunde nicht weitergehen und sieht Please select a DPD pickup point. Der Server prüft, ob der Punkt zur DPD-Liste für die Adresse des Kunden gehört. Eine manipulierte oder veraltete Auswahl wird mit The selected DPD pickup point is not available for this address. Please choose another one. abgelehnt.

Der gewählte Punkt wird in der Bestellung gespeichert. Er wird auf der Bestellbestätigungsseite und in den Bestelldetails des Kunden als DPD pickup point: angezeigt. In der Bestellbestätigungs-E-Mail wird er nach dem Namen des Versanddienstleisters ergänzt. Die neue Bestell-E-Mail an den Shop (ps_emailalerts) zeigt ebenfalls die ID des Punktes. Der in der Bestellung gespeicherte Name stammt von DPD, nicht vom Browser.

Auf der Bestellseite im Back Office zeigt der Block DPD pickup point den Namen des Punktes, seine ID und sein Land. Klicken Sie auf Edit, wählen Sie eine Stadt und einen anderen Punkt und klicken Sie auf Save. Der Punkt wird mit der DPD-Liste für die Adresse der Bestellung geprüft, und die Seite zeigt Pickup point updated. oder Pickup point not found for the order address. Das Ändern des Punktes erfordert die Berechtigung zum Bearbeiten von Bestellungen, nicht den Zugriff auf die Modulseiten. Jede Änderung wird unter Advanced Parameters > Logs für die Bestellung protokolliert, mit dem alten Punkt, dem neuen Punkt und dem Mitarbeiter. Um den Punkt bei DPD Slowakei zu ändern, benötigt die Bestellung eine Lieferstadt und Postleitzahl.

Wird ein Warenkorb auf mehrere Bestellungen aufgeteilt, bleibt der Abholpunkt bei der ersten Bestellung. Die anderen Bestellungen zeigen No pickup point was selected for this order., das Debug-Log enthält für jede von ihnen einen Fehler, und Edit zeigt dort The pickup point of this cart belongs to another order of the same cart. Nothing was changed. Den Punkt einer solchen Bestellung müssen Sie manuell bei DPD angeben.

Lizenzschlüssel

Das Modul arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox DPD Pickup ist der erste Block unter Modules > Module Manager > VibeFox DPD Pickup > Configure, oberhalb der Einstellungen. Fügen Sie den Schlüssel in License key ein und klicken Sie auf Activate. Danach zeigt der Block den Schlüssel maskiert, 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-dpd-pickup und der Link Manage licenses and domains in your account, der zu Ihrem vibefox.net-Konto führt. 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. Ist der Lizenzserver nicht erreichbar, arbeitet das Modul mit dem zuletzt bekannten Status weiter.

Ein Schlüssel funktioniert auf einer Domain: der Domain des Hauptshops, auch bei einer Multistore-Konfiguration. 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 DPD Pickup Kunden an der Kasse nicht angezeigt, und es wird kein Tarif berechnet. Der PrestaShop-Storefront 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 an der Kasse nicht testen. Eine Erinnerung erscheint unter Modules > Module Manager auf dem Tab Alerts. Bestehende Bestellungen sind nicht betroffen.

Läuft eine Lizenz ab, arbeitet das Modul weiter, aber Updates und Support erfordern eine Verlängerung. Der Status wird während Ihrer Arbeit im Back Office automatisch erneut geprüft: einmal am Tag in den ersten 14 Tagen nach der Eingabe des Schlüssels, danach einmal pro Woche. Ein Cron-Job ist nicht nötig. Die Deinstallation oder das Zurücksetzen des Moduls entfernt immer den Lizenzschlüssel und den Lizenzstatus.

Fehlerbehebung

DPD Pickup erscheint nicht an der Kasse: 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 des Kunden und die Kundengruppe abdeckt (oder ob Ignore shipping zones eingeschaltet und das Land erlaubt ist). Prüfen Sie die Hinweise oben auf der Modulseite und klicken Sie auf Refresh pickup points. Prüfen Sie die Gewichts- und Zwischensummen-Grenzen und ob das Land einen Preis (oder einen Ersatzpreis) hat. Produkte können auf der Produktseite auch auf bestimmte Versanddienstleister beschränkt sein.

Ein Fehler nach Refresh pickup points: Das Ergebnis zeigt den DPD-Fehler je Land. „Login failed“ bedeutet zum Beispiel, dass DPD die Baltic-Zugangsdaten abgelehnt hat, sodass keine Abholpunkte geladen werden können. Prüfen Sie den API-Benutzernamen und das Passwort bei DPD.

DPD Slowakei zeigt keine Punkte: Die Punkte erscheinen, sobald der Kunde Stadt und Postleitzahl eingegeben hat. DPD listet nur die Punkte im Umkreis von 50 km um diese Adresse. Entwickler können den Radius mit dem Modul-Hook actionVfdDpdSkSearchRadius ändern.

Ursache finden: Aktivieren Sie das Debug log, laden Sie die Kasse neu und sehen Sie sich das Feld Log auf der Modulseite an. Jede Entscheidung wird dort protokolliert. API-Fehler werden immer protokolliert. API-Benutzernamen und Passwörter werden nie in das Log geschrieben.

Abholpunkte wirken nach einer Änderung veraltet: Klicken Sie auf der Modulseite auf Save oder Refresh pickup points. Beides leert die zwischengespeicherten Listen.

Die Seite meldet, dass der Versanddienstleister DPD Pickup nicht gefunden wurde: Der Versanddienstleister wurde unter Shipping > Carriers gelöscht. Setzen Sie das Modul unter Modules > Module Manager zurück, um ihn neu anzulegen.

Deinstallation

Gehen Sie zu Modules > Module Manager, öffnen Sie das Menü neben VibeFox DPD Pickup und wählen Sie Uninstall. Der Lizenzschlüssel, der Lizenzstatus und der Cache der Abholpunkte werden immer entfernt. Ist Remove data on uninstall eingeschaltet, wird der Versanddienstleister gelöscht (Bestellungen behalten ihren Verlauf), und die Einstellungen, das Log und die Auswahl nicht abgeschlossener Warenkörbe werden entfernt. Ist die Option aus, wird der Versanddienstleister nur deaktiviert und alle Einstellungen bleiben erhalten. Wenn Sie das Modul erneut installieren oder ein Reset ausführen, erhält der gespeicherte Versanddienstleister den Status zurück, den er vorher hatte: Ein deaktivierter Versanddienstleister bleibt deaktiviert. Der in Bestellungen gespeicherte Abholpunkt wird nie gelöscht.

DPD ist eine Marke ihres jeweiligen Inhabers. Dieses Modul ist nicht mit DPD verbunden und wird nicht von DPD unterstützt.