VibeFox Frenet for WooCommerce — Hilfe

Anforderungen

WordPress: 5.8 oder neuer.

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

PHP: 8.0 oder neuer.

Frenet-Konto (nur für Live-Angebote): Erstellen Sie ein kostenloses Konto im Frenet-Panel (painel.frenet.com.br), aktivieren Sie die Versanddienstleister, die Sie nutzen, und kopieren Sie Ihr API-Token. Wenn Sie nur feste Preise verwenden, benötigen Sie kein Frenet-Konto.

Produkte: Tragen Sie Gewicht und Abmessungen ein, damit die Preise genau sind. Produkte ohne diese Angaben werden mit 0,3 kg und 16 × 11 × 2 cm berechnet (der kleinste Correios-Karton).

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. Alternativ können Sie den Ordner vfd_frenet per FTP nach /wp-content/plugins/ hochladen.

2. Klicken Sie auf Activate.

3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Shipping > VibeFox Frenet, oder klicken Sie auf der Plugins-Seite 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. Fügen Sie das API-Token ein und geben Sie die CEP des Ursprungs ein. Wenn Ihre Shopwährung nicht BRL ist, geben Sie den BRL-Wechselkurs ein. Optional können Sie feste Preise und einen Ersatzpreis hinzufügen.

6. Fügen Sie VibeFox Frenet unter WooCommerce > Settings > Shipping > Shipping zones einer Versandzone für Brasilien hinzu, oder aktivieren Sie Ignore shipping zones und wählen Sie die Länder aus.

Konfiguration

Alle Einstellungen befinden sich auf einer Seite: WooCommerce > Settings > Shipping > VibeFox Frenet. 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.

Oben auf der Seite zeigt das Plugin Warnungen an: kein API-Token (dann werden nur feste Preise verwendet, oder die Methode wird nie angezeigt, wenn auch keine festen Preise vorhanden sind), keine achtstellige CEP des Ursprungs oder eine Shopwährung ungleich BRL ohne Wechselkurs. Bei jedem Speichern der Einstellungen werden die zwischengespeicherten Angebote gelöscht. Preisfelder akzeptieren sowohl den Punkt als auch das Komma als Dezimaltrennzeichen.

Allgemein

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

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

Live-Angebote von Frenet

Frenet vergleicht die Versanddienstleister, die in Ihrem Frenet-Konto aktiviert sind, und liefert deren Preise für den Warenkorb. Live-Angebote werden nur für Adressen in Brasilien mit einer vollständigen achtstelligen CEP angefordert.

API token: Ihr Frenet-API-Token aus dem Frenet-Panel. Lassen Sie das Feld leer, um nur feste Preise zu verwenden.

Origin CEP: die Postleitzahl (CEP), von der die Pakete versendet werden, z. B. 00000-000. Lassen Sie das Feld leer, um die Postleitzahl des Shops zu verwenden, wenn die Shop-Adresse in Brasilien liegt. Eine CEP mit weniger als acht Ziffern wird beim Speichern gemeldet.

Service to offer: Cheapest service (Standard) oder Fastest service. Frenet liefert mehrere Services, und die Methode zeigt einen Preis an.

BRL exchange rate: Frenet rechnet in brasilianischen Real ab. Wenn Ihre Shopwährung nicht BRL ist, geben Sie an, wie viel 1 BRL in Ihrer Shopwährung entspricht, z. B. 0.16. Damit werden das Angebot und der deklarierte Bestellwert umgerechnet. Ohne ihn werden keine Live-Angebote verwendet. Nicht nötig, wenn die Shopwährung BRL ist.

Feste Preise

Werden verwendet, wenn kein API-Token vorhanden ist, für Länder, die Frenet nicht beliefert, und immer dann, wenn Frenet keinen Preis liefert (API nicht erreichbar, CEP nicht bedient).

Price per country: eine Tabelle mit den Spalten Country, Price, XS, S, M, L und XL, Preise in Ihrer Shopwährung. Klicken Sie auf + Add country, um eine Zeile hinzuzufügen, und auf das Kreuz (×), um eine zu entfernen. Die Größenspalten richten sich nach dem Warenkorbgewicht: XS bis 1 kg, S bis 2 kg, M bis 3 kg, L bis 5 kg, XL über 5 kg. Price wird verwendet, wenn die Größenspalte leer ist. Ein Price von 0 bedeutet kostenloser Versand für dieses Land. Verwenden Sie * Default für alle übrigen Länder. Zeilen ohne Preis werden beim Speichern entfernt.

Fallback cost: wird verwendet, wenn weder Frenet noch die Tabelle einen Preis liefern. Lassen Sie das Feld leer, um die Methode auszublenden.

Fixed price applies: Per order berechnet den Preis einmal. Per item (price × quantity) multipliziert ihn mit der Anzahl der Artikel. Das gilt nur für feste Preise und die Ersatzkosten. Frenet-Angebote decken bereits den gesamten Warenkorb ab.

Bedingungen

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

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

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

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

Free shipping from: die Zwischensumme des Warenkorbs (nach Rabatten, vor Steuern), ab der der Versand kostenlos ist. Lassen Sie das Feld leer, wenn es nie kostenlosen Versand geben soll.

Tax status: Taxable fügt den WooCommerce-Steuersatz zu den Versandkosten hinzu, None nicht. Frenet-Preise sind endgültige Preise der Versanddienstleister; wählen Sie None, wenn WooCommerce keine Steuer darauf aufschlagen soll.

Produktgewichte werden von der Maßeinheit Ihres Shops in kg umgerechnet.

Verfügbarkeit ohne Versandzonen

Ignore shipping zones: bietet Frenet für die unten genannten Länder an, auch wenn es keiner Versandzone hinzugefügt wurde.

Countries: die Zielländer für diesen Modus. Lassen Sie das Feld leer, um alle Länder zu verwenden, in die Sie versenden. Wird nur verwendet, wenn Ignore shipping zones aktiviert ist.

Erweitert

Debug log: protokolliert jede Angebotsanfrage und jede Antwort unter WooCommerce > Status > Logs, Quelle vfd-frenet. API-Fehler werden immer protokolliert. Das Token wird nie protokolliert, und die CEP des Kunden wird gekürzt. Schalten Sie das Protokoll nach der Prüfung wieder aus.

Remove data on uninstall: Wenn aktiviert, entfernt das Löschen des Plugins alle Frenet-Einstellungen und Zonenmethoden. Das Deaktivieren des Plugins löscht nie Einstellungen. Zwischengespeicherte Angebote werden immer entfernt.

So funktioniert es an der Kasse

Sobald 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 Frenet.

Für eine Adresse in Brasilien mit einer vollständigen achtstelligen CEP sendet das Plugin an Frenet die CEP des Ursprungs und des Ziels, jeden Warenkorbartikel (Gewicht in kg, Abmessungen in cm, Menge, SKU und Kategorien), den Bestellwert in BRL und den ersten angewendeten Gutschein. Solange die CEP unvollständig ist, wird keine Anfrage gestellt. Frenet liefert die Services Ihrer aktivierten Versanddienstleister. Services mit Fehler oder ohne Preis werden übersprungen. Das Plugin wählt den günstigsten oder den schnellsten Service und rechnet den Preis in Ihre Shopwährung um. Versanddienstleister, Service und Lieferzeit werden mit der Versandposition der Bestellung gespeichert und auf dem Bestellbildschirm im Admin-Bereich angezeigt.

Jede Antwort wird für denselben Warenkorb und dieselbe Adresse 1 Stunde lang zwischengespeichert. Eine fehlgeschlagene Anfrage oder eine CEP, die kein aktivierter Versanddienstleister bedient, wird 10 Minuten lang gespeichert. Das Zeitlimit der API beträgt 10 Sekunden. In diesen Fällen sieht der Kunde keine Fehlermeldung: Es wird der feste Preis oder die Ersatzkosten verwendet, oder die Methode wird ausgeblendet, wenn keines von beiden vorhanden ist. Für Adressen außerhalb Brasiliens werden nur feste Preise verwendet.

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

Das Plugin berechnet nur Tarife. Es erstellt keine Sendungen, druckt keine Etiketten und verfolgt keine Pakete; Frenet bietet dies in seinem eigenen Panel an. Es zeigt pro Warenkorb einen Frenet-Service an, nicht mehrere, und bietet keine Abholstationen oder Paketboxen. Frenet liefert Angebote nur innerhalb Brasiliens; verwenden Sie für andere Länder die festen Preise.

Lizenzschlüssel

Das Plugin funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock befindet sich oben unter WooCommerce > Settings > Shipping > VibeFox Frenet. Fügen Sie den Schlüssel in License key ein und klicken Sie auf Activate. Der Block zeigt den Status, z. B. das Datum, bis zu dem die Lizenz aktiv ist, sowie 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 einen aktiven Schlüssel wird Frenet 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. Auf der Plugins-Seite und auf WooCommerce-Seiten erscheint ein Hinweis. Bestehende Bestellungen sind nicht betroffen.

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

Fehlerbehebung

Frenet erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist und die Methode der Zone des Kundenlandes hinzugefügt wurde (oder Ignore shipping zones aktiv ist und das Land erlaubt ist). Prüfen Sie die Warnungen oben auf der Einstellungsseite, die Gewichtsgrenzen, Minimum order amount und Excluded shipping classes. Typische Ursachen: Der Kunde hat noch keine vollständige achtstellige CEP eingegeben und es gibt keine festen Preise, oder Frenet hat für die Strecke keinen Service zurückgegeben und es gibt keinen festen Preis.

Live-Angebote erscheinen nicht: Aktivieren Sie Debug log, laden Sie die Kasse neu und öffnen Sie WooCommerce > Status > Logs, Quelle vfd-frenet. Dort steht der Grund: ein abgelehntes Token (HTTP 401 oder 403), keine CEP des Ursprungs, kein BRL-Wechselkurs, keine aktivierten Versanddienstleister im Frenet-Panel oder die Meldungen der übersprungenen Services.

Mein Shop verkauft in Euro oder Dollar: Frenet antwortet in BRL. Geben Sie den BRL exchange rate ein (wie viel 1 BRL in Ihrer Shopwährung entspricht).

Preise wirken nach einer Änderung veraltet: Speichern Sie die Einstellungsseite. Dadurch werden die zwischengespeicherten Angebote gelöscht.

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 löscht nur die zwischengespeicherten Angebote. Zum Entfernen deaktivieren und löschen Sie es auf der Seite Plugins. Der Lizenzschlüssel und der Lizenzstatus dieses Plugins, die zwischengespeicherten Angebote und alte Protokolldateien werden immer entfernt. Einstellungen und Zonenmethoden werden nur entfernt, wenn Remove data on uninstall aktiviert war. Andernfalls bleiben sie für eine spätere Neuinstallation erhalten. Bestehende Bestellungen behalten ihre Versandpositionen mit dem Frenet-Versanddienstleister.

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