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

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 Ihren API-Token. Wenn Sie nur feste Preise verwenden, brauchen 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 (die kleinste Correios-Verpackung).

VibeFox-Lizenzschlüssel: Er wird auf vibefox.net gekauft. Ein Schlüssel gilt für eine 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 aus.

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

3. Fügen 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. Fügen Sie den API-Token ein und geben Sie die CEP des Versandursprungs ein. Ist Ihre Standardwährung nicht BRL, geben Sie den BRL-Wechselkurs ein. Optional können Sie feste Preise und einen Ersatzpreis hinzufügen. Klicken Sie auf Save.

Bei der Installation legt das Modul den Versanddienstleister Frenet mit dem Lieferzeittext Delivery by the carriers of your Frenet account an. Der Versanddienstleister wird allen Zonen und allen Kundengruppen zugewiesen. Zonen, Kundengruppen, Lieferzeit, Logo und Größenbeschränkungen können Sie 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 Frenet > Configure. Sie gelten für alle Zonen des Versanddienstleisters. Jeder Abschnitt hat eine eigene Schaltfläche Save, die die gesamte Seite speichert. Jedes Speichern löscht außerdem die zwischengespeicherten Frenet-Angebote. Preisfelder akzeptieren sowohl den Punkt als auch das Komma als Dezimaltrennzeichen. Ein Wert, der keine Zahl ist, wird mit der Meldung "…" must be a number. abgelehnt. Ebenso abgelehnt werden negative Beträge und Gewichte, ein BRL exchange rate von 0 oder weniger sowie ein Minimum weight, das größer als das Maximum weight ist. Bei einem Fehler wird nichts gespeichert.

Oben auf der Seite zeigt das Modul Warnungen an: kein API-Token (dann werden nur feste Preise verwendet, oder der Versanddienstleister wird nie angezeigt, wenn auch keine festen Preise vorhanden sind), keine 8-stellige CEP des Ursprungs oder eine Standardwährung ungleich BRL ohne Wechselkurs. Es warnt auch, wenn die Gewichts- oder Abmessungseinheit Ihres Shops nicht erkannt wird; eine solche Einheit wird wie kg oder cm behandelt. Stellen Sie unter International > Localization (Local units) eine Standardeinheit ein (kg, g, lb oder oz; cm, mm, m oder in).

Allgemein

Enable Frenet: schaltet den Versanddienstleister ein oder aus. Dies ist derselbe Schalter wie der Status des Versanddienstleisters unter Shipping > Carriers.

Method title: der Name des Versanddienstleisters, der im Warenkorb und an der Kasse angezeigt wird. Default: Frenet. Pflichtfeld, höchstens 64 Zeichen.

Live-Angebote von Frenet

Frenet vergleicht die in Ihrem Frenet-Konto aktivierten Versanddienstleister und liefert deren Preise für den Warenkorb. Live-Angebote werden nur für Adressen in Brasilien mit einer vollständigen 8-stelligen CEP angefragt. Der Abschnitt enthält einen Link zum Frenet-Panel.

API token: Ihr Frenet-API-Token aus dem Frenet-Panel. Lassen Sie das Feld leer, um nur feste Preise zu verwenden. Nach dem Speichern bleibt das Feld leer und zeigt A token is saved — leave empty to keep it. Geben Sie nur dann einen neuen Wert ein, wenn Sie ihn ändern möchten. Um den gespeicherten Token zu löschen, setzen Sie das Häkchen bei Remove the saved token und speichern Sie.

Origin CEP: die CEP, von der aus die Pakete versendet werden, zum Beispiel 00000-000. Lassen Sie das Feld leer, um die Shop-Postleitzahl aus Shop Parameters > Contact > Stores zu verwenden, sofern die Shop-Adresse in Brasilien liegt. Eine CEP mit weniger als 8 Ziffern wird so gespeichert, wie sie eingegeben wurde, und die Seite zeigt Frenet: the origin CEP must have 8 digits.

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

BRL exchange rate: Frenet rechnet in brasilianischen Real ab. Ist Ihre Standardwährung nicht BRL, geben Sie ein, wie viel 1 BRL in Ihrer Standardwährung ist, zum Beispiel 0.16. Damit werden das Angebot und der angegebene Bestellwert umgerechnet. Ohne ihn werden keine Live-Angebote verwendet. Ist Ihre Standardwährung BRL, zeigt das Feld Not needed (shop currency is BRL).

Feste Preise

Werden verwendet, wenn kein API-Token vorhanden ist, für Länder, die Frenet nicht bedient, 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 Standardwährung ohne Steuer. Klicken Sie auf Add country, um eine Zeile hinzuzufügen, und auf das Papierkorb-Symbol, 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 jeglichen Preis werden beim Speichern entfernt.

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

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

Bedingungen

Minimum weight: blendet den Versanddienstleister unterhalb dieses Warenkorbgewichts aus, in kg. 0 bedeutet keine Grenze.

Maximum weight: blendet den Versanddienstleister oberhalb dieses Warenkorbgewichts aus, in kg. Default: 30 (wird auch verwendet, wenn das Feld leer ist). 0 bedeutet keine Grenze. Er darf nicht niedriger als das Minimum weight sein.

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

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

Tax: die Steuerregel des Versanddienstleisters oder No tax. Frenet-Preise sind endgültige Preise des Versanddienstleisters. Wählen Sie No tax, wenn PrestaShop keine Steuer darauf aufschlagen soll.

Produktgewichte und -abmessungen werden von den Einheiten Ihres Shops in kg und cm umgerechnet.

Verfügbarkeit ohne Versandzonen

Normalerweise wird der Versanddienstleister in den Zonen angeboten, die ihm unter Shipping > Carriers zugewiesen sind.

Ignore shipping zones: bietet Frenet für die unten genannten Länder an, unabhängig davon, welche Zone passt. Beim Speichern wird der Versanddienstleister allen Zonen hinzugefügt, ebenso später angelegten Zonen. Wenn Sie die Option wieder ausschalten, erhält der Versanddienstleister die Zonen zurück, die er vorher hatte.

Countries: die Zielländer für diesen Modus, ausgewählt aus den aktiven Ländern Ihres Shops. Lassen Sie das Feld leer, um alle Länder zu verwenden, in die Sie liefern. Wird nur verwendet, wenn Ignore shipping zones aktiviert ist.

Erweitert

Debug log: protokolliert jede Angebotsanfrage und jede Antwort in logs/vfd_frn_debug.log.php im Modulordner. Die Datei lässt sich nicht über das Web öffnen. API-Fehler werden immer protokolliert. Der Token wird nie protokolliert, und die CEP des Kunden wird gekürzt. Schalten Sie das Protokoll nach Abschluss der Prüfung wieder aus.

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

Remove data on uninstall: Ist die Option aktiv, löscht die Deinstallation des Moduls alle Frenet-Einstellungen, den Versanddienstleister und das Protokoll. Ist sie inaktiv, bleibt alles für eine erneute Installation erhalten. Zwischengespeicherte Angebote werden immer entfernt. Die mit Bestellungen gespeicherten Frenet-Services sind Bestellhistorie und bleiben erhalten.

So funktioniert es an der Kasse

Im Versandschritt fragt PrestaShop das Modul nach dem Frenet-Preis. Nur physische Produkte zählen: Virtuelle Produkte erhöhen weder das Gewicht noch fließen sie in den Bestellwert ein. Bevor der Kunde eine Adresse eingibt, verwendet das Modul das Land, das der Shop für den Besucher schätzt. Das Modul prüft zuerst die Länderliste (wenn Ignore shipping zones aktiv ist), das Warenkorbgewicht und den Mindestbestellwert. Gilt kostenloser Versand, beträgt der Preis 0 und es wird keine Anfrage an Frenet gesendet.

Bei einer Adresse in Brasilien mit vollständiger 8-stelliger CEP sendet das Modul an Frenet die CEP des Ursprungs und des Ziels, jeden Warenkorbartikel (Gewicht in kg, Abmessungen in cm, Menge, Produktreferenz und Kategorien), den Bestellwert in BRL und den ersten Gutscheincode des Warenkorbs. 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 Modul wählt den günstigsten oder den schnellsten Service aus und rechnet den Preis in Ihre Standardwährung um. Anschließend wird der Preis in der Warenkorbwährung des Kunden 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 der Ersatzpreis verwendet, oder der Versanddienstleister wird ausgeblendet, wenn keiner vorhanden ist. Der Grund wird im Protokoll festgehalten. Für Adressen außerhalb Brasiliens werden nur feste Preise verwendet.

Wenn Sie den Versanddienstleister unter Shipping > Carriers bearbeiten, nachdem er Bestellungen hat, speichert PrestaShop ihn als neue Version des Versanddienstleisters. Das Modul übernimmt die neue Version automatisch.

Das Modul berechnet nur Tarife. Es erstellt keine Sendungen, druckt keine Etiketten und verfolgt keine Pakete. 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.

Bestellungen

Wird eine Bestellung mit dem Frenet-Versanddienstleister aufgegeben, speichert das Modul, wie der Versandpreis berechnet wurde. Die Bestellseite im Back Office zeigt dann einen Frenet-Block mit diesen Zeilen:

Carrier: der Frenet-Versanddienstleister und der Service, zum Beispiel ein Correios- oder Jadlog-Service. Wird für Live-Angebote angezeigt.

Delivery time: die von Frenet gelieferte Lieferzeit in Werktagen. Wird für Live-Angebote angezeigt.

Price source: Live Frenet quote, Fixed price (price per country), Fallback cost oder Free shipping.

Diese Daten bleiben auch bei der Deinstallation des Moduls erhalten, ebenso bei Remove data on uninstall.

Lizenzschlüssel

Das Modul funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox Frenet ist der erste Block unter Modules > Module Manager > VibeFox Frenet > 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 aktiv ist, und Ihre Domain) sowie die Schaltflächen Check now zum erneuten Prüfen des Status, Change key zur Eingabe eines anderen Schlüssels und Remove key zum Entfernen des Schlüssels aus diesem Shop. Darunter stehen die Zeile Product: presta-shipping-frenet 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. Klicken Sie nach einer Änderung der Shop-Adresse oder nachdem Sie in Ihrem Konto einen Domain-Platz freigegeben haben, 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 in einem Multistore-Setup. Das Entfernen des Schlüssels aus dem Shop gibt seinen Domain-Platz nicht frei. Geben Sie den Platz in Ihrem vibefox.net-Konto frei.

Ohne einen aktiven Schlüssel wird der Frenet-Versanddienstleister Kunden an der Kasse nicht angezeigt und es wird kein Tarif berechnet. Der PrestaShop-Storefront weiß nicht, dass Sie im Back Office angemeldet sind, daher wird der Versanddienstleister auch Ihnen ausgeblendet: Sie können das Modul vor dem Kauf eines Schlüssels einrichten, aber nicht an der Kasse testen. Ein Hinweis erscheint unter Modules > Module Manager auf der Registerkarte Alerts. Bestehende Bestellungen sind nicht betroffen.

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 Eingabe des Schlüssels, danach einmal pro Woche. Ein Cron-Job ist nicht nötig. Beim Deinstallieren oder Zurücksetzen des Moduls werden Lizenzschlüssel und Lizenzstatus immer entfernt.

Fehlerbehebung

Frenet erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv ist und Enable Frenet eingeschaltet ist. Prüfen Sie unter Shipping > Carriers, ob der Versanddienstleister die Zone des Ländes des Kunden und dessen Kundengruppe abdeckt, oder ob Ignore shipping zones aktiv ist und das Land erlaubt ist. Beachten Sie die Warnungen oben auf der Modulseite, die Gewichtsgrenzen und den Minimum order amount. Typische Ursachen: Der Kunde hat noch keine vollständige 8-stellige CEP eingegeben und es gibt keine festen Preise, oder Frenet hat für die Strecke keinen Service geliefert und es gibt keinen festen Preis. Produkte können außerdem auf der Produktseite auf bestimmte Versanddienstleister beschränkt sein.

Live-Angebote erscheinen nicht: Aktivieren Sie Debug log, laden Sie die Kasse neu und sehen Sie sich das Feld Log auf der Modulseite an. Es zeigt den Grund: keine CEP des Ursprungs, kein BRL-Wechselkurs, eine unvollständige CEP des Kunden, eine Gewichts- oder Betragsgrenze oder die Meldungen der übersprungenen Services.

Das Protokoll meldet, dass der API-Token abgelehnt wurde (HTTP 401 oder 403): Kopieren Sie den Token erneut aus dem Frenet-Panel und fügen Sie ihn in API token ein.

Das Protokoll meldet, dass Frenet keine Services geliefert hat: Aktivieren Sie mindestens einen Versanddienstleister im Frenet-Panel.

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

Auf den Frenet-Preis wird zusätzlich Steuer erhoben: Frenet-Preise sind endgültige Preise des Versanddienstleisters. Stellen Sie Tax auf No tax.

Nach einer Änderung wirken die Tarife veraltet: Klicken Sie auf der Modulseite auf Save. Dadurch werden die zwischengespeicherten Frenet-Angebote gelöscht.

Die Seite meldet, dass der Frenet-Versanddienstleister nicht gefunden wurde: Der Versanddienstleister wurde unter Shipping > Carriers gelöscht. Setzen Sie das Modul unter Modules > Module Manager zurück, um ihn erneut anzulegen. Bis dahin zeigt das Speichern The settings were saved, but the carrier could not be updated.

Deinstallation

Gehen Sie zu Modules > Module Manager, öffnen Sie das Menü neben VibeFox Frenet und wählen Sie Uninstall. Lizenzschlüssel und Lizenzstatus werden immer entfernt. Zwischengespeicherte Angebote werden immer entfernt. Ist Remove data on uninstall aktiv, wird der Versanddienstleister gelöscht (Bestellungen behalten ihre Historie), und die Einstellungen und das Protokoll werden entfernt. Ist die Option inaktiv, wird der Versanddienstleister nur deaktiviert und alle Einstellungen bleiben erhalten. Wenn Sie das Modul erneut installieren oder Reset ausführen, erhält der gespeicherte Versanddienstleister den vorherigen Status zurück: Ein Versanddienstleister, den Sie ausgeschaltet hatten, bleibt ausgeschaltet. Bestehende Bestellungen behalten den Frenet-Versanddienstleister und den Frenet-Block auf der Bestellseite.

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