VibeFox Balikobot for WooCommerce — Hilfe

Anforderungen

WordPress: 5.8 oder neuer.

WooCommerce: 7.0 oder neuer, installiert und aktiv. Das Plugin lässt sich ohne WooCommerce nicht aktivieren.

PHP: 8.0 oder neuer.

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 (client.balikobot.cz). Der Balikobot-Support (podpora@balikobot.cz) aktiviert die API für Ihr Konto und Ihre Versanddienstleister. Live-Tarife setzen einen Dienstleister und einen Service voraus, für die Balikobot "transportcosts" unterstützt. Abholstellen setzen einen Dienstleister mit "branchlocator"-Unterstützung voraus (zum Beispiel Česká pošta, Zásilkovna, PPL, DPD, GLS). Fragen Sie im Zweifel den Balikobot-Support. Feste Preise funktionieren ohne 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 den Ordner vfd_balikobot auch per FTP nach /wp-content/plugins/ hochladen.

2. Klicken Sie auf Activate.

3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Shipping > VibeFox Balikobot, 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. Geben Sie API-Benutzer und API-Schlüssel ein, wählen Sie Dienstleister, Servicetyp, Preisquelle und Länderpreise (siehe Konfiguration). Bei Abholservices aktivieren Sie Pickup point selection.

6. Fügen Sie VibeFox Balikobot einer Versandzone hinzu (zum Beispiel Tschechien) unter WooCommerce > Settings > Shipping > Shipping zones, 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 Balikobot. Sie gelten für alle Versandzonen. Warnungen zu Einstellungen, die die Versandart, die Live-Tarife oder die Abholstellen ausblenden würden, werden oben auf der Seite angezeigt. Bei jedem Speichern der Einstellungen werden die zwischengespeicherten Tarife und Abholstellen gelöscht. Wenn Sie die Versandart einer Zone hinzufügen, hat das Zonenfenster nur ein Feld:

Title (zone): der Name der Versandart, den Kunden in dieser Zone sehen. Lassen Sie das Feld leer, um den globalen Name zu verwenden.

Allgemein

Enable/Disable: schaltet den Balikobot-Versand in allen Zonen gleichzeitig ein oder aus.

Name: der Name der Versandart, den Kunden sehen. Eine Zone kann ihn mit einem eigenen Title überschreiben. Standard: Balikobot.

Tax status: Taxable bedeutet, dass WooCommerce die Versandsteuer auf den Preis aufschlägt, None bedeutet, dass dies nicht geschieht. Balikobot-Preise verstehen sich in der Regel ohne Mehrwertsteuer.

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.

Carrier: der Balikobot-Dienstleister 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 Dienstleisters. Standard: NP. Für Česká pošta: NP = Paket an eine Postfiliale, NB = Paket an Balíkovna, DR = Hauslieferung. Die Codes anderer Dienstleister finden Sie im Balikobot-Kundenbereich und in der API-Dokumentation.

Preis (alle Preise in der Währung Ihres Shops)

Price source: so wird der Preis berechnet.

Country prices: ein fester Preis je Zielland (2-stelliger Ländercode, zum Beispiel CZ, SK). Verwenden Sie * für alle übrigen Länder. Dezimalzahlen mit Punkt oder Komma. Wird im festen Modus und als Ersatz bei API-Fehlern verwendet. Ein Land ohne Preis (und ohne *-Zeile) erhält keinen festen Tarif.

Fixed price per: Order berechnet den Preis einmal. Item (price × 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 Wä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 einem Kunden nie ein falscher Preis berechnet wird.

Bedingungen

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

Max weight (kg): blendet die Versandart aus, wenn der Warenkorb schwerer ist. Standard: 100. 0 bedeutet keine Grenze.

Minimum order amount: zeigt die Versandart nur ab dieser Warenkorb-Zwischensumme (nach Rabatten, ohne Steuer) an. Leer lassen, um sie immer anzuzeigen.

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

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

Free shipping from: die Warenkorb-Zwischensumme (nach Rabatten, ohne Steuer), ab der der Versand kostenlos ist. In diesem Fall wird keine API-Anfrage gesendet.

Verfügbarkeit ohne Versandzonen

Ignore shipping zones: bietet die Versandart in den unten genannten Ländern an, auch wenn sie der passenden Zone nicht zugeordnet ist.

Countries: die Zielländer für diesen Modus. Leer lassen, um alle Länder zu verwenden, in die Sie liefern. 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 unter WooCommerce > Status > Logs, Quelle "vfd-balikobot". API-Fehler werden immer protokolliert. Zugangsdaten und Kundenadressen werden nie protokolliert.

Remove data on uninstall: ist die Option aktiv, entfernt das Löschen des Plugins dessen Einstellungen und Zonen-Versandarten. Das Deaktivieren des Plugins löscht nie Daten. In Bestellungen gespeicherte Abholstellen bleiben erhalten.

So funktioniert es an der Kasse

Sobald der Kunde eine Lieferadresse eingibt, prüft das Plugin das Warenkorbgewicht, den Minimum order amount und die Excluded shipping classes. Gilt kostenloser Versand, beträgt der Tarif 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 Plugin an Balikobot den Dienstleister, den Servicetyp, das Zielland und die Postleitzahl sowie das Warenkorbgewicht in kg. Ein Live-Tarif wird erst angefragt, nachdem der Kunde eine Postleitzahl eingegeben hat. Ein Preis in einer anderen Währung wird mit Exchange rate umgerechnet oder abgelehnt, wenn kein Kurs festgelegt ist.

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: Die Versandart wird ausgeblendet, oder im Ersatzmodus wird der feste Preis verwendet. Die Details gehen ins Protokoll.

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

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

Abholstellen

Ist Pickup point selection aktiviert, erscheint an der Kasse unter der Balikobot-Option eine Liste von Abholstellen, sowohl an der klassischen Kasse als auch im Kassen-Block. Die Liste wird über den Balikobot-"branchlocator" für Land, Ort und Postleitzahl des Kunden geladen. Solange Ort und Postleitzahl nicht eingegeben sind, sieht der Kunde Enter your city and postcode to see the pickup points. Die Liste wird 12 Stunden zwischengespeichert.

Die Auswahl ist Pflicht: Der Kunde sieht Please select a pickup point. Der Server prüft außerdem, ob die gewählte Abholstelle zur Lieferadresse gehört. Nach einer Adressänderung wird der Kunde gebeten, erneut eine Abholstelle 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. Im Bestellbildschirm des Admins wird sie unter der Lieferadresse als Balikobot pickup point angezeigt, mit der Filial-ID von Balikobot und dem Dienstleister, die Sie beim Erstellen der Sendung in Balikobot brauchen. Klicken Sie auf Change, um eine andere Abholstelle in der Nähe der Bestelladresse zu wählen. Der Kunde sieht die Abholstelle als Pickup point auf der Bestellseite und in den Bestell-E-Mails (HTML und Nur-Text). Bestehende Bestellungen behalten ihre Abholstellen-Daten.

Lizenzschlüssel

Das Plugin arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock befindet sich oben unter WooCommerce > Settings > Shipping > VibeFox Balikobot. 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. Wenn Sie den Schlüssel von einer Website entfernen, wird der Domain-Platz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.

Ohne aktiven Schlüssel wird Balikobot 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. Auf der Seite Plugins und auf WooCommerce-Seiten erscheint eine Erinnerung. 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

Balikobot erscheint nicht an der Kasse: prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist und die Versandart der Zone des Kundenlandes hinzugefügt wurde (oder Ignore shipping zones aktiv ist und das Land erlaubt ist). Lesen Sie die Warnungen oben auf der Einstellungsseite. Prüfen Sie die Gewichtsgrenzen, Minimum order amount und Excluded shipping classes. Prüfen Sie im festen Modus, ob das Land oder * einen Preis hat.

Live-Tarife erscheinen nicht: aktivieren Sie Debug log, laden Sie die Kasse neu und öffnen Sie WooCommerce > Status > Logs (Quelle "vfd-balikobot"). Dort steht der Grund: fehlende API-Zugangsdaten, noch keine Postleitzahl, der Balikobot-Fehler für Dienstleister und Service 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 in der falschen Währung: feste Preise sind in der Währung Ihres Shops. Balikobot gibt Live-Preise in der Währung Ihres Balikobot-Vertrags zurück (in der Regel CZK). Weicht sie von der Shop-Währung ab, legen Sie Exchange rate fest.

Ist die MwSt. enthalten? Balikobot-Preise verstehen sich in der Regel ohne Mehrwertsteuer. Mit Tax status auf Taxable fügt WooCommerce die Versandsteuer hinzu.

Keine Abholstellen in der Liste: prüfen Sie, ob API-Benutzer und -Schlüssel eingetragen sind, ob der Dienstleister "branchlocator" unterstützt und ob der Kunde Ort und Postleitzahl eingegeben hat. Prüfen Sie das Protokoll auf den Balikobot-Fehler.

Tarife oder Abholstellen wirken nach einer Änderung veraltet: speichern Sie die Einstellungsseite. Dadurch werden die zwischengespeicherten Tarife und Abholstellen gelöscht.

Der Lizenzblock zeigt einen Fehler: folgen Sie der Meldung im Block. Ist der Schlüssel etwa 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 Einstellungen und löscht nur die Caches. Zum Entfernen deaktivieren und löschen Sie es auf der Seite Plugins. Der Lizenzschlüssel und der Lizenzstatus dieses Plugins sowie die zwischengespeicherten Tarife und Abholstellen werden immer entfernt. Einstellungen und Zonen-Versandarten werden nur entfernt, wenn Remove data on uninstall aktiv war. Andernfalls bleiben sie für eine spätere Neuinstallation erhalten. In Bestellungen gespeicherte Abholstellen-Daten werden nie gelöscht.

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