VibeFox Bob Go 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.

Bob-Go-Konto (nur für Live-Tarife): Bob Go hat keine API-Schlüssel. Sie benötigen ein Bob-Go-Konto (bobgo.co.za), Ihren WooCommerce-Shop als Verkaufskanal in Ihrem Bob-Go-Konto (Sales channels) installiert und „Rates at checkout“ für diesen Kanal aktiviert, mit Ihren Services und Preisen dort eingerichtet. Wenn Sie nur feste Preise nutzen, brauchen Sie kein Bob-Go-Konto.

VibeFox-Lizenzschlüssel: Kauf 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_bob_go per FTP nach /wp-content/plugins/ hochladen.

2. Klicken Sie auf Activate.

3. Installieren Sie in Ihrem Bob-Go-Konto Ihren WooCommerce-Shop als Verkaufskanal. Aktivieren Sie „Rates at checkout“ für diesen Kanal und richten Sie Ihre Services und Preise ein.

4. Öffnen Sie die Einstellungen: WooCommerce > Settings > Shipping > VibeFox Bob Go, oder klicken Sie auf der Seite Plugins unter dem Namen des Plugins auf Settings.

5. Geben Sie Ihren VibeFox-Lizenzschlüssel im Lizenzblock oben auf der Seite ein und klicken Sie auf Activate.

6. Prüfen Sie die Store-Domain, die Absenderadresse (Origin) und, falls die Währung Ihres Shops nicht ZAR ist, den ZAR-Umrechnungskurs (siehe Konfiguration).

7. Fügen Sie VibeFox Bob Go unter WooCommerce > Settings > Shipping > Shipping zones einer Versandzone für Südafrika hinzu oder aktivieren Sie Ignore shipping zones.

Konfiguration

Alle Einstellungen befinden sich auf einer Seite: WooCommerce > Settings > Shipping > VibeFox Bob Go. Sie gelten für alle Versandzonen. Bei jedem Speichern der Einstellungen werden die zwischengespeicherten Bob-Go-Tarife gelöscht. Wenn Sie die Methode einer Zone hinzufügen, hat das Zonenfenster nur ein Feld:

Title (zone): der Name, der für feste Preise und kostenlosen Versand in dieser Zone angezeigt wird. Leer lassen, um die globale Method title zu verwenden. Live-Tarife von Bob Go werden immer mit den bei Bob Go konfigurierten Servicenamen angezeigt.

Allgemein

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

Method title: wird dem Kunden für feste Preise und kostenlosen Versand angezeigt. Eine Zone kann ihn überschreiben. Live-Tarife von Bob Go werden mit den Servicenamen von Bob Go angezeigt, zum Beispiel „The Courier Guy - Economy“. Standard: Bob Go.

Shipping cost: legt fest, wie der Preis berechnet wird.

Der Grund für fehlende Live-Tarife wird ins Protokoll geschrieben. Er wird dem Kunden nie angezeigt.

Bob-Go-Konto

Dieser Abschnitt zeigt die letzte Antwort von Bob Go für Ihre Store-Domain: connected, the WooCommerce channel is not installed on Bob Go (HTTP 404), "Rates at checkout" is not enabled for this channel (HTTP 401) oder einen anderen Fehler. Wenn die Währung Ihres Shops nicht ZAR ist und kein Umrechnungskurs gesetzt ist, warnt er außerdem, dass keine Live-Tarife angefragt werden.

Store domain: Bob Go identifiziert Ihren Shop über seine Domain. Leer lassen, um die Domain Ihrer Website zu verwenden. Geben Sie eine andere Domain nur ein, wenn Ihr Kanal bei Bob Go unter einer anderen Adresse installiert ist, zum Beispiel example.co.za/shop für einen Shop in einem Unterordner.

ZAR conversion rate: Bob Go rechnet in südafrikanischen Rand (ZAR). Wenn die Währung Ihres Shops nicht ZAR ist, geben Sie ein, wie viel 1 ZAR in der Währung Ihres Shops entspricht, zum Beispiel 0.05 für EUR. Damit werden Tarife umgerechnet, und Produktpreise werden in ZAR an Bob Go übermittelt. Leer lassen, um in Ihrer Währung keine Live-Tarife von Bob Go zu verwenden (feste Preise funktionieren weiterhin). Wenn die Währung Ihres Shops ZAR ist, lassen Sie das Feld leer. Sowohl Punkt als auch Komma werden als Dezimaltrennzeichen akzeptiert.

Delivery dates: zeigt die von Bob Go geschätzte Lieferdatumsspanne im Tarifnamen an. Die Schätzung wird immer mit der Bestellung gespeichert und ist auf dem Bestellbildschirm sichtbar.

Versand ab (Absenderadresse)

Die Absenderadresse wird bei jeder Tarifanfrage an Bob Go übermittelt. Liegt die Adresse Ihres Shops unter WooCommerce > Settings > General im selben Land, werden leere Felder daraus übernommen.

Origin country: das Land, aus dem Sie versenden. Standard: Südafrika. Bob Go versendet nur innerhalb Südafrikas.

Origin province: eine südafrikanische Provinz oder Store province (if in South Africa).

Origin city / suburb: die Stadt oder der Stadtteil, aus dem Sie versenden, zum Beispiel Johannesburg.

Origin postal code: die Postleitzahl, aus der Sie versenden, zum Beispiel 2001.

Origin street address: die Straßenadresse, von der Sie versenden.

Feste Preise (werden im festen Modus und als Ausweichlösung verwendet, wenn Bob Go keine Tarife zurückgibt)

Price per country: eine Zeile pro Land: ein 2-stelliger Ländercode, ein Gleichheitszeichen und der Preis in der Währung Ihres Shops, zum Beispiel ZA=99.99. Verwenden Sie * für alle anderen Länder, zum Beispiel *=199.99. Zeilen in einem anderen Format werden beim Speichern entfernt.

Flat price: der Preis in der Währung Ihres Shops für Länder ohne Zeile oben. Leer lassen, um die Methode für diese Länder auszublenden.

Fixed price applies: Per order berechnet den Preis einmal. Per item (price × quantity) multipliziert ihn mit der Anzahl der Artikel im Warenkorb. Live-Tarife von Bob Go gelten immer für die gesamte Sendung.

Bedingungen

Minimum weight (kg): blendet die Methode unterhalb dieses Warenkorbgewichts aus. 0 bedeutet keine Grenze.

Maximum weight (kg): blendet die Methode oberhalb dieses Warenkorbgewichts aus. 0 bedeutet keine Grenze (Standard).

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

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

Free shipping: aktiviert kostenlosen Versand, sobald der unten angegebene Bestellbetrag erreicht ist.

Free shipping from: die Zwischensumme des Warenkorbs (nach Rabatten, vor Steuern), ab der der Versand kostenlos ist. Wird nur verwendet, wenn Free shipping aktiviert ist. Dann werden keine Tarife bei Bob Go angefragt.

Tax status: Taxable fügt der Versandkostenberechnung die WooCommerce-Steuer hinzu, None nicht. Bob-Go-Tarife enthalten in der Regel bereits die MwSt. In diesem Fall wählen Sie None, damit die Steuer nicht doppelt berechnet wird.

Verfügbarkeit ohne Versandzonen

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

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

Erweitert

Debug log: protokolliert Tarifberechnungen und Anfragen an Bob Go unter WooCommerce > Status > Logs, Quelle „vfd_bob_go“. Kundenadressen werden nicht protokolliert. API-Fehler werden auch dann protokolliert, wenn diese Option aus ist.

Remove data on uninstall: wenn aktiviert, entfernt das Löschen des Plugins alle Bob-Go-Einstellungen, Zonenmethoden und zwischengespeicherten Tarife. Das Deaktivieren des Plugins löscht nie etwas.

So funktioniert es an der Kasse

Sobald der Kunde eine Lieferadresse eingibt, prüft das Plugin das Warenkorbgewicht, Minimum order amount und Excluded shipping classes. Gilt kostenloser Versand, sieht der Kunde die Methode als Bob Go (free), und es wird keine Anfrage an Bob Go gesendet.

In den Live-Modi sendet das Plugin an Bob Go die Store-Domain, die Absender- und Lieferadressen sowie die Warenkorbartikel mit den Produktpreisen in ZAR. Live-Tarife werden erst angefragt, nachdem der Kunde eine Stadt oder Postleitzahl eingegeben hat. Jeder Service, den Bob Go zurückgibt, wird als eigene Versandoption mit seinem Namen von Bob Go angezeigt und, falls Delivery dates aktiviert ist, mit den voraussichtlichen Lieferdaten. Tarife in ZAR werden mit der ZAR conversion rate umgerechnet, wenn die Währung Ihres Shops nicht ZAR ist.

Tarife werden pro Warenkorb und Adresse 1 Stunde zwischengespeichert, sodass derselbe Warenkorb keine neue Anfrage auslöst. Eine fehlgeschlagene Anfrage wird 5 Minuten zwischengespeichert, und das Zeitlimit beträgt 12 Sekunden, damit ein Ausfall von Bob Go nicht jede Aktualisierung der Kasse verlangsamt. Eine fehlgeschlagene Anfrage bricht die Kasse nie ab: Die Methode wird ausgeblendet oder im Modus mit Ausweichlösung wird der feste Preis verwendet. Der Grund wird ins WooCommerce-Protokoll geschrieben.

Der gewählte Bob-Go-Servicecode und die Lieferschätzung werden mit der Versandposition der Bestellung gespeichert und auf dem Bestellbildschirm als Bob Go service und Estimated delivery angezeigt.

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

Das Plugin zeigt nur Tarife an. Es erstellt keine Sendungen, Frachtbriefe oder Etiketten, verfolgt keine Pakete, synchronisiert keine Bestellungen mit Bob Go und versendet keine E-Mail-Benachrichtigungen. Für die Abwicklung nutzen Sie das Bob-Go-Dashboard (oder die eigene Bestellsynchronisation von Bob Go). Es gibt keine Auswahl von Abholstellen oder Paketstationen (Bob Box, Pargo) und kein zusätzliches Feld für Stadtteile an der Kasse. Bob Go versendet nur innerhalb Südafrikas.

Lizenzschlüssel

Das Plugin funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock befindet sich oben unter WooCommerce > Settings > Shipping > VibeFox Bob Go. Fügen Sie den Schlüssel in License key ein und klicken Sie auf Activate. Der Block zeigt den Status an, 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 Bob Go Kunden an der Kasse nicht angezeigt. Angemeldete Shop-Manager sehen es weiterhin, markiert mit (unlicensed — visible to admins only), damit Sie das Plugin vor dem Kauf eines Schlüssels einrichten und testen können. Ein Hinweis erscheint auf der Plugins-Seite und auf WooCommerce-Seiten. Bestehende Bestellungen sind nicht betroffen.

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

Fehlerbehebung

Bob Go erscheint nicht an der Kasse: prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist und die Methode der Zone des Landes des Kunden hinzugefügt wurde (oder Ignore shipping zones aktiviert und das Land erlaubt ist). Prüfen Sie die Gewichtsgrenzen, Minimum order amount und Excluded shipping classes. Prüfen Sie im festen Modus, dass das Land, * oder Flat price einen Preis hat.

Es werden keine Bob-Go-Tarife angezeigt: öffnen Sie die Plugin-Einstellungen. Der Abschnitt Bob Go account zeigt die letzte Antwort von Bob Go. „Channel is not installed“ (HTTP 404) bedeutet, dass die Store-Domain kein Verkaufskanal bei Bob Go ist: Prüfen Sie Store domain. „Rates at checkout is not enabled“ (HTTP 401) bedeutet, dass die Funktion für den Kanal deaktiviert ist. Achten Sie außerdem darauf, dass der Kunde eine Stadt oder Postleitzahl eingegeben hat und, bei Shops ohne ZAR, dass ZAR conversion rate gesetzt ist. Aktivieren Sie Debug log und öffnen Sie WooCommerce > Status > Logs (Quelle „vfd_bob_go“) für Details. Mit Bob Go live rates, fixed prices if Bob Go returns no rates erhalten Kunden weiterhin den festen Preis, während Sie das Problem beheben.

Mein Shop ist nicht in Rand: Bob Go rechnet in ZAR. Geben Sie ein, wie viel 1 ZAR in der Währung Ihres Shops entspricht (zum Beispiel 0.05 für EUR). Ohne diesen Wert fragt das Plugin keine Tarife bei Bob Go an. Feste Preise funktionieren weiterhin.

Versandsteuer wird doppelt berechnet: Bob-Go-Tarife enthalten in der Regel bereits die MwSt. Stellen Sie Tax status auf None.

Tarife wirken nach einer Änderung veraltet: speichern Sie die Einstellungsseite. Dadurch werden die zwischengespeicherten Bob-Go-Tarife gelöscht. Änderungen in Ihrem Bob-Go-Konto werden nach dem 1-Stunden-Cache oder beim Speichern der Einstellungen übernommen.

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. 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 Tarife 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.

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