VibeFox Loggi for PrestaShop — Hilfe

Anforderungen

PrestaShop: 8.0 bis 9.x.

PHP: 8.0 oder neuer. Das Modul lässt sich auf älteren PHP-Versionen nicht installieren.

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: wird auf vibefox.net gekauft. Ein Schlüssel funktioniert auf einer Domain.

Installation

1. Gehen Sie im Back-Office zu Modules > Module Manager und klicken Sie auf Upload a module. Wählen Sie die ZIP-Datei des Moduls.

2. Wenn der Upload abgeschlossen ist, klicken Sie auf Configure, oder suchen Sie VibeFox Loggi später in der Modulliste und klicken Sie dort auf Configure.

3. Geben Sie Ihren VibeFox-Lizenzschlüssel in License key im Lizenzblock oben auf der Seite Configure ein und klicken Sie auf Activate (siehe Lizenzschlüssel).

4. Geben Sie die Loggi-API-E-Mail, den API-Schlüssel, die Shop ID und die Abholadresse ein und, falls die Standardwährung Ihres Shops nicht BRL ist, den BRL-Wechselkurs. Fügen Sie feste Preise als Sicherheitsnetz hinzu (siehe Konfiguration) und klicken Sie auf Save.

5. Fügen Sie Brasilien unter Shipping > Carriers den Zonen der Loggi-Versandart hinzu, oder aktivieren Sie Ignore shipping zones und wählen Sie Länder aus.

Bei der Installation erstellt das Modul die Versandart Loggi mit dem Lieferzeittext Courier delivery in Brazil. Die Versandart wird allen Zonen und allen Kundengruppen zugewiesen. Sie können Zonen, Kundengruppen, Lieferzeit, Logo und Größenbeschränkungen unter Shipping > Carriers ändern. Legen Sie dort keine Preise fest: Der Preis kommt immer vom Modul.

Konfiguration

Alle Einstellungen befinden sich auf der Modulseite: Modules > Module Manager > VibeFox Loggi > Configure. Sie gelten für alle Zonen der Versandart. Jeder Abschnitt hat eine eigene Schaltfläche Save, die die gesamte Seite speichert. Jedes Speichern löscht außerdem die zwischengespeicherten Loggi-Preise.

Warnungen oben auf der Seite zeigen eine unvollständige Einrichtung an: keine API-Zugangsdaten (es werden nur feste Preise verwendet), keine API-Zugangsdaten und keine festen Preise (die Versandart wird nie angezeigt), keine Abholadresse, kein BRL-Wechselkurs oder eine Gewichts- oder Abmessungseinheit des Shops, die das Modul nicht kennt (dann wird sie als kg bzw. cm gezählt; legen Sie die Einheiten unter International > Localization fest). Ist ein Wert ungültig, etwa eine negative Zahl, zeigt die Seite einen Fehler an und es wird nichts gespeichert.

Allgemein

Enable Loggi: schaltet die Versandart ein oder aus. Dies ist derselbe Schalter wie der Status der Versandart unter Shipping > Carriers.

Method title: der Name der Versandart, den der Kunde im Warenkorb und in der Kasse sieht. Standard: Loggi. Pflichtfeld, maximal 64 Zeichen.

Loggi-API (Live-Preis) (Zugangsdaten leer lassen, 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. Sie muss eine gültige E-Mail-Adresse sein.

API key: Ihr Loggi-API-Schlüssel. Er wird nur an Loggi gesendet und nie protokolliert. Nach dem Speichern bleibt das Feld leer und zeigt Saved — leave empty to keep it; clear the API e-mail to remove it. Geben Sie einen neuen Wert nur ein, wenn Sie den Schlüssel ändern möchten. Wenn Sie API e-mail ändern, geben Sie auch den API-Schlüssel für die neue E-Mail-Adresse ein, sonst zeigt die Seite einen Fehler und es wird nichts gespeichert. Um den gespeicherten Schlüssel zu entfernen, leeren Sie API e-mail und speichern Sie.

Shop ID: die numerische ID (pk) Ihres Shops im Loggi-Dashboard. Nur eine positive Zahl wird akzeptiert. Ein anderer Wert wird mit einem Fehler abgelehnt.

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 Shop-Adresse aus Shop Parameters > Contact > Stores zu verwenden, wenn sie in Brasilien liegt und eine Adresse und eine Stadt hat. Ohne Abholadresse kann Loggi nicht schätzen, und es werden nur feste Preise verwendet.

BRL exchange rate: Loggi-Preise sind in brasilianischen Real angegeben. Wenn die Standardwährung Ihres Shops BRL ist, wird dieses Feld nicht benötigt und die Seite weist darauf hin. Andernfalls geben Sie ein, wie viel 1 BRL in der Währung Ihres Shops entspricht, zum Beispiel 0.16. Ohne diesen Wert werden Live-Preise nicht verwendet. Nur eine positive Zahl wird akzeptiert. Sowohl Punkt als auch Komma werden als Dezimaltrennzeichen akzeptiert.

Feste Preise (in der Standardwährung Ihres Shops, ohne Steuern)

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 liefert (API nicht erreichbar, Schlüssel abgelehnt, Adresse außerhalb des Liefergebiets).

Price table: eine Zeile je Zielland. Klicken Sie auf Add country, um eine Zeile hinzuzufügen, und auf das Papierkorbsymbol, 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. Ein Basispreis von 0 bedeutet kostenlosen 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 Loggi-Live-Preis vorliegt und die Tabelle keine Zeile für das Zielland hat (und keine *-Zeile). Lassen Sie es leer, um die Versandart in diesem Fall auszublenden.

Fixed price applies: die Art, wie feste Preise berechnet werden. Ein Loggi-Live-Preis deckt bereits den gesamten Warenkorb ab und wird nie multipliziert.

Bedingungen

Minimum weight: blendet die Versandart aus, wenn der Warenkorb weniger wiegt, in kg. 0 bedeutet keine Grenze.

Maximum weight: blendet die Versandart aus, wenn der Warenkorb mehr wiegt, in kg. Standard: 30. 0 bedeutet keine Grenze. Minimum weight darf nicht größer als Maximum weight sein.

Minimum order amount: zeigt die Versandart 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. Leer lassen für keinen kostenlosen Versand.

Tax: die Steuerregel der Versandart oder No tax. Wählen Sie No tax, wenn Ihre Preise und der Loggi-Preis bereits Steuern enthalten.

Bei den Gewichtsgrenzen und den Gewichtsspalten zählt ein Produkt ohne Gewicht als 0 kg.

Verfügbarkeit ohne Versandzonen

Ignore shipping zones: bietet Loggi für die unten genannten Länder an, unabhängig von der passenden Zone. Wenn Sie mit dieser Option speichern, wird die Versandart allen Zonen hinzugefügt, auch später erstellten Zonen. Wird die Option ausgeschaltet, werden diese hinzugefügten Zonen wieder entfernt, sodass die Versandart ihre eigenen Zonen zurückbekommt.

Countries: die Zielländer für diesen Modus. Leer lassen, um alle aktiven Länder Ihres Shops zu erlauben. Dieses Feld wird nur verwendet, wenn Ignore shipping zones eingeschaltet ist.

Erweitert

Debug log: schreibt Preisberechnungen und Loggi-Anfragen in logs/vfd_lggi_debug.log.php im Modulordner. Die Datei kann nicht über das Web geöffnet werden. API-Fehler werden immer protokolliert, auch wenn diese Option aus ist. Der API-Schlüssel und Kundenadressen werden nie protokolliert.

Log: zeigt die Größe und die neuesten Einträge des Debug-Protokolls. Klicken Sie auf Clear log, um es zu leeren.

Remove data on uninstall: wenn eingeschaltet, löscht die Deinstallation des Moduls die Loggi-Einstellungen, die Versandart, die zwischengespeicherten Preise und die Protokolle. Wenn ausgeschaltet, bleibt alles für eine erneute Installation erhalten.

So funktioniert es in der Kasse

Im Versandschritt fragt PrestaShop das Modul nach dem Loggi-Preis. Nur physische Produkte zählen: Virtuelle Produkte fügen kein Gewicht hinzu und sind nicht im Bestellwert enthalten. Das Modul prüft zuerst die Bedingungen: erlaubte Länder (mit Ignore shipping zones), Warenkorbgewicht und Mindestbestellwert. Gilt kostenloser Versand, beträgt der Preis 0 und es wird keine Anfrage an Loggi gesendet.

Für eine Adresse in Brasilien mit vollständiger 8-stelliger CEP erstellt das Modul Loggi-Pakete: Jeder Artikel wird so gedreht, dass seine kürzeste Seite die Höhe ist, und die 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 mit 1 cm je Seite, und jedes Paket wiegt mindestens 100 g. Loggi akzeptiert 2 Pakete je Schätzung, daher werden größere Warenkörbe in mehreren Anfragen gesendet und die Summen addiert. Das Modul sendet an Loggi Ihre Shop ID, die Abholadresse, die Lieferadresse und die Pakete und rechnet die Loggi-Summe von BRL in die Standardwährung Ihres Shops um. Der Preis wird dann in der Warenkorbwährung des Kunden angezeigt.

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.

Die festen Preise werden stattdessen verwendet, wenn die API nicht konfiguriert ist, die Adresse außerhalb Brasiliens liegt oder noch keine vollständige CEP hat, der BRL-Wechselkurs fehlt, keine Abholadresse vorliegt, 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 des Liefergebiets oder eine Summe von null zurückgibt. Gibt es auch keinen festen Preis, wird die Versandart ausgeblendet. Der Kunde sieht nie einen API-Fehler. Der Grund wird im Debug-Protokoll festgehalten.

Wenn Sie die Versandart unter Shipping > Carriers bearbeiten, nachdem sie Bestellungen hat, speichert PrestaShop sie als neue Version der Versandart. Das Modul folgt der neuen Version automatisch.

Das Modul berechnet nur Preise. Es erstellt keine Loggi-Bestellungen oder -Sendungen, druckt keine Etiketten, verfolgt keine Pakete, zeigt die Lieferzeit in der Kasse nicht an und bietet keine Abholpunkte oder Schließfächer 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 Modul funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox Loggi ist der erste Block auf Modules > Module Manager > VibeFox Loggi > Configure, oberhalb der Einstellungen. Fügen Sie den Schlüssel in License key ein und klicken Sie auf Activate. Danach zeigt der Block den Schlüssel maskiert, den Status (zum Beispiel das Datum, bis zu dem die Lizenz gültig ist, und Ihre Domain) sowie die Schaltflächen Check now, um den Status erneut zu prüfen, Change key, um einen anderen Schlüssel einzugeben, und Remove key, um den Schlüssel aus diesem Shop zu entfernen. Darunter stehen die Zeile Product: presta-shipping-loggi und der Link Manage licenses and domains in your account, der Ihr vibefox.net-Konto öffnet. Nur Mitarbeiter mit der Berechtigung Configure für das Modul können den Schlüssel ändern. Die Texte des Blocks folgen der Sprache des Back Office (Englisch und Russisch sind enthalten).

Wird der Schlüssel nicht akzeptiert, nennt der Block den Grund, zum Beispiel Key not found, This key belongs to another product, Domain limit reached oder License expired on mit einem Datum. Nachdem sich die Shop-Adresse geändert hat oder nachdem Sie in Ihrem Konto einen Domainplatz freigegeben haben, klicken Sie auf Check now. Ist der Lizenzserver nicht erreichbar, arbeitet das Modul mit dem zuletzt bekannten Status weiter.

Ein Schlüssel gilt für eine Domain: die Domain des Hauptshops, auch bei einer Multistore-Konfiguration. Das Entfernen des Schlüssels aus dem Shop gibt seinen Domainplatz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.

Ohne aktiven Schlüssel wird die Loggi-Versandart Kunden an der Kasse nicht angezeigt, und es wird kein Preis berechnet. Der Kundenbereich von PrestaShop weiß nicht, dass Sie im Back Office angemeldet sind, daher wird die Versandart auch für Sie ausgeblendet: Sie können das Modul einrichten, bevor Sie einen Schlüssel kaufen, es aber an der Kasse nicht testen. Ein Hinweis erscheint unter Modules > Module Manager auf dem Reiter Alerts. Bestehende Bestellungen bleiben unberührt.

Läuft eine Lizenz ab, arbeitet das Modul weiter, Updates und Support benötigen jedoch eine Verlängerung. Der Status wird während Ihrer Arbeit im Back Office automatisch erneut geprüft: einmal täglich in den ersten 14 Tagen nach der Eingabe des Schlüssels, danach einmal pro Woche. Ein Cronjob ist nicht nötig. Beim Deinstallieren oder Zurücksetzen des Moduls werden der Lizenzschlüssel und der Lizenzstatus immer entfernt.

Fehlerbehebung

Loggi erscheint nicht in der Kasse: Prüfen Sie, ob die Lizenz aktiv ist und Enable Loggi eingeschaltet ist. Prüfen Sie unter Shipping > Carriers, ob die Versandart die Zone des Landes und die Kundengruppe des Kunden abdeckt (oder ob Ignore shipping zones eingeschaltet und das Land erlaubt ist). Prüfen Sie die Warnungen oben auf der Modulseite, die Gewichtsgrenzen und Minimum order amount. Hat der Kunde noch keine vollständige CEP eingegeben oder liefert Loggi keinen Preis, braucht die Versandart einen festen Preis: eine Zeile für das Land, eine *-Zeile oder Price for countries not in the table. Produkte können auf der Produktseite auch auf bestimmte Versandarten beschränkt werden.

Nur feste Preise werden angezeigt: Sehen Sie sich das Feld Log auf der Modulseite an. Fehler werden immer protokolliert. Schalten Sie Debug log für jeden Schritt ein und laden Sie die Kasse neu. 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 Standardwährung Ihres Shops entspricht). Feste Preise sind immer in der Standardwährung Ihres Shops.

Die Preise sind nicht genau: Tragen Sie Gewicht und Abmessungen Ihrer Produkte ein. Ohne sie zählen Produkte mit 1 cm je Seite und jedes Paket mit mindestens 100 g.

Per item multipliziert den Loggi-Preis nicht: Das ist so vorgesehen. Ein Loggi-Live-Preis deckt den gesamten Warenkorb ab. Per item gilt nur für feste Preise.

Preise wirken nach einer Änderung veraltet: Klicken Sie auf der Modulseite auf Save. Dadurch werden die zwischengespeicherten Loggi-Preise gelöscht.

Die Seite meldet, dass die Loggi-Versandart nicht gefunden wurde: Die Versandart wurde unter Shipping > Carriers gelöscht. Setzen Sie das Modul unter Modules > Module Manager zurück, um sie neu zu erstellen.

Deinstallation

Gehen Sie zu Modules > Module Manager, öffnen Sie das Menü neben VibeFox Loggi und wählen Sie Uninstall. Der Lizenzschlüssel und der Lizenzstatus werden immer entfernt. Die zwischengespeicherten Loggi-Preise werden immer entfernt. Ist Remove data on uninstall eingeschaltet, wird die Versandart gelöscht (Bestellungen behalten ihren Verlauf), und die Einstellungen und das Protokoll werden entfernt. Ist die Option ausgeschaltet, wird die Versandart nur deaktiviert und alle Einstellungen bleiben erhalten. Wenn Sie das Modul erneut installieren, erhält die gespeicherte Versandart den Status zurück, den sie vor der Deinstallation hatte.

Loggi ist eine Marke ihres jeweiligen Inhabers. Dieses Modul ist nicht mit Loggi verbunden und wird nicht von Loggi unterstützt.