VibeFox DHL Packstation for WooCommerce — Hilfe
Anforderungen
WordPress: 5.8 oder neuer.
WooCommerce: 7.0 oder neuer, installiert und aktiv. Ohne WooCommerce lässt sich das Plugin nicht aktivieren.
PHP: 8.0 oder neuer.
DHL API key: Die Liste der Standorte stammt aus 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 die Methode an der Kasse ausgeblendet. Achten Sie auf das Anfragelimit Ihrer DHL-App: Jede neue Suche nach PLZ oder Ort ist eine API-Anfrage.
VibeFox license key: erhältlich auf vibefox.net. Ein Schlüssel funktioniert für eine 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. Alternativ können Sie den Ordner vfd_dhl_packstation per FTP nach /wp-content/plugins/ hochladen.
2. Klicken Sie auf Activate.
3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Shipping > DHL Packstation oder klicken Sie auf der Seite Plugins unter dem Plugin-Namen auf Settings.
4. Geben Sie Ihren VibeFox-Lizenzschlüssel im Lizenzblock oben auf der Seite ein und klicken Sie auf Activate.
5. Fügen Sie den DHL-API-Schlüssel ein, speichern Sie, klicken Sie auf Test API key, wählen Sie die Standorttypen aus und geben Sie die Preise je Land ein (siehe Konfiguration).
6. Fügen Sie DHL Packstation einer Versandzone (zum Beispiel Deutschland) unter WooCommerce > Settings > Shipping > Shipping zones hinzu oder aktivieren Sie Ignore shipping zones.
Konfiguration
Alle Einstellungen befinden sich auf einer Seite: WooCommerce > Settings > Shipping > DHL Packstation. Sie gelten für alle Versandzonen. Wenn Sie die Methode einer Zone hinzufügen, hat das Zonenfenster nur ein Feld:
Title (zone): der Name dieser Versandoption an der Kasse für diese Zone. Lassen Sie das Feld leer, um den globalen Name zu verwenden.
Warnungen oberhalb der Einstellungen zeigen an, wenn der DHL-API-Schlüssel leer ist und wenn Ländereinträge im Preisfeld nicht im richtigen Format sind. Bei jedem Speichern der Einstellungen wird der Standort-Cache geleert.
Allgemein
Enable/Disable: schaltet die Methode in allen Zonen gleichzeitig ein oder aus.
Name: der Name der Versandmethode, den der Kunde sieht. Standard: DHL Packstation. Eine Zone kann ihn mit einem eigenen Title überschreiben.
Tax status: Taxable fügt die WooCommerce-Steuer zu den Versandkosten hinzu, None nicht.
DHL Location Finder API
DHL API key: der API-Schlüssel Ihrer App auf developer.dhl.com. Ohne ihn wird die Methode an der Kasse ausgeblendet.
Connection test: Der Button Test API key sucht mit dem gespeicherten Schlüssel nach Standorten in der Nähe von 53113 Bonn und leert den Standort-Cache. Speichern Sie die Einstellungen vorher. Angezeigt wird, wie viele Standorte gefunden wurden, oder dass DHL den Schlüssel abgelehnt hat (401/403).
Abholstandorte
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 die Methode 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. DHL erlaubt bis zu 25000 m.
Max results: die maximale Anzahl Standorte pro Suche. Standard: 20. DHL erlaubt bis zu 50.
Shipping address: verwendet den gewählten Standort als Versandadresse der Bestellung. Standardmäßig aktiviert. Adresszeile 1 wird zum Beispiel „Packstation 105“, Zeile 2 „Postnummer“ mit der Nummer, dazu PLZ und Ort des Standorts, damit Etiketten, die aus der Bestellung gedruckt werden, an den richtigen Ort gehen. Die Postnummer wird außerdem als _shipping_dhl_postnum gespeichert, dem Feld, das das offizielle Plugin „DHL Shipping Germany for WooCommerce“ liest.
Preise
Country prices: der Preis je Zielland in der Shopwährung im Format CC:PREIS, 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. Leer lassen, um die Methode für solche 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 Warenkorb-Zwischensumme, ab der dieser Versand kostenlos ist. Leer lassen, wenn der Versand nie kostenlos sein soll.
Verfügbarkeit
Min weight (kg): das minimale Warenkorbgewicht. Produktgewichte werden aus der Gewichtseinheit Ihres Shops umgerechnet. 0 bedeutet kein Limit.
Max weight (kg): die Methode wird oberhalb dieses Warenkorbgewichts ausgeblendet. Standard: 31.5, da eine Packstation Pakete bis 31,5 kg annimmt. 0 bedeutet kein Limit.
Minimum subtotal: zeigt die Methode nur, wenn die Warenkorb-Zwischensumme mindestens diesen Wert erreicht. Leer lassen, um sie immer anzuzeigen.
Excluded shipping classes: die Methode wird ausgeblendet, wenn der Warenkorb ein Produkt einer dieser WooCommerce-Versandklassen enthält.
Ignore shipping zones: bietet die Methode für die unten genannten Länder an, auch wenn die passende Zone sie nicht enthält.
Countries (ignore zones): die Zielländer für diesen Modus. Leer lassen für alle Länder. Wird nur zusammen mit Ignore shipping zones verwendet.
Erweitert
Debug log: protokolliert API-Anfragen und Schritte an der Kasse unter WooCommerce > Status > Logs, Quelle vfd-dhl-packstation. API-Fehler werden immer protokolliert, auch wenn dies ausgeschaltet ist. Der API-Schlüssel, die Postnummer und Kundenadressen werden nie protokolliert.
Remove data on uninstall: ist diese Option aktiv, entfernt das Löschen des Plugins seine Einstellungen und Zonenmethoden. Deaktivieren löscht nie etwas. Die gewählten Standorte bleiben in den Bestellungen erhalten.
So funktioniert es 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, nimmt den Preis für das Zielland (oder den Preis für andere Länder) und wendet kostenlosen Versand an, wenn die Zwischensumme hoch genug ist.
Die Methode funktioniert an der klassischen Kasse sowie in den Blöcken Warenkorb und Kasse. Sie ist mit WooCommerce High-Performance Order Storage (HPOS) kompatibel.
Das Plugin erstellt keine DHL-Sendungen, druckt keine Etiketten und verfolgt keine Pakete. Verwenden Sie das Geschäftskundenportal von DHL oder ein Etiketten-Plugin: Die Bestellung enthält bereits die Packstation-Adresse und die Postnummer im erwarteten Format. Das Plugin berechnet keine Live-Tarife von DHL und zeigt keine Karte. Ist die DHL-API nicht erreichbar, sieht der Kunde eine Meldung und kann diese Methode erst wieder nutzen, wenn die API wieder funktioniert. Eine manuelle Eingabe einer Packstation-Nummer gibt es nicht.
Abholstandorte
Wenn der Kunde DHL Packstation auswählt, erscheint unter der Versandoption ein Auswahlfeld. Die DHL-Standorte in der Nähe der Versand-PLZ oder des Versandorts werden geladen. Der Kunde kann nach einer anderen PLZ oder einem anderen Ort suchen. Die Standorte werden nach Typ (Packstation, Post Office, Parcel Shop) gruppiert und nach Entfernung sortiert.
Für eine Packstation muss der Kunde die DHL Postnummer eingeben, seine 6- bis 12-stellige DHL-Kundennummer aus der DHL-App oder dem DHL-Konto. Für andere Standorte ist sie optional. Die Bestellung kann ohne Standort oder mit einer ungültigen Postnummer nicht aufgegeben werden. Dies wird auf dem Server geprüft, auch bei der Kasse mit Blöcken.
Suchergebnisse werden 12 Stunden zwischengespeichert. Eine fehlgeschlagene Suche wird 10 Minuten zwischengespeichert, damit die Kasse bei jeder Aktualisierung nicht auf DHL warten muss. Das API-Zeitlimit beträgt 12 Sekunden.
Der Standort (ID, Typ, Nummer, Name, Adresse) und die Postnummer werden in der Bestellung gespeichert. Sie werden auf der Bestellseite unter der Versandadresse, auf der Dankeseite, unter My account > Orders und in den Bestell-E-Mails (HTML und Nur-Text) als DHL pickup location und DHL Postnummer angezeigt.
Auf der Bestellseite klicken Sie neben dem Standort auf Edit, suchen nach PLZ oder Ort, wählen einen anderen Standort, ändern die Postnummer und klicken auf Save location. Jede Änderung erzeugt eine Bestellnotiz. Ist Shipping address aktiviert, wird auch die Versandadresse aktualisiert. Laden Sie die Seite neu, um sie zu sehen.
Lizenzschlüssel
Das Plugin funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock befindet sich oben unter WooCommerce > Settings > Shipping > DHL Packstation. Fügen Sie den Schlüssel in License key ein und klicken Sie auf Activate. Der Block zeigt den Status, zum Beispiel das Datum, bis zu dem die Lizenz aktiv ist, sowie 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 für eine 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 DHL Packstation Kunden an der Kasse nicht angezeigt. Angemeldete Shop-Manager sehen sie weiterhin, markiert mit (unlicensed — visible to admins only), damit Sie das Plugin einrichten und testen können, bevor Sie einen Schlüssel kaufen. Eine Erinnerung erscheint auf der Plugins-Seite 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
DHL Packstation erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist und die Methode der Zone des Landes des Kunden hinzugefügt wurde (oder Ignore shipping zones aktiv und das Land erlaubt ist). Prüfen Sie, ob der DHL API key ausgefüllt ist, mindestens ein Standorttyp ausgewählt ist, das Zielland einen Preis hat (oder Other countries gesetzt ist) und die Regeln für Gewicht, Zwischensumme und Versandklasse die Methode nicht ausblenden.
Keine Standorte werden 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. Aktivieren Sie Debug log und öffnen Sie WooCommerce > Status > Logs, Quelle vfd-dhl-packstation. 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.
Der Lizenzblock zeigt einen Fehler: Folgen Sie der Meldung im Block. Ist der Schlüssel beispielsweise bereits auf einer anderen Domain verwendet, geben Sie in Ihrem vibefox.net-Konto einen Platz frei und klicken Sie auf Check now. Hat sich 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 bei. Es leert nur den Standort-Cache. Zum Entfernen des Plugins deaktivieren und löschen Sie es auf der Seite Plugins. Der Lizenzschlüssel und der Lizenzstatus dieses Plugins werden immer entfernt, ebenso der Standort-Cache. Einstellungen und Zonenmethoden werden nur entfernt, wenn Remove data on uninstall aktiv war. Andernfalls bleiben sie für eine spätere Neuinstallation erhalten. Die gewählten Standorte bleiben in den Bestellungen erhalten, und bestehende Bestellungen behalten ihre Versandzeilen.
DHL und Packstation sind Marken ihrer jeweiligen Inhaber. Dieses Plugin ist weder mit DHL verbunden noch wird es von DHL unterstützt.