VibeFox Delhivery 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.

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. Beide Links befinden sich auf der Modulseite. Test-Token funktionieren mit der Staging-Umgebung. Außerdem benötigen Sie die 6-stellige PIN-Code-Nummer Ihres Abholorts. Wenn Sie nur Festpreise verwenden, benötigen Sie kein Token.

VibeFox-Lizenzschlüssel: Erhältlich auf vibefox.net. Ein Schlüssel gilt für eine 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 aus.

2. Wenn der Upload abgeschlossen ist, klicken Sie auf Configure oder suchen Sie später VibeFox Delhivery in der Modulliste und klicken Sie dort auf Configure.

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

4. Geben Sie den API-Token und Ihre Ursprungs-PIN-Code-Nummer ein, wählen Sie Express oder Surface sowie Pre-paid oder COD. Wenn die Standardwährung Ihres Shops nicht INR ist, geben Sie den Umrechnungskurs ein. Optional können Sie Festpreise eingeben (siehe Konfiguration). Klicken Sie auf Save.

Bei der Installation legt das Modul den Versanddienstleister Delhivery mit dem Lieferzeittext Courier delivery (India) und der Delhivery-Sendungsverfolgungsseite als Tracking-URL an. Der Versanddienstleister wird allen Zonen und allen Kundengruppen zugewiesen. Zonen, Kundengruppen, Lieferzeit, Logo und Größenbeschränkungen können Sie unter Shipping > Carriers ändern. Setzen Sie dort keine Preise: Der Preis kommt immer aus dem Modul.

Konfiguration

Alle Einstellungen befinden sich auf der Modulseite: Modules > Module Manager > VibeFox Delhivery > Configure. Sie gelten für alle Zonen. Jeder Abschnitt hat eine eigene Schaltfläche Save, die die gesamte Seite speichert. Jedes Speichern leert außerdem die zwischengespeicherten Delhivery-Tarife. Beträge akzeptieren „9.99“ und „9,99“. Wenn ein Zahlenfeld keine nicht negative Zahl enthält, wird ein Fehler angezeigt und nichts gespeichert.

Wenn die Standardwährung Ihres Shops nicht INR ist, ein API-Token gespeichert ist und kein Umrechnungskurs festgelegt wurde, erinnert eine Warnung oberhalb des Formulars daran, dass Live-Tarife erst verwendet werden, wenn Sie den Kurs eingeben. Wenn die Gewichtseinheit Ihres Shops keine Standardeinheit ist (kg, g, lb oder oz), fordert eine Warnung Sie auf, sie unter International > Localization (Local units) festzulegen, da Produktgewichte sonst als Kilogramm gelesen werden.

Allgemein

Enable Delhivery: schaltet den Versanddienstleister ein oder aus. Dies ist derselbe Schalter wie der Status des Versanddienstleisters unter Shipping > Carriers.

Method title: der Name des Versanddienstleisters, der im Warenkorb und an der Kasse angezeigt wird. Standard: Delhivery. Pflichtfeld, höchstens 64 Zeichen.

Tax: die Steuerregel des Versanddienstleisters oder No tax. Mit einer Regel fügt PrestaShop die Steuer auf die Versandkosten hinzu.

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 niemals in Logs geschrieben. Nach dem Speichern bleibt das Feld leer und zeigt Saved — leave empty to keep it. an. Geben Sie nur dann einen neuen Wert ein, wenn Sie ihn ändern möchten.

Remove saved token: aktivieren und speichern, um das gespeicherte Token zu löschen. Danach werden nur noch die Festpreise verwendet.

Origin pincode: die 6-stellige PIN-Code-Nummer Ihres Abholorts oder Lagers, zum Beispiel 110001. Hat sie nicht 6 Stellen, wird eine Warnung angezeigt und es werden keine Live-Tarife angefragt, bis sie korrigiert ist.

Live-Tarife

Ein Live-Tarif wird für indische Ziele mit einer gültigen 6-stelligen PIN-Code-Nummer angefragt, und zwar für eine Vorwärtssendung (Zustellung).

Shipping mode: der Delhivery-Abrechnungsmodus für den Tarif: Express (Standard) oder Surface.

Payment type: die an Delhivery übermittelte Zahlungsart: Pre-paid (Standard) oder COD (cash on delivery — Delhivery adds its COD charge). Das Modul wechselt sie nicht anhand der vom Kunden gewählten Zahlungsmethode.

Rate amount: Delhivery liefert den Betrag mit und ohne GST zurück.

INR to (shop currency) conversion rate: die Beschriftung zeigt die Standardwährung Ihres Shops. Delhivery-Tarife sind in indischen Rupien. Ist Ihre Standardwährung nicht INR, geben Sie ein, wie viele Einheiten Ihrer Währung einer Rupie entsprechen, zum Beispiel 0.011. Der Kurs muss größer als 0 sein. Lassen Sie das Feld leer, werden keine Live-Tarife verwendet und die Festpreise gelten. Nicht erforderlich, wenn Ihre Standardwährung INR ist.

Festpreise (werden verwendet, wenn kein Live-Tarif verfügbar ist)

Festpreise werden verwendet, wenn noch kein Token oder keine PIN-Code-Nummer vorhanden ist, das Ziel außerhalb Indiens liegt, die PIN-Code-Nummer nicht zustellbar ist oder die API einen Fehler zurückgibt. Sie gelten in der Standardwährung Ihres Shops, ohne Steuern.

Prices per country: eine Zeile pro Land im Format COUNTRY_CODE:price, zum Beispiel IN:120. Wird vor dem Ausweichpreis geprüft. Zeilen in einem anderen Format werden beim Speichern verworfen, und eine Warnung listet sie auf.

Fallback price: wird verwendet, wenn weder ein Live-Tarif noch ein Länderpreis zutrifft. Lassen Sie das Feld leer, um den Versanddienstleister 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 (versandpflichtige Produkte, nach Rabatten, vor Steuern) mindestens diesen Betrag erreicht. Es wird keine Anfrage an Delhivery gesendet. Leer lassen, um dies zu deaktivieren.

Show from subtotal: zeigt den Versanddienstleister nur an, wenn die Zwischensumme des Warenkorbs mindestens diesen Betrag erreicht. Leer lassen, um ihn immer anzuzeigen.

Min weight: das minimale Warenkorbgewicht in kg, damit der Versanddienstleister angezeigt wird. 0 bedeutet keine Begrenzung.

Max weight: blendet den Versanddienstleister aus, wenn der Warenkorb schwerer ist, in kg. Standard: 30. 0 bedeutet keine Begrenzung, ein leeres Feld bedeutet 30 kg. Min weight darf nicht größer sein als Max weight: Die Seite zeigt einen Fehler an und speichert nichts.

Produktgewichte werden aus der Gewichtseinheit Ihres Shops in kg umgerechnet. Der Tarif verwendet das tatsächliche Warenkorbgewicht (die Summe der Produktgewichte), ohne Volumengewicht oder Kartons.

Verfügbarkeit ohne Versandzonen

Ignore zones: ist die Option deaktiviert, werden die Länder durch die Zonen des Versanddienstleisters unter Shipping > Carriers festgelegt. Ist sie aktiviert, wird der Versanddienstleister allen Zonen zugewiesen (auch später angelegten Zonen) und für die unten genannten Länder angeboten. Wird sie deaktiviert, erhält der Versanddienstleister seine vorherigen Zonen zurück.

Countries: die Zielländer für diesen Modus, aus Ihren aktiven Ländern ausgewählt. Leer lassen, um alle Länder zu verwenden, in die Sie liefern. Wird nur verwendet, wenn Ignore zones aktiviert ist.

Erweitert

Debug log: schreibt die Tarifberechnungen in logs/vfd_dlv_debug.log.php im Modulordner. Die Datei kann nicht über das Web geöffnet werden. API-Fehler werden immer protokolliert, auch wenn diese Option deaktiviert ist. Token und vollständige PIN-Code-Nummern von Kunden werden niemals protokolliert.

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

Remove data on uninstall: ist die Option aktiviert, löscht die Deinstallation des Moduls die Delhivery-Einstellungen, den Versanddienstleister, die zwischengespeicherten Tarife, die Bestelldaten und die Logs. Ist sie deaktiviert, bleibt alles für eine erneute Installation erhalten. AWB-Nummern von Bestellungen werden niemals gelöscht.

So funktioniert es an der Kasse

Im Versandschritt fragt PrestaShop das Modul nach dem Delhivery-Preis. Nur physische Produkte zählen: Virtuelle Produkte erhöhen das Gewicht nicht und sind nicht in der Zwischensumme enthalten. Das Modul prüft zuerst die Länder (wenn Ignore zones aktiviert ist), das Warenkorbgewicht und Show from subtotal. Gilt kostenloser Versand, beträgt der Preis 0 und es wird keine Anfrage an Delhivery gesendet.

Bei einer indischen Adresse mit gültiger 6-stelliger PIN-Code-Nummer sendet das Modul an Delhivery die Ursprungs- und Ziel-PIN-Code-Nummern, das Warenkorbgewicht in Gramm, den Versandmodus und die Zahlungsart. Der zurückgegebene Betrag wird von INR in die Standardwährung Ihres Shops umgerechnet und anschließend in der Warenkorbwährung des Kunden angezeigt. 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-Timeout beträgt 10 Sekunden.

Gibt es keinen Live-Tarif, wird der Länderpreis oder der Ausweichpreis verwendet. Ist keiner von beiden gesetzt, wird der Versanddienstleister ausgeblendet. Der Kunde sieht nie einen API-Fehler. Der Grund wird im Log festgehalten.

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 berechnet Tarife und gibt Kunden einen Sendungsverfolgungslink. Es erstellt keine Sendungen oder Frachtbriefe, druckt keine Etiketten, beauftragt keine Abholungen oder Manifeste, prüft nicht die Zustellbarkeit von PIN-Code-Nummern, schätzt keine Liefertermine, synchronisiert keine Sendungsstatus und berechnet keine internationalen Delhivery-Tarife. Außerhalb Indiens werden nur die Festpreise verwendet.

Bestellungen und Sendungsverfolgung

Wenn eine Bestellung mit Delhivery aufgegeben wird, speichert das Modul den Versandmodus und die Preisquelle zusammen mit der Bestellung. Auf der Bestellseite im Admin zeigt der Block Delhivery Mode: (Express oder Surface), Price: (Live-Tarif von Delhivery, Festpreis oder Schwelle für kostenlosen Versand) sowie die Delhivery AWB / tracking number oder Not entered yet. an.

Legen Sie die Sendung in Delhivery One an und geben Sie danach ihre AWB-Nummer als Tracking-Nummer der Bestellung im Block Carriers auf der Bestellseite (Edit) ein. Der Block Delhivery zeigt dann einen Link Track on delhivery.com. Der Kunde sieht einen Sendungsverfolgungslink im Bestellverlauf und erhält die E-Mail „In Transit“ von PrestaShop.

Lizenzschlüssel

Das Modul arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox Delhivery ist der erste Block auf Modules > Module Manager > VibeFox Delhivery > 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, um den Status erneut zu prüfen, Change key, um einen anderen Schlüssel einzugeben, und Remove key, um den Schlüssel aus diesem Shop zu entfernen. Darunter stehen die Zeile Product: presta-shipping-delhivery und der Link Manage licenses and domains in your account, der Ihr vibefox.net-Konto öffnet. 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 Adresse des Shops 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 gilt für eine Domain: die Domain des Hauptshops, auch bei einer Multistore-Installation. 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 aktiven Schlüssel wird der Versanddienstleister Delhivery Kunden an der Kasse nicht angezeigt, und es wird kein Tarif berechnet. Der PrestaShop-Shop 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 nicht an der Kasse testen. Eine Erinnerung erscheint unter Modules > Module Manager auf dem Reiter 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 täglich in den ersten 14 Tagen nach 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

Delhivery erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv ist und Enable Delhivery eingeschaltet ist. Prüfen Sie unter Shipping > Carriers, ob der Versanddienstleister die Zone des Landes und die Kundengruppe abdeckt, oder aktivieren Sie Ignore zones und prüfen Sie Countries. Prüfen Sie die Gewichtsgrenzen und Show from subtotal. Ohne Live-Tarif werden ein Länderpreis oder ein Fallback price benötigt. Produkte können auf der Produktseite außerdem auf bestimmte Versanddienstleister beschränkt sein.

Live-Tarife erscheinen nicht: Prüfen Sie das API-Token, eine gültige Origin pincode und, wenn Ihre Standardwährung nicht INR ist, den Umrechnungskurs. Der Kunde muss eine gültige 6-stellige indische PIN-Code-Nummer eingeben. Aktivieren Sie Debug log, laden Sie die Kasse neu und sehen Sie im Feld Log auf der Modulseite nach. Dort steht der Grund, zum Beispiel eine nicht zustellbare PIN-Code-Nummer oder ein HTTP-Fehler von Delhivery.

GST wird doppelt berechnet: Der Gesamtbetrag von Delhivery enthält GST bereits. Setzen Sie Rate amount auf Gross amount (excluding GST) oder setzen Sie Tax auf No tax.

Testen: Setzen Sie Environment auf Staging und verwenden Sie ein Delhivery-Test-Token.

Tarife wirken nach einer Änderung veraltet: Klicken Sie auf der Modulseite auf Save. Dadurch werden die zwischengespeicherten Delhivery-Tarife geleert.

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

Für Entwickler: Das Modul führt die Hooks actionVfdDlvApiUrl und actionVfdDlvApiTimeout aus, mit denen sich die API-Adresse und das Timeout ändern lassen.

Deinstallation

Gehen Sie zu Modules > Module Manager, öffnen Sie das Menü neben VibeFox Delhivery und wählen Sie Uninstall. Der Lizenzschlüssel, der Lizenzstatus und die zwischengespeicherten Tarife werden immer entfernt. Ist Remove data on uninstall aktiviert, erhält der Versanddienstleister seine vorherigen Zonen zurück und wird gelöscht (Bestellungen behalten ihren Verlauf). Außerdem werden die Einstellungen, das Log und die Delhivery-Daten der Bestellungen (Modus und Preisquelle) entfernt. Ist die Option deaktiviert, wird der Versanddienstleister nur deaktiviert und alle Einstellungen bleiben erhalten. Bei einer erneuten Installation des Moduls wird der Versanddienstleister mit dem vorherigen Status wiederhergestellt. AWB-Nummern bleiben in den Bestellungen erhalten.

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