VibeFox Ninja Van for PrestaShop — Hilfe

Anforderungen

PrestaShop: 8.0 bis 9.x.

PHP: 8.0 oder neuer. Das Modul verweigert die Installation auf älteren PHP-Versionen.

Ninja-Van-Preisliste: die Preise Ihres Ninja-Van-Versenderkontos oder vom Ninja-Van-Vertrieb, eingetragen in der Preistabelle. Es sind keine API-Schlüssel erforderlich. Die optionalen Live-Preise innerhalb Indonesiens nutzen die Ninja Van Tariff API, die öffentlich ist und keine Authentifizierung benötigt.

VibeFox-Lizenzschlüssel: wird auf vibefox.net gekauft. Ein Schlüssel funktioniert 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 in der Modulliste nach VibeFox Ninja Van und klicken Sie 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. Tragen Sie Ihre Ninja-Van-Preise in die Preistabelle ein. Für Indonesien können Sie optional Live rates aktivieren (siehe Konfiguration). Klicken Sie auf Save.

Bei der Installation legt das Modul die Versandart Ninja Van mit dem Lieferzeittext Courier delivery an. Die Versandart ist eingeschaltet, allen Zonen und allen Kundengruppen zugewiesen und hat keine Steuerregel. Zonen, Kundengruppen, Lieferzeit, Logo und Größenlimits können Sie unter Shipping > Carriers ändern. Legen Sie dort keine Preise fest: Der Preis stammt immer aus dem Modul.

Konfiguration

Alle Einstellungen befinden sich auf der Modulseite: Modules > Module Manager > VibeFox Ninja Van > Configure. Sie gelten für alle Zonen der Versandart. Jeder Abschnitt hat eine eigene Schaltfläche Save, die die gesamte Seite speichert. Nichts wird gespeichert, und es erscheint eine Fehlermeldung, wenn ein Zahlenfeld Text oder eine negative Zahl enthält, IDR conversion rate 0 ist, Minimum weight (kg) größer ist als Maximum weight (kg) oder Method title länger als 64 Zeichen ist. Wenn die Gewichtseinheit Ihres Shops nicht eine der vom Modul bekannten ist, erscheint nach dem Speichern eine Warnung, dass Produktgewichte in Kilogramm angenommen werden.

Allgemein

Enable Ninja Van: schaltet die Versandart ein oder aus. Dies ist derselbe Schalter wie der Status der Versandart unter Shipping > Carriers.

Method title: der Name der Versandart, den der Kunde im Warenkorb und an der Kasse sieht. Standard: Ninja Van. Pflichtfeld, höchstens 64 Zeichen.

Tax: die Steuerregel der Versandart oder No tax (Standard). Wählen Sie No tax, wenn die Preise in der Tabelle bereits Steuern (GST, SST, VAT) enthalten.

Preise (in der Standardwährung Ihres Shops, ohne Steuern)

Tragen Sie die Preise Ihrer Ninja-Van-Preisliste in der Standardwährung Ihres Shops ein. Wenn Ihre Preisliste in SGD, MYR, IDR oder einer anderen Währung vorliegt, rechnen Sie sie zuerst um. Diese Tabelle wird für jedes Ziel außerhalb Indonesiens verwendet und immer dann, wenn kein Live-Preis verfügbar ist.

Price table: eine Zeile pro Zielland. Klicken Sie auf Add country, um eine Zeile hinzuzufügen, und auf das Papierkorb-Symbol, um eine zu entfernen. Wählen Sie * All other countries für alle Länder ohne eigene Zeile. Jede Zeile hat einen Base price und Gewichtsspalten: XS bis 1 kg, S bis 2 kg, M bis 3 kg, L bis 5 kg und XL über 5 kg. Eine leere (oder mit 0 gefüllte) Gewichtsspalte verwendet den Basispreis. Ein Basispreis von 0 bedeutet kostenlosen Versand in dieses Land. Sowohl „9.99“ als auch „9,99“ werden akzeptiert. Zeilen ohne Preise werden beim Speichern entfernt, und von jedem Land wird nur die erste Zeile behalten.

Price for countries not in the table: wird verwendet, wenn die Tabelle keine Zeile für das Zielland (und keine *-Zeile) hat oder die Zeile für dieses Gewicht keinen Preis enthält. Lassen Sie das Feld leer, um die Versandart in diesem Fall auszublenden. 0 bedeutet kostenloser Versand.

Price applies: die Art, wie die Preise berechnet werden. Dies gilt auch für Live-Preise.

Live-Preise (API) — Indonesien

Die Ninja Van Tariff API liefert die Standard-Liefergebühr ohne Zuschläge und Rabatte für Pakete innerhalb Indonesiens. Ninja Van bietet sie nur für Indonesien an. Wenn Live rates aktiviert ist, zeigen Statuszeilen unter dem Abschnittstitel die Ausgangszone des Versands, eine fehlende Umrechnungsrate und die letzte Antwort der Tariff API (Umgebung, Zeit und Ergebnis).

Live rates: Live-Preise von Ninja Van für Lieferungen innerhalb Indonesiens abrufen. Standard: aus. Ohne diese Option wird während des Bezahlvorgangs nichts an Ninja Van gesendet.

Environment: Production (api.ninjavan.co) (Standard) oder Sandbox — testing only (api-sandbox.ninjavan.co).

Service level: die Servicestufe, für die der Preis angefragt wird: Standard (Standard), Express, Same day oder Next day. Hat Ninja Van für Route und Service keinen Preis, wird die Preistabelle verwendet.

Ship-from zone code L1 und Ship-from zone code L2: die L1- und L2-Zonencodes des Distrikts, von dem Sie versenden, zum Beispiel ID_A00007_01 und ID_B00069_01, aus der Ninja-Van-Zuordnungstabelle der Zonencodes (CSV), deren Adresse unter dem Feld angezeigt wird. Geben Sie beide ein oder lassen Sie beide leer, um sie aus der Shop-Adresse unter Shop Parameters > Contact > Stores zu ermitteln: Indonesien, Provinz (state), Stadt und, wenn die Stadt mehrere Zonen hat, der Distrikt (Kecamatan) in der Adresszeile. Ein Code im falschen Format wird mit einer Warnung gelöscht. Wird nur einer der beiden Codes eingegeben, fordert eine Warnung auf, beide einzugeben, und eine Statuszeile zeigt, dass keine Live-Preise abgefragt werden.

IDR conversion rate: die Tariff API liefert die Gebühr in indonesischen Rupiah (IDR). Wenn die Standardwährung Ihres Shops IDR ist, lassen Sie das Feld leer. Andernfalls geben Sie an, wie viel 1 IDR in der Währung Ihres Shops ist, zum Beispiel 0.000058. Der Wert muss größer als 0 sein. Ohne ihn werden keine Live-Preise verwendet, sondern die Preistabelle.

Bedingungen

Minimum weight (kg): blendet die Versandart aus, wenn der Warenkorb leichter ist. Produktgewichte werden von der Gewichtseinheit Ihres Shops in Kilogramm umgerechnet. 0 bedeutet kein Limit.

Maximum weight (kg): blendet die Versandart aus, wenn der Warenkorb schwerer ist. Standard: 30. 0 bedeutet kein Limit. Der Wert kann nicht niedriger sein als Minimum weight (kg).

Minimum order amount: zeigt die Versandart nur an, wenn die Zwischensumme des Warenkorbs (versandpflichtige Produkte, nach Rabatten, vor Steuern) diesen Betrag erreicht. Leer lassen, um sie immer anzuzeigen.

Free shipping from: die Zwischensumme des Warenkorbs (versandpflichtige Produkte, nach Rabatten, vor Steuern), ab der der Versand mit Ninja Van kostenlos ist. Leer lassen für keinen kostenlosen Versand.

Verfügbarkeit ohne Versandzonen

Ignore shipping zones: bietet Ninja Van für die unten angegebenen Länder an, auch wenn die Versandart nicht mit deren Zone verknüpft ist. Ist die Option aktiv, wird die Versandart mit allen aktiven Zonen verknüpft, einschließlich später erstellter Zonen. Wenn Sie sie ausschalten, erhält die Versandart die Zonen zurück, die sie vorher hatte.

Countries: die Zielländer für diesen Modus. Leer lassen, um alle Länder zu verwenden, in die Sie versenden. Dieses Feld wird nur verwendet, wenn Ignore shipping zones aktiviert ist.

Erweitert

Debug log: protokolliert die Tarifberechnungen in logs/vfd_njvn_debug.log.php im Modulordner. Die Datei kann nicht über das Web geöffnet werden. Kundenadressen werden nicht protokolliert. Fehlgeschlagene Tariff-API-Anfragen werden auch protokolliert, wenn diese Option aus ist. Schalten Sie sie nach Abschluss wieder aus.

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

Remove data on uninstall: ist die Option aktiv, löscht die Deinstallation des Moduls die Moduleinstellungen, die Versandart, die zwischengespeicherten Preise und das Protokoll. Ist sie aus, bleibt alles für eine erneute Installation erhalten.

Funktionsweise an der Kasse

Im Versandschritt fragt PrestaShop das Modul nach dem Ninja-Van-Preis. Nur physische Produkte zählen: Virtuelle Produkte erhöhen das Gewicht nicht und sind nicht im Bestellbetrag enthalten. Das Modul prüft zuerst die Bedingungen: die Länderliste von Ignore shipping zones (falls aktiv), das Warenkorbgewicht und den Mindestbestellwert. Gilt kostenloser Versand, beträgt der Preis 0 und es wird keine Anfrage an Ninja Van gesendet.

Der Preis stammt aus der Zeile des Landes (oder der *-Zeile): die Gewichtsspalte, sonst der Basispreis, sonst Price for countries not in the table. Gibt es keinen Preis, wird die Versandart für diesen Warenkorb ausgeblendet. Der Preis wird in der Standardwährung des Shops berechnet und dann in der Warenkorbwährung des Kunden angezeigt.

Mit aktivem Live rates wird eine Lieferung innerhalb Indonesiens zuerst von Ninja Van bepreist. Das Modul wandelt Versand- und Lieferadresse in Ninja-Van-Zonencodes um: Provinz (state), Stadt oder Regentschaft und bei Städten mit mehreren Zonen den Distrikt (Kecamatan), der in einer Adresszeile steht. Es sendet die Codes, das Gewicht und die Servicestufe und rechnet die Gebühr von IDR in die Währung Ihres Shops um. Bei Per item wird pro unterschiedlichem Artikelgewicht eine Anfrage gesendet, höchstens 5 pro Warenkorb. Bei mehr verschiedenen Gewichten wird die Preistabelle verwendet.

Die Tariff API erlaubt 20 Anfragen pro Minute. Deshalb werden Antworten 6 Stunden, Fehler 5 Minuten und „kein Preis für diese Route“ 1 Stunde zwischengespeichert. Das Modul sendet nie mehr als 18 Anfragen pro Minute, und nach einer HTTP-429-Antwort pausiert es eine Stunde. Das API-Zeitlimit beträgt 12 Sekunden. Antwortet Ninja Van nicht, meldet einen Fehler, hat keinen Preis für die Route oder kann die Adresse nicht zugeordnet werden, wird der Tabellenpreis verwendet. Fehler gehen ins Protokoll, nie zum Kunden.

Wenn Sie die Versandart unter Shipping > Carriers bearbeiten, nachdem sie Bestellungen hat, speichert PrestaShop sie als neue Version der Versandart. Das Modul folgt der neuen Version automatisch.

Das Modul berechnet nur Preise. Es erstellt keine Ninja-Van-Bestellungen, druckt keine Luftfrachtbriefe (AWB), bucht keine Abholungen, verfolgt keine Pakete und verarbeitet keine Nachnahme (COD). Verwenden Sie dafür das Ninja-Van-Dashboard. Es gibt keine Auswahl von Abholstellen (Ninja Points): Die Versandart ist Haustürzustellung. Live-Preise sind außerhalb Indonesiens nicht verfügbar.

Lizenzschlüssel

Das Modul arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox Ninja Van ist der erste Block unter Modules > Module Manager > VibeFox Ninja Van > 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 verdeckt, den Status (zum Beispiel das Datum, bis zu dem die Lizenz aktiv 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-ninja-van 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. Nach einer Änderung der Shop-Adresse 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 funktioniert für eine Domain: die Domain des Hauptshops, auch bei einer Multistore-Einrichtung. Wenn Sie den Schlüssel aus dem Shop entfernen, wird sein Domain-Platz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.

Ohne aktiven Schlüssel wird die Versandart Ninja Van Kunden an der Kasse nicht angezeigt, und es wird kein Tarif berechnet. Der PrestaShop-Storefront weiß nicht, dass Sie im Back Office angemeldet sind, daher ist die Versandart auch für Sie ausgeblendet: Sie können das Modul vor dem Kauf eines Schlüssels einrichten, aber an der Kasse nicht 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 der Arbeit im Back Office automatisch erneut geprüft: einmal täglich in den ersten 14 Tagen nach der Eingabe des Schlüssels, danach einmal pro Woche. Ein Cron-Job ist nicht nötig. Das Deinstallieren oder Zurücksetzen des Moduls entfernt immer den Lizenzschlüssel und den Lizenzstatus.

Fehlerbehebung

Ninja Van erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv ist und Enable Ninja Van eingeschaltet ist. Prüfen Sie unter Shipping > Carriers, ob die Versandart die Zone des Landes des Kunden und die Kundengruppe abdeckt (oder schalten Sie Ignore shipping zones ein und prüfen Sie Countries). Prüfen Sie die Gewichtslimits und Minimum order amount sowie ob das Land, die *-Zeile oder Price for countries not in the table einen Preis hat. Produkte können auch auf der Produktseite auf bestimmte Versandarten beschränkt sein.

Der Live-Preis wird für manche Adressen nicht verwendet: Das Ziel muss einer Ninja-Van-Zone zugeordnet werden: Indonesien, Provinz (state), Stadt oder Regentschaft und bei Städten mit mehreren Zonen der Distrikt (Kecamatan) in einer Adresszeile. Andernfalls wird der Tabellenpreis verwendet. Aktivieren Sie Debug log, laden Sie die Kasse neu und sehen Sie sich das Feld Log auf der Modulseite an.

Live-Preise werden überhaupt nicht abgefragt: Die Statuszeilen unter Live-Preise (API) — Indonesien nennen den Grund: Die Shop-Adresse liegt nicht in Indonesien oder die Ausgangszone konnte nicht ermittelt werden (beide Zonencodes eingeben), nur einer der beiden Codes ist eingegeben, die eingegebenen Codes bilden in der Zuordnungstabelle kein Paar oder IDR conversion rate fehlt.

Anfragelimit erreicht (HTTP 429): Live-Anfragen werden eine Stunde lang pausiert, und in dieser Zeit wird die Preistabelle verwendet.

Währung der Preise: Die Tabelle und die Bedingungen gelten in der Standardwährung Ihres Shops. Live-Preise sind in Rupiah (IDR) und werden mit IDR conversion rate umgerechnet, es sei denn, die Währung Ihres Shops ist IDR.

Die Seite meldet, dass die Versandart Ninja Van nicht gefunden wurde: Die Versandart wurde unter Shipping > Carriers gelöscht. Setzen Sie das Modul unter Modules > Module Manager zurück, um sie erneut anzulegen.

Entwickler: Ein Shop mit einem eigenen Distrikt-Feld (Kecamatan) kann die Zonencodes über den Hook actionVfdNjvnTariffZone bereitstellen.

Deinstallation

Gehen Sie zu Modules > Module Manager, öffnen Sie das Menü neben VibeFox Ninja Van und wählen Sie Uninstall. Der Lizenzschlüssel und der Lizenzstatus werden immer entfernt. Die zwischengespeicherten Preise werden immer entfernt. Ist Remove data on uninstall aktiv, wird die Versandart gelöscht (Bestellungen behalten ihren Verlauf) und die Einstellungen, der letzte Status der Tariff API und das Protokoll werden entfernt. Ist die Option aus, wird die Versandart nur deaktiviert und alle Einstellungen bleiben erhalten. Beim erneuten Installieren des Moduls erhält die gespeicherte Versandart den Status zurück, den sie vor der Deinstallation hatte.

Ninja Van ist eine Marke ihres jeweiligen Inhabers. Dieses Modul ist weder mit Ninja Van verbunden noch wird es von Ninja Van empfohlen.