VibeFox Delhivery 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.
Delhivery-API-Token (nur für Live-Tarife): Melden Sie sich bei Delhivery One an und öffnen Sie Settings > API setup. Der Delhivery-Hilfeartikel „API token generation“ erklärt die Schritte. Test-Token funktionieren mit der Staging-Umgebung. Sie benötigen außerdem die 6-stellige PIN-Code-Nummer Ihres Abholorts. Wenn Sie nur Festpreise nutzen, brauchen Sie kein Token.
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. Sie können auch den Ordner vfd_delhivery per FTP nach /wp-content/plugins/ hochladen.
2. Klicken Sie auf Activate.
3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Shipping > VibeFox Delhivery, 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. Geben Sie das API-Token und Ihren Ursprungs-PIN-Code ein, wählen Sie Express oder Surface sowie Pre-paid oder COD. Wenn die Währung Ihres Shops nicht INR ist, geben Sie den Umrechnungskurs ein. Optional geben Sie Festpreise ein (siehe Konfiguration).
6. Fügen Sie VibeFox Delhivery einer Versandzone hinzu (zum Beispiel Indien) unter WooCommerce > Settings > Shipping > Shipping zones, oder aktivieren Sie Ignore zones und wählen Sie Länder aus.
Konfiguration
Alle Einstellungen befinden sich auf einer Seite: WooCommerce > Settings > Shipping > VibeFox Delhivery. Sie gelten für alle Versandzonen. Wenn Sie die Methode einer Zone hinzufügen, hat das Zonenfenster nur ein Feld:
Title (zone): der Name, den Kunden für diese Zone sehen. Leer lassen, um die globale Method title zu verwenden.
Jedes Mal, wenn Sie die Einstellungen speichern, werden die zwischengespeicherten Delhivery-Tarife gelöscht. Preise und Beträge akzeptieren „9.99“ und „9,99“.
Allgemein
Enable/Disable: schaltet die Methode in allen Zonen gleichzeitig ein oder aus.
Method title: der Name der Versandmethode an der Kasse. Standard: Delhivery. Eine Zone kann ihn durch einen eigenen Title ersetzen.
Tax status: Taxable fügt die WooCommerce-Steuer auf die Versandkosten hinzu, None nicht.
Delhivery-API-Konto (nur für Live-Tarife erforderlich)
Environment: Production (track.delhivery.com) (Standard) oder Staging / test account (staging-express.delhivery.com). Verwenden Sie Staging nur mit einem Delhivery-Test-Token.
API token: Ihr Delhivery-API-Token. Es wird nur im Autorisierungs-Header gesendet und nie protokolliert.
Origin pincode: die 6-stellige PIN-Code-Nummer Ihres Abholorts oder Lagers, zum Beispiel 110001.
Live-Tarife
Ein Live-Tarif wird für indische Ziele mit einer gültigen 6-stelligen PIN-Code-Nummer angefragt, für eine Vorwärtssendung (Zustellung).
Shipping mode: der Delhivery-Abrechnungsmodus für den Tarif: Express (Standard) oder Surface.
Payment type: die Zahlungsart, die an Delhivery gesendet wird: Pre-paid (Standard) oder COD (Nachnahme; Delhivery fügt seine COD-Gebühr hinzu). Das Plugin wechselt sie nicht abhängig von der Zahlungsmethode, die der Kunde wählt.
Rate amount: Delhivery liefert den Betrag mit und ohne GST.
INR to (store currency) conversion rate: Delhivery-Tarife sind in indischen Rupien angegeben. Wenn die Währung Ihres Shops nicht INR ist, geben Sie ein, wie viele Einheiten Ihrer Währung eine Rupie wert ist, zum Beispiel 0.011. Lassen Sie das Feld leer, werden keine Live-Tarife verwendet, es gelten die Festpreise und oberhalb der Einstellungen erscheint ein Hinweis. Nicht nötig, wenn die Währung Ihres Shops INR ist.
Festpreise (werden verwendet, wenn kein Live-Tarif verfügbar ist)
Festpreise gelten, wenn noch kein Token oder keine PIN-Code-Nummer vorhanden ist, das Ziel außerhalb Indiens liegt, die PIN-Code-Nummer nicht bedient wird oder die API einen Fehler zurückgibt. Sie sind in der Währung Ihres Shops angegeben.
Prices per country: eine Zeile pro Land im Format COUNTRY_CODE:price, zum Beispiel IN:120. Wird vor dem Ausweichpreis geprüft.
Fallback price: wird verwendet, wenn weder ein Live-Tarif noch ein Länderpreis gilt. Leer lassen, um die Methode auszublenden. 0 bedeutet kostenlos.
Fixed price is charged: Per order berechnet den Preis einmal. Per item (price × quantity) multipliziert ihn mit der Anzahl der Artikel im Warenkorb. Ein Live-Tarif von Delhivery gilt immer für das Gesamtgewicht des Pakets.
Bedingungen
Free shipping from: die Lieferung ist kostenlos, wenn die Zwischensumme des Warenkorbs mindestens diesen Betrag erreicht. Es wird keine Anfrage an Delhivery gesendet. Leer lassen, um die Option zu deaktivieren.
Show from subtotal: die Methode nur anzeigen, wenn die Zwischensumme des Warenkorbs mindestens diesen Betrag erreicht. Leer lassen, um sie immer anzuzeigen.
Min weight (kg): das minimale Warenkorbgewicht, ab dem die Methode angezeigt wird. 0 bedeutet keine Grenze.
Max weight (kg): blendet die Methode aus, wenn der Warenkorb schwerer ist. Standard: 30. 0 bedeutet keine Grenze.
Produktgewichte werden aus der Gewichtseinheit Ihres Shops in kg umgerechnet. Der Tarif verwendet das tatsächliche Warenkorbgewicht (die Summe der Produktgewichte), ohne volumetrisches Gewicht oder Kartons.
Excluded shipping classes: blendet die Methode aus, wenn ein Artikel im Warenkorb zu einer dieser WooCommerce-Versandklassen gehört.
Verfügbarkeit ohne Versandzonen
Ignore zones: bietet Delhivery an, ohne es einer Versandzone hinzuzufügen, für die unten angegebenen Länder.
Countries: die Zielländer für diesen Modus. Leer lassen, um alle Länder zu verwenden, in die Sie liefern. Wird nur verwendet, wenn Ignore zones aktiviert ist.
Erweitert
Debug log: protokolliert Tarifberechnungen unter WooCommerce > Status > Logs, Quelle vfd_delhivery. API-Fehler werden immer protokolliert, auch wenn diese Option aus ist. Token und vollständige PIN-Code-Nummern von Kunden werden nie protokolliert.
Remove data on uninstall: wenn aktiviert, entfernt das Löschen des Plugins alle seine Einstellungen, Zonenmethoden und zwischengespeicherten Tarife. Das Deaktivieren des Plugins löscht nie etwas.
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 Zwischensumme und die ausgeschlossenen Versandklassen. Gilt kostenloser Versand, erhält der Kunde die Lieferung kostenlos und es wird keine Anfrage an Delhivery gesendet.
Für eine indische Adresse mit gültiger 6-stelliger PIN-Code-Nummer sendet das Plugin an Delhivery die Ursprungs- und Ziel-PIN-Codes, das Warenkorbgewicht in Gramm, den Versandmodus und die Zahlungsart und zeigt den zurückgegebenen Betrag in der Währung Ihres Shops an. Jede Antwort wird 1 Stunde zwischengespeichert. Eine fehlgeschlagene Anfrage wird 10 Minuten zwischengespeichert, damit die Kasse bei jeder Aktualisierung nicht auf Delhivery warten muss. Das API-Zeitlimit beträgt 10 Sekunden.
Gibt es keinen Live-Tarif, gilt der Preis für das Land oder der Ausweichpreis. Ist keiner von beiden gesetzt, wird die Methode ausgeblendet. Der Kunde sieht nie einen API-Fehler.
Die Methode funktioniert in der klassischen Kasse sowie in den Blöcken Warenkorb und Kasse. Sie ist mit der Speicherung von Bestellungen mit hoher Leistung (HPOS) von WooCommerce kompatibel.
Das Plugin berechnet Tarife und zeigt einen Sendungsverfolgungslink. Es erstellt keine Sendungen oder Frachtbriefe, druckt keine Etiketten, beauftragt keine Abholungen oder Manifeste, prüft nicht die Bedienbarkeit von PIN-Codes, schätzt keine Liefertermine, synchronisiert keine Sendungsstatus und berechnet keine internationalen Delhivery-Tarife. Außerhalb Indiens werden nur die Festpreise verwendet.
Bestellungen und Sendungsverfolgung
Auf dem Bestellbildschirm unter der Lieferadresse zeigt der Block Delhivery den Versandmodus (Express oder Surface) und die Preisquelle: Live-Tarif von Delhivery, Festpreis oder Schwellenwert für kostenlosen Versand.
Erstellen Sie die Sendung in Delhivery One, fügen Sie dann deren AWB in das Feld Delhivery AWB / tracking number ein und speichern Sie die Bestellung. Im Admin erscheint ein Link Track on delhivery.com. Der Kunde sieht Delhivery tracking mit einem Link auf der Bestellseite unter „Mein Konto“ und in den Bestell-E-Mails (HTML und Nur-Text). Die AWB wird vor dem Bestellstatus gespeichert, daher enthält die E-Mail „Abgeschlossene Bestellung“ sie bereits, wenn Sie die Bestellung beim selben Speichern abschließen.
Lizenzschlüssel
Das Plugin funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock befindet sich oben unter WooCommerce > Settings > Shipping > VibeFox Delhivery. 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, 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 Delhivery Kunden an der Kasse nicht angezeigt. Angemeldete Shop-Manager sehen es weiterhin, markiert mit (unlicensed — visible to admins only), damit Sie das Plugin einrichten und testen können, bevor Sie einen Schlüssel kaufen. Auf der Seite Plugins und auf WooCommerce-Seiten erscheint eine Erinnerung. Bestehende Bestellungen sind nicht betroffen.
Läuft eine Lizenz ab, arbeitet das Plugin weiter, für Updates und Support ist aber eine Verlängerung nötig. Der Status wird im Hintergrund automatisch erneut geprüft.
Fehlerbehebung
Delhivery erscheint nicht an der Kasse: prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist und die Methode der Zone des Kundenlandes hinzugefügt wurde (oder Ignore zones aktiv ist und das Land erlaubt ist). Prüfen Sie die Gewichtsgrenzen, Show from subtotal und Excluded shipping classes. Ohne Live-Tarif ist ein Länderpreis oder ein Fallback price nötig.
Live-Tarife erscheinen nicht: prüfen Sie das API-Token, eine gültige Origin pincode und bei einem Shop mit einer Nicht-INR-Währung den Umrechnungskurs. Der Kunde muss eine gültige 6-stellige indische PIN-Code-Nummer eingeben. Aktivieren Sie Debug log und öffnen Sie WooCommerce > Status > Logs, Quelle vfd_delhivery, um die API-Fehler zu sehen, zum Beispiel eine PIN-Code-Nummer, die nicht bedient wird.
GST wird doppelt berechnet: Der Gesamtbetrag von Delhivery enthält bereits GST. Stellen Sie Rate amount auf Gross amount (excluding GST) oder Tax status auf None.
Testen: Verwenden Sie Environment Staging mit einem Delhivery-Test-Token.
Tarife wirken nach einer Änderung veraltet: Speichern Sie die Einstellungsseite. Dadurch werden die zwischengespeicherten Delhivery-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 einen Platz in Ihrem vibefox.net-Konto 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 Daten. Zum Entfernen deaktivieren Sie es und löschen Sie es auf der Seite Plugins. Der Lizenzschlüssel und der Lizenzstatus dieses Plugins werden immer entfernt. Einstellungen, Zonenmethoden und zwischengespeicherte Tarife werden nur entfernt, wenn Remove data on uninstall aktiv war. Andernfalls bleiben sie für eine spätere Neuinstallation erhalten. AWB-Nummern bleiben in den Bestellungen, und bestehende Bestellungen behalten ihre Versandpositionen.
Delhivery ist eine Marke ihres jeweiligen Inhabers. Dieses Plugin ist nicht mit Delhivery verbunden und wird nicht von Delhivery unterstützt.