VibeFox bpost Cubee 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.

bpost-Shipping-Platform-Konto (nur für die Abholstellen-Auswahl): Das Plugin sucht Abholstellen über die API der bpost Shipping Platform. Melden Sie sich in Ihrem bpost-Shipping-Platform-Konto unter plugins.bpost.be an und erstellen Sie die Schlüssel unter Settings > Key management. Sie benötigen drei Werte: Account ID (öffentlicher Schlüssel), Passphrase (privater Schlüssel) und eine App ID (X-APPID). Die App ID stellt bpost für Ihre Integration aus; fragen Sie den E-Commerce-Support von bpost (eol@bpost.be). Außerdem brauchen Sie die Carrier-ID Ihres Vertrags (68 = bpost). Ohne vollständige Schlüssel funktioniert die Versandart weiterhin als Versandart mit Festpreis, aber der Kunde wird nicht aufgefordert, eine Abholstelle zu wählen.

VibeFox-Lizenzschlüssel: erhältlich auf vibefox.net. Ein Schlüssel funktioniert für eine 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_bpost_cubee per FTP nach /wp-content/plugins/ hochladen.

2. Klicken Sie auf Activate.

3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Shipping > VibeFox bpost Cubee, 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 Ihre Preise ein und für die Abholstellen-Auswahl die bpost-API-Schlüssel (siehe Konfiguration).

6. Fügen Sie VibeFox bpost Cubee Ihrer Versandzone für Belgien unter WooCommerce > Settings > Shipping > Shipping zones hinzu, oder aktivieren Sie Ignore shipping zones und wählen Sie Länder aus.

Konfiguration

Alle Einstellungen befinden sich auf einer Seite: WooCommerce > Settings > Shipping > VibeFox bpost Cubee. Sie gelten für alle Versandzonen. Wenn Sie die Versandart einer Zone hinzufügen, hat das Zonenfenster nur ein Feld:

Title (zone): der Name dieser Option an der Kasse für diese Zone. Lassen Sie das Feld leer, um den globalen Name zu verwenden.

Die Einstellungsseite zeigt Warnungen, wenn etwas die Versandart oder die Auswahl stillschweigend ausblendet: Die Abholstellen-Auswahl ist aktiviert, aber die API-Schlüssel sind unvollständig, für Belgien gibt es keinen Preis oder die letzte Verbindung zur bpost-API ist fehlgeschlagen. Bei jedem Speichern der Einstellungen werden das gespeicherte API-Token und die zwischengespeicherten Abholstellenlisten gelöscht.

Allgemein

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

Name: der Name der Versandart, den der Kunde an der Kasse sieht. Standard: bpost parcel locker.

Tax status: Taxable fügt die WooCommerce-Steuer auf Ihre Preise auf, None bedeutet, dass die Preise endgültig sind.

bpost-API (Abholstellensuche) (nur für die Abholstellen-Auswahl erforderlich)

Account ID (public key): der öffentliche Schlüssel Ihres bpost-Shipping-Platform-Kontos, zu finden unter Key management auf plugins.bpost.be.

Passphrase (private key): der private Schlüssel, mit dem jede Anfrage signiert wird (HMAC-SHA256). Er wird nie an bpost gesendet und nicht im Protokoll gespeichert.

App ID (X-APPID): die Anwendungskennung, die bpost für Ihre Integration ausgestellt hat. Sie wird im Header X-APPID gesendet.

Carrier ID: der Carrier Ihres bpost-Shipping-Platform-Vertrags, dessen Abholstellen und Paketboxen aufgelistet werden. Standard: 68 (bpost). Andere Carrier, die in Ihrem Vertrag aktiviert sind, haben eigene IDs.

Abholstellen-Auswahl

Pickup points: zeigt die Auswahl für Abholstellen und Paketboxen an der Kasse. Standardmäßig aktiviert. Die Auswahl erscheint nur, wenn alle drei API-Schlüssel ausgefüllt sind.

Search field width: die CSS-Breite des Feldes für Postleitzahl / Ort, zum Beispiel 100% oder 300px. Standard: 100%.

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

Preise (in Ihrer Shop-Währung; bpost liefert über diese API keine Versandpreise)

Price by: legt fest, wie der Preis gewählt wird.

Country prices: eine Zeile pro Land im Format CC=PRICE, zum Beispiel BE=4.95. Die Zeile *=PRICE legt den Preis für alle anderen Länder fest, zum Beispiel *=9.95. Sowohl Punkt als auch Komma werden als Dezimaltrennzeichen akzeptiert. Ungültige Zeilen werden ignoriert und beim Speichern in einer Fehlermeldung aufgelistet. Länder ohne Preis (wenn keine *-Zeile vorhanden ist) erhalten die Versandart nicht.

Size prices: wird verwendet, wenn Price by auf Paketgröße steht, im Format S=3.50, M=4.50, L=6.00, XL=8.00. Die Größe richtet sich nach dem Warenkorbgewicht: S bis 2 kg, M bis 5 kg, L bis 10 kg, XL darüber.

Calculation: Per order berechnet den Preis einmal. Per item (price x number of items) multipliziert ihn mit der Anzahl der Artikel im Warenkorb.

Bedingungen

Min weight (kg): das minimale Warenkorbgewicht, damit die Versandart erscheint. 0 bedeutet keine Begrenzung.

Max weight (kg): die Versandart wird oberhalb dieses Warenkorbgewichts ausgeblendet. Standard: 30, weil bpost-Paketboxen Pakete bis 30 kg annehmen. 0 bedeutet keine Begrenzung.

Minimum order amount: zeigt die Versandart nur, wenn die Warenkorbsumme (ohne Steuer) diesen Betrag erreicht. Leer lassen, um sie immer anzuzeigen.

Excluded shipping classes: blendet die Versandart aus, wenn ein Artikel im Warenkorb zu einer dieser WooCommerce-Versandklassen gehört.

Produktgewichte werden von der Gewichtseinheit Ihres Shops in Kilogramm umgerechnet.

Kostenloser Versand

Free shipping: aktiviert kostenlose Lieferung ab dem unten genannten Betrag.

Free shipping from: die Warenkorbsumme (ohne Steuer), ab der der Versand kostenlos ist. Wird nur verwendet, wenn Free shipping aktiviert ist.

Verfügbarkeit ohne Versandzonen

Ignore shipping zones: bietet die Versandart in den unten genannten Ländern an, ohne sie einer Zone hinzuzufügen.

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

Erweitert

Debug log: protokolliert API-Anfragen und Preisberechnungen unter WooCommerce > Status > Logs, Quelle vfd-bpost-cubee. API-Fehler werden immer protokolliert, auch wenn diese Option ausgeschaltet ist. Schlüssel, Token und Kundendaten werden nie protokolliert.

Remove data on uninstall: Wenn aktiviert, entfernt das Löschen des Plugins seine Einstellungen und seine Zonen-Versandarten. Das Deaktivieren des Plugins löscht nie Daten. In Bestellungen gespeicherte Abholstellen bleiben immer erhalten.

So funktioniert es an der Kasse

Wenn der Kunde eine Lieferadresse eingibt, fragt WooCommerce das Plugin nach einem Tarif. Das Plugin prüft die Bedingungen: Lieferland, Warenkorbgewicht, Mindestbestellwert und ausgeschlossene Versandklassen. Dann nimmt es den Preis aus der Länderliste oder nach Paketgröße, multipliziert ihn im Modus Per item mit der Anzahl der Artikel und setzt ihn auf null, wenn kostenloser Versand gilt.

Wenn der Kunde den bpost-Tarif wählt, erscheinen darunter ein Suchfeld, eine Schaltfläche Search und eine Liste von Abholstellen. Ist das Suchfeld leer, wird automatisch die Postleitzahl der Kundenadresse an der Kasse gesucht. Der Kunde kann eine andere Postleitzahl oder einen Ortsnamen eingeben. Jede Stelle wird mit Namen und Adresse angezeigt. Es werden bis zu 50 Stellen aufgelistet. Die Liste der Abholstellen wird auf niederländischsprachigen Seiten auf Niederländisch und sonst auf Französisch abgerufen.

Der Kunde muss eine Abholstelle auswählen. Ohne Auswahl zeigt die klassische Kasse Please select a bpost pickup point. an, und die Block-Kasse verweigert die Bestellung mit derselben Meldung. Die Auswahl bleibt während der Kassensitzung erhalten, sodass ein Neuladen der Seite sie nicht verliert.

Um Abholstellen aufzulisten, sendet das Plugin an bpost nur die gesuchte Postleitzahl oder den Ort, das Land und die Carrier-ID, signiert mit Ihren Schlüsseln. Name, E-Mail-Adresse oder Adresszeile des Kunden werden nicht übertragen. Das API-Token wird automatisch angefordert und erneuert. Lehnt bpost ein Token ab, wird einmal ein neues angefordert und die Suche wiederholt. Suchergebnisse werden 6 Stunden lang zwischengespeichert. Antwortet bpost nicht, sieht der Kunde Pickup points cannot be loaded right now. Please try again in a few minutes or choose another shipping method., und das Plugin versucht es nach 5 Minuten erneut. Das API-Timeout beträgt 15 Sekunden.

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 verwendet nur Festpreise. Es ruft keine Live-Tarife bei bpost ab, erstellt keine Sendungen, druckt keine Etiketten und verfolgt keine Pakete. Abholstellen werden als Liste angezeigt, nicht auf einer Karte. Erstellen Sie die Sendungen in Ihrem bpost-Shipping-Platform- oder Shipping-Manager-Konto; die ID der Abholstelle steht in der Bestellung.

Abholstellen

Die gewählte Abholstelle (Name und Adresse) sowie ihre ID werden in der Bestellung gespeichert. Im Bestellbildschirm des Admins wird sie unter der Lieferadresse als bpost pickup point angezeigt. Klicken Sie auf Change, suchen Sie eine Postleitzahl oder einen Ort und wählen Sie aus der Liste eine andere Stelle. Die Bestellung wird sofort aktualisiert und eine Bestellnotiz bpost pickup point changed to: … wird hinzugefügt. Der Link Change ist nur verfügbar, wenn die API-Schlüssel ausgefüllt sind.

Kunden sehen die Abholstelle auf der Danke-Seite und unter My account > Orders. Sie wird außerdem in die Bestell-E-Mails aufgenommen, sowohl als HTML als auch als reiner Text.

Um Paketbox- und Hauslieferung gemeinsam anzubieten, fügen Sie derselben Zone eine weitere Versandart hinzu, zum Beispiel Flat rate. Die Abholstellen-Auswahl erscheint nur unter dem bpost-Tarif.

Lizenzschlüssel

Das Plugin funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock befindet sich oben unter WooCommerce > Settings > Shipping > VibeFox bpost Cubee. 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 Konto auf vibefox.net.

Ein Schlüssel funktioniert für eine Domain. Das Entfernen des Schlüssels von einer Website gibt deren Domain-Platz nicht frei. Geben Sie den Platz in Ihrem Konto auf vibefox.net frei.

Ohne aktiven Schlüssel wird die bpost-Versandart Kunden an der Kasse nicht angezeigt. Angemeldete Shopmanager sehen sie weiterhin, gekennzeichnet 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 ein Hinweis. Bestehende Bestellungen sind nicht betroffen.

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

Fehlerbehebung

bpost 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 eingeschaltet ist und das Land erlaubt ist). Prüfen Sie, ob das Land einen Preis hat oder eine Zeile *=PRICE vorhanden ist, und kontrollieren Sie die Gewichtsgrenzen, Minimum order amount und Excluded shipping classes. Die Einstellungsseite zeigt eine Warnung, wenn Belgien keinen Preis hat.

Keine Auswahl für Abholstellen an der Kasse: Prüfen Sie, ob Pickup points eingeschaltet ist und Account ID (public key), Passphrase (private key) und App ID (X-APPID) alle ausgefüllt sind. Die Einstellungsseite zeigt eine Warnung, wenn die Schlüssel unvollständig sind.

Kunden sehen „Pickup points cannot be loaded right now“: bpost hat nicht geantwortet oder die Schlüssel abgelehnt. Der Grund steht unter WooCommerce > Status > Logs (Quelle vfd-bpost-cubee) und auf der Einstellungsseite. Das Plugin versucht es nach 5 Minuten automatisch erneut. Das Speichern der Einstellungen startet sofort einen neuen Versuch.

Für diese Postleitzahl oder diesen Ort wurden keine Abholstellen gefunden: bpost hat für diese Suche keine Stellen zurückgegeben. Bitten Sie den Kunden, eine benachbarte Postleitzahl oder einen Ortsnamen zu versuchen, und prüfen Sie die Carrier ID.

Preise mit Komma werden nicht verwendet: Sowohl 5,50 als auch 5.50 werden akzeptiert. Zeilen in Country prices, die nicht dem Format CC=PRICE folgen, werden ignoriert; die Fehlermeldung nach dem Speichern listet sie auf.

Sind Preise inklusive Steuer? Mit Tax status auf Taxable fügt WooCommerce die Steuer auf Ihre Preise auf. Mit None sind die Preise endgültig.

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 Konto auf vibefox.net 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 behält alle Einstellungen; es löscht nur das API-Token und die zwischengespeicherten Abholstellenlisten. Zum Entfernen deaktivieren und löschen Sie es auf der Seite Plugins. Der Lizenzschlüssel und der Lizenzstatus dieses Plugins, das API-Token und die Caches werden immer entfernt. Einstellungen und Zonen-Versandarten werden nur entfernt, wenn Remove data on uninstall aktiviert war. Andernfalls bleiben sie für eine spätere Neuinstallation erhalten. In Bestellungen gespeicherte Abholstellen sind Teil der Bestellhistorie und werden nie gelöscht.

bpost ist eine Marke ihres jeweiligen Inhabers. Dieses Plugin ist nicht mit bpost verbunden und wird von bpost weder unterstützt noch empfohlen.