VibeFox Blue Express 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.

Blue-Express-Konto (nur für Live-Tarife): Live-Tarife benötigen ein Blue-Express-E-Commerce-Konto und dessen API-Schlüssel (x-api-key). Fordern Sie ihn bei Blue Express an: developers.bluex.cl oder gpo.integraciones@bx.cl. Der verwendete Service (EX, PY oder MD) muss in Ihrem Blue-Express-Vertrag freigeschaltet sein. Wenn Sie nur Festpreise verwenden, benötigen Sie keinen API-Schlüssel.

Abholpunkte: Die Karte von Blue Express wird im Browser des Kunden von widget-pudo.blue.cl geladen.

VibeFox-Lizenzschlüssel: wird auf vibefox.net gekauft. 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. Sie können auch den Ordner vfd_blue_express per FTP nach /wp-content/plugins/ hochladen.

2. Klicken Sie auf Activate.

3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Shipping > VibeFox Blue Express oder klicken Sie auf der Seite Plugins unter dem Namen des Plugins auf Settings.

4. Geben Sie Ihren VibeFox-Lizenzschlüssel im Lizenzblock oben auf der Seite ein und klicken Sie auf Activate.

5. Geben Sie den API-Schlüssel, den Service, den Herkunfts-Distriktcode (zum Beispiel SCL), den CLP-Wechselkurs, falls die Währung Ihres Shops nicht CLP ist, und die Festpreise (zum Beispiel CL=4500) ein. Siehe Konfiguration.

6. Gehen Sie zu WooCommerce > Settings > Shipping > Shipping zones und fügen Sie VibeFox Blue Express Ihrer Zone für Chile hinzu. Wählen Sie in den Methodeneinstellungen den Titel und die Lieferart (Lieferung nach Hause oder Abholung an einem Blue-Express-Punkt). Fügen Sie die Methode zweimal hinzu, um beides anzubieten.

Konfiguration

Die wichtigsten Einstellungen finden Sie unter WooCommerce > Settings > Shipping > VibeFox Blue Express. Sie gelten für alle Versandzonen. Warnungen zu Einstellungen, die die Methode oder den Live-Tarif ausblenden würden (kein API-Schlüssel, kein CLP-Wechselkurs, leere Festpreistabelle), werden oben auf der Seite angezeigt. Beim Speichern der Einstellungen wird der Cache geleert.

Zonenfenster (wenn Sie die Methode einer Versandzone hinzufügen)

Title: der Name der Versandmethode, den der Kunde für diese Zone sieht. Lassen Sie das Feld leer, um den globalen Name zu verwenden.

Delivery type: As in the global settings (Standard), Home delivery oder Pickup at a Blue Express point (PUDO). Fügen Sie die Methode zweimal zu einer Zone hinzu, um Lieferung nach Hause und Abholung anzubieten.

Allgemein

Enable/Disable: schaltet die Methode in allen Versandzonen überall ein oder aus.

Name: der Name der Versandmethode, der an der Kasse angezeigt wird. Eine Zone kann einen eigenen Titel festlegen. Standard: Blue Express.

Tax status: Blue-Express-Preise enthalten IVA. Wählen Sie None, wenn WooCommerce keine Steuer aufschlagen soll, oder Taxable, wenn es das tun soll.

Blue-Express-API (für Live-Tarife erforderlich)

API key: Ihr Blue-Express-API-Schlüssel (Header x-api-key). Ohne ihn werden nur die Festpreise verwendet.

Service: der Blue-Express-Service für den Tarif: Express (EX) (Standard), Prioritario (PY) oder SameDay (MD). Er muss in Ihrem Blue-Express-Vertrag freigeschaltet sein.

Origin district code: der Blue-Express-Distriktcode des Orts, von dem Sie versenden, zum Beispiel SCL für Santiago (Standard). Fragen Sie im Zweifel bei Blue Express nach.

CLP per 1 (your currency): Blue-Express-Preise sind in chilenischen Pesos (CLP) angegeben. Wenn Ihr Shop eine andere Währung verwendet, geben Sie ein, wie viele CLP eine Einheit davon wert ist, zum Beispiel 1050. Ohne diesen Wert werden keine Live-Tarife verwendet. Wird ignoriert, wenn die Währung Ihres Shops CLP ist.

Preis

Rate source: wie der Preis berechnet wird.

Fixed prices: eine Zeile pro Land im Format COUNTRY_CODE=PRICE, in der Währung Ihres Shops, zum Beispiel CL=4500 in einem Shop in CLP oder CL=4.50 in einem Shop in EUR. Als Dezimaltrennzeichen werden Komma oder Punkt akzeptiert. Ungültige Zeilen werden beim Speichern gemeldet. Festpreise können für jedes Land verwendet werden.

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 den Festpreis. Der API-Tarif gilt immer für die gesamte Sendung.

Bedingungen

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

Max weight (kg): blendet die Methode aus, wenn der Warenkorb mehr wiegt. Standard: 100. 0 bedeutet keine Grenze.

Minimum order subtotal: zeigt die Methode nur ab dieser Zwischensumme des Warenkorbs (Währung des Shops) an. Leer lassen, um sie immer anzuzeigen.

Excluded shipping classes: Enthält der Warenkorb einen Artikel aus einer ausgewählten WooCommerce-Versandklasse, wird die Methode ausgeblendet.

Kostenloser Versand

Free shipping: aktiviert kostenlosen Versand ab einer Warenkorb-Zwischensumme.

Free from subtotal: die Warenkorb-Zwischensumme (Währung des Shops), ab der der Versand kostenlos ist.

Abholung an Blue-Express-Punkten (PUDO)

Pickup point by default: ist sie aktiv, liefern Blue-Express-Methoden an einen vom Kunden gewählten Blue-Express-Punkt. Dies ist der Standard für Zonenmethoden mit Delivery type = As in the global settings. Der Kunde muss einen Punkt wählen, um die Bestellung aufzugeben.

Verfügbarkeit ohne Versandzonen

Ignore shipping zones: bietet die Methode auch dann an, wenn sie der passenden Versandzone nicht hinzugefügt wurde. Sie verwendet dann die globalen Einstellungen (kein Zonentitel und keine Lieferart).

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

Erweitert

Debug log: protokolliert Anfragen und Entscheidungen unter WooCommerce > Status > Logs, Quelle „vfd-blue-express“. API-Fehler werden immer protokolliert. Der API-Schlüssel und Kundenadressen werden nie protokolliert.

Remove data on uninstall: ist sie aktiv, werden beim Löschen des Plugins seine Einstellungen und Zonenmethoden entfernt. Deaktivieren löscht nie Einstellungen. In Bestellungen gespeicherte Abholpunkte bleiben erhalten.

So funktioniert es an der Kasse

Sobald der Kunde eine Lieferadresse eingibt, prüft das Plugin das Warenkorbgewicht, die Minimum order subtotal und die Excluded shipping classes. Gilt kostenloser Versand, beträgt der Tarif 0, und es wird keine Anfrage an Blue Express gesendet.

Für einen Live-Tarif muss die Adresse in Chile liegen, mit Region und Stadt (Gemeinde). Das Plugin bittet Blue Express zuerst, die Gemeinde zu erkennen, und fragt dann den Preis für den Service, den Herkunftsdistrikt, das Ziel und die Pakete ab. Jedes Produkt wird mit Gewicht und Maßen in kg und cm übermittelt. Produkte ohne Gewicht oder Größe werden mit 0,01 kg, 10 x 10 x 10 cm übermittelt. Der deklarierte Wert wird in CLP übermittelt. Der CLP-Preis wird in die Währung Ihres Shops umgerechnet.

Tarife werden 1 Stunde und Gemeindedaten 12 Stunden zwischengespeichert. Ein fehlgeschlagener API-Aufruf wird 5 Minuten gemerkt, die Zeitüberschreitung beträgt 10 Sekunden. So verlangsamt eine langsame oder nicht erreichbare API nicht jede Aktualisierung der Kasse. API-Fehler werden dem Kunden nie angezeigt: Die Methode wird ausgeblendet, oder im Ersatzmodus wird der Festpreis verwendet. Der Grund wird im Protokoll festgehalten.

Die Methode funktioniert in der klassischen Kasse sowie in den Blöcken Warenkorb und Kasse. Sie ist mit der WooCommerce-Speicherung von Bestellungen mit hoher Leistung (HPOS) kompatibel.

Das Plugin erstellt keine Sendungen oder Etiketten bei Blue Express, vergibt keine Sendungsnummern und zeigt keine Sendungsverfolgung an. Erstellen Sie die Sendung in Ihrem Blue-Express-Konto. Es gibt keine regionalen Tariftabellen je Gemeinde: Verwenden Sie den Blue-Express-API-Tarif oder einen Festpreis je Land. Live-Tarife funktionieren nur für Chile.

Abholpunkte

Mit der Lieferart Pickup at a Blue Express point (PUDO) sieht der Kunde Choose pickup point unter der Blue-Express-Option, sowohl in der klassischen Kasse als auch in der Blockkasse. Die Schaltfläche öffnet die offizielle Karte von Blue Express, auf der der Kunde einen Punkt wählt. Der gewählte Punkt wird mit Name und Adresse angezeigt, und die Schaltfläche wechselt zu Change pickup point. Anschließend wird der Tarif mit dem Abholpreis (PUDO) von Blue Express neu berechnet.

Ohne Punkt kann die Bestellung nicht abgeschlossen werden: Der Kunde sieht Please choose a Blue Express pickup point. Dies wird auf dem Server geprüft.

Der gewählte Punkt wird mit seinem Blue-Express-Agenturcode, Namen und seiner Adresse in der Bestellung gespeichert. Im Bestellbildschirm des Admins wird er unter der Lieferadresse als Blue Express pickup point angezeigt. Klicken Sie auf Edit, um auf der Karte von Blue Express einen anderen Punkt zu wählen oder Agenturcode, Name und Adresse von Hand einzugeben, und dann auf Save pickup point. Die Änderung wird in einer Bestellnotiz festgehalten. Der Kunde sieht den Punkt auf der Bestellseite und in den Bestell-E-Mails (HTML und Nur-Text). E-Mails an den Shop zeigen ebenfalls den Agenturcode. Vorhandene Bestellungen behalten ihre Abholpunktdaten.

Lizenzschlüssel

Das Plugin arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock befindet sich oben unter WooCommerce > Settings > Shipping > VibeFox Blue Express. 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 für eine Domain. Das Entfernen des Schlüssels von einer Website gibt deren Domainplatz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.

Ohne aktiven Schlüssel wird Blue Express 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. Ein Hinweis erscheint auf der Seite Plugins und auf WooCommerce-Seiten. Vorhandene Bestellungen sind nicht betroffen.

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

Fehlerbehebung

Blue Express erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist und die Methode der Zone der Kundenadresse hinzugefügt wurde (oder Ignore shipping zones eingeschaltet ist und das Land erlaubt ist). Lesen Sie die Warnungen oben auf der Einstellungsseite. Prüfen Sie die Gewichtsgrenzen, die Minimum order subtotal und die Excluded shipping classes sowie, ob Fixed prices eine Zeile für das Land hat, wenn Sie Festpreise oder die Ersatzlösung verwenden.

Live-Tarife erscheinen nicht: Bei Blue Express API only wird die Methode ausgeblendet, wenn kein Tarif vorliegt. Schalten Sie Debug log ein, laden Sie die Kasse neu und öffnen Sie WooCommerce > Status > Logs (Quelle „vfd-blue-express“). Typische Gründe: kein API-Schlüssel, Währung des Shops nicht CLP ohne Wechselkurs, fehlende Region oder Gemeinde in der Adresse, eine von Blue Express nicht erkannte Gemeinde oder ein API-Fehler (zum Beispiel HTTP 401 oder 403, wenn der API-Schlüssel abgelehnt wird). Bei Blue Express API, fixed price if the API gives no rate erhalten Kunden weiterhin den Festpreis, während Sie das Problem beheben.

Steuer wird auf den Blue-Express-Preis aufgeschlagen: Blue-Express-Preise enthalten IVA. Stellen Sie Tax status auf None, wenn WooCommerce keine Steuer aufschlagen soll.

Die Karte öffnet sich nicht: Die Karte wird im Browser des Kunden von widget-pudo.blue.cl geladen. Diese Adresse muss daher erreichbar und auf Ihrer Website nicht blockiert sein.

Tarife wirken nach einer Änderung veraltet: Speichern Sie die Einstellungsseite. Dadurch werden die zwischengespeicherten Tarife und Gemeindedaten geleert.

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 behält alle Einstellungen und leert nur den Cache. Zum Entfernen deaktivieren und löschen Sie es auf der Seite Plugins. Lizenzschlüssel und Lizenzstatus dieses Plugins sowie der Cache werden immer entfernt. Einstellungen und Zonenmethoden werden nur entfernt, wenn Remove data on uninstall aktiv war. Andernfalls bleiben sie für eine spätere Neuinstallation erhalten. In Bestellungen gespeicherte Abholpunkte werden nie entfernt.

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