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

Chilexpress-API-Schlüssel (nur für Live-Tarife): Erstellen Sie ein Konto im Entwicklerportal von Chilexpress (developers.wschilexpress.com) und abonnieren Sie zwei Produkte: Rating (Cotizador) und Coverage (Coberturas / Georreferencia). Jedes Produkt hat einen eigenen Abonnementschlüssel. Testschlüssel funktionieren nur mit der Testumgebung; Produktionsschlüssel werden Geschäftskunden von Chilexpress mit einem Kundenvertrag ausgestellt. Außerdem brauchen Sie den Chilexpress-County-Code der Comuna, von der Sie versenden, zum Beispiel STGO. Wenn Sie nur Festpreise verwenden, benötigen Sie keine API-Schlüssel.

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 auch den Ordner vfd_chilexpress per FTP nach /wp-content/plugins/ hochladen.

2. Klicken Sie auf Activate.

3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Shipping > VibeFox Chilexpress, 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. Füllen Sie die Preistabelle aus. Für Live-Tarife geben Sie beide Abonnementschlüssel, Ihren Ursprungs-County-Code und, falls die Währung Ihres Shops nicht CLP ist, den CLP-Wechselkurs ein und wählen dann die Tarifquelle (siehe Konfiguration).

6. Fügen Sie VibeFox Chilexpress unter WooCommerce > Settings > Shipping > Shipping zones einer Versandzone für Chile 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 Chilexpress. Sie gelten für alle Versandzonen. Wenn Sie die Methode einer Zone hinzufügen, hat das Zonenfenster nur ein Feld:

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

Die Einstellungsseite zeigt Probleme oben an: API-Tarife sind ausgewählt, aber ein Schlüssel, der Ursprungs-County-Code oder der CLP-Wechselkurs fehlt, oder die Preistabelle hat keine Zeile für Chile oder für * Default. Jedes Mal, wenn Sie die Einstellungen speichern, werden die zwischengespeicherten Tarife und Comuna-Listen gelöscht. Zahlen können mit Punkt oder Komma eingegeben werden; eine ungültige Zahl wird nicht gespeichert, und es erscheint eine Fehlermeldung.

Allgemein

Enable/Disable: schaltet den Versand mit Chilexpress in allen Zonen gleichzeitig ein oder aus.

Name: der Name der Versandmethode, den der Kunde an der Kasse sieht. Default: Chilexpress.

Tax status: Taxable fügt den WooCommerce-Steuern auf die Versandkosten hinzu (sofern Steuern aktiviert sind), None fügt keine hinzu. Chilexpress-API-Tarife werden genau so verwendet, wie sie angeboten werden. Wählen Sie None, wenn das Angebot bereits die IVA enthält und Ihr Shop sonst zusätzlich Steuern berechnen würde.

Tarife

Rate source: woher der Preis stammt.

Live-Tarife sind nur für Ziele in Chile verfügbar. Andere Länder verwenden immer die Festpreise.

Country prices: eine Tabelle der Zielländer mit einer Spalte Price und optionalen Preisen nach Paketgröße in Ihrer Shopwährung. Die Größe ergibt sich aus dem Warenkorbgewicht: XS bis 1 kg, S bis 2 kg, M bis 3 kg, L bis 5 kg, XL über 5 kg. Eine Größe, die auf 0 bleibt, verwendet Price. Klicken Sie auf + Add country, um eine Zeile hinzuzufügen, und auf das Kreuz, um sie zu entfernen. Die Zeile * Default gilt für Länder ohne eigene Zeile. Ein Land ohne Zeile (und ohne *) erhält keinen Festpreis. Eine Zeile, bei der Preis und Größenpreis beide 0 sind, ergibt kostenlosen Versand.

Calculation type: Per order berechnet den Festpreis einmal. Per item (fixed price x number of items) multipliziert ihn mit der Anzahl der Artikel im Warenkorb. Ein Chilexpress-API-Tarif gilt immer für das gesamte Paket.

Chilexpress API (Live-Tarife)

Test environment: nutzt die Testumgebung von Chilexpress (qaservices.wschilexpress.com). Verwenden Sie sie mit Testschlüsseln und schalten Sie sie in einem Live-Shop aus.

Rating API key: der Abonnementschlüssel des Produkts Rating (Cotizador).

Coverage API key: der Abonnementschlüssel des Produkts Coverage (Coberturas / Georreferencia). Er dient dazu, den Chilexpress-County-Code der Comuna des Kunden zu finden (das Feld Stadt an der Kasse).

Origin county code: der Chilexpress-County-Code (Comuna), von der Sie versenden, 2–5 Buchstaben, zum Beispiel STGO (Santiago Centro), PROV (Providencia), LCON (Las Condes), VALP (Valparaíso) oder CONC (Concepción). Ein Wert, der kein County-Code ist, wird mit einem Fehler abgelehnt.

Service: der Chilexpress-Service, der für den Tarif verwendet wird. Wird er für das Ziel nicht angeboten, wird der günstigste angebotene Service verwendet.

CLP exchange rate: Chilexpress rechnet in chilenischen Pesos. Nur nötig, wenn die Währung Ihres Shops nicht CLP ist: der Preis von 1 CLP in Ihrer Shopwährung, zum Beispiel 0.001. Ohne ihn werden API-Tarife nicht verwendet.

Verfügbarkeit

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

Max weight (kg): die Methode wird oberhalb dieses Warenkorbgewichts ausgeblendet. Default: 25. 0 bedeutet keine Grenze.

Minimum subtotal: zeigt die Methode nur, wenn die Warenkorb-Zwischensumme (nach Rabatten, ohne Steuer) mindestens diesem Betrag entspricht. Leer lassen, um sie immer anzuzeigen.

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

Ignore shipping zones: bietet die Methode für die unten genannten Länder an, auch ohne Zuordnung zu einer Versandzone.

Countries: die Zielländer für diesen Modus. Leer lassen, um alle Versandländer des Shops zu verwenden. Dieses Feld wird nur verwendet, wenn Ignore shipping zones aktiviert ist.

Kostenloser Versand

Free shipping: aktiviert die Schwelle für kostenlosen Versand.

Free shipping from: die Warenkorb-Zwischensumme, ab der der Versand kostenlos ist. Wird nur verwendet, wenn Free shipping aktiviert ist. In diesem Fall wird keine API-Anfrage gestellt.

Erweitert

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

Remove data on uninstall: ist die Option aktiv, werden beim Löschen des Plugins seine Einstellungen und Zonenmethoden entfernt. Deaktivieren löscht nie Einstellungen. Versandzeilen bestehender Bestellungen 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 zuerst die Bedingungen: Warenkorbgewicht, Mindestzwischensumme und ausgeschlossene Versandklassen. Gilt kostenloser Versand, erhält der Kunde einen kostenlosen Tarif, und es geht keine Anfrage an Chilexpress.

Bei einer Adresse in Chile und einer API-Tarifquelle entnimmt das Plugin Region und Comuna dem Feld Stadt und sucht den Chilexpress-County-Code in der Comuna-Liste dieser Region (Coverage API). Akzente, Leerzeichen und Schreibvarianten werden ignoriert, sodass Ñuñoa und Nunoa übereinstimmen und Santiago mit Santiago Centro. Ein County-Code, der im Feld Stadt eingegeben wird, wird ebenfalls akzeptiert. Danach sendet das Plugin an die Rating API die County-Codes von Ursprung und Ziel, das Warenkorbgewicht (mindestens 0,1 kg), die Paketmaße (Länge und Breite des größten Produkts, Höhen gestapelt) und die Warenkorb-Zwischensumme in CLP als deklarierten Wert. Chilexpress liefert seine Services zurück; das Plugin verwendet den gewählten oder den günstigsten Service und rechnet den Pesobetrag in Ihre Shopwährung um. Der Servicename wird in der Versandzeile der Bestellung als Chilexpress service gespeichert.

Tarife werden 1 Stunde und Comuna-Listen 7 Tage zwischengespeichert. Eine fehlgeschlagene Anfrage wird 5 Minuten lang gemerkt, damit eine langsame oder nicht erreichbare API nicht jede Aktualisierung der Kasse verlangsamt. Das API-Timeout beträgt 10 Sekunden. Gibt Chilexpress einen Fehler zurück, keinen Service mit Preis oder eine unbekannte Comuna, sieht der Kunde keine Fehlermeldung. Die Methode wird im reinen API-Modus ausgeblendet, sonst wird der Festpreis verwendet. Der Grund wird im WooCommerce-Protokoll festgehalten.

Die Methode funktioniert an der klassischen Kasse und im Warenkorb- und Kassen-Block. Sie ist mit der High-Performance-Bestellspeicherung (HPOS) von WooCommerce kompatibel.

Das Plugin berechnet nur Tarife. Es erstellt keine Sendungen oder Transportaufträge (OT), druckt keine Etiketten, bucht keine Abholungen und verfolgt keine Pakete; buchen Sie die Sendung in Ihrem Chilexpress-Konto. Kunden können keine Chilexpress-Filiale wählen, und es gibt keine Comuna-Auswahl: Der Kunde gibt die Comuna in das Standardfeld Stadt ein. Internationale Sendungen verwenden die Festpreise.

Lizenzschlüssel

Das Plugin arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock befindet sich oben unter WooCommerce > Settings > Shipping > VibeFox Chilexpress. 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 Chilexpress 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. 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 im Hintergrund automatisch erneut geprüft.

Fehlerbehebung

Chilexpress erscheint nicht an der Kasse: prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist und die Methode der Zone des Landes des Kunden hinzugefügt wurde (oder Ignore shipping zones aktiv ist und das Land erlaubt ist). Prüfen Sie die Gewichtsgrenzen, Minimum subtotal und Excluded shipping classes. Bei Festpreisen prüfen Sie, ob das Land oder * Default eine Zeile hat.

Der Live-Tarif wird nicht angezeigt, stattdessen wird der Festpreis verwendet: prüfen Sie zuerst die Warnungen oben auf der Einstellungsseite. Andernfalls aktivieren Sie Debug log, laden Sie die Kasse neu und öffnen Sie WooCommerce > Status > Logs, Quelle vfd-chilexpress. Typische Ursachen: eine Comuna, die Chilexpress nicht erkennt (prüfen Sie Feld Stadt und Region), ein Schlüssel für das falsche Produkt oder die falsche Umgebung oder ein Ziel ohne Chilexpress-Abdeckung.

HTTP 401 oder 403 im Protokoll: der Abonnementschlüssel ist falsch, inaktiv oder gehört zu einem anderen Produkt oder einer anderen Umgebung. Testschlüssel funktionieren nur, wenn Test environment aktiviert ist.

API-Tarife werden in einem Shop mit anderer Währung nicht verwendet: geben Sie den CLP exchange rate ein.

Enthalten API-Tarife die IVA oder nicht? Sie werden genau so verwendet, wie Chilexpress sie angibt. Fügt Ihr Shop dem Versand Steuern hinzu und enthält das Angebot bereits die IVA, setzen Sie Tax status auf None.

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

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; es löscht nur die zwischengespeicherten Tarife und Comuna-Listen. Zum Entfernen deaktivieren und löschen Sie es auf der Seite Plugins. Der Lizenzschlüssel und der Lizenzstatus dieses Plugins sowie die Caches 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. Versandzeilen bestehender Bestellungen bleiben immer erhalten.

Chilexpress ist eine Marke ihres jeweiligen Inhabers. Dieses Plugin ist weder mit Chilexpress verbunden noch von Chilexpress empfohlen.