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

Budbee-API-Zugangsdaten (nur für die Auswahl der Paketbox): ein API-Schlüssel und ein API-Secret. Instabee stellt sie Händlern mit einer Liefervereinbarung aus. Fragen Sie Ihren Instabee-Ansprechpartner oder nutzen Sie das Händlerportal von Instabee. Die API-Dokumentation finden Sie auf developer.budbee.com. Ohne Zugangsdaten funktioniert die Versandart weiterhin mit festen Preisen, Kunden können dann aber keine Paketbox wählen.

VibeFox-Lizenzschlüssel: wird auf vibefox.net gekauft. 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_instabee per FTP nach /wp-content/plugins/ hochladen.

2. Klicken Sie auf Activate.

3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Shipping > VibeFox Instabee, 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 den Abschnitt Preise aus und tragen Sie für die Paketbox-Auswahl Ihren Budbee-API key und Ihr API secret ein (siehe Konfiguration).

6. Fügen Sie VibeFox Instabee den Versandzonen Ihrer Lieferländer hinzu (zum Beispiel Schweden) 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 Instabee. Sie gelten für jede Versandzone. Wenn Sie die Versandart einer Zone hinzufügen, hat das Zonenfenster nur ein Feld:

Title: der Name dieses Tarifs an der Kasse in dieser Zone. Lassen Sie das Feld leer, um den globalen Method name zu verwenden.

Warnungen über den Einstellungen zeigen an, wenn nur einer der beiden API-Zugangsdaten eingetragen ist, wenn keine API-Zugangsdaten vorhanden sind, wenn weder Länderpreise noch ein Ausweichpreis hinterlegt sind und wenn die letzte Budbee-API-Anfrage fehlgeschlagen ist (mit Datum, Uhrzeit und Grund). Bei jedem Speichern der Einstellungen werden die zwischengespeicherten Paketbox-Listen und der letzte API-Fehler gelöscht.

Allgemein

Enable/Disable: schaltet die Versandart überall ein oder aus, auch in den Versandzonen. Standard: an.

Method name: der Name der Versandart, der im Warenkorb und an der Kasse angezeigt wird. Eine Zone kann ihn mit einem eigenen Title überschreiben. Standard: Instabee parcel box.

Tax status: Taxable fügt den Versandkosten die WooCommerce-Steuer hinzu, None nicht.

Paketbox-Auswahl (Budbee-API)

Mit API-Zugangsdaten wählt der Kunde an der Kasse eine Paketbox in der Nähe seiner Postleitzahl, und die Box wird in der Bestellung gespeichert. Beide Felder sind nötig. Die Auswahl bleibt ausgeschaltet, bis beide ausgefüllt sind.

API key: Ihr Budbee-API-Schlüssel (der HTTP-Basic-Benutzername).

API secret: Ihr Budbee-API-Secret (das HTTP-Basic-Passwort).

Test environment: nutzt die Budbee-Staging-API (api.staging.budbee.com). Aktivieren Sie sie nur mit Staging-Zugangsdaten von Instabee. Live-Shops lassen sie aus (api.budbee.com). Standard: aus.

Preise (der Abschnittstitel zeigt Ihre Shopwährung)

Alle Preise sind in der Shopwährung. Dezimalkomma und Dezimalpunkt werden beide akzeptiert (49,90 = 49.90). Ein Wert, der keine Zahl ist, wird nicht gespeichert, und eine Fehlermeldung nennt das Feld.

Calculation type: wie der Preis angewendet wird.

Country prices: eine Tabelle mit den Spalten Country, Price, XS (bis 1 kg), S (bis 2 kg), M (bis 3 kg), L (bis 5 kg) und XL (über 5 kg). Klicken Sie auf + Add country, um eine Zeile hinzuzufügen, und auf das Kreuz, um eine zu entfernen. Wählen Sie * Any other country für eine Zeile, die für alle Länder ohne eigene Zeile gilt. Eine leere oder 0-Stufe verwendet die Spalte Price. Ein Price von 0 bedeutet kostenlose Lieferung. Hat die Zeile des Landes für das Warenkorbgewicht keinen Preis, wird die Zeile * verwendet, danach der Fallback cost. Gewichte werden von Ihrer Shop-Gewichtseinheit in kg umgerechnet.

Fallback cost: wird verwendet, wenn weder die Zeile des Ziellandes noch die Zeile * einen Preis liefert. Lassen Sie das Feld leer, um die Versandart für solche Länder auszublenden.

Bedingungen

Min weight (kg): blendet die Versandart aus, wenn der Warenkorb weniger wiegt. Standard: 0 (keine Grenze).

Max weight (kg): blendet die Versandart aus, wenn der Warenkorb mehr wiegt. Paketboxen nehmen bis etwa 20 kg auf. Standard: 20. 0 bedeutet keine Grenze.

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

Free shipping from: die Zwischensumme des Warenkorbs (nach Rabatten, vor Steuern), ab der die Versandart kostenlos ist. Leer lassen, um sie nie kostenlos zu machen.

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

Verfügbarkeit ohne Versandzonen

Normalerweise fügen Sie VibeFox Instabee einer Versandzone hinzu. Alternativ können Sie es hier für eine Länderliste aktivieren.

Ignore shipping zones: bietet die Versandart in den unten genannten Ländern an, auch dort, wo keine Versandzone sie enthält.

Countries: die Zielländer für diesen Modus. Leer lassen, um alle Länder zu nutzen, in die Sie liefern. Dieses Feld wird nur verwendet, wenn Ignore shipping zones aktiviert ist.

Erweitert

Debug log: schreibt Debug-Meldungen in WooCommerce > Status > Logs (Quelle vfd-instabee). API-Fehler werden immer protokolliert, auch wenn dies ausgeschaltet ist. API-Schlüssel und Kundendaten werden nie protokolliert.

Remove data on uninstall: wenn aktiviert, entfernt das Löschen des Plugins die Einstellungen und die Zonentarife dieser Versandart. Das Deaktivieren des Plugins löscht nie Einstellungen. In Bestellungen gespeicherte Paketboxen bleiben erhalten.

So funktioniert es an der Kasse

Sobald der Kunde eine Lieferadresse eingibt, fragt WooCommerce das Plugin nach einem Tarif. Das Plugin prüft die Bedingungen: Warenkorbgewicht, Mindestbestellwert und ausgeschlossene Versandklassen. Erreicht die Zwischensumme des Warenkorbs Free shipping from, ist der Tarif kostenlos. Andernfalls wird der Preis aus der Zeile Country prices des Ziellandes, der Zeile * oder dem Fallback cost übernommen. Gibt es keinen Preis, wird die Versandart ausgeblendet.

Wählt der Kunde den Instabee-Tarif und sind die API-Zugangsdaten hinterlegt, erscheint unter dem Tarif für Schweden, Finnland, Dänemark, die Niederlande und Belgien eine Auswahl Parcel box. Sie listet die Boxen in der Nähe der Postleitzahl der Lieferadresse auf, sortiert nach Entfernung, mit Name, Adresse und Entfernung. Der Kunde kann eine andere Postleitzahl eingeben und auf Search klicken. Solange keine Postleitzahl eingegeben ist, fordert die Auswahl eine an. Werden keine Boxen gefunden, wird der Kunde gebeten, eine andere Postleitzahl zu versuchen oder eine andere Versandart zu wählen.

Eine Paketbox ist Pflicht. Bei der Bestellung prüft das Plugin serverseitig, ob die gewählte Box für diese Postleitzahl in der Budbee-Liste steht. Andernfalls sieht der Kunde Please choose an Instabee parcel box. Der Name der Box stammt aus der Budbee-Liste, nicht aus dem Browser.

Das Plugin sendet an Budbee nur das Zielland und die Postleitzahl, niemals Namen, Adressen, E-Mails oder Bestelldaten. Boxlisten werden 12 Stunden je Postleitzahl zwischengespeichert, eine Postleitzahl ohne Boxen 1 Stunde und eine fehlgeschlagene Anfrage 5 Minuten, damit eine langsame oder defekte API nicht jede Aktualisierung der Kasse verlangsamt. Das API-Timeout beträgt 10 Sekunden.

Ist die Budbee-API nicht erreichbar, wird dem Kunden mitgeteilt, dass die Bestellung ohne Auswahl einer Box abgeschlossen werden kann. Die Bestellung wird dann markiert, und Sie wählen die Box, wenn Sie die Sendung buchen. Eine zuvor gewählte Box, die in diesem Moment nicht geprüft werden kann, bleibt erhalten und wird als nicht verifiziert markiert.

Die Auswahl funktioniert in der klassischen Kasse sowie in den Warenkorb- und Kassen-Blöcken. Das Plugin ist mit WooCommerce High-Performance Order Storage (HPOS) kompatibel.

Das Plugin berechnet keine Live-Tarife, bucht keine Sendungen, druckt keine Etiketten, vergibt keine Sendungsnummern oder Tracking-E-Mails, bietet keine Lieferzeitfenster für Budbee Home und zeigt keine Karte. Buchen Sie das Paket für die gewählte Box in Ihren Händlerwerkzeugen von Instabee / Budbee.

Abholpunkte

Die gewählte Paketbox wird in der Bestellung gespeichert und an diesen Stellen angezeigt:

Admin-Bestellseite: unter der Lieferadresse, als Instabee parcel box mit Name der Box, Adresse und Box ID. Konnte die Box an der Kasse nicht geprüft werden, wird sie als not verified (Budbee API was unavailable at checkout) markiert. Wurde keine Box gewählt, weil die API nicht verfügbar war, zeigt die Seite das an und erinnert Sie daran, die Box beim Buchen der Sendung zu wählen.

Dankeseite und Bestellseite unter Mein Konto: Name und Adresse der Box.

Bestell-E-Mails: HTML und reiner Text. E-Mails an den Shop zeigen zusätzlich die Box-ID. Wurde keine Box gewählt, weil die API nicht verfügbar war, erwähnen nur E-Mails an den Shop dies.

Lizenzschlüssel

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

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

Fehlerbehebung

Instabee 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). Prüfen Sie, ob das Land einen Preis hat oder eine Zeile * bzw. einen Fallback cost gibt. Prüfen Sie die Gewichtsgrenzen, Minimum order amount und Excluded shipping classes. Eine Warnung über den Einstellungen zeigt an, wenn kein Preis konfiguriert ist.

Kunden sehen die Liste der Paketboxen nicht: die Liste erscheint nur, wenn API key und API secret gesetzt sind, für Schweden, Finnland, Dänemark, die Niederlande und Belgien, und sobald eine Postleitzahl eingegeben ist. Der letzte API-Fehler wird über den Einstellungen angezeigt. Details stehen in WooCommerce > Status > Logs (Quelle vfd-instabee). Aktivieren Sie Debug log für mehr Details.

HTTP 401 oder 403 im Protokoll: Budbee hat den API-Schlüssel oder das Secret abgelehnt. Prüfen Sie beides und ob Test environment zu Ihren Zugangsdaten passt (Staging-Zugangsdaten nur mit eingeschalteter Testumgebung).

Keine Boxen für eine Postleitzahl: Budbee bedient diese Postleitzahl nicht. Der Kunde kann eine andere Postleitzahl suchen oder eine andere Versandart wählen.

Alte Boxlisten nach einer Änderung: speichern Sie die Einstellungsseite. Dadurch werden die zwischengespeicherten Boxlisten gelöscht.

Andere Länder für die Boxsuche: Entwickler können die Länderliste mit dem Filter vfd_ibee_box_countries ändern.

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. 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 zuletzt bekannten Status weiter.

Deinstallation

Das Deaktivieren des Plugins löscht nur die zwischengespeicherten Boxlisten. Zum Entfernen deaktivieren und löschen Sie es auf der Seite Plugins. Der Lizenzschlüssel und Lizenzstatus dieses Plugins, die zwischengespeicherten Boxlisten und der letzte API-Fehler werden immer entfernt. Einstellungen, Zonen-Versandarten und Versionsdaten werden nur entfernt, wenn Remove data on uninstall aktiviert war. Andernfalls bleiben sie für eine spätere Neuinstallation erhalten. In Bestellungen gespeicherte Paketboxen bleiben immer erhalten, und bestehende Bestellungen behalten ihre Versandpositionen.

Instabee und Budbee sind Marken ihrer jeweiligen Inhaber. Dieses Plugin ist nicht mit Instabee oder Budbee verbunden und wird von ihnen nicht unterstützt.