VibeFox DHL Africa for WooCommerce — Hilfe
Anforderungen
WordPress: 5.8 oder neuer.
WooCommerce: 5.0 oder neuer, installiert und aktiv. Das Plugin lässt sich ohne WooCommerce nicht aktivieren.
PHP: 8.0 oder neuer.
DHL-Express-Konto (nur für Live-Tarife): Live-Tarife nutzen die MyDHL API. Sie benötigen Ihre DHL-Express-Kontonummer und MyDHL-API-Zugangsdaten: einen API-Schlüssel und ein API-Secret. Beantragen Sie diese im DHL Developer Portal (MyDHL API, „Get access“) oder bei Ihrem DHL-Express-Kundenbetreuer. Konten, die noch DHL-XML-Services-Zugangsdaten (Site ID und Passwort) besitzen, können diese stattdessen verwenden. Wenn Sie nur Ersatzpreise nutzen, benötigen Sie keine DHL-Zugangsdaten.
VibeFox-Lizenzschlüssel: erhältlich auf vibefox.net. Ein Schlüssel gilt 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_africa per FTP nach /wp-content/plugins/ hochladen.
2. Klicken Sie auf Activate.
3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Shipping > DHL Express Africa oder klicken Sie auf der Seite Plugins unter dem Namen des Plugins auf Settings.
4. Geben Sie Ihren VibeFox-Lizenzschlüssel im Lizenzblock oben auf der Seite ein und klicken Sie auf Activate.
5. Wählen Sie die DHL API und geben Sie API-Schlüssel, API-Secret und Ihre DHL-Kontonummer ein. Lassen Sie Test mode eingeschaltet, solange Sie Testzugangsdaten verwenden. Geben Sie die Adresse unter Ship from ein. Wenn Ihr DHL-Konto nicht in Ihrer Shopwährung abgerechnet wird, stellen Sie DHL quote currency und Exchange rate ein. Optional können Sie Länderpreise und einen Ersatzbetrag festlegen (siehe Konfiguration).
6. Fügen Sie DHL Express Africa unter WooCommerce > Settings > Shipping > Shipping zones Ihren Versandzonen hinzu oder aktivieren Sie Ignore shipping zones und wählen Sie Länder aus.
Konfiguration
Alle Einstellungen befinden sich auf einer Seite: WooCommerce > Settings > Shipping > DHL Express Africa. Sie gelten für alle Versandzonen. Wenn Sie die Methode einer Zone hinzufügen, enthält das Zonenfenster 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.
Warnhinweise oberhalb der Einstellungen zeigen an, wenn Live-Tarife deaktiviert sind, weil Zugangsdaten oder der Versandursprung fehlen, sowie wenn eine Angebotswährung ohne Wechselkurs gesetzt ist. Bei jedem Speichern der Einstellungen werden die zwischengespeicherten DHL-Tarife gelöscht. Preise und Gewichte akzeptieren ein Dezimalkomma oder einen Dezimalpunkt.
Allgemein
Enable/Disable: schaltet die Methode in allen Zonen gleichzeitig ein oder aus.
Name: der Name der Versandart, der an der Kasse angezeigt wird. Standard: DHL Express.
Tax status: Taxable (wenn WooCommerce-Steuern aktiviert sind) übernimmt den DHL-Tarif ohne die von DHL angegebene Steuer, und WooCommerce fügt seine eigene Steuer hinzu. None berechnet den DHL-Tarif wie angegeben, inklusive Steuer.
DHL-Express-Konto (nur für Live-Tarife erforderlich)
DHL API: die DHL-Schnittstelle, die verwendet wird. Es werden nur die Felder der gewählten API angezeigt.
API key: Ihr MyDHL-API-Benutzername (API-Schlüssel).
API secret: Ihr MyDHL-API-Passwort (API-Secret).
XML Site ID: Ihre DHL-XML-Services-Site-ID (nur für die Legacy-API).
XML password: Ihr DHL-XML-Services-Passwort (nur für die Legacy-API).
DHL account number: Ihre DHL-Express-Kontonummer (9 Stellen). Die MyDHL API benötigt sie. Mit XML Services liefert sie Ihre Kontotarife statt der veröffentlichten Tarife.
Test mode: nutzt die DHL-Testumgebung. Standardmäßig eingeschaltet. Testzugangsdaten funktionieren nur in der Testumgebung, Produktivzugangsdaten nur in der Produktivumgebung. Schalten Sie ihn aus, wenn Sie live gehen.
Versand ab
Die Adresse, von der DHL die Pakete abholt. Der Tarif hängt davon ab.
Origin country: das Land, aus dem Sie versenden.
Origin city: die Stadt, aus der Sie versenden, zum Beispiel Johannesburg. Die MyDHL API benötigt sie.
Origin postcode: leer lassen für Länder ohne Postleitzahlen (zum Beispiel Kenia, Nigeria, Ghana).
Tarife
Alle Preise sind in Ihrer Shopwährung. Der Live-Tarif ist das günstigste DHL-Express-Produkt für das Paket. Wenn DHL nicht konfiguriert ist, fehlschlägt oder für die Route keinen Service hat, wird der Länderpreis verwendet, danach der Ersatzbetrag. Ohne beides wird die Methode ausgeblendet.
DHL quote currency: DHL gibt Tarife in der Währung des Landes Ihres DHL-Kontos an (zum Beispiel ZAR, NGN oder KES). Wenn DHL keinen Betrag in Ihrer Shopwährung zurückgibt, wird der Live-Tarif mit dem unten stehenden Wechselkurs aus dieser Währung umgerechnet. Andernfalls wird er nicht verwendet.
Exchange rate: wie viel 1 Einheit der DHL-Angebotswährung in Ihrer Shopwährung ist, zum Beispiel 1 ZAR = 0.05. Leer lassen, wenn keine Umrechnung erfolgen soll. Der Kurs wird manuell eingegeben.
Fallback cost: ein pauschaler Betrag, wenn es weder Live-Tarif noch Länderpreis gibt. Leer lassen, um die Methode auszublenden.
Country prices: ein Ersatzpreis pro Zielland, einer pro Zeile: CC:Price, zum Beispiel ZA:25.00. Wird verwendet, wenn kein Live-Tarif vorliegt.
Fallback price basis: Per order berechnet den Preis einmal. Per item (multiplied by the cart quantity) multipliziert ihn mit der Anzahl der Artikel im Warenkorb. Gilt nur für den Länderpreis und den Ersatzbetrag. Der Live-DHL-Tarif gilt immer für das gesamte Paket.
Free shipping from: die Warenkorb-Zwischensumme, ab der diese Methode kostenlos ist. DHL wird nicht abgefragt. Leer lassen, wenn die Methode nie kostenlos sein soll.
Bedingungen
Minimum weight (kg): blendet die Methode unterhalb dieses Warenkorbgewichts aus. 0 bedeutet keine Grenze.
Maximum weight (kg): blendet die Methode oberhalb dieses Warenkorbgewichts aus. Standard: 70. 0 bedeutet keine Grenze.
Minimum subtotal: zeigt die Methode nur, wenn die Warenkorb-Zwischensumme mindestens diesen Betrag erreicht. Leer lassen, um sie immer anzuzeigen.
Excluded shipping classes: blendet die Methode aus, wenn der Warenkorb ein Produkt aus einer dieser WooCommerce-Versandklassen enthält.
Verfügbarkeit ohne Versandzonen
Ignore shipping zones: bietet die Methode für die unten genannten Länder an, auch wenn die passende Versandzone die Methode nicht enthält.
Countries: die Zielländer für diesen Modus. Leer lassen, um alle Länder zu verwenden, in die Sie versenden. Wird nur mit Ignore shipping zones verwendet.
Erweitert
Debug log: protokolliert Tarifberechnungen unter WooCommerce > Status > Logs, Quelle vfd-dhl-africa. DHL-Fehler werden immer protokolliert, auch wenn dies ausgeschaltet ist. Zugangsdaten und Kundenadressen werden nie protokolliert.
Remove data on uninstall: wenn aktiv, entfernt das Löschen des Plugins dessen Einstellungen und Zonenmethoden. Das Deaktivieren des Plugins löscht nie Daten.
So funktioniert es an der Kasse
Wenn der Kunde eine Lieferadresse eingibt, fragt WooCommerce das Plugin nach einem Tarif. Das Plugin prüft zuerst das Warenkorbgewicht, die Mindestzwischensumme und die ausgeschlossenen Versandklassen. Gilt kostenloser Versand, erhält der Kunde kostenlose Lieferung und es geht keine Anfrage an DHL.
Andernfalls sendet das Plugin an DHL Herkunft und Ziel (Land, Stadt, Postleitzahl), das Warenkorbgewicht umgerechnet in kg (mindestens 0,5 kg) und eine Box aus den Produktabmessungen in cm: die größte Länge, die größte Breite und die gestapelten Höhen. Produkte ohne Abmessungen fügen nichts hinzu. Hat kein Produkt Abmessungen, wird eine Box mit 10 x 10 x 10 cm verwendet. Internationale Sendungen werden als Waren deklariert, wobei die Warenkorb-Zwischensumme als Warenwert angegeben wird, sodass DHL Paketprodukte anbietet. Inlandssendungen werden nicht deklariert. Ein Live-Tarif wird erst angefragt, nachdem der Kunde eine Stadt eingegeben hat (bei XML Services eine Stadt oder eine Postleitzahl).
Das günstigste DHL-Express-Produkt wird als ein Tarif mit Ihrem Titel angezeigt. Der Kunde sieht weder das DHL-Produkt noch eine Lieferzeit. Der Produktname (zum Beispiel „EXPRESS WORLDWIDE (P)“) wird als DHL product in der Versandposition der Bestellung gespeichert, damit Sie wissen, was Sie buchen müssen.
Jeder Tarif wird 1 Stunde pro Paket und Route zwischengespeichert. Eine fehlgeschlagene Anfrage wird 10 Minuten zwischengespeichert, damit die Kasse bei jeder Aktualisierung nicht auf DHL warten muss. Das API-Timeout beträgt 12 Sekunden. Gibt DHL einen Fehler zurück oder hat keinen Service, sieht der Kunde keine Fehlermeldung: Es wird der Ersatzpreis verwendet oder die Methode wird ausgeblendet.
Die Methode funktioniert in der klassischen Kasse sowie in den Warenkorb- und Kassen-Blöcken. Sie ist mit WooCommerce High-Performance Order Storage (HPOS) kompatibel.
Das Plugin berechnet nur Tarife. Es erstellt keine DHL-Sendungen, druckt keine Etiketten oder Handelsrechnungen, bucht keine Abholungen, verfolgt keine Pakete, bietet keine DHL-Servicepunkte an, lässt den Kunden nicht zwischen DHL-Produkten wählen, verteilt nicht auf mehrere Boxen, bietet keine Versicherung an und berechnet keine Zölle und Einfuhrsteuern. Der Tarif gilt nur für den Versand. Zölle und Einfuhrabgaben trägt der Empfänger.
Lizenzschlüssel
Das Plugin funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock befindet sich oben unter WooCommerce > Settings > Shipping > DHL Express Africa. Fügen Sie den Schlüssel unter License key ein und klicken Sie auf Activate. Der Block zeigt den Status an, 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 gilt 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 Express Kunden an der Kasse nicht angezeigt. Angemeldete Shop-Manager sehen die Methode 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.
Wenn eine Lizenz abläuft, funktioniert das Plugin weiter, Updates und Support erfordern jedoch eine Verlängerung. Der Status wird automatisch im Hintergrund erneut geprüft.
Fehlerbehebung
DHL Express 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 ist und das Land erlaubt ist). Prüfen Sie die Gewichtsgrenzen, Minimum subtotal und Excluded shipping classes. Ohne Live-Tarif erscheint die Methode nur, wenn ein Länderpreis oder ein Ersatzbetrag festgelegt ist.
Live-Tarife erscheinen nicht: prüfen Sie die Warnhinweise oben auf der Einstellungsseite (fehlende Zugangsdaten oder fehlender Versandursprung). Aktivieren Sie Debug log und öffnen Sie WooCommerce > Status > Logs, Quelle vfd-dhl-africa. DHL-Fehler wie falsche Zugangsdaten, fehlender Service für die Route oder ein Währungsproblem werden immer protokolliert. Prüfen Sie, ob Test mode zu Ihren Zugangsdaten passt.
DHL liefert den Tarif in ZAR, NGN oder KES, aber mein Shop verwendet eine andere Währung: stellen Sie DHL quote currency auf diese Währung ein und geben Sie den Exchange rate ein. Ohne ihn wird der Live-Tarif nicht verwendet und es gelten die Ersatzpreise.
Ich habe alte DHL-XML-Services-Zugangsdaten: wählen Sie unter DHL API die Option XML Services (legacy). Wechseln Sie zur MyDHL API, sobald Sie MyDHL-Zugangsdaten erhalten.
Die Versandsteuer wird doppelt berechnet: stellen Sie Tax status auf Taxable, damit der DHL-Tarif ohne DHL-Mehrwertsteuer übernommen wird, oder auf None, um den DHL-Betrag wie angegeben zu berechnen.
Tarife wirken nach einer Änderung veraltet: speichern Sie die Einstellungsseite. Dadurch werden die zwischengespeicherten DHL-Tarife gelöscht.
Der Lizenzblock zeigt einen Fehler: folgen Sie der Meldung im Block. Wenn der Schlüssel zum Beispiel bereits auf einer anderen Domain verwendet wird, geben Sie in Ihrem vibefox.net-Konto einen Platz frei und klicken Sie auf Check now. Wenn sich die Adresse der Website geändert hat, 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 letzten bekannten Status weiter.
Deinstallation
Beim Deaktivieren des Plugins bleiben alle Einstellungen erhalten. Dabei werden nur die zwischengespeicherten DHL-Tarife gelöscht. 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 die zwischengespeicherten Tarife. Einstellungen und Zonenmethoden werden nur entfernt, wenn Remove data on uninstall aktiv war. Andernfalls bleiben sie für eine spätere Neuinstallation erhalten. Bestellungen werden nie verändert, und bestehende Bestellungen behalten ihre Versandpositionen.
DHL ist eine Marke ihres jeweiligen Inhabers. Dieses Plugin ist weder mit DHL verbunden noch von DHL empfohlen.