VibeFox Bob Go for PrestaShop — Hilfe

Anforderungen

PrestaShop: 8.0 bis 9.x.

PHP: 8.0 oder neuer. Das Modul lässt sich auf älteren PHP-Versionen nicht installieren.

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

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.

2. Wenn der Upload abgeschlossen ist, klicken Sie auf Configure, oder suchen Sie später VibeFox Bob Go in der Modulliste und klicken Sie dort auf Configure.

3. Geben 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. Installieren Sie Ihren Shop in Ihrem Bob-Go-Konto als Verkaufskanal. Aktivieren Sie „Rates at checkout“ für diesen Kanal und richten Sie Ihre Services und Preise ein.

5. Prüfen Sie auf der Seite Configure die Shop-Domain, die Absenderadresse (Versand von) und, falls die Währung Ihres Shops nicht ZAR ist, den ZAR-Umrechnungskurs (siehe Konfiguration). Haben südafrikanische Adressen in Ihrem Shop keine Provinz, klicken Sie auf Add South African provinces. Klicken Sie auf Save.

Bei der Installation legt das Modul die Versandart Bob Go mit dem Lieferzeittext Courier delivery (South Africa) an. Die Versandart ist aktiv, allen Zonen und allen Kundengruppen zugewiesen und verwendet standardmäßig die Live-Tarife von Bob Go. Zonen, Kundengruppen, Lieferzeit, Logo und Größenlimits können Sie unter Shipping > Carriers ändern. Legen Sie dort keine Preise fest: Der Preis kommt immer vom Modul.

Konfiguration

Alle Einstellungen befinden sich auf der Modulseite: Modules > Module Manager > VibeFox Bob Go > Configure. Sie gelten für alle Zonen der Versandart. Jeder Abschnitt hat eine eigene Schaltfläche Save, die die gesamte Seite speichert. Jedes Speichern löscht außerdem die zwischengespeicherten Tarife von Bob Go. Zahlen akzeptieren einen Punkt oder ein Komma als Dezimaltrennzeichen. Ist ein Wert falsch, zeigt die Seite einen Fehler an und nichts wird gespeichert: ein Wert, der keine Zahl ist ("…" must be a number.), ein negativer Betrag oder ein negatives Gewicht ("…" must be a number of 0 or more.), ein ZAR conversion rate von 0 oder weniger, ein Minimum weight, das über dem Maximum weight liegt, oder ein Method title mit mehr als 64 Zeichen.

Oberhalb des Formulars warnt die Seite, wenn Live-Tarife nicht funktionieren können: Live rates are not requested: your store currency is … — set the "ZAR conversion rate"., wenn südafrikanische Adressen keine Provinz haben (siehe unten Südafrikanische Provinzen), oder wenn die Gewichts- oder Maßeinheit des Shops nicht erkannt und als kg bzw. cm behandelt wird. Stellen Sie die Einheiten unter International > Localization (Local units) ein.

Allgemein

Enable Bob Go: schaltet die Versandart ein oder aus. Das ist derselbe Schalter wie der Status der Versandart unter Shipping > Carriers.

Method title: der Name der Versandart, den der Kunde sieht. Die Bob-Go-Services, zum Beispiel „The Courier Guy - Economy“, werden darunter an der Kasse mit den Namen von Bob Go aufgelistet. Standard: Bob Go. Pflichtfeld, höchstens 64 Zeichen.

Shipping cost: so wird der Preis berechnet.

Der Grund für fehlende Live-Tarife wird im Log protokolliert. Dem Kunden wird er nie angezeigt.

Bob-Go-Konto

Dieser Abschnitt erklärt, was Sie bei Bob Go benötigen, und zeigt die letzte Antwort von Bob Go für die Domain Ihres Shops: connected, the WooCommerce channel is not installed on Bob Go (HTTP 404), "Rates at checkout" is not enabled for this channel (HTTP 401) oder request failed mit dem Fehlercode oder no connection.

Store domain: Bob Go identifiziert Ihren Shop anhand seiner Domain. Lassen Sie das Feld leer, um die Domain Ihres Shops zu verwenden, die als Platzhalter angezeigt wird. 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. Das Schema und der abschließende Schrägstrich werden entfernt.

ZAR conversion rate: Bob Go rechnet in südafrikanischen Rand (ZAR). Wenn die Standardwährung Ihres Shops nicht ZAR ist, geben Sie an, wie viel 1 ZAR in Ihrer Währung wert ist, zum Beispiel 0.05. Damit werden die Tarife umgerechnet, und Produktpreise werden in ZAR an Bob Go übermittelt. Lassen Sie das Feld leer, um in Ihrer Währung keine Live-Tarife von Bob Go zu verwenden (feste Preise funktionieren weiterhin). Der Kurs muss größer als 0 sein. Wenn die Währung Ihres Shops ZAR ist, lassen Sie das Feld leer.

Delivery dates: zeigt den von Bob Go geschätzten Lieferzeitraum neben jedem Service an der Kasse an. Die Schätzung wird immer mit der Bestellung gespeichert und ist auf der Bestellseite sichtbar.

Versand von (Absenderadresse)

Die Absenderadresse wird mit jeder Tarifanfrage an Bob Go gesendet. Liegt die Shop-Adresse unter Shop Parameters > Contact > Stores im selben Land, werden leere Felder daraus übernommen.

Origin country: das Land, von 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, von dem Sie versenden, zum Beispiel Johannesburg.

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

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

Südafrikanische Provinzen: PrestaShop kennt für Südafrika keine Provinzen. Kundenadressen dort haben daher keine Provinz, Bob Go erwartet aber eine. Klicken Sie auf Add South African provinces, um die 9 Provinzen (Codes EC, FS, GP, KZN, LP, MP, NC, NW, WC) als Bundesstaaten von Südafrika hinzuzufügen und das Feld für den Bundesstaat in südafrikanischen Adressen anzuzeigen. Provinzen, die bereits vorhanden sind (nach Code oder Name), werden nicht erneut hinzugefügt. Erst mit dem Klick auf die Schaltfläche ändert sich etwas. Sind die Provinzen angelegt, zeigt das Feld South African addresses have a province mit der Anzahl an.

Feste Preise (verwendet, wenn Shipping cost auf Fixed prices (below) steht, und als Ausweichlösung, wenn Bob Go keine Tarife zurückgibt)

Price per country: eine Zeile pro Land: ein zweistelliger Ländercode, ein Gleichheitszeichen und der Preis in der Standardwährung Ihres Shops ohne Steuer, zum Beispiel ZA=99.99. Verwenden Sie * für alle anderen Länder, zum Beispiel *=199.99 in der nächsten Zeile. Zeilen in einem anderen Format werden beim Speichern entfernt, und die Seite listet sie in einer Warnung auf.

Flat price: der Preis für Länder ohne eigene Zeile oben. Lassen Sie das Feld leer, um die Versandart 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: blendet die Versandart unterhalb dieses Warenkorbgewichts aus, in kg. 0 bedeutet keine Grenze (Standard).

Maximum weight: blendet die Versandart oberhalb dieses Warenkorbgewichts aus, in kg. 0 bedeutet keine Grenze (Standard). Sind beide Grenzen gesetzt, darf das Minimum nicht über dem Maximum liegen.

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

Free shipping: schaltet kostenlosen Versand ein, wenn der unten angegebene Bestellbetrag erreicht wird.

Free shipping from: die Zwischensumme des Warenkorbs (nach Rabatten, vor Steuern) für kostenlosen Versand. Wird nur verwendet, wenn Free shipping eingeschaltet ist. Dann werden keine Tarife bei Bob Go angefragt.

Tax: die Steuerregel der Versandart oder No tax (Standard). Bob-Go-Tarife enthalten in der Regel bereits die MwSt. In diesem Fall belassen Sie es bei No tax, damit die Steuer nicht doppelt berechnet wird.

Verfügbarkeit ohne Versandzonen

Ignore shipping zones: Ist die Option eingeschaltet, wird die Versandart allen Zonen zugeordnet, auch später angelegten, und für die unten genannten Länder angeboten. Ist sie ausgeschaltet, wird sie nur in den Zonen der Versandart unter Shipping > Carriers angeboten; die Zonen, die sie vorher hatte, werden wiederhergestellt.

Countries: die Zielländer für diesen Modus. Lassen Sie das Feld leer, um alle Länder zuzulassen, in die Sie versenden. Wird nur verwendet, wenn Ignore shipping zones eingeschaltet ist.

Erweitert

Debug log: protokolliert Tarifberechnungen und Anfragen an Bob Go in logs/vfd_bobg_debug.log.php im Modulordner. Die Datei kann nicht über das Web geöffnet werden. Kundenadressen werden nicht protokolliert. Fehler von Bob Go werden auch dann protokolliert, wenn dies ausgeschaltet ist. Schalten Sie das Debug-Log aus, wenn Sie fertig sind.

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

Remove data on uninstall: ist die Option eingeschaltet, löscht die Deinstallation des Moduls die Bob-Go-Einstellungen, die Versandart, zwischengespeicherte Tarife und Logs. Der mit Bestellungen gespeicherte Bob-Go-Service bleibt erhalten. Ist sie ausgeschaltet, bleibt alles für eine erneute Installation erhalten.

So funktioniert es an der Kasse

Im Versandschritt fragt PrestaShop das Modul nach dem Bob-Go-Preis. Nur physische Produkte zählen: Virtuelle Produkte haben kein Gewicht und sind nicht im Bestellbetrag enthalten. Das Modul prüft zuerst das Zielland (mit Ignore shipping zones), das Warenkorbgewicht und den Minimum order amount. Gilt kostenloser Versand, wird die Versandart als kostenlos angezeigt und es wird keine Anfrage an Bob Go gesendet.

In den Live-Modi übermittelt das Modul an Bob Go die Domain Ihres Shops, die Absender- und die Lieferadresse (mit Provinz) sowie die Warenkorbartikel, wobei die Produktpreise in ZAR angegeben werden. Live-Tarife werden erst angefragt, nachdem der Kunde eine Stadt oder eine Postleitzahl eingegeben hat. Tarife in ZAR werden mit dem ZAR conversion rate umgerechnet, wenn die Währung Ihres Shops nicht ZAR ist. Der Preis wird in Ihrer Standardwährung berechnet und dann in der Warenkorbwährung des Kunden angezeigt.

Unter der Versandart Bob Go sieht der Kunde Choose a delivery service: und eine Option pro Bob-Go-Service mit dessen Namen, Preis und, wenn Delivery dates eingeschaltet ist, den voraussichtlichen Lieferdaten. Der erste Service ist standardmäßig ausgewählt. Wählt der Kunde einen anderen Service, wird die Auswahl sofort gespeichert, und der Preis der Versandart sowie die Warenkorbsumme werden aktualisiert. Die Versandart kostet genau, was der gewählte Service kostet. Wird ein Service für die Adresse nicht mehr angeboten, sieht der Kunde This service is not available for your address any more. Please choose another one. Schlägt das Speichern fehl, lautet die Meldung The service could not be saved. Please try again. Die Serviceliste funktioniert mit den Themes Classic und Hummingbird.

Tarife werden pro vollständiger Anfrage 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 Versandart wird ausgeblendet, oder im Ausweichmodus wird der feste Preis verwendet. Der Grund wird im Log protokolliert.

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 zeigt nur Tarife an. Es erstellt keine Sendungen, Frachtbriefe oder Etiketten, verfolgt keine Pakete, synchronisiert keine Bestellungen mit Bob Go und versendet keine Benachrichtigungen. Für die Abwicklung nutzen Sie das Bob-Go-Dashboard. Eine Auswahl von Abholstellen oder Paketstationen gibt es nicht. Bob Go versendet nur innerhalb Südafrikas.

Bestellungen

Wenn die Bestellung aufgegeben wird, werden der gewählte Bob-Go-Service, sein Code und die Lieferschätzung mit der Bestellung gespeichert. Spätere Änderungen am Warenkorb oder an den Bob-Go-Preisen ändern sie nicht.

Im Back-Office zeigt die Bestellseite einen Block Bob Go mit Bob Go service (Name und Code) und Estimated delivery. Der Kunde sieht Bob Go service und Estimated delivery auf der Bestelldetailseite in seinem Konto. Bestellungen mit festem Preis oder kostenlosem Versand haben keinen Bob-Go-Service.

Lizenzschlüssel

Das Modul funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox Bob Go ist der erste Block unter Modules > Module Manager > VibeFox Bob Go > Configure, oberhalb der Einstellungen. Geben Sie den Schlüssel in License key ein und klicken Sie auf Activate. Danach zeigt der Block den maskierten Schlüssel, den Status (zum Beispiel das Datum, bis zu dem die Lizenz aktiv ist, und Ihre Domain) sowie die Schaltflächen Check now zum erneuten Prüfen des Status, Change key zum Eingeben eines anderen Schlüssels und Remove key zum Entfernen des Schlüssels aus diesem Shop. Darunter stehen die Zeile Product: presta-shipping-bob-go und der Link Manage licenses and domains in your account, der Ihr vibefox.net-Konto öffnet. Den Schlüssel können nur Mitarbeiter ändern, die die Berechtigung Configure für das Modul haben. Die Texte des Blocks folgen der Sprache des Back Office (Englisch und Russisch sind enthalten).

Wird der Schlüssel nicht akzeptiert, zeigt der Block den Grund an, zum Beispiel Key not found, This key belongs to another product, Domain limit reached oder License expired on mit einem Datum. Nachdem sich die Shop-Adresse geändert hat 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 gilt für eine Domain: die Domain des Hauptshops, auch bei einer Multistore-Einrichtung. Das Entfernen des Schlüssels aus dem Shop gibt seinen Domain-Platz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.

Ohne aktiven Schlüssel wird die Versandart Bob Go Kunden an der Kasse nicht angezeigt, und es wird kein Tarif berechnet. Das Frontend von PrestaShop 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 der Registerkarte Alerts. Bestehende Bestellungen bleiben unberührt.

Läuft eine Lizenz ab, arbeitet das Modul weiter, Updates und Support benötigen aber eine Verlängerung. Der Status wird automatisch erneut geprüft, während Sie im Back Office arbeiten: 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

Bob Go erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv ist und Enable Bob Go eingeschaltet ist. Prüfen Sie unter Shipping > Carriers, ob die Versandart die Zone des Ziellandes des Kunden und dessen Kundengruppe abdeckt, oder schalten Sie Ignore shipping zones ein und prüfen Sie Countries. Prüfen Sie die Gewichtsgrenzen und den Minimum order amount. Prüfen Sie im festen Modus, ob das Land, * oder der Flat price einen Preis hat. Produkte können auf der Produktseite auch auf bestimmte Versandarten beschränkt sein.

Keine Bob-Go-Tarife werden angezeigt: Öffnen Sie die Modulseite. Der Abschnitt Bob-Go-Konto zeigt die letzte Antwort von Bob Go. „The WooCommerce channel is not installed on Bob Go“ (HTTP 404) bedeutet, dass die Shop-Domain bei Bob Go kein Verkaufskanal 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 dass bei Shops mit einer anderen Währung als ZAR der ZAR conversion rate gesetzt ist. Schalten Sie das Debug log ein, laden Sie die Kasse neu und sehen Sie im Feld Log nach. 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 rechnet nicht in Rand: Bob Go rechnet in ZAR. Geben Sie an, wie viel 1 ZAR in der Währung Ihres Shops wert ist. Ohne diesen Wert fragt das Modul keine Tarife bei Bob Go an. Feste Preise funktionieren weiterhin.

Die Seite warnt, dass südafrikanische Adressen keine Provinz haben: Klicken Sie im Abschnitt Versand von (Absenderadresse) auf Add South African provinces. Bestehende Kundenadressen erhalten erst dann eine Provinz, wenn sie bearbeitet werden.

Steuer wird beim Versand doppelt berechnet: Bob-Go-Tarife enthalten normalerweise die MwSt. Setzen Sie Tax auf No tax.

Tarife wirken nach einer Änderung veraltet: Klicken Sie auf der Modulseite auf Save. Das löscht die zwischengespeicherten Tarife von Bob Go. Änderungen in Ihrem Bob-Go-Konto werden nach dem 1-stündigen Cache oder beim Speichern der Einstellungen übernommen.

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

Deinstallation

Gehen Sie zu Modules > Module Manager, öffnen Sie das Menü neben VibeFox Bob Go und wählen Sie Uninstall. Der Lizenzschlüssel, der Lizenzstatus und die zwischengespeicherten Tarife werden immer gelöscht. Ist Remove data on uninstall eingeschaltet, wird die Versandart gelöscht (Bestellungen behalten ihren Verlauf), und die Einstellungen, das Log sowie die Serviceauswahl offener Warenkörbe werden entfernt. Ist die Option ausgeschaltet, wird die Versandart nur deaktiviert und alle Einstellungen bleiben erhalten. Bei einer erneuten Installation des Moduls oder bei Reset erhält die gespeicherte Versandart wieder den Status, den sie vorher hatte: Eine aktive Versandart wird wieder eingeschaltet, eine deaktivierte bleibt deaktiviert. Der mit Bestellungen gespeicherte Bob-Go-Service bleibt immer erhalten.

Bob Go ist eine Marke ihres jeweiligen Inhabers. Dieses Modul ist weder mit Bob Go verbunden noch wird es von Bob Go unterstützt.