VibeFox Envioclick for WooCommerce — Hilfe

Voraussetzungen

WordPress: 5.8 oder neuer.

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

PHP: 8.0 oder neuer.

Envioclick-Konto (nur für Live-Tarife): ein Envioclick-Konto in Mexiko oder Kolumbien mit API-Zugang. Den API-Schlüssel finden Sie in Ihrem Envioclick-Konto unter Mi cuenta (oben rechts) > Información del API. Wenn Sie nur feste Preise verwenden, benötigen Sie kein Envioclick-Konto.

User-Agent (nur Mexiko): Envioclick Mexiko verlangt bei jeder API-Anfrage einen User-Agent-Wert. Fragen Sie den Envioclick-Support danach (soporte.tecnico@envioclick.com).

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_envioclick per FTP nach /wp-content/plugins/ hochladen.

2. Klicken Sie auf Activate.

3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Shipping > VibeFox Envioclick, 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 den API-Schlüssel ein, wählen Sie das API-Land, geben Sie den User-Agent (Mexiko), die Ausgangs-Postleitzahl oder den DANE-Code und die Ausgangsadresse ein. Wenn die Shopwährung nicht MXN oder COP ist, geben Sie den Umrechnungskurs ein.

6. Fügen Sie optional feste Preise je Land und Ausweichkosten hinzu.

7. Fügen Sie VibeFox Envioclick unter WooCommerce > Settings > Shipping > Shipping zones einer Versandzone hinzu, oder aktivieren Sie Ignore shipping zones und wählen Sie die Länder.

Konfiguration

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

Title (zone): der Name, den Kunden für diese Zone sehen. Lassen Sie das Feld leer, um den globalen Method title zu verwenden.

Wenn ein API-Schlüssel gesetzt ist, zeigt das Plugin oben auf der Seite Warnungen an, falls Live-Tarife nicht funktionieren können: kein Umrechnungskurs für eine andere Shopwährung als MXN oder COP, kein User-Agent für Mexiko, keine Ausgangs-Postleitzahl oder kein DANE-Code, oder keine Ausgangsadresse für Kolumbien. Bei jedem Speichern der Einstellungen werden die zwischengespeicherten Tarife gelöscht. Zahlenfelder akzeptieren sowohl Punkt als auch Komma als Dezimaltrennzeichen.

General

Enable/Disable: schaltet die Methode in allen Zonen gleichzeitig ein oder aus. Standard: ein.

Method title: der Name der Versandmethode, der im Warenkorb und an der Kasse angezeigt wird. Eine Zone kann ihn überschreiben. Standard: Envioclick Shipping.

Carrier in the title: zeigt bei Live-Tarifen den Versanddienstleister und die geschätzte Lieferzeit neben dem Titel an, zum Beispiel „Envioclick Shipping (Estafeta Express, 1 day)“. Der Versanddienstleister wird in jedem Fall in der Bestellung gespeichert und in den Bestell-E-Mails angezeigt. Standard: ein.

Envioclick-API (Live-Tarife)

Optional. Ohne API-Schlüssel werden nur die festen Preise verwendet. Live-Tarife werden nur für Ziele im API-Land angefragt. Versand in andere Länder nutzt die festen Preise.

API key: Ihr Envioclick-API-Schlüssel aus Mi cuenta > Información del API.

API country: das Land Ihres Envioclick-Kontos.

User-Agent (Mexico): der von Envioclick-Support ausgestellte Wert (soporte.tecnico@envioclick.com). Für Mexiko erforderlich; ohne ihn werden für Mexiko keine Live-Tarife angefragt. Für Kolumbien optional.

Carrier choice: Cheapest (Standard) oder Fastest (then cheapest). Envioclick liefert Tarife mehrerer Versanddienstleister, und der Kunde erhält einen einzigen Tarif.

Branch pickup rates: berücksichtigt auch Tarife „Ocurre“, bei denen der Kunde das Paket in der Filiale des Versanddienstleisters abholt. Ist die Option aus, werden nur Tarife für die Zustellung an die Haustür verwendet. Nachnahme-Dienste (COD) werden nie verwendet. Standard: aus.

Currency conversion rate: Envioclick berechnet in MXN (Mexiko) oder COP (Kolumbien). Wenn Ihre Shopwährung eine andere ist, geben Sie den Wert von 1 MXN oder 1 COP in Ihrer Shopwährung ein, zum Beispiel 0.05. Der deklarierte Paketwert wird ebenso umgerechnet. Lassen Sie das Feld leer, wenn die Shopwährung MXN oder COP ist. Ohne Kurs werden Live-Tarife in einer anderen Währung nicht verwendet.

Versand von

Wird für Live-Tarife verwendet. Leere Felder werden aus der Shopadresse unter WooCommerce > Settings > General übernommen, wenn der Shop im API-Land liegt.

Origin postcode / DANE code: Mexiko: die 5-stellige Postleitzahl. Kolumbien: der 8-stellige DANE-Code der Gemeinde, zum Beispiel 11001000 für Bogotá.

Origin address: Straße und Hausnummer der Abholadresse. Für Kolumbien erforderlich, für Mexiko optional.

Feste Preise

Werden verwendet, wenn kein Live-Tarif vorliegt: kein API-Schlüssel, ein Ziel außerhalb des API-Landes, ein API-Fehler oder kein Versanddienstleister für die Strecke.

Price per country: eine Tabelle mit Ländern und Preisen in Ihrer Shopwährung. Klicken Sie auf + Add country, um eine Zeile hinzuzufügen, und auf das Kreuz, um eine zu entfernen. Die Zeile * Default gilt für alle Länder ohne eigene Zeile.

Fallback cost: wird verwendet, wenn kein Live-Tarif vorliegt und keine Zeile der Tabelle passt. Lassen Sie das Feld leer, um die Methode in diesem Fall auszublenden.

Fixed price applies: Per order berechnet den Preis einmal. Per item (price × quantity) multipliziert ihn mit der Anzahl der Artikel im Warenkorb. Live-Tarife von Envioclick gelten immer pro Sendung.

Bedingungen

Minimum weight (kg): blendet die Methode unterhalb dieses Warenkorbgewichts aus. 0 bedeutet keine Grenze.

Maximum weight (kg): blendet die Methode oberhalb dieses Warenkorbgewichts aus. Standard: 25. 0 bedeutet keine Grenze.

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

Free shipping from: kostenloser Versand, wenn die Zwischensumme des Warenkorbs (nach Rabatten, vor Steuern) diesen Betrag erreicht. In diesem Fall wird keine API-Anfrage gestellt. Leer lassen, um nie kostenlosen Versand anzubieten.

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

Tax status: Taxable fügt die WooCommerce-Steuer zu den Versandkosten hinzu, None nicht. Envioclick-Tarife enthalten bereits die Steuern der Versanddienstleister. Wählen Sie daher None, um die Steuer auf den Versand nicht doppelt zu berechnen.

Verfügbarkeit ohne Versandzonen

Ignore shipping zones: bietet Envioclick für die unten angegebenen Länder an, auch wenn die Methode keiner Versandzone hinzugefügt wurde.

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

Erweitert

Debug log: protokolliert Tarifberechnungen und API-Fehler unter WooCommerce > Status > Logs, Quelle vfd_envioclick. Der API-Schlüssel und Kundenadressen werden nicht protokolliert. Schalten Sie es nach Abschluss wieder aus.

Remove data on uninstall: ist die Option aktiv, entfernt das Löschen des Plugins alle Envioclick-Einstellungen, Zonenmethoden und zwischengespeicherten Tarife. Das Deaktivieren des Plugins löscht nie Einstellungen.

So funktioniert es an der Kasse

Wenn der Kunde eine Lieferadresse eingibt, fragt WooCommerce das Plugin nach einem Tarif. Das Plugin prüft zuerst das Warenkorbgewicht, den Mindestbestellwert und die ausgeschlossenen Versandklassen. Gilt kostenloser Versand, wird die Methode mit dem Preis null angezeigt und es geht keine Anfrage an Envioclick.

Ist ein API-Schlüssel gesetzt und liegt das Ziel im API-Land, fragt das Plugin Envioclick nach Tarifen. In Mexiko erfolgt die Anfrage, sobald der Kunde eine 5-stellige Postleitzahl eingegeben hat. In Kolumbien erfolgt sie, sobald Departamento und Gemeinde erkannt wurden (Akzente und Groß- und Kleinschreibung spielen keine Rolle, „Bogotá D.C.“ funktioniert). Das Plugin wählt den günstigsten oder den schnellsten Tarif für die Zustellung an die Haustür, der kein Nachnahme-Dienst ist, und rechnet ihn in Ihre Shopwährung um.

Das Paket ist immer ein einziger Karton: das Gesamtgewicht in kg sowie Länge und Breite des größten Artikels, mit einer Höhe, die das Gesamtvolumen aller Artikel einhält. Produkte ohne Maße zählen als 10 × 10 × 10 cm. Ein Warenkorb ohne Gewicht wird als 0,5 kg gesendet. Der deklarierte Wert ist die Zwischensumme des Warenkorbs.

Jeder Tarif wird für dieselbe Strecke und dasselbe Paket 1 Stunde lang zwischengespeichert. Eine fehlgeschlagene Anfrage wird 10 Minuten lang zwischengespeichert, damit eine nicht erreichbare API nicht jede Aktualisierung an der Kasse verlangsamt. Das Zeitlimit der API beträgt 10 Sekunden. Gibt Envioclick einen Fehler zurück oder gibt es keinen Versanddienstleister für die Strecke, sieht der Kunde keinen Fehler: Es wird der feste Preis verwendet oder die Methode wird ausgeblendet. Der Grund wird im Debug-Log vermerkt.

Die Methode funktioniert in der klassischen Kasse sowie im Warenkorb- und Kassen-Block. Sie ist mit WooCommerce High-Performance Order Storage (HPOS) kompatibel.

Das Plugin berechnet nur Tarife. Es erstellt keine Sendungsbelege oder Etiketten, beauftragt keine Abholungen und verfolgt oder storniert keine Sendungen. Es bietet einen einzigen Tarif statt einer Auswahl zwischen Versanddienstleistern und verwendet keine Nachnahme-Dienste, keine zusätzliche Versicherung und keine Tarife für mehrere Pakete. Live-Tarife gelten nur innerhalb eines Landes.

Bestellungen

Wird eine Bestellung mit einem Live-Tarif von Envioclick aufgegeben, werden Versanddienstleister und Service in der Bestellung gespeichert. Der Bestellbildschirm im Admin-Bereich zeigt Envioclick carrier mit der geschätzten Lieferzeit unter der Lieferadresse. Die Bestellseite des Kunden und die Bestell-E-Mails (HTML und Nur-Text) zeigen Shipping carrier. Die Envioclick-Tarif-ID des Angebots wird als verborgene Daten bei der Versandposition der Bestellung gespeichert; sie wird auf dem Bestellbildschirm nicht angezeigt. Erstellen Sie den Versandbeleg in Ihrem Envioclick-Konto.

Bestellungen mit festem Preis haben keinen Versanddienstleister.

Lizenzschlüssel

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

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

Fehlerbehebung

Envioclick 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 eingeschaltet ist und das Land erlaubt ist). Prüfen Sie die Gewichtsgrenzen, Minimum order amount und Excluded shipping classes. Ohne Live-Tarif benötigt die Methode einen festen Preis für das Land, eine Zeile * Default oder eine Fallback cost.

Live-Tarife erscheinen nicht: lesen Sie die Warnungen oben auf der Einstellungsseite, schalten Sie dann das Debug log ein, laden Sie die Kasse neu und öffnen Sie WooCommerce > Status > Logs, Quelle vfd_envioclick. Häufige Gründe: kein Umrechnungskurs (die Shopwährung ist nicht MXN oder COP), kein User-Agent (Mexiko), keine Ausgangs-Postleitzahl oder kein DANE-Code, die Postleitzahl (Mexiko) oder Stadt (Kolumbien) des Kunden ist noch nicht eingegeben, das Ziel liegt außerhalb des API-Landes oder es gibt keinen Versanddienstleister für die Strecke.

Warum ein Umrechnungskurs? Envioclick liefert Preise nur in mexikanischen oder kolumbianischen Pesos. Das Plugin zeigt nie einen Pesobetrag als eine andere Währung an.

Kolumbien: die Stadt wird nicht erkannt: der Kunde muss das Departamento auswählen und den Namen der Gemeinde eintippen. Ein 8-stelliger DANE-Code, der als Postleitzahl eingegeben wird, funktioniert ebenfalls. Entwickler können einen DANE-Code mit dem Filter vfd_evc_dane_code bereitstellen.

Steuer wird auf den Versand doppelt berechnet: Envioclick-Tarife enthalten bereits die Steuern der Versanddienstleister. Setzen Sie Tax status auf None.

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

Entwicklerfilter: vfd_evc_quotation_request (Anfragekörper), vfd_evc_api_url, vfd_evc_dane_code, vfd_evc_default_dimensions und vfd_evc_package_description.

Der Lizenzblock zeigt einen Fehler: folgen Sie der Meldung im Block. Wenn der Schlüssel zum Beispiel bereits auf einer anderen Domain verwendet wird, 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 Zonenmethoden; nur die zwischengespeicherten Tarife werden gelöscht. Zum Entfernen deaktivieren Sie das Plugin und löschen Sie es auf der Seite Plugins. Lizenzschlüssel und Lizenzstatus dieses Plugins werden immer entfernt. Einstellungen, Zonenmethoden und zwischengespeicherte Tarife werden nur entfernt, wenn Remove data on uninstall aktiv war. Andernfalls bleiben sie für eine spätere Neuinstallation erhalten. Der in früheren Bestellungen gespeicherte Versanddienstleister bleibt erhalten, und bestehende Bestellungen behalten ihre Versandpositionen.

Envioclick ist eine Marke des jeweiligen Inhabers. Dieses Plugin ist weder mit Envioclick verbunden noch wird es von Envioclick unterstützt.