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

DrEnvio-Konto (nur für Live-Tarife): Live-Tarife von Estafeta kommen von DrEnvio, einem Estafeta-Partner in Mexiko. Erstellen Sie ein Konto auf drenvio.com, aktivieren Sie Estafeta, hinterlegen Sie dort Ihre Abholadresse und kopieren Sie den API-Schlüssel aus dem DrEnvio-Panel. Es ist derselbe Schlüssel, den das offizielle DrEnvio-Plugin verwendet. Wenn Sie nur Ihre eigenen Preise nutzen, brauchen Sie kein DrEnvio-Konto.

Produkte: Für Live-Tarife benötigen Produkte ein Gewicht.

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

2. Klicken Sie auf Activate.

3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Shipping > VibeFox Estafeta 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 DrEnvio-API-Schlüssel und optional die Postleitzahl des Abholorts ein. Wenn Ihre Shop-Währung nicht MXN ist, geben Sie den MXN exchange rate ein. Legen Sie einen Länderpreis für MX oder eine Ersatzgebühr fest, falls die Versandart sichtbar bleiben soll, wenn DrEnvio keinen Tarif liefert.

6. Fügen Sie VibeFox Estafeta unter WooCommerce > Settings > Shipping > Shipping zones Ihrer Zone für Mexiko 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 Estafeta. 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 Option an der Kasse. Leer lassen, um den globalen Name zu verwenden.

Oben auf der Seite zeigt das Plugin Warnungen an: kein DrEnvio-API-Schlüssel, eine Shop-Währung außer MXN ohne Wechselkurs oder kein Länderpreis für MX und keine Ersatzgebühr (die Versandart wird dann ausgeblendet, wenn kein Live-Tarif vorliegt). Bei jedem Speichern der Einstellungen werden die zwischengespeicherten DrEnvio-Tarife gelöscht. Zahlenfelder akzeptieren einen Dezimalpunkt oder ein Komma. Ein Wert, der keine gültige Zahl ist, wird beim Speichern gelöscht und gemeldet.

Allgemein

Enable/Disable: schaltet den Estafeta-Versand in allen Zonen gleichzeitig ein oder aus. Standard: ein.

Name: der Name der Versandart, den der Kunde an der Kasse sieht. Standard: Estafeta.

Tax status: Taxable lässt WooCommerce Steuern auf die Versandkosten aufschlagen, None tut das nicht. Ob DrEnvio-Preise IVA enthalten, hängt von Ihrem DrEnvio-Konto ab. Wenn sie bereits IVA enthalten, wählen Sie None. Standard: Taxable.

Live-Tarife (DrEnvio-API)

Angeboten wird der günstigste Estafeta-Service für die Adresse. Ohne Schlüssel werden die Preise aus dem nächsten Abschnitt verwendet.

DrEnvio API key: der API-Schlüssel aus Ihrem DrEnvio-Panel.

Origin country: der zweistellige Ländercode der Abholadresse. Standard: MX. Wird nur zusammen mit der Abhol-Postleitzahl gesendet.

Origin postcode: die fünfstellige Postleitzahl der Abholadresse. Leer lassen, um die in Ihrem DrEnvio-Konto gespeicherte Absenderadresse zu verwenden. Eine Postleitzahl, die nicht aus 5 Ziffern besteht, wird beim Speichern gelöscht.

MXN exchange rate: DrEnvio rechnet in mexikanischen Pesos ab. Nur nötig, wenn Ihre Shop-Währung nicht MXN ist: der Wert von 1 MXN in Ihrer Shop-Währung, zum Beispiel 0.05. Ohne ihn werden keine Live-Tarife verwendet.

Preise ohne Live-Tarif

Werden verwendet, wenn kein API-Schlüssel vorliegt oder DrEnvio keinen Estafeta-Tarif zurückgibt (API nicht erreichbar, unbekannte Postleitzahl, noch keine Postleitzahl eingegeben). Die Preise sind in Ihrer Shop-Währung.

Country prices: ein Zielland pro Zeile im Format CC:PRICE, zum Beispiel MX:150. Verwenden Sie einen Dezimalpunkt oder ein Komma, kein Tausendertrennzeichen. Teile in einem anderen Format werden ignoriert und beim Speichern gemeldet.

Fallback cost: der Preis, wenn kein Live-Tarif und kein Länderpreis vorliegt. Leer lassen, um die Versandart auszublenden; 0 bedeutet kostenloser Versand.

Calculation type: Per order berechnet den Preis einmal. Per item (price x number of items) multipliziert ihn mit der Anzahl versandfähiger Artikel. Das gilt für Country prices und Fallback cost. Ein Live-Tarif von DrEnvio ist immer der Preis des gesamten Pakets.

Bedingungen

Free shipping from: der Versand ist kostenlos, wenn die Zwischensumme des Warenkorbs diesen Betrag erreicht. Dann wird keine Anfrage an DrEnvio gestellt. Leer lassen, um nie kostenlosen Versand anzubieten.

Minimum subtotal: die Versandart wird nur angezeigt, wenn die Zwischensumme des Warenkorbs mindestens diesen Betrag erreicht. Leer lassen, um sie immer anzuzeigen.

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

Max weight (kg): das maximale Warenkorbgewicht. Wird es überschritten, ist die Versandart ausgeblendet. Standard: 30. 0 bedeutet keine Grenze.

Excluded shipping classes: Gehört ein Warenkorbartikel einer dieser WooCommerce-Versandklassen an, wird die Versandart ausgeblendet.

Produktgewichte werden von der Gewichtseinheit Ihres Shops in kg umgerechnet.

Verfügbarkeit ohne Versandzonen

Ignore shipping zones: bietet die Versandart für die unten genannten Länder an, auch wenn sie keiner Versandzone zugeordnet ist.

Countries: die Zielländer für diesen Modus. Leer lassen für alle Länder. Wird nur verwendet, wenn Ignore shipping zones aktiviert ist.

Erweitert

Debug log: protokolliert API-Anfragen und die Tarifberechnung unter WooCommerce > Status > Logs, Quelle vfd-estafeta. API-Fehler werden immer protokolliert. API-Schlüssel und Kundenadressen werden nie protokolliert.

Remove data on uninstall: ist die Option aktiv, entfernt das Löschen des Plugins alle Plugin-Einstellungen und Zonen-Methoden. Das Deaktivieren des Plugins löscht nie etwas.

So funktioniert es an der Kasse

Gibt der Kunde eine Lieferadresse ein, fragt WooCommerce das Plugin nach einem Tarif. Das Plugin prüft zuerst das Warenkorbgewicht, die Mindestzwischensumme und die ausgeschlossenen Versandklassen. Gilt kostenloser Versand, wird die Versandart mit Preis null angezeigt und es geht keine Anfrage an DrEnvio.

Andernfalls sendet das Plugin an DrEnvio das Zielland und die Postleitzahl, das Warenkorbgewicht, die Anzahl der Artikel und die Zwischensumme sowie die Absender-Postleitzahl, falls Sie eine festgelegt haben. Mexikanische Postleitzahlen müssen 5 Ziffern haben; bis der Kunde eine eingibt, wird keine Anfrage gestellt. DrEnvio liefert Angebote aller Versanddienstleister Ihres Kontos. Das Plugin verwendet nur Estafeta-Angebote, ignoriert Preise von null, wählt das günstigste aus und rechnet es in Ihre Shop-Währung um. Der Estafeta-Service und die Lieferzeit werden mit der Versandposition der Bestellung gespeichert und auf dem Bestellbildschirm im Admin-Bereich angezeigt.

Jede Antwort wird 1 Stunde lang zwischengespeichert. Eine fehlgeschlagene Anfrage oder eine Route ohne Estafeta-Tarif wird 5 Minuten lang gemerkt, sodass eine langsame oder defekte API nie jede Aktualisierung an der Kasse ausbremst. Das API-Timeout beträgt 12 Sekunden. In diesen Fällen sieht der Kunde keine Fehlermeldung: Es wird der Länderpreis oder die Ersatzgebühr verwendet, oder die Versandart wird ausgeblendet, wenn keines von beiden gesetzt ist.

Die Methode funktioniert an der klassischen Kasse und an den Blöcken Warenkorb und Kasse. Sie ist mit der WooCommerce-Bestellspeicherung für hohe Leistung (HPOS) kompatibel.

Das Plugin berechnet nur Tarife. Es erstellt keine Sendungen, druckt keine Etiketten (guías) und verfolgt keine Pakete; erstellen Sie die Sendung in Ihrem DrEnvio- oder Estafeta-Konto. Der Kunde kann keinen bestimmten Estafeta-Service und keine Estafeta-Filiale wählen, und Wechselkurse werden nicht automatisch aktualisiert.

Lizenzschlüssel

Das Plugin funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock befindet sich oben auf WooCommerce > Settings > Shipping > VibeFox Estafeta. 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 Estafeta 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, arbeitet das Plugin weiter, Updates und Support erfordern jedoch eine Verlängerung. Der Status wird automatisch im Hintergrund erneut geprüft.

Fehlerbehebung

Estafeta 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 die Hinweise oben auf der Einstellungsseite, die Gewichtsgrenzen, Minimum subtotal und Excluded shipping classes. Ohne API-Schlüssel oder wenn DrEnvio keinen Estafeta-Tarif hat, braucht die Versandart einen Länderpreis für das Ziel oder eine Ersatzgebühr.

Live-Tarife erscheinen nicht: Aktivieren Sie das Debug log, laden Sie die Kasse neu und öffnen Sie WooCommerce > Status > Logs, Quelle vfd-estafeta. Dort steht der Grund: kein API-Schlüssel, kein Wechselkurs für einen Shop ohne MXN, eine fehlende oder ungültige Postleitzahl, ein abgelehnter API-Schlüssel (HTTP 401 oder 403) oder kein Estafeta-Tarif für die Route.

Enthält der Preis IVA? Das hängt von Ihrem DrEnvio-Konto ab. Wenn die DrEnvio-Preise bereits IVA enthalten, setzen Sie Tax status auf None.

Tarife wirken nach einer Änderung veraltet: Speichern Sie die Einstellungsseite. Dadurch werden die zwischengespeicherten DrEnvio-Tarife 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 und löscht nur den Tarif-Cache. Zum Entfernen deaktivieren Sie das Plugin und löschen Sie es auf der Seite Plugins. Der Lizenzschlüssel und der Lizenzstatus dieses Plugins, die zwischengespeicherten Tarife und alte Protokolldateien werden immer entfernt. Einstellungen und Zonen-Methoden werden nur entfernt, wenn Remove data on uninstall aktiv war. Andernfalls bleiben sie für eine spätere Neuinstallation erhalten. Bestellungen werden nie angetastet, und bestehende Bestellungen behalten ihre Versandpositionen.

Estafeta und DrEnvio sind Marken ihrer jeweiligen Inhaber. Dieses Plugin ist weder mit Estafeta noch mit DrEnvio verbunden und wird von ihnen nicht unterstützt.