VibeFox Ninja Van for WooCommerce — Hilfe

Anforderungen

WordPress: 5.8 oder neuer.

WooCommerce: 5.0 oder neuer, installiert und aktiv. Ohne WooCommerce lässt sich das Plugin nicht aktivieren.

PHP: 8.0 oder neuer.

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 verwenden die Ninja Van Tariff API, die öffentlich ist und keine Authentifizierung benötigt.

VibeFox-Lizenzschlüssel: Erwerb auf vibefox.net. Ein Schlüssel funktioniert auf einer 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_ninja_van per FTP nach /wp-content/plugins/ hochladen.

2. Klicken Sie auf Activate.

3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Shipping > VibeFox Ninja Van 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. Tragen Sie Ihre Ninja-Van-Preise in die Preistabelle ein. Für Indonesien können Sie optional Live rates aktivieren (siehe Konfiguration).

6. Fügen Sie VibeFox Ninja Van einer Versandzone hinzu (zum Beispiel „Singapur“) unter WooCommerce > Settings > Shipping > Shipping zones, oder aktivieren Sie Ignore shipping zones und wählen Sie die Länder aus.

Konfiguration

Alle Einstellungen befinden sich auf einer Seite: WooCommerce > Settings > Shipping > VibeFox Ninja Van. 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, den Kunden für diese Zone sehen. Lassen Sie das Feld leer, um den globalen Method title zu verwenden.

Allgemein

Enable/Disable: schaltet die Methode in allen Zonen gleichzeitig ein oder aus.

Method title: der Name der Versandmethode, der im Warenkorb und an der Kasse angezeigt wird. Eine Zone kann ihn überschreiben. Standard: Ninja Van.

Preise (in Ihrer Shop-Währung)

Tragen Sie die Preise Ihrer Ninja-Van-Preisliste in Ihrer Shop-Währung ein. Wenn Ihre Preisliste in SGD, MYR, IDR, PHP, THB oder VND vorliegt, rechnen Sie sie zuerst um. Diese Tabelle gilt für alle Ziele außerhalb Indonesiens 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 Kreuz, um eine Zeile 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 belegte) 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.

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

Price applies: die Art, wie 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 die Statuszeilen in diesem Abschnitt die Versandursprungszone, einen fehlenden Umrechnungskurs und die letzte Antwort der Tariff API.

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-Stufencodes des Distrikts, von dem Sie versenden, zum Beispiel ID_A00007_01 und ID_B00069_01, aus der auf der Einstellungsseite verlinkten Zuordnungsdatei der Zonencodes von Ninja Van (CSV). Geben Sie beide ein oder lassen Sie beide leer, um sie aus der Shop-Adresse unter WooCommerce > Settings > General zu ermitteln: Indonesien, Provinz, Stadt und, wenn die Stadt mehrere Zonen hat, der Distrikt (Kecamatan) in der Adresszeile. Ein Code im falschen Format wird mit einer Fehlermeldung gelöscht.

IDR conversion rate: Die Tariff API liefert die Gebühr in indonesischen Rupiah (IDR). Ist Ihre Shop-Währung IDR, lassen Sie das Feld leer. Andernfalls geben Sie ein, wie viel 1 IDR in Ihrer Shop-Währung wert ist, zum Beispiel 0.000058. Ohne diesen Wert werden keine Live-Preise verwendet, sondern die Preistabelle.

Bedingungen

Minimum weight (kg): blendet die Methode aus, wenn der Warenkorb weniger wiegt. 0 bedeutet keine Begrenzung.

Maximum weight (kg): blendet die Methode aus, wenn der Warenkorb mehr wiegt. Standard: 30. 0 bedeutet keine Begrenzung.

Minimum order amount: zeigt die Methode nur an, wenn die Zwischensumme des Warenkorbs (nach Rabatten, vor Steuern) diesen Betrag erreicht. Lassen Sie das Feld leer, um die Methode immer anzuzeigen.

Free shipping from: die Zwischensumme des Warenkorbs (nach Rabatten, vor Steuern), ab der die Zustellung mit Ninja Van kostenlos ist. Lassen Sie das Feld leer, wenn es keinen kostenlosen Versand gibt.

Excluded shipping classes: blendet die Methode aus, wenn der Warenkorb ein Produkt aus einer dieser WooCommerce-Versandklassen enthält.

Tax status: Taxable fügt die WooCommerce-Steuer zu den Versandkosten hinzu, None nicht. Wählen Sie None, wenn die Preise in der Tabelle bereits Steuern enthalten (GST, SST, MwSt.).

Verfügbarkeit ohne Versandzonen

Ignore shipping zones: bietet Ninja Van für die unten angegebenen Länder an, auch wenn die Methode keiner Versandzone hinzugefügt wurde.

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

Erweitert

Debug log: protokolliert die Tarifberechnungen unter WooCommerce > Status > Logs (Quelle vfd_ninja_van). Kundenadressen werden nicht protokolliert. Fehlgeschlagene Anfragen an die Tariff API werden auch protokolliert, wenn diese Option ausgeschaltet ist. Schalten Sie sie nach Abschluss der Arbeiten wieder aus.

Remove data on uninstall: ist die Option aktiviert, entfernt das Löschen des Plugins alle Ninja-Van-Einstellungen und Zonenmethoden. Das Deaktivieren des Plugins löscht nie etwas.

Ablauf an der Kasse

Wenn der Kunde eine Lieferadresse eingibt, fragt WooCommerce das Plugin nach einem Tarif. Das Plugin prüft zuerst die Bedingungen: Lieferland, Warenkorbgewicht, Mindestbestellwert und ausgeschlossene Versandklassen. Gilt kostenloser Versand, sieht der Kunde die Methode kostenlos, 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. Produktgewichte werden von Ihrer Gewichtseinheit im Shop in Kilogramm umgerechnet. Gibt es keinen Preis, wird die Methode ausgeblendet.

Ist Live rates aktiviert, wird eine Lieferung innerhalb Indonesiens zuerst von Ninja Van bepreist. Das Plugin übersetzt die Versand- und Lieferadressen in Ninja-Van-Zonencodes: Provinz, Stadt oder Regentschaft und bei Städten mit mehreren Zonen den Distrikt (Kecamatan) aus einer Adresszeile. Es sendet die Codes, das Gewicht und die Servicestufe und rechnet die Gebühr von IDR in Ihre Shop-Währung um. Bei Per item wird pro verschiedenem Artikelgewicht eine Anfrage gesendet, höchstens 5 pro Warenkorb.

Die Tariff API erlaubt 20 Anfragen pro Minute. Deshalb werden Antworten 6 Stunden zwischengespeichert, Fehler 5 Minuten und „kein Preis für diese Route“ 1 Stunde. Das Plugin sendet nie mehr als 18 Anfragen pro Minute, und nach einer HTTP-429-Antwort pausiert es eine Stunde lang. Das Zeitlimit der API beträgt 12 Sekunden. Antwortet Ninja Van nicht, antwortet mit einem Fehler, hat keinen Preis für die Route oder lässt sich die Adresse nicht zuordnen, wird der Tabellenpreis verwendet. Fehler werden im Protokoll festgehalten und niemals dem Kunden angezeigt.

Die Methode funktioniert an der klassischen Kasse und in den Blöcken Cart und Checkout. Sie ist mit der WooCommerce-Bestellspeicherung mit hoher Leistung (HPOS) kompatibel.

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

Lizenzschlüssel

Das Plugin funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock befindet sich oben unter WooCommerce > Settings > Shipping > VibeFox Ninja Van. 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 funktioniert auf einer Domain. Wenn Sie den Schlüssel von einer Website entfernen, wird der Domain-Platz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.

Ohne aktiven Schlüssel wird Ninja Van 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. Auf der Seite Plugins und auf WooCommerce-Seiten erscheint ein Hinweis. Bestehende Bestellungen bleiben unverändert.

Läuft eine Lizenz ab, funktioniert das Plugin weiter, aber Updates und Support erfordern eine Verlängerung. Der Status wird automatisch im Hintergrund erneut geprüft.

Fehlerbehebung

Ninja Van 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 shipping zones aktiviert ist und das Land erlaubt ist). Prüfen Sie die Gewichtsgrenzen, Minimum order amount und Excluded shipping classes sowie ob für das Land, die *-Zeile oder Price for countries not in the table ein Preis hinterlegt ist.

Der Live-Preis wird bei einigen Adressen nicht verwendet: Das Ziel muss einer Ninja-Van-Zone zugeordnet werden: Indonesien, Provinz, 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, um den Grund zu sehen, und prüfen Sie die Statuszeilen unter Live-Preise (API) — Indonesien.

Live-Preise werden überhaupt nicht angefragt: Die Statuszeilen zeigen den Grund: Die Shop-Adresse liegt nicht in Indonesien oder die Versandursprungszone konnte nicht erkannt werden (geben Sie beide Zonencodes ein), oder IDR conversion rate fehlt.

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

In welcher Währung sind die Preise: Die Tabelle ist in Ihrer Shop-Währung. Live-Preise sind in Rupiah (IDR) und werden mit IDR conversion rate umgerechnet, sofern Ihre Shop-Währung nicht IDR ist.

Entwickler: Eine Website mit einem eigenen Feld für den Distrikt (Kecamatan) an der Kasse kann die Zonencodes über den Filter vfd_njvn_tariff_zone bereitstellen.

Der Lizenzblock zeigt einen Fehler: Folgen Sie der Meldung im Block. Ist der Schlüssel zum Beispiel bereits auf einer anderen Domain verwendet, geben Sie in Ihrem vibefox.net-Konto einen Platz frei und klicken Sie auf Check now. Wurde 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 und löschen Sie es auf der Seite Plugins. Der Lizenzschlüssel und der Lizenzstatus dieses Plugins werden immer entfernt. Einstellungen, Zonenmethoden, der letzte Status der Tariff API und zwischengespeicherte Live-Preise werden nur entfernt, wenn Remove data on uninstall aktiviert war. Andernfalls bleiben sie für eine spätere Neuinstallation erhalten. Bestehende Bestellungen behalten ihre Versandpositionen.

Ninja Van ist eine Marke ihres jeweiligen Inhabers. Dieses Plugin ist nicht mit Ninja Van verbunden und wird von Ninja Van nicht unterstützt.