VibeFox J&T Express 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.

Zugang zur J&T Express Malaysia API (nur für Live-Preise): Live-Preise gibt es nur für J&T Express Malaysia, für Lieferadressen in Malaysia. Sie benötigen vier Werte. Beantragen Sie ein J&T-VIP-Konto auf der Website von J&T Express Malaysia (die Einstellungsseite enthält einen Link). J&T stellt Ihnen den VIP-Kundencode und den VIP-API-Schlüssel bereit. Das API-Konto und der private Schlüssel zum Signieren der Anfragen werden von J&T für die API-Integration ausgestellt. Fragen Sie Ihren J&T-Kundenbetreuer danach. J&T Philippinen, Indonesien und andere Länder haben keine öffentliche Preis-API; verwenden Sie dort die Preistabelle. Wenn Sie nur die Preistabelle und die Ersatzkosten nutzen, benötigen Sie keinen Zugang zur J&T-API.

VibeFox-Lizenzschlüssel: erhältlich 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_jt_express per FTP nach /wp-content/plugins/ hochladen.

2. Klicken Sie auf Activate.

3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Shipping > VibeFox J&T Express, 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. Füllen Sie die Preistabelle und/oder die Ersatzkosten aus. Für Live-Preise in Malaysia geben Sie außerdem die J&T-API-Zugangsdaten, die Absender-Postleitzahl und, falls die Shopwährung nicht MYR ist, den Währungsumrechnungskurs ein (siehe Konfiguration).

6. Fügen Sie VibeFox J&T Express unter WooCommerce > Settings > Shipping > Shipping zones einer Versandzone 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 > VibeFox J&T Express. Sie gelten für alle Versandzonen. Wenn Sie die Versandart einer Zone hinzufügen, hat das Zonenfenster nur ein Feld:

Title (zone): der Name, den Kunden für diese Zone sehen. Lassen Sie das Feld leer, um die globale Method title zu verwenden.

Bei jedem Speichern der Einstellungen werden die zwischengespeicherten J&T-Preise gelöscht. Sind Live-Preise nur teilweise konfiguriert, listet ein Hinweis oben auf der Seite die fehlenden Einstellungen auf oder meldet, dass der Währungsumrechnungskurs fehlt.

Allgemein

Enable/Disable: schaltet die Versandart in allen Zonen gleichzeitig ein oder aus. Standard: on.

Method title: der Name der Versandart, der im Warenkorb und an der Kasse angezeigt wird. Eine Zone kann ihn überschreiben. Standard: J&T Express.

Tax status: Taxable fügt die Versandsteuer Ihres Shops auf die Kosten auf, None nicht. Wählen Sie None, wenn der J&T-Preis bereits alles enthält, was Sie berechnen möchten.

J&T Express Malaysia API (Live-Preise) (optional, für Lieferadressen in Malaysia; alle vier Zugangsdaten sind erforderlich)

VIP customer code: Ihr J&T-Express-VIP-Code.

VIP API key: der API-Schlüssel (Passwort), den Ihnen J&T Express zusammen mit dem VIP-Code gegeben hat. Er wird nie protokolliert.

API account: der Name Ihres J&T-Express-API-Kontos.

API private key: der private Schlüssel des API-Kontos. Er wird nur zum Signieren der Anfragen (SHA-256) verwendet. Er wird nie an J&T gesendet und nie protokolliert.

Sender postcode: die malaysische Postleitzahl, von der die Pakete versendet werden. Lassen Sie das Feld leer, um die Shop-Postleitzahl aus WooCommerce > Settings > General zu verwenden, wenn der Shop in Malaysia liegt. Leerzeichen werden beim Speichern entfernt.

Currency conversion rate: J&T-Express-Malaysia-Preise sind in MYR. Wenn die Shopwährung nicht MYR ist, geben Sie an, wie viele Einheiten Ihrer Währung einem MYR entsprechen (1 MYR = X). Ohne diesen Wert werden keine Live-Preise verwendet; stattdessen gelten die Preistabelle oder die Ersatzkosten. Wenn die Shopwährung MYR ist, lassen Sie das Feld leer: Die Preise werden unverändert übernommen. Sowohl Punkt als auch Komma werden als Dezimaltrennzeichen akzeptiert.

Preistabelle und Ersatz (verwendet für andere Länder als Malaysia, wenn keine Live-Preise konfiguriert sind oder J&T keinen Preis liefert; Preise in der Shopwährung)

Country prices: eine Tabelle mit einer Zeile pro Land. Klicken Sie auf Add country, um eine Zeile hinzuzufügen, und auf das Kreuz, um sie zu entfernen. Wählen Sie * Any other country für alle Länder ohne eigene Zeile. Jede Zeile hat einen Base price und fünf Gewichtsstufen: XS bis 1 kg, S bis 2 kg, M bis 3 kg, L bis 5 kg und XL über 5 kg. Ein Stufenpreis über 0 ersetzt den Grundpreis für Warenkörbe in dieser Stufe. Eine Stufe mit 0 verwendet den Grundpreis. Ein Grundpreis von 0 bedeutet kostenlosen Versand; ein leerer Grundpreis wird als 0 gespeichert. Länder ohne Zeile (wenn keine *-Zeile vorhanden ist) erhalten keinen Tabellenpreis.

Fallback cost: der Preis, der verwendet wird, wenn weder J&T noch die Tabelle einen Preis liefern. Lassen Sie das Feld leer, um die Versandart in diesem Fall auszublenden.

Table / fallback price is: Per order berechnet den Preis einmal. Per item (multiplied by the number of items) multipliziert ihn mit der Anzahl der Artikel im Warenkorb. Live-J&T-Preise gelten immer für die gesamte Bestellung.

Bedingungen

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

Minimum subtotal: Die Versandart wird nur angezeigt, wenn die Zwischensumme des Warenkorbs diesen Betrag erreicht. Lassen Sie das Feld leer, um sie immer anzuzeigen.

Min weight (kg): blendet die Versandart aus, wenn der Warenkorb weniger wiegt. Produktgewichte werden aus der Gewichtseinheit Ihres Shops umgerechnet. 0 bedeutet keine Grenze.

Max weight (kg): blendet die Versandart aus, wenn der Warenkorb mehr wiegt. Standard: 50. 0 bedeutet keine Grenze.

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

Verfügbarkeit ohne Versandzonen

Ignore shipping zones: bietet die Versandart für die unten genannten Länder an, auch wenn sie keiner Versandzone hinzugefügt ist. Ist die Option aus, erscheint die Versandart nur in den Zonen, denen sie 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: schreibt Preisberechnungen in WooCommerce > Status > Logs, Quelle vfd-jt-express. J&T-API-Fehler werden immer protokolliert, auch wenn diese Option aus ist. Es werden keine Schlüssel, Passwörter oder Postleitzahlen von Kunden geschrieben. Schalten Sie das Protokoll nach Abschluss wieder aus.

Remove data on uninstall: ist die Option aktiviert, entfernt das Löschen des Plugins seine Einstellungen, Zonen-Versandarten und zwischengespeicherten Preise. 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 Preis. Das Plugin prüft zuerst die Bedingungen: Lieferland, Warenkorbgewicht, Mindest-Zwischensumme und ausgeschlossene Versandklassen. Erreicht die Zwischensumme des Warenkorbs Free shipping from, wird die Versandart mit Kosten von 0 angezeigt, aber nur, wenn für das Land ein Preis vorliegt: eine Zeile in Country prices, eine Fallback cost oder ein Live-J&T-Preis. J&T wird nur abgefragt, wenn Tabelle und Ersatzkosten keinen Preis liefern.

Andernfalls werden die Kosten aus der ersten Quelle entnommen, die einen Preis liefert:

1. Live-Preis von J&T: nur wenn alle vier API-Zugangsdaten und eine Absender-Postleitzahl gesetzt sind, das Lieferland Malaysia ist, der Kunde eine 5-stellige Postleitzahl eingegeben hat und, bei Shops nicht in MYR, ein Umrechnungskurs gesetzt ist. Das Plugin sendet an J&T die Absender- und Lieferpostleitzahlen sowie das Warenkorbgewicht (mindestens 0,1 kg) für den Standardservice EZ, ein Paket, und rechnet den zurückgegebenen MYR-Preis in die Shopwährung um.

2. Country prices: die Zeile des Lieferlandes oder die *-Zeile mit dem Preis für die Gewichtsstufe des Warenkorbs.

3. Fallback cost.

Wenn keine dieser Quellen einen Preis liefert, wird die Versandart ausgeblendet. Per item gilt nur für Tabellen- und Ersatzpreise.

Jede Antwort von J&T wird 1 Stunde lang zwischengespeichert, damit derselbe Warenkorb keine neue Anfrage auslöst. Eine fehlgeschlagene Anfrage wird 10 Minuten lang zwischengespeichert, damit die Kasse bei jeder Aktualisierung nicht auf J&T wartet. Das Zeitlimit für Anfragen beträgt 10 Sekunden. Gibt J&T einen Fehler, einen Preis von null oder keine Antwort zurück, sieht der Kunde keine Fehlermeldung. Es wird der Tabellen- oder Ersatzpreis verwendet, und der Grund wird im Protokoll festgehalten.

Die Versandart funktioniert an der klassischen Kasse und an den Blöcken Warenkorb und Kasse. Sie ist mit WooCommerce High-Performance Order Storage (HPOS) kompatibel.

Das Plugin berechnet nur die Versandkosten. Es erstellt keine Frachtbriefe, Versandbelege oder Etiketten, bucht keine Abholungen, storniert oder verfolgt keine Sendungen und ermöglicht Kunden keine Wahl eines Abholpunkts. Erstellen und verfolgen Sie Sendungen wie gewohnt in Ihrem J&T-Konto. Das Plugin wurde auf Basis des Anfrageformats des offiziellen Plugins von J&T Express Malaysia entwickelt. Bestätigen Sie die Preise mit Ihrem J&T-Konto, bevor Sie live gehen.

Lizenzschlüssel

Das Plugin funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock befindet sich oben unter WooCommerce > Settings > Shipping > VibeFox J&T Express. 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. 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 J&T Express an der Kasse nicht angezeigt. Angemeldete Shop-Manager sehen sie weiterhin, mit dem Hinweis (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 unberührt.

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

Fehlerbehebung

J&T Express erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist und die Versandart der Zone des Landes des Kunden hinzugefügt ist (oder Ignore shipping zones eingeschaltet und das Land erlaubt ist). Prüfen Sie die Gewichtsgrenzen, Minimum subtotal und Excluded shipping classes. Prüfen Sie, ob Country prices eine Zeile für das Land oder eine *-Zeile hat oder ob Fallback cost gesetzt ist. Schalten Sie das Debug log ein und sehen Sie sich WooCommerce > Status > Logs an.

Der Preis stammt aus der Tabelle, nicht von J&T: Live-Preise benötigen alle vier API-Zugangsdaten, eine Absender-Postleitzahl, eine malaysische Lieferadresse mit 5-stelliger Postleitzahl und bei Shops nicht in MYR den Currency conversion rate. Prüfen Sie die Hinweise oben auf der Einstellungsseite. Lehnt J&T die Anfrage ab oder antwortet nicht, wird der Fehler protokolliert und der Tabellen- oder Ersatzpreis verwendet. Die fehlgeschlagene Anfrage wird nach 10 Minuten erneut versucht.

Keine Live-Preise für die Philippinen oder Indonesien: J&T bietet für diese Länder keine öffentliche Preis-API. Verwenden Sie dort die Preistabelle und die Ersatzkosten.

Ein Land erhält aus Versehen kostenlosen Versand: Seine Zeile hat einen Grundpreis von 0 (ein leerer Grundpreis wird als 0 gespeichert). Geben Sie einen Grundpreis ein oder entfernen Sie die Zeile.

Preise wirken nach einer Änderung veraltet: Speichern Sie die Einstellungsseite. Dadurch werden die zwischengespeicherten J&T-Preise gelöscht.

Entwickler-Hooks: der Filter vfd_jtex_quote_request ändert den Anfragekörper (zum Beispiel den Servicetyp), vfd_jtex_api_url ändert den Endpunkt für Preisanfragen, und der Standardfilter woocommerce_shipping_vfd_jt_express_is_available steuert die Verfügbarkeit.

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. 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 letzten bekannten Status weiter.

Deinstallation

Das Deaktivieren des Plugins behält alle Daten. Zum vollständigen Entfernen deaktivieren und löschen Sie es auf der Seite Plugins. Der Lizenzschlüssel und der Lizenzstatus dieses Plugins werden immer entfernt. Einstellungen, Zonen-Versandarten und zwischengespeicherte 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.

J&T Express ist eine Marke ihres jeweiligen Inhabers. Dieses Plugin ist nicht mit J&T Express verbunden und wird von diesem Unternehmen nicht befürwortet.