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

SF-Express-Konto (nur für Live-Preise): Live-Preise nutzen die FengQiao-Open-Plattform von SF Express (open.sf-express.com). Sie benötigen ein monatliches SF-Express-Konto und ein Entwicklerkonto bei FengQiao. Registrieren Sie sich dort, erstellen Sie eine Anwendung, fügen Sie ihr die API "Delivery time standard and price query" (EXP_RECE_QUERY_DELIVERTM) hinzu und kopieren Sie den Kundencode und das Checkword. Die Checkwords für Sandbox und Produktion unterscheiden sich. Wenn Sie nur die Preistabelle nutzen, brauchen Sie kein SF-Express-Konto.

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. Sie können auch den Ordner vfd_sf_express per FTP nach /wp-content/plugins/ hochladen.

2. Klicken Sie auf Activate.

3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Shipping > VibeFox SF Express, oder klicken Sie auf der Plugins-Seite 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 den Ersatzpreis aus.

6. Für Live-Preise auf dem chinesischen Festland geben Sie den Kundencode und das Checkword, die Absenderprovinz und -stadt (oder hinterlegen Sie eine chinesische Shop-Adresse) sowie – falls Ihre Shop-Währung nicht CNY ist – den Umrechnungskurs ein. Testen Sie zuerst mit Sandbox und Sandbox-Zugangsdaten.

7. Fügen Sie VibeFox SF Express unter WooCommerce > Settings > Shipping > Shipping zones einer Versandzone hinzu, 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 SF Express. 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. Lassen Sie das Feld leer, um den globalen Method title zu verwenden.

Jedes Mal, wenn Sie die Einstellungen speichern, werden die zwischengespeicherten SF-Express-Preise gelöscht. Sind Live-Preise nur teilweise eingerichtet, listet ein Hinweis über den Einstellungen die fehlenden Angaben oder den fehlenden Umrechnungskurs auf.

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: SF Express.

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

SF-Express-FengQiao-API (Live-Preise) (optional, für Lieferadressen auf dem chinesischen Festland)

Customer code (partnerID): der Kundencode (顾客编码) Ihrer FengQiao-Anwendung.

Checkword: das Checkword (校验码) derselben Umgebung. Es wird nur zum Signieren von Anfragen verwendet und nie gesendet oder protokolliert.

Sandbox: verwenden Sie die FengQiao-Sandbox zum Testen mit Sandbox-Zugangsdaten. Sandbox-Preise sind nicht echt. Schalten Sie sie in einem Live-Shop aus. Standard: off.

SF Express product: welches SF-Express-Produkt der angezeigte Preis betrifft.

Sender province: die Provinz, aus der die Pakete versendet werden. Lassen Sie das Feld leer, um die Provinz der Shop-Adresse unter WooCommerce > Settings > General zu verwenden, sofern der Shop in China liegt.

Sender city: der standardisierte chinesische Stadtname, zum Beispiel 深圳市. Lassen Sie das Feld leer, um die Shop-Stadt zu verwenden, sofern der Shop in China liegt.

Currency conversion rate: SF-Express-Preise sind in CNY (Yuan). Wenn Ihre Shop-Währung nicht CNY ist, geben Sie an, wie viele Einheiten Ihrer Shop-Währung ein CNY wert ist. Ohne diesen Wert werden Live-Preise nicht verwendet. Ist Ihre Shop-Währung CNY, werden die Preise unverändert übernommen. Sowohl der Punkt als auch das Komma werden als Dezimaltrennzeichen akzeptiert.

Preistabelle und Ersatzpreis (wird für Hongkong, Macau, Taiwan und andere Länder verwendet, wenn keine Live-Preise eingerichtet sind oder SF Express keinen Preis liefert; Preise in Ihrer Shop-Währung)

Country prices: eine Tabelle mit einem Grundpreis pro Land. Die Zeile * Any other country gilt für alle Länder ohne eigene Zeile. Ein Gewichtsstufenpreis über 0 ersetzt den Grundpreis für Pakete in dieser Stufe: ≤ 1 kg, ≤ 2 kg, ≤ 3 kg, ≤ 5 kg und > 5 kg. Ein Grundpreis von 0 bedeutet kostenlosen Versand. Ein leerer Grundpreis bedeutet, dass es für dieses Land keinen Preis gibt und der Ersatzpreis verwendet wird.

Fallback cost: wird verwendet, wenn weder SF Express noch die Tabelle einen Preis liefern. Lassen Sie das Feld leer, um die Methode in diesem Fall auszublenden.

Table / fallback price is: wie Tabellen- und Ersatzpreise berechnet werden.

Live-Preise von SF Express gelten immer für die gesamte Bestellung.

Bedingungen

Free shipping from: die Warenkorb-Zwischensumme, ab der der Versand kostenlos ist. Kostenloser Versand wird nur dort angeboten, wo die Methode einen Preis für das Ziel hat: einen Live-Preis, eine Tabellenzeile oder die Fallback cost. Lassen Sie das Feld leer, um nie kostenlosen Versand anzubieten.

Minimum subtotal: zeigt die Methode nur an, wenn die Warenkorb-Zwischensumme diesen Betrag erreicht. Lassen Sie das Feld leer, um sie immer anzuzeigen.

Min weight (kg): das minimale Warenkorbgewicht in kg. Produktgewichte werden aus Ihrer Gewichtseinheit im Shop umgerechnet. 0 bedeutet keine Grenze.

Max weight (kg): das maximale Warenkorbgewicht in kg. Standard: 50. 0 bedeutet keine Grenze.

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

Verfügbarkeit ohne Versandzonen

Ignore shipping zones: bietet die Methode für die unten genannten Länder an, auch wenn sie keiner Zone hinzugefügt wurde. Ist die Option aus, erscheint die Methode nur in den Versandzonen, 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 die Preisberechnungen in das WooCommerce-Protokoll: WooCommerce > Status > Logs, Quelle vfd-sf-express. API-Fehler werden immer protokolliert, auch wenn diese Option aus ist. Es werden weder Checkwords noch Kundenadressen geschrieben.

Remove data on uninstall: ist die Option aktiv, entfernt das Löschen des Plugins seine Einstellungen, seine Methoden in Versandzonen und seine Caches. 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, Mindestzwischensumme und ausgeschlossene Versandklassen. Gilt kostenloser Versand und hat die Preistabelle oder die Fallback cost einen Preis für das Ziel, wird die Methode mit einem Preis von 0 angezeigt, und es geht keine Anfrage an SF Express. Andernfalls fragt das Plugin zuerst bei SF Express nach einem Live-Preis und zeigt die Methode nur dann als kostenlos an, wenn einer zurückkommt.

Bei einer Lieferadresse auf dem chinesischen Festland, wenn Kundencode und Checkword eingerichtet sind, sendet das Plugin an SF Express Ihre Absenderprovinz und -stadt, die Provinz und Stadt des Kunden, das Warenkorbgewicht und das Warenkorbvolumen (aus Produkten mit allen drei Abmessungen). Die Anfrage wird mit Ihrem Checkword signiert. SF Express liefert Preise in CNY, und das Plugin rechnet den gewählten in Ihre Shop-Währung um.

SF Express erkennt Adressen anhand der standardisierten chinesischen Namen. Die Provinz des Kunden stammt aus dem Feld Bundesland/Region an der Kasse. Die Stadt muss auf Chinesisch eingegeben werden, zum Beispiel 广州市. Für Peking, Shanghai, Tianjin und Chongqing wird die Stadt automatisch eingetragen. Eine Stadt in lateinischen Buchstaben, etwa "Guangzhou", erhält den Tabellenpreis.

Jeder Preis wird eine Stunde lang zwischengespeichert, damit derselbe Warenkorb keine neue Anfrage auslöst. Eine fehlgeschlagene Anfrage wird zehn Minuten lang zwischengespeichert, damit die Kasse bei jeder Aktualisierung nicht auf SF Express wartet. Das HTTP-Timeout beträgt 10 Sekunden.

Gibt es keinen Live-Preis, stammt der Preis aus der Preistabelle und danach aus der Fallback cost. Trifft keines davon zu, wird die Methode ausgeblendet. Der Kunde sieht nie einen Fehler. Der Fehler wird im Protokoll festgehalten.

Die Methode funktioniert in der klassischen Kasse sowie im Warenkorb- und Kassen-Block. Sie ist kompatibel mit WooCommerce High-Performance Order Storage (HPOS). Englische und vereinfachte chinesische Übersetzungen sind enthalten.

Das Plugin berechnet nur Preise. Es erstellt keine Frachtbriefe oder Etiketten, legt keine Bestellungen bei SF Express an, bucht keine Abholungen und storniert oder verfolgt keine Sendungen. Erstellen und verfolgen Sie Sendungen wie gewohnt in Ihrem SF-Express-Konto. Kunden können keine SF-Servicestelle und keinen Paketautomaten wählen. SF Express wird als Haus-zu-Haus-Kurier genutzt. Live-Preise gibt es nur für Lieferadressen auf dem chinesischen Festland. Das Plugin wurde anhand der FengQiao-Dokumentation und mit simulierten Antworten entwickelt. Bestätigen Sie die Preise deshalb vor dem Livegang mit Ihrem SF-Express-Konto (zuerst in der Sandbox).

Lizenzschlüssel

Das Plugin funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock befindet sich oben unter WooCommerce > Settings > Shipping > VibeFox SF 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 SF Express 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. Ein Hinweis erscheint auf der Plugins-Seite und auf WooCommerce-Seiten. Bestehende Bestellungen sind nicht betroffen.

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

SF Express 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 ist (oder Ignore shipping zones aktiv ist und das Land erlaubt ist). Prüfen Sie die Gewichtsgrenzen, Minimum subtotal und Excluded shipping classes. Prüfen Sie, ob die Tabelle oder die Fallback cost einen Preis für das Land hat.

Der Preis stammt aus der Tabelle, nicht von SF Express: Live-Preise benötigen Kundencode und Checkword, eine Absenderprovinz und -stadt, eine Lieferadresse auf dem chinesischen Festland mit Provinz und chinesischem Stadtnamen sowie (bei Shops, die nicht in CNY arbeiten) den Umrechnungskurs. Öffnen Sie WooCommerce > Status > Logs, Quelle vfd-sf-express, um den Grund zu sehen. Eine fehlgeschlagene Anfrage wird nach 10 Minuten erneut versucht.

Fehler A1006 im Protokoll: ungültige Signatur. Das Checkword ist falsch oder gehört zur anderen Umgebung. Prüfen Sie die Einstellung Sandbox.

Fehler A1004 im Protokoll: die Preisabfrage-API ist Ihrer FengQiao-Anwendung nicht hinzugefügt.

Hongkong: funktioniert mit der Preistabelle und dem Ersatzpreis. Die FengQiao-Preisabfrage gilt nur für Adressen auf dem chinesischen Festland.

Preise wirken nach einer Änderung veraltet: speichern Sie die Einstellungsseite. Dadurch werden die zwischengespeicherten SF-Express-Preise gelöscht.

Für Entwickler: der Filter vfd_sfex_quote_request ändert die Preisanfrage, zum Beispiel auf einen anderen Produktcode. vfd_sfex_api_url ändert die Gateway-URL.

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 einen Platz in Ihrem vibefox.net-Konto frei und klicken Sie auf Check now. Wenn sich die Adresse der Website geändert hat, 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 und zwischengespeicherte Preise werden nur entfernt, wenn Remove data on uninstall aktiv war. Andernfalls bleiben sie für eine spätere Neuinstallation erhalten. Bestehende Bestellungen behalten ihre Versandpositionen.

SF Express ist eine Marke ihres jeweiligen Inhabers. Dieses Plugin ist weder mit SF Express verbunden noch von SF Express unterstützt.