VibeFox Loggi for WooCommerce — Hilfe
Anforderungen
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.
Loggi-Konto (nur für Live-Preise): Der Live-Preis nutzt die Loggi-GraphQL-API mit einem API-Schlüssel, den Loggi für Geschäftskonten ausstellt. Fragen Sie Ihren Loggi-Kundenbetreuer oder den Loggi-Integrationssupport (integracoes@loggi.com); siehe auch die Loggi-API-Dokumentation unter docs.api.loggi.com. Sie benötigen drei Werte: die E-Mail-Adresse Ihres Loggi-Kontos, den API-Schlüssel und die numerische ID Ihres Shops. Wenn Ihr Loggi-Konto nur Zugangsdaten für die neuere Loggi-REST-Plattform-API (Client-ID und Secret) hat, ist der Live-Preis nicht verfügbar und es werden die festen Preise verwendet. Wenn Sie nur feste Preise nutzen, benötigen Sie kein Loggi-Konto.
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_loggi per FTP nach /wp-content/plugins/ hochladen.
2. Klicken Sie auf Activate.
3. Öffnen Sie die Einstellungen: WooCommerce > Settings > Shipping > VibeFox Loggi oder klicken Sie auf der Plugins-Seite 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 die E-Mail-Adresse der Loggi-API, den API-Schlüssel, die Shop ID und die Abholadresse ein und, falls die Währung Ihres Shops nicht BRL ist, den BRL-Wechselkurs. Fügen Sie feste Preise als Sicherheitsnetz hinzu (siehe Konfiguration).
6. Fügen Sie VibeFox Loggi unter WooCommerce > Settings > Shipping > Shipping zones einer Versandzone für Brasilien 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 Loggi. 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.
Warnungen oben auf der Seite zeigen eine unvollständige Einrichtung an: keine API-Zugangsdaten, keine Abholadresse oder kein BRL-Wechselkurs. Bei jedem Speichern der Einstellungen werden die zwischengespeicherten Loggi-Preise gelöscht.
Allgemein
Enable/Disable: schaltet die Methode in allen Zonen gleichzeitig ein oder aus.
Method title: der Name der Versandmethode, der im Warenkorb und in der Kasse angezeigt wird. Eine Zone kann ihn überschreiben. Standard: Loggi.
Loggi-API (Live-Preis) (lassen Sie die Zugangsdaten leer, um nur feste Preise zu verwenden)
API e-mail: die E-Mail-Adresse Ihres Loggi-Kontos. Der API-Schlüssel gehört zu diesem Konto.
API key: Ihr Loggi-API-Schlüssel. Er wird nur an Loggi gesendet und nie protokolliert.
Shop ID: die numerische ID (pk) Ihres Shops im Loggi-Dashboard. Es wird nur eine positive Zahl akzeptiert. Ein anderer Wert wird mit einem Fehler abgelehnt, und der gespeicherte Wert bleibt erhalten.
Staging: verwendet die Loggi-Staging-Umgebung mit Testzugangsdaten. Staging und Produktion haben unterschiedliche Konten und Schlüssel. Standard: aus.
Pickup address: wo Loggi die Pakete abholt, in einer Zeile: Straße und Hausnummer, Stadtteil, Stadt, Bundesstaat und CEP, zum Beispiel Rua Example, 123 - Bairro, São Paulo - SP, 01310-100. Lassen Sie das Feld leer, um die Shopadresse aus WooCommerce > Settings > General zu verwenden, falls sie in Brasilien liegt. Ohne Abholadresse kann Loggi nicht schätzen, und es werden nur feste Preise verwendet.
BRL exchange rate: Loggi-Preise sind in brasilianischen Real. Wenn die Währung Ihres Shops BRL ist, wird dieses Feld nicht benötigt. Andernfalls geben Sie ein, wie viel 1 BRL in der Währung Ihres Shops entspricht, zum Beispiel 0.16. Ohne ihn werden keine Live-Preise verwendet. Sowohl Punkt als auch Komma werden als Dezimaltrennzeichen akzeptiert.
Feste Preise (in der Währung Ihres Shops)
Feste Preise werden verwendet, wenn die Loggi-API nicht konfiguriert ist, für Ziele außerhalb Brasiliens oder ohne vollständige CEP, und immer dann, wenn Loggi keinen Preis zurückgibt (API nicht erreichbar, Schlüssel abgelehnt, Adresse außerhalb der Loggi-Abdeckung).
Price table: eine Zeile je Zielland. Klicken Sie auf + Add country, um eine Zeile hinzuzufügen, und auf das Kreuz, um eine zu entfernen. Wählen Sie * All other countries für alle Länder ohne eigene Zeile. Jede Zeile hat einen Base price und Gewichtsspalten: XS ≤1 kg, S ≤2 kg, M ≤3 kg, L ≤5 kg und XL >5 kg. Eine leere (oder 0) Gewichtsspalte verwendet den Basispreis. Basispreis 0 bedeutet kostenloser Versand. Sowohl „9.99“ als auch „9,99“ werden akzeptiert. Leere Zeilen und eine zweite Zeile für dasselbe Land werden beim Speichern entfernt.
Price for countries not in the table: wird verwendet, wenn kein Live-Preis von Loggi vorliegt und die Tabelle keine Zeile für das Zielland hat (und auch keine *-Zeile). Lassen Sie das Feld leer, um die Methode in diesem Fall auszublenden.
Fixed price applies: die Art, wie feste Preise berechnet werden. Ein Live-Preis von Loggi deckt bereits den gesamten Warenkorb ab und wird nie multipliziert.
Bedingungen
Minimum weight (kg): blendet die Methode aus, wenn der Warenkorb weniger wiegt. 0 bedeutet kein Limit.
Maximum weight (kg): blendet die Methode aus, wenn der Warenkorb mehr wiegt. Standard: 30. 0 bedeutet kein Limit.
Minimum order amount: zeigt die Methode nur an, wenn die Zwischensumme des Warenkorbs (nach Rabatten, vor Steuern) diesen Betrag erreicht. Lassen Sie das Feld leer, um sie immer anzuzeigen.
Free shipping from: die Zwischensumme des Warenkorbs (nach Rabatten, vor Steuern), ab der der Loggi-Versand kostenlos ist. Lassen Sie das Feld leer, wenn es keinen kostenlosen Versand gibt.
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. Wählen Sie None, wenn Ihre Preise und der Loggi-Preis bereits Steuern enthalten.
Verfügbarkeit ohne Versandzonen
Ignore shipping zones: bietet Loggi für die unten genannten Länder an, auch wenn die Methode 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. Dieses Feld wird nur verwendet, wenn Ignore shipping zones aktiviert ist.
Erweitert
Debug log: protokolliert jede Preisberechnung und jede Anfrage an Loggi unter WooCommerce > Status > Logs (Quelle vfd-loggi). API-Fehler werden immer protokolliert, auch wenn diese Option aus ist. Der API-Schlüssel und Kundenadressen werden nie protokolliert.
Remove data on uninstall: wenn aktiviert, entfernt das Löschen des Plugins alle Loggi-Einstellungen und Zonenmethoden. Das Deaktivieren des Plugins löscht nie Einstellungen.
So funktioniert es in der Kasse
Wenn der Kunde eine Lieferadresse eingibt, fragt WooCommerce das Plugin nach einem Preis. Das Plugin prüft zuerst die Bedingungen: Lieferland, Warenkorbgewicht, Mindestbestellwert und ausgeschlossene Versandklassen. Gilt kostenloser Versand, sieht der Kunde die Methode kostenlos, und es wird keine Anfrage an Loggi gesendet.
Für eine Adresse in Brasilien mit vollständiger 8-stelliger CEP erstellt das Plugin Loggi-Pakete: Jeder Artikel wird so gedreht, dass seine kürzeste Seite die Höhe ist, und Artikel werden in ein Paket gestapelt, solange es innerhalb von 55 × 55 × 55 cm und 20 kg bleibt. Produkte ohne Gewicht oder Abmessungen zählen als 1 cm pro Seite, und jedes Paket wiegt mindestens 100 g. Loggi akzeptiert 2 Pakete pro Schätzung, daher werden größere Warenkörbe in mehreren Anfragen gesendet und die Summen addiert. Das Plugin sendet an Loggi Ihre Shop ID, die Abholadresse, die Lieferadresse und die Pakete, rechnet die Loggi-Summe von BRL in die Währung Ihres Shops um und zeigt sie an.
Jeder Loggi-Preis wird 1 Stunde pro Warenkorb, Adresse, Konto und Umgebung zwischengespeichert, damit derselbe Warenkorb keine neue Anfrage auslöst. Eine fehlgeschlagene Schätzung wird 10 Minuten zwischengespeichert. Wenn Loggi überhaupt nicht erreichbar ist, pausieren Anfragen 2 Minuten, damit die Kasse bei jeder Aktualisierung nicht auf Loggi warten muss. Das API-Timeout beträgt 10 Sekunden.
Stattdessen werden feste Preise verwendet, wenn die API nicht konfiguriert ist, die Adresse außerhalb Brasiliens liegt oder noch keine vollständige CEP hat, der BRL-Wechselkurs fehlt, ein Produkt größer als ein Loggi-Paket ist, der Warenkorb mehr als 10 Pakete benötigt oder Loggi einen Fehler, ein abgelehntes Paket, eine Adresse außerhalb der Abdeckung oder eine Gesamtsumme von null zurückgibt. Gibt es auch keinen festen Preis, wird die Methode ausgeblendet. Der Kunde sieht nie einen API-Fehler. Der Grund wird im Protokoll festgehalten.
Die Methode funktioniert in der klassischen Kasse sowie in den Blöcken Warenkorb und Kasse. Sie ist mit WooCommerce High-Performance Order Storage (HPOS) kompatibel.
Das Plugin berechnet nur Preise. Es erstellt keine Loggi-Bestellungen oder -Sendungen, druckt keine Etiketten, verfolgt keine Pakete, zeigt in der Kasse keine Lieferzeit an und bietet keine Abholpunkte oder Paketstationen an. Erstellen Sie Sendungen im Loggi-Dashboard. Loggi liefert nur innerhalb Brasiliens. Verwenden Sie für andere Länder die festen Preise.
Lizenzschlüssel
Das Plugin arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock befindet sich oben unter WooCommerce > Settings > Shipping > VibeFox Loggi. 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 Loggi Kunden in 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 eine Erinnerung. Bestehende Bestellungen sind nicht betroffen.
Wenn eine Lizenz abläuft, funktioniert das Plugin weiter, Updates und Support erfordern aber eine Verlängerung. Der Status wird automatisch im Hintergrund erneut geprüft.
Fehlerbehebung
Loggi erscheint nicht in 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 ist (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. Wenn der Kunde noch keine vollständige CEP eingegeben hat oder Loggi keinen Preis zurückgibt, benötigt die Methode einen festen Preis: eine Zeile für das Land, eine *-Zeile oder Price for countries not in the table.
Es werden nur feste Preise angezeigt: Öffnen Sie WooCommerce > Status > Logs, Quelle vfd-loggi. Fehler werden immer protokolliert. Aktivieren Sie Debug log für jeden Schritt. Typische Gründe: fehlende API-E-Mail, fehlender Schlüssel oder fehlende Shop ID, keine Abholadresse, kein BRL exchange rate bei einer anderen Shop-Währung als BRL, noch keine vollständige 8-stellige CEP, ein Produkt größer als 55 cm oder schwerer als 20 kg, oder eine Adresse außerhalb der Loggi-Abdeckung.
HTTP 401 oder 403 im Protokoll: Loggi hat die API-E-Mail oder den Schlüssel abgelehnt. Prüfen Sie sie bei Loggi und kontrollieren Sie, dass Staging zu den Zugangsdaten passt: Staging- und Produktionsschlüssel sind verschieden.
Mein Shop verkauft in Euro oder Dollar: Loggi antwortet in BRL. Geben Sie den BRL exchange rate ein (wie viel 1 BRL in der Währung Ihres Shops ist). Feste Preise sind immer in der Währung Ihres Shops.
Die Preise sind nicht genau: Tragen Sie Gewicht und Abmessungen für Ihre Produkte ein. Ohne diese Angaben zählen Produkte als 1 cm pro Seite und jedes Paket als mindestens 100 g.
Pro Artikel multipliziert den Loggi-Preis nicht: Das ist beabsichtigt. Ein Live-Preis von Loggi deckt den gesamten Warenkorb ab. Per item gilt nur für feste Preise.
Preise wirken nach einer Änderung veraltet: Speichern Sie die Einstellungsseite. Dadurch werden die zwischengespeicherten Loggi-Preise 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. Nur die zwischengespeicherten Loggi-Preise werden gelöscht. Zum Entfernen deaktivieren und löschen Sie es auf der Seite Plugins. Der Lizenzschlüssel und der Lizenzstatus dieses Plugins sowie die zwischengespeicherten Preise 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.
Loggi ist eine Marke ihres jeweiligen Inhabers. Dieses Plugin ist weder mit Loggi verbunden noch wird es von Loggi unterstützt.