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

Balikobot-Konto (für Live-Tarife und Abholstellen): Sie benötigen ein Balikobot-Konto mit API-Zugang. API-Benutzer und API-Schlüssel finden Sie im Kundenbereich von Balikobot (client.balikobot.cz). Der Balikobot-Support (podpora@balikobot.cz) aktiviert die API für Ihr Konto und Ihre Versanddienstleister. Live-Tarife benötigen einen Versanddienstleister und einen Service, für die Balikobot "transportcosts" unterstützt. Abholstellen benötigen einen Versanddienstleister mit Unterstützung für "branchlocator" (zum Beispiel Česká pošta, Zásilkovna, PPL, DPD, GLS). Wenden Sie sich bei Unsicherheit an den Balikobot-Support. Feste Preise funktionieren ohne Konto.

VibeFox-Lizenzschlüssel: Erwerb auf vibefox.net. 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 aus.

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

3. Fügen Sie Ihren VibeFox-Lizenzschlüssel in das Feld License key im Lizenzbereich oben auf der Seite Configure ein und klicken Sie auf Activate (siehe Lizenzschlüssel).

4. Geben Sie API-Benutzer und API-Schlüssel ein, wählen Sie Versanddienstleister und Servicetyp, die Preisquelle und die Länderpreise (siehe Konfiguration). Aktivieren Sie bei Abholservices Pickup point selection. Klicken Sie auf Save.

Bei der Installation legt das Modul den Versanddienstleister Balikobot mit dem Liefertext Delivery by Balikobot an. Der Versanddienstleister wird den Zonen Tschechien, Slowakei und Ungarn sowie allen Kundengruppen zugewiesen. Zonen, Kundengruppen, Lieferzeit, Logo und Größenbeschränkungen können Sie unter Shipping > Carriers ändern. Legen Sie dort keine Preise fest: Der Preis stammt immer aus dem Modul.

Konfiguration

Alle Einstellungen befinden sich auf der Modulseite: Modules > Module Manager > VibeFox Balikobot > Configure. Jeder Abschnitt hat eine eigene Schaltfläche Save, die die gesamte Seite speichert. Nach dem Speichern sehen Sie Settings saved. Cached rates and pickup points were cleared. Oben auf der Seite erscheinen Warnungen zu Einstellungen, die den Versanddienstleister, die Live-Tarife oder die Abholstellen ausblenden würden: Live-Tarife oder Abholstellen ohne API-Benutzer oder API-Schlüssel, eine Shop-Währung außer CZK ohne Exchange rate, leere Country prices bei festen Preisen oder dem Fallback, eine Gewichtseinheit des Shops, die das Modul nicht kennt (Gewichte werden dann als kg gelesen; verwenden Sie kg, g, lb oder oz), und ein gelöschter Versanddienstleister. Ein Wert, der keine Zahl ist, wird nicht gespeichert, und Sie erhalten eine Warnung mit dem Feldnamen.

General

Enable/Disable: schaltet den Balikobot-Versand ein oder aus. Es ist derselbe Schalter wie der Status des Versanddienstleisters unter Shipping > Carriers.

Name: der Name der Versandart, der dem Kunden angezeigt wird (der Name des Versanddienstleisters). Standard: Balikobot. Pflichtfeld, höchstens 64 Zeichen.

Tax status: None oder Taxable mit einer Ihrer Steuerregeln. Bei einer Steuerregel wird deren Steuer zum Versandpreis addiert. Die Auswahl wird am Versanddienstleister gespeichert. Balikobot-Preise verstehen sich in der Regel ohne MwSt. Standard: None.

Balikobot-API-Konto (für Live-Tarife und Abholstellen erforderlich)

API user: Ihr Balikobot-API-Benutzer aus dem Kundenbereich.

API key: Ihr Balikobot-API-Schlüssel aus dem Kundenbereich. Nach dem Speichern bleibt das Feld leer und zeigt Saved - leave empty to keep it. Clear the API user to remove the saved key. Geben Sie nur dann einen neuen Wert ein, wenn Sie den Schlüssel ändern möchten.

Carrier: der Balikobot-Versanddienstleister für Tarife und Abholstellen: Česká pošta (Standard), Zásilkovna (Packeta), PPL, DPD, GLS, DHL Express, UPS, TNT, FedEx, Geis, InTime, Uloženka, Toptrans, Pošta bez hranic, Slovenská pošta, SPS (Slovak Parcel Service) oder Magyar Posta. Er muss in Ihrem Balikobot-Konto aktiviert sein.

Service type: der Balikobot-Servicecode des Versanddienstleisters. Standard: NP. Für Česká pošta: NP = Paket an eine Postfiliale, NB = Paket an Balíkovna, DR = Hauszustellung. Die Codes anderer Versanddienstleister finden Sie im Kundenbereich von Balikobot und in der API-Dokumentation.

Preis (alle Preise gelten in der Standardwährung Ihres Shops)

Price source: wie der Preis berechnet wird.

Country prices: eine Tabelle mit zweistelligen Ländercodes (zum Beispiel CZ, SK) und Preisen. Klicken Sie auf Add row, um ein Land hinzuzufügen, und auf das Papierkorb-Symbol, um es zu entfernen. Verwenden Sie * als Ländercode für alle übrigen Länder. Dezimalstellen mit Punkt oder Komma. Die Tabelle wird im festen Modus und als API-Fallback verwendet. Ein Land ohne Preis (und ohne eine Zeile mit *) erhält keinen festen Tarif. Ungültige Zeilen werden beim Speichern entfernt, und eine Warnung listet sie auf.

Fixed price per: Order berechnet den Preis einmal. Item (price x quantity) multipliziert ihn mit der Anzahl der Artikel im Warenkorb. Dies gilt nur für feste Preise. Ein Live-Tarif von Balikobot gilt immer für das gesamte Paket.

Exchange rate: der Wert von 1 Einheit der Balikobot-Preiswährung (in der Regel CZK) in der Standardwährung Ihres Shops, zum Beispiel 0.04. Wird nur verwendet, wenn Balikobot einen Preis in einer anderen Währung zurückgibt. Lassen Sie das Feld leer, um solche Preise abzulehnen, damit ein Kunde nie einen falschen Preis zahlt.

Bedingungen

Min weight (kg): blendet den Versanddienstleister aus, wenn der Warenkorb leichter ist. 0 bedeutet keine Begrenzung. Produktgewichte werden aus der Gewichtseinheit Ihres Shops umgerechnet.

Max weight (kg): blendet den Versanddienstleister aus, wenn der Warenkorb schwerer ist. Standard: 100. 0 bedeutet keine Begrenzung. Ein leeres Feld bedeutet 100 kg. Wenn Min weight (kg) größer als das Maximum ist, erhalten Sie eine Warnung und die vorherigen Gewichte bleiben erhalten.

Minimum order amount: zeigt den Versanddienstleister nur ab dieser Warenkorbsumme an (nach Rabatten, ohne Steuern). Lassen Sie das Feld leer, um ihn immer anzuzeigen.

Free shipping: schaltet kostenlosen Versand ab dem unten angegebenen Betrag ein.

Free shipping from: die Warenkorbsumme (nach Rabatten, ohne Steuern), ab der der Versand kostenlos ist. In diesem Fall wird keine API-Anfrage gestellt.

Verfügbarkeit ohne Versandzonen

Normalerweise wird der Versanddienstleister in seinen Zonen unter Shipping > Carriers angeboten.

Ignore shipping zones: bietet den Versanddienstleister in den unten genannten Ländern an, auch wenn er nicht mit deren Zone verknüpft ist. Das Modul verknüpft den Versanddienstleister mit allen Zonen, auch mit Zonen, die Sie später anlegen. Wenn Sie die Option ausschalten, werden die auf diese Weise hinzugefügten Zonen wieder entfernt. Ihre eigenen Zonen bleiben erhalten.

Countries: die Zielländer für diesen Modus. Lassen Sie das Feld leer, um alle Länder zu verwenden, in die Sie versenden. Wird nur zusammen mit Ignore shipping zones verwendet.

Abholstellen

Pickup point selection: der Kunde muss eine Abholstelle wählen. Verwenden Sie dies für Abholservices, zum Beispiel Česká pošta NP oder NB oder Zásilkovna. Benötigt API-Benutzer und API-Schlüssel.

Selector width: die CSS-Breite der Liste der Abholstellen, zum Beispiel 100% oder 400px. Standard: 100%.

Erweitert

Debug log: protokolliert API-Anfragen und Tarifberechnungen in logs/vfd_blkb_debug.log.php im Modulordner. Die Datei lässt sich nicht über das Web öffnen. API-Fehler werden immer protokolliert. Zugangsdaten und Kundenadressen werden nie protokolliert. Schalten Sie das Protokoll aus, wenn Sie fertig sind.

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

Remove data on uninstall: Ist die Option eingeschaltet, löscht die Deinstallation des Moduls die Modul-Einstellungen und den Versanddienstleister. Ohne diese Option werden bei der Deinstallation nie Daten gelöscht. In Bestellungen gespeicherte Abholstellen bleiben erhalten.

So funktioniert es an der Kasse

Im Versandschritt fragt PrestaShop das Modul nach dem Balikobot-Preis. Nur physische Produkte zählen: Virtuelle Produkte erhöhen weder das Gewicht noch fließen sie in die Bestellsumme ein. Das Modul prüft zuerst die Länder (mit Ignore shipping zones), das Warenkorbgewicht und den Minimum order amount. Gilt kostenloser Versand, beträgt der Preis 0 und es wird keine Anfrage an Balikobot gesendet.

Im festen Modus wird der Preis aus Country prices übernommen. In den Live-Modi sendet das Modul an Balikobot den Versanddienstleister, den Servicetyp, das Zielland und die Postleitzahl sowie das Warenkorbgewicht in kg. Ein Live-Tarif wird nur abgefragt, wenn die Lieferadresse eine Postleitzahl hat. Ein Preis in einer anderen Währung wird mit Exchange rate umgerechnet oder abgelehnt, wenn kein Wechselkurs festgelegt ist. Der Preis wird in der Standardwährung Ihres Shops berechnet und danach in der Warenkorbwährung des Kunden angezeigt.

Live-Preise werden 1 Stunde zwischengespeichert, damit derselbe Warenkorb keine neue Anfrage auslöst. Eine fehlgeschlagene Anfrage wird 5 Minuten zwischengespeichert, und das API-Zeitlimit beträgt 12 Sekunden, damit die Kasse bei jeder Aktualisierung nicht auf Balikobot warten muss. API-Fehler werden dem Kunden nie angezeigt: Der Versanddienstleister wird ausgeblendet oder im Fallback-Modus wird der feste Preis verwendet. Die Details gehen ins Debug-Log.

Wenn Sie den Versanddienstleister unter Shipping > Carriers bearbeiten, nachdem er Bestellungen hat, speichert PrestaShop ihn als neue Version des Versanddienstleisters. Das Modul übernimmt die neue Version automatisch.

Das Modul erstellt keine Sendungen in Balikobot, druckt keine Etiketten und bestellt keine Abholungen: Bestellen Sie den Versand im Kundenbereich von Balikobot. Es verfolgt keine Pakete und aktualisiert den Bestellstatus nicht. Für alle Zonen wird ein Versanddienstleister und ein Servicetyp verwendet. Abholstellen werden als Auswahlliste ohne Karte angezeigt.

Abholstellen

Ist Pickup point selection eingeschaltet, erscheint im Versandschritt unter dem Balikobot-Versanddienstleister eine Liste der Abholstellen. Die Liste wird über den "branchlocator" von Balikobot für Land, Ort und Postleitzahl der Lieferadresse geladen. Solange die Adresse keinen Ort hat, sieht der Kunde Enter your city to see the pickup points. Die Liste wird 12 Stunden zwischengespeichert.

Die Auswahl wird im Warenkorb gespeichert, sobald der Kunde eine Abholstelle wählt. Sie ist Pflicht: Continue im Versandschritt und Place order sind mit Please select a pickup point. blockiert. Der Server prüft außerdem, ob die gewählte Abholstelle zur Lieferadresse gehört. Andernfalls sieht der Kunde The selected pickup point is not available for your shipping address. Please choose a pickup point again. Werden keine Abholstellen gefunden, wird der Kunde gebeten, Ort und Postleitzahl zu prüfen oder eine andere Versandart zu wählen. Können die Abholstellen nicht geladen werden, wird der Kunde gebeten, es später erneut zu versuchen oder eine andere Versandart zu wählen.

Die gewählte Abholstelle wird in der Bestellung gespeichert. Auf der Bestellseite im Back Office wird sie im Block Balikobot pickup point angezeigt, mit der Balikobot-Filial-ID und dem Versanddienstleister, die Sie beim Erstellen der Sendung in Balikobot benötigen. Klicken Sie auf Change, um eine andere Abholstelle in der Nähe der Bestelladresse zu wählen, und dann auf Save. Für die Änderung der Abholstelle genügt das Recht, Bestellungen zu bearbeiten; Zugriff auf die Modulseiten ist nicht nötig. Hat eine Bestellung keine Abholstelle, zeigt der Block No pickup point was selected for this order.

Der Kunde sieht die Abholstelle als Pickup point: auf der Bestellbestätigungsseite und in den Bestelldetails. In der Bestellbestätigungs-E-Mail und in der E-Mail über neue Bestellungen für den Shop (Modul Mail alerts) wird sie nach dem Namen des Versanddienstleisters ergänzt. Bestehende Bestellungen behalten ihre Abholstellendaten.

Lizenzschlüssel

Das Modul arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox Balikobot ist der erste Block auf Modules > Module Manager > VibeFox Balikobot > Configure, über den Einstellungen. Fügen 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 gültig ist, und Ihre Domain) sowie die Schaltflächen Check now zum erneuten Prüfen des Status, Change key zur Eingabe eines anderen Schlüssels und Remove key zum Entfernen des Schlüssels aus diesem Shop. Darunter stehen die Zeile Product: presta-shipping-balikobot und der Link Manage licenses and domains in your account, der Ihr vibefox.net-Konto öffnet. Nur Mitarbeiter mit der Berechtigung Configure für das Modul können den Schlüssel ändern. Die Texte des Blocks folgen der Sprache des Back Office (Englisch und Russisch sind enthalten).

Wird der Schlüssel nicht akzeptiert, nennt der Block den Grund, 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 einen Domain-Platz in Ihrem Konto freigegeben haben, klicken Sie auf Check now. Ist der Lizenzserver nicht erreichbar, arbeitet das Modul mit dem zuletzt bekannten Status weiter.

Ein Schlüssel funktioniert für eine Domain: die Domain des Haupt-Shops, auch bei einer Multistore-Konfiguration. Wenn Sie den Schlüssel aus dem Shop entfernen, wird sein Domain-Platz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.

Ohne einen aktiven Schlüssel wird der Balikobot-Versanddienstleister Kunden an der Kasse nicht angezeigt und es wird kein Tarif berechnet. Die PrestaShop-Storefront weiß nicht, dass Sie im Back Office angemeldet sind, daher wird der Versanddienstleister auch für Sie ausgeblendet: Sie können das Modul vor dem Kauf eines Schlüssels einrichten, aber nicht an der Kasse testen. Eine Erinnerung erscheint unter Modules > Module Manager auf dem Tab Alerts. Bestehende Bestellungen sind nicht betroffen.

Läuft eine Lizenz ab, arbeitet das Modul weiter, aber Updates und Support erfordern eine Verlängerung. Der Status wird während Ihrer Arbeit im Back Office automatisch erneut geprüft: einmal täglich in den ersten 14 Tagen nach der Eingabe des Schlüssels, danach einmal wöchentlich. Ein Cron-Job ist nicht nötig. Deinstallation oder Zurücksetzen des Moduls entfernt immer den Lizenzschlüssel und den Lizenzstatus.

Fehlerbehebung

Balikobot erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv ist und Enable/Disable eingeschaltet ist. Lesen Sie die Warnungen oben auf der Modulseite. Prüfen Sie unter Shipping > Carriers, ob der Versanddienstleister die Zone des Kundenlandes und die 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 * einen Preis hat. Produkte können auf der Produktseite auch auf bestimmte Versanddienstleister beschränkt sein.

Live-Tarife erscheinen nicht: Schalten Sie Debug log ein, laden Sie die Kasse neu und sehen Sie im Feld Log auf der Modulseite nach. Dort steht der Grund: fehlende API-Zugangsdaten, noch keine Postleitzahl, der Balikobot-Fehler für den Versanddienstleister und den Service (zum Beispiel authorization failed; prüfen Sie API-Benutzer und API-Schlüssel) oder ein Preis in einer anderen Währung ohne Exchange rate. Mit Live Balikobot rate, fixed price if the API fails erhalten Kunden weiterhin den festen Preis, während Sie das Problem beheben.

Preise sind in der falschen Währung: Feste Preise gelten in der Standardwährung Ihres Shops. Balikobot gibt Live-Preise in der Währung Ihres Balikobot-Vertrags zurück (in der Regel CZK). Weicht sie von Ihrer Standardwährung ab, legen Sie Exchange rate fest.

Ist die MwSt. enthalten: Balikobot-Preise verstehen sich in der Regel ohne MwSt. Ist Tax status auf eine Steuerregel gesetzt, fügt PrestaShop die Steuer auf den Versand hinzu.

Keine Abholstellen in der Liste: Prüfen Sie, ob API-Benutzer und -Schlüssel eingetragen sind, ob der Versanddienstleister "branchlocator" unterstützt und ob die Lieferadresse Ort und Postleitzahl hat. Sehen Sie im Protokoll nach dem Balikobot-Fehler.

Tarife oder Abholstellen wirken nach einer Änderung veraltet: Klicken Sie auf der Modulseite auf Save. Dadurch werden die zwischengespeicherten Tarife und Abholstellen gelöscht.

Die Seite meldet, dass der Balikobot-Versanddienstleister nicht gefunden wurde: Der Versanddienstleister wurde unter Shipping > Carriers gelöscht. Setzen Sie das Modul unter Modules > Module Manager zurück, um ihn erneut anzulegen.

Für Entwickler: Das Modul bietet eigene Hooks zum Ändern der API-Adresse (actionVfdBlkbApiUrl), des "transportcosts"-Pakets (actionVfdBlkbTransportcostsPackage) und der Anzahl der Abholstellen (actionVfdBlkbPickupMaxResults, Standard 30).

Deinstallation

Gehen Sie zu Modules > Module Manager, öffnen Sie das Menü neben VibeFox Balikobot und wählen Sie Uninstall. Der Lizenzschlüssel, der Lizenzstatus, die zwischengespeicherten Tarife und Abholstellen werden immer entfernt. Ist Remove data on uninstall eingeschaltet, wird der Versanddienstleister gelöscht (Bestellungen behalten ihren Verlauf), und die Einstellungen, das Protokoll sowie die Abholstellen von Warenkörben ohne Bestellung werden entfernt. Ist die Option aus, wird der Versanddienstleister nur deaktiviert und alle Einstellungen bleiben erhalten. Wenn Sie das Modul erneut installieren (oder zurücksetzen), erhält der gespeicherte Versanddienstleister den Status von vor der Deinstallation zurück: Eingeschaltet bleibt eingeschaltet, ausgeschaltet bleibt ausgeschaltet. In Bestellungen gespeicherte Abholstellendaten werden nie gelöscht.

Balikobot ist eine Marke ihres jeweiligen Inhabers. Dieses Modul ist nicht mit Balikobot verbunden und wird von Balikobot nicht unterstützt.