VibeFox DPD Pickup for WooCommerce — Hilfe
Anforderungen
WordPress: 5.8 oder neuer.
WooCommerce: 7.0 oder neuer, installiert und aktiv. Das Plugin lässt sich ohne WooCommerce nicht aktivieren.
PHP: 8.0 oder neuer.
Zugangsdaten für DPD Baltic (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 seinen 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: erhältlich auf vibefox.net. Ein Schlüssel funktioniert auf einer Domain.
Installation
1. Gehen Sie in WordPress zu Plugins > Add New > Upload Plugin, wählen Sie die ZIP-Datei des Plugins und klicken Sie auf Install Now. Sie können auch den Ordner vfd_dpd_pickup per FTP nach /wp-content/plugins/ hochladen.
2. Klicken Sie auf Activate.
3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Shipping > VibeFox DPD Pickup oder klicken Sie auf der Seite Plugins unter dem Namen des Plugins auf Settings.
4. Geben Sie Ihren VibeFox-Lizenzschlüssel im Lizenzbereich oben auf der Seite ein und klicken Sie auf Activate.
5. Wählen Sie Ihre DPD-API. Für DPD Litauen, Lettland oder Estland geben Sie API-Benutzername und Passwort ein. Tragen Sie die Preise je Land ein und speichern Sie. Klicken Sie auf Refresh pickup points, um die Verbindung zu prüfen (siehe Konfiguration).
6. Fügen Sie VibeFox DPD Pickup unter WooCommerce > Settings > Shipping > Shipping zones Ihren Versandzonen hinzu oder aktivieren Sie Ignore shipping zones.
Konfiguration
Alle Einstellungen befinden sich auf einer Seite: WooCommerce > Settings > Shipping > VibeFox DPD Pickup. Sie gelten für alle Versandzonen. Wenn Sie die Versandart einer Zone hinzufügen, hat das Fenster der Zone nur ein Feld:
Title (zone): der Name dieser Option an der Kasse für diese Zone. Lassen Sie das Feld leer, um den globalen Name zu verwenden.
Warnungen über den Einstellungen zeigen an, wenn Benutzername oder Passwort von DPD Baltic leer sind und wenn keine Preise festgelegt sind. Bei jedem Speichern der Einstellungen wird der Zwischenspeicher der Abholpunkte geleert.
Allgemein
Enable/Disable: schaltet die Versandart in allen Zonen gleichzeitig ein oder aus.
Name: der Name der Versandart, der an der Kasse angezeigt wird. Standard: DPD Pickup Point.
Tax status: Taxable fügt die WooCommerce-Steuer zu den Versandkosten hinzu, None tut das nicht.
Liste der DPD-Abholpunkte
Abholpunkte werden von DPD geladen und 24 Stunden zwischengespeichert.
DPD API: das DPD-Unternehmen, bei dem Ihr Konto geführt wird. Baltic-Konten nutzen den Webservice ihres eigenen Landes.
API username (Baltic): Ihr Benutzername für den DPD-Baltic-Webservice. Für DPD Slowakei nicht nötig.
API password (Baltic): Ihr Passwort für den DPD-Baltic-Webservice. Für DPD Slowakei nicht nötig.
Pickup points: Die Schaltfläche Refresh pickup points leert den Zwischenspeicher und lädt die Abholpunkte jetzt von DPD: Litauen, Lettland und Estland bei der Baltic-API oder eine Testsuche in Bratislava für DPD Slowakei. Das Ergebnis wird je Land angezeigt. Speichern Sie die Einstellungen vorher.
Preise
Versandpreise sind feste Preise je Land in der Shopwährung. Die DPD-Preise werden nicht über die API abgefragt.
Country prices: eine Zeile je Land: CC:price, 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, um die Versandart nur in den aufgeführten Ländern anzubieten.
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 Gutscheinen) diesen Betrag erreicht. Lassen Sie das Feld leer, um es auszuschalten.
Verfügbarkeit
Die Versandart wird auch ausgeblendet, wenn DPD keine Abholpunkte für die Adresse des Kunden 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 Ihrer Gewichtseinheit im Shop umgerechnet. Leer oder 0 bedeutet kein Limit.
Max weight (kg): schwerere Warenkörbe sehen die Versandart nicht. Standard: 31.5. 0 bedeutet kein Limit. Prüfen Sie die Paketgrenzen der DPD-Pickup-Punkte und Paketstationen in Ihrem Land.
Minimum subtotal: die Versandart wird nur angezeigt, wenn die Zwischensumme der Bestellung mindestens diesen Betrag erreicht. Lassen Sie das Feld leer, um sie immer anzuzeigen.
Excluded shipping classes: die Versandart wird ausgeblendet, wenn der Warenkorb ein Produkt einer dieser WooCommerce-Versandklassen enthält.
Ignore shipping zones: bietet die Versandart für die unten genannten Länder an, auch wenn die Versandzone des Kunden sie nicht enthält. Aus bedeutet, dass Sie die Versandart wie üblich den Versandzonen hinzufügen.
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 Stadtliste, 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: protokolliert API-Anfragen und Schritte an der Kasse unter WooCommerce > Status > Logs, Quelle vfd-dpd-pickup. API-Fehler werden immer protokolliert, auch wenn dies ausgeschaltet ist. Zugangsdaten werden nie protokolliert.
Remove data on uninstall: ist die Option aktiviert, löscht das Entfernen des Plugins seine Einstellungen und Zonenmethoden. Das Deaktivieren löscht nie Einstellungen. Der in Bestellungen gespeicherte Abholpunkt bleibt immer erhalten.
Funktionsweise an der Kasse
Wenn der Kunde eine Lieferadresse eingibt, fragt WooCommerce das Plugin nach einem Preis. Das Plugin prüft das Warenkorbgewicht, die minimale Zwischensumme und die ausgeschlossenen Versandklassen, übernimmt den Preis für das Land (oder den Ersatzpreis) und wendet kostenlosen Versand an, wenn die Zwischensumme hoch genug ist. Danach lädt es die DPD-Abholpunkte für die Adresse. Liefert DPD keine, ist die Verbindung nicht möglich oder fehlen die Baltic-Zugangsdaten, wird die Versandart ausgeblendet.
Eine Liste der Abholpunkte wird 24 Stunden zwischengespeichert. Eine fehlgeschlagene Anfrage wird 5 Minuten lang gemerkt, sodass ein DPD-Ausfall den Kassenvorgang nie verlangsamt. Das Zeitlimit der API beträgt 15 Sekunden.
Die Versandart funktioniert an der klassischen Kasse und in den Blöcken Warenkorb und Kasse. Sie ist mit WooCommerce High-Performance Order Storage (HPOS) kompatibel.
Das Plugin 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. Unterstützt werden nur der DPD-Baltic-Webservice und die DPD-Paketshop-Suche der Slowakei.
Abholpunkte
Wenn der Kunde DPD Pickup auswählt, erscheinen unter der Versandart eine Stadtliste und eine Liste der Abholpunkte. Die Stadt aus der Adresse des Kunden ist vorausgewählt. Bei DPD Slowakei gibt der Kunde zuerst Stadt und Postleitzahl ein und sieht dann die Punkte in der Nähe. Ein Abholpunkt ist erforderlich. Der Server prüft, dass der Punkt zu Land und Adresse des Kunden gehört, sodass eine gefälschte oder veraltete Auswahl abgelehnt wird.
Der gewählte Punkt wird in der Bestellung gespeichert. Er wird auf der Bestellseite unter der Lieferadresse, auf der Dankesseite, unter My account > Orders und in den Bestell-E-Mails (HTML und Nur-Text) als DPD pickup point angezeigt. Der in der Bestellung gespeicherte Name stammt von DPD, nicht vom Browser.
Klicken Sie auf der Bestellseite neben dem Abholpunkt auf Edit, wählen Sie eine Stadt und einen anderen Punkt. Der Punkt wird gegen die DPD-Liste für die Bestelladresse geprüft. Die Bestellung braucht eine Versandstadt und Postleitzahl, um den Punkt zu ändern.
Lizenzschlüssel
Das Plugin arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzbereich befindet sich oben unter WooCommerce > Settings > Shipping > VibeFox DPD Pickup. Fügen Sie den Schlüssel in License key ein und klicken Sie auf Activate. Der Bereich zeigt den Status, zum Beispiel das Datum, bis zu dem die Lizenz aktiv ist, und Ihre Domain. Mit Check now prüfen Sie den Status erneut, mit Change key geben Sie einen anderen Schlüssel ein und mit Remove key entfernen Sie ihn von dieser Website. Der Link Manage licenses and domains in your account öffnet Ihr vibefox.net-Konto.
Ein Schlüssel funktioniert auf einer Domain. Das Entfernen des Schlüssels von einer Website gibt deren Domain-Platz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.
Ohne aktiven Schlüssel wird DPD Pickup Kunden an der Kasse nicht angezeigt. Angemeldete Shop-Manager sehen es weiterhin, markiert mit (unlicensed — visible to admins only), damit Sie das Plugin vor dem Kauf eines Schlüssels einrichten und testen können. Ein Hinweis erscheint auf der Seite Plugins und auf WooCommerce-Seiten. Bestehende Bestellungen sind nicht betroffen.
Läuft eine Lizenz ab, arbeitet das Plugin weiter, aber Updates und Support erfordern eine Verlängerung. Der Status wird automatisch im Hintergrund erneut geprüft.
Fehlerbehebung
DPD Pickup erscheint nicht an der Kasse: Prüfen Sie, dass die Lizenz aktiv ist, Enable/Disable eingeschaltet ist und die Versandart der Zone des Kundenlandes hinzugefügt wurde (oder Ignore shipping zones eingeschaltet ist und das Land erlaubt ist). Prüfen Sie die Warnungen oben auf der Einstellungsseite und klicken Sie auf Refresh pickup points. Prüfen Sie die Grenzen für Gewicht und Zwischensumme, die ausgeschlossenen Versandklassen und ob das Land einen Preis (oder einen Ersatzpreis) hat.
„Login failed“ nach Refresh pickup points: DPD hat die Baltic-Zugangsdaten abgelehnt, daher kann kein Abholpunkt geladen werden. Prüfen Sie API-Benutzername und Passwort bei DPD.
DPD Slowakei zeigt keine Punkte: Die Punkte erscheinen, sobald der Kunde Stadt und Postleitzahl eingegeben hat. DPD listet nur Punkte im Umkreis von 50 km um diese Adresse auf.
Ursache finden: Aktivieren Sie das Debug log. Jede Entscheidung wird unter WooCommerce > Status > Logs, Quelle vfd-dpd-pickup, protokolliert. API-Fehler werden immer protokolliert. API-Benutzernamen und Passwörter werden nie ins Protokoll geschrieben.
Der Lizenzbereich zeigt einen Fehler: Folgen Sie der Meldung im Bereich. Wenn der Schlüssel etwa bereits auf einer anderen Domain verwendet wird, geben Sie in Ihrem vibefox.net-Konto einen Platz frei und klicken Sie auf Check now. Wurde die Adresse der Website geändert, klicken Sie auf Check now, um den Schlüssel für die neue Domain zu aktivieren. Ist der Lizenzserver nicht erreichbar, arbeitet das Plugin mit dem zuletzt bekannten Status weiter.
Deinstallation
Das Deaktivieren des Plugins behält alle Einstellungen. Es leert nur den Zwischenspeicher der Abholpunkte. Um das Plugin zu entfernen, deaktivieren und löschen Sie es auf der Seite Plugins. Der Lizenzschlüssel und der Lizenzstatus dieses Plugins werden immer entfernt, ebenso der Zwischenspeicher der Abholpunkte. Einstellungen und Zonenmethoden werden nur entfernt, wenn Remove data on uninstall eingeschaltet war. Sonst bleiben sie für eine spätere Neuinstallation erhalten. Der in Bestellungen gespeicherte Abholpunkt wird nie gelöscht, und bestehende Bestellungen behalten ihre Versandpositionen.
DPD ist eine Marke ihres jeweiligen Inhabers. Dieses Plugin ist nicht mit DPD verbunden und wird von DPD nicht unterstützt.