VibeFox Estafeta for PrestaShop — Hilfe

Anforderungen

PrestaShop: 8.0 bis 9.x.

PHP: 8.0 oder neuer mit der cURL-Erweiterung. Das Modul lässt sich auf älteren PHP-Versionen oder ohne cURL nicht installieren.

DrEnvio-Konto (nur für Live-Tarife): Live-Tarife von Estafeta stammen von DrEnvio, einem Estafeta-Partner in Mexiko. Legen Sie ein Konto auf drenvio.com an, aktivieren Sie Estafeta, richten Sie dort Ihre Abholadresse ein und kopieren Sie den API-Schlüssel aus Ihrem 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: Produkte benötigen ein Gewicht für Live-Tarife.

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

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

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

4. Geben Sie den DrEnvio API key und optional die Origin postcode ein. Wenn Ihre Standardwährung nicht MXN ist, geben Sie den MXN exchange rate ein. Legen Sie einen Länderpreis für MX oder eine Fallback cost fest, wenn der Versanddienstleister sichtbar bleiben soll, falls DrEnvio keinen Tarif liefert. Klicken Sie auf Save.

Bei der Installation legt das Modul den Versanddienstleister Estafeta mit dem Lieferzeittext Estafeta courier (Mexico) an. Der Versanddienstleister 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 Estafeta > Configure. Jeder Abschnitt hat seine eigene Schaltfläche Save, die die ganze Seite speichert. Jedes Speichern löscht außerdem die zwischengespeicherten DrEnvio-Tarife.

Oben auf der Seite zeigt das Modul Warnungen an: kein DrEnvio-API-Schlüssel; eine Standardwährung außer MXN ohne Wechselkurs; kein Länderpreis für MX und keine Ersatzgebühr (der Versanddienstleister wird dann ausgeblendet, wenn kein Live-Tarif vorliegt, oder ist ohne API-Schlüssel nie sichtbar); oder eine Gewichtseinheit des Shops, die das Modul nicht kennt (Produktgewichte werden dann als kg angenommen; stellen Sie die Einheit unter International > Localization, Local units ein). Zahlenfelder akzeptieren Punkt oder Komma als Dezimaltrennzeichen. Ein Wert, der keine gültige Zahl ist, wird beim Speichern gelöscht und gemeldet; die anderen Einstellungen werden trotzdem gespeichert.

Allgemein

Zonen, Kundengruppen und Größenbeschränkungen des Versanddienstleisters werden unter Shipping > Carriers eingestellt. Diese Einstellungen gelten für jede Zone.

Enable/Disable: schaltet den Versand mit Estafeta ein oder aus. Es ist derselbe Schalter wie der Status des Versanddienstleisters unter Shipping > Carriers.

Name: der Name des Versanddienstleisters, den der Kunde an der Kasse sieht. Standard: Estafeta. Pflichtfeld. Ein ungültiger Name wird gemeldet, und der vorherige Name bleibt erhalten.

Tax: die Steuerregel des Versanddienstleisters oder No tax. Der Shop schlägt diese Steuer auf die Versandkosten auf. Ob die DrEnvio-Preise IVA enthalten, hängt von Ihrem DrEnvio-Konto ab. Wenn sie IVA bereits enthalten, wählen Sie No tax.

Live-Tarife (DrEnvio-API)

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

DrEnvio API key: der API-Schlüssel aus Ihrem DrEnvio-Panel. Nach dem Speichern bleibt das Feld leer und zeigt Saved — leave empty to keep it. Geben Sie nur dann einen neuen Wert ein, wenn Sie ihn ändern möchten.

Remove the saved API key: wird nur angezeigt, solange ein Schlüssel gespeichert ist. Setzen Sie es auf Yes und speichern Sie, um den Schlüssel zu löschen. Danach werden nur Country prices und die Fallback cost verwendet. Ein Schlüssel, der im Feld oben eingegeben wird, ersetzt stattdessen den gespeicherten.

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

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

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

Preise ohne Live-Tarif

Diese werden verwendet, wenn kein API-Schlüssel vorhanden ist oder DrEnvio keinen Estafeta-Tarif zurückgibt (API nicht erreichbar, unbekannte Postleitzahl, noch keine Postleitzahl eingegeben). Die Preise sind in der Standardwährung Ihres Shops angegeben, ohne Steuern.

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

Fallback cost: der Preis, wenn weder ein Live-Tarif noch ein Länderpreis vorliegt. Leer lassen, um den Versanddienstleister 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 der Artikel im Warenkorb. Dies gilt für Country prices und Fallback cost. Ein Live-Tarif von DrEnvio ist immer der Preis für das gesamte Paket.

Bedingungen

Free shipping from: der Versand ist kostenlos, wenn die Zwischensumme des Warenkorbs (Produkte, die versendet werden müssen, nach Rabatten, vor Steuern) diesen Betrag erreicht. In diesem Fall wird keine Anfrage an DrEnvio gestellt. Leer lassen, um nie kostenlosen Versand anzubieten.

Minimum subtotal: den Versanddienstleister nur anzeigen, wenn die Zwischensumme des Warenkorbs (nach Rabatten, vor Steuern) mindestens diesen Betrag erreicht. Leer lassen, um ihn immer anzuzeigen.

Min weight: das minimale Warenkorbgewicht in kg, damit der Versanddienstleister erscheint. 0 bedeutet keine Begrenzung.

Max weight: das maximale Warenkorbgewicht in kg. Der Versanddienstleister wird ausgeblendet, wenn es überschritten wird. Standard: 30. 0 bedeutet keine Begrenzung.

Wenn Min weight größer ist als Max weight, erscheint beim Speichern ein Fehler und beide Gewichte bleiben unverändert. Produktgewichte werden von der Gewichtseinheit Ihres Shops in kg umgerechnet.

Verfügbarkeit ohne Versandzonen

Ignore shipping zones: bietet den Versanddienstleister für die unten genannten Länder an, ohne dafür Zonen einzurichten. Solange diese Option aktiv ist, erhält der Versanddienstleister alle Zonen, auch solche, die Sie später anlegen. Beim Ausschalten erhält der Versanddienstleister wieder seine eigenen Zonen.

Countries: die Zielländer für diesen Modus, gewählt aus den aktiven Ländern Ihres Shops. Leer lassen für alle Länder. Wird nur verwendet, wenn Ignore shipping zones aktiv ist.

Erweitert

Debug log: schreibt API-Anfragen und Tarifberechnungen in logs/vfd_est_debug.log.php im Modulordner. Die Datei kann nicht über das Web geöffnet werden. API-Fehler werden immer protokolliert. API-Schlüssel und Kundenadressen werden nie protokolliert. Schalten Sie das Protokoll aus, wenn Sie fertig sind.

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 aktiviert, löscht die Deinstallation des Moduls alle Modul-Einstellungen, den Versanddienstleister, die gespeicherten Estafeta-Services der Bestellungen und das Protokoll. Wenn deaktiviert, bleibt alles für eine Neuinstallation erhalten.

Ablauf an der Kasse

Im Versandschritt fragt PrestaShop das Modul nach dem Estafeta-Preis. Nur physische Produkte zählen: Virtuelle Produkte haben kein Gewicht und sind nicht in der Zwischensumme enthalten. Das Modul prüft zuerst die Bedingungen: die Liste Countries (wenn Ignore shipping zones aktiv ist), das Warenkorbgewicht und die Mindestzwischensumme. Gilt kostenloser Versand, ist der Preis 0 und es wird keine Anfrage an DrEnvio gestellt.

Andernfalls sendet das Modul an DrEnvio das Zielland und die Postleitzahl, das Warenkorbgewicht, die Anzahl der Artikel und die Zwischensumme in MXN sowie die Ursprungs-Postleitzahl, falls Sie eine festgelegt haben. Mexikanische Postleitzahlen müssen 5 Ziffern haben; bis der Kunde eine Lieferadresse mit einer solchen eingibt, wird keine Anfrage gestellt. DrEnvio liefert Angebote aller Versanddienstleister Ihres Kontos. Das Modul verwendet nur die Estafeta-Angebote, ignoriert Preise von 0, wählt das günstigste und rechnet es in Ihre Standardwährung um. Der Preis wird dann in der Warenkorbwährung des Kunden angezeigt.

Jede Antwort wird 1 Stunde lang zwischengespeichert. Eine fehlgeschlagene Anfrage oder eine Strecke ohne Estafeta-Tarif wird 5 Minuten lang gemerkt, damit 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 keinen Fehler: Es werden der Länderpreis oder die Ersatzgebühr verwendet, oder der Versanddienstleister wird ausgeblendet, wenn keines von beiden gesetzt ist. Der Grund wird im Protokoll festgehalten.

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

Das Modul berechnet nur Tarife. Es erstellt keine Sendungen, druckt keine Etiketten (guías) und verfolgt keine Pakete; die Sendung erstellen Sie 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.

Bestellungen

Wenn eine Bestellung mit dem Versanddienstleister Estafeta aufgegeben wird, speichert das Modul den für ihren Warenkorb berechneten Tarif. Spätere Neuberechnungen, zum Beispiel auf der Bestellseite im Back-Office, ändern ihn nicht.

Die Bestellseite unter Orders > Orders zeigt einen Block Estafeta:

Estafeta service: der Estafeta-Service des DrEnvio-Angebots und seine Lieferzeit. Wird nur für Live-Tarife angezeigt.

Price source: Live DrEnvio rate, Country price (no live rate), Fallback cost (no live rate) oder Free shipping threshold.

Calculated price (excl. tax): der Versandpreis in Ihrer Standardwährung.

Lizenzschlüssel

Das Modul funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox Estafeta ist der erste Block auf Modules > Module Manager > VibeFox Estafeta > Configure, oberhalb der Einstellungen. Geben Sie den Schlüssel in License key ein und klicken Sie auf Activate. Danach zeigt der Block den maskierten Schlüssel, den Status (zum Beispiel das Datum, bis zu dem die Lizenz gültig ist, und Ihre Domain) sowie die Schaltflächen Check now zur erneuten Prüfung 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-estafeta 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).

Wenn der Schlüssel nicht akzeptiert wird, 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 Domain-Platz freigegeben haben, klicken Sie auf Check now. Kann der Lizenzserver nicht erreicht werden, arbeitet das Modul weiter mit dem zuletzt bekannten Status.

Ein Schlüssel funktioniert für eine Domain: die Domain des Haupt-Shops, auch in einer Multistore-Konfiguration. 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 Versanddienstleister Estafeta 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 für Sie ausgeblendet: Sie können das Modul vor dem Kauf eines Schlüssels einrichten, aber an der Kasse nicht testen. Eine Erinnerung erscheint unter Modules > Module Manager auf der Registerkarte Alerts. Bestehende Bestellungen sind davon nicht betroffen.

Wenn eine Lizenz abläuft, arbeitet das Modul weiter, Updates und Support erfordern 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 Cron-Job ist nicht nötig. Beim Deinstallieren oder Zurücksetzen des Moduls werden immer der Lizenzschlüssel und der Lizenzstatus entfernt.

Fehlerbehebung

Estafeta erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv ist und Enable/Disable eingeschaltet ist. Prüfen Sie unter Shipping > Carriers, ob der Versanddienstleister die Zone des Ländes des Kunden und die Kundengruppe abdeckt (oder ob Ignore shipping zones aktiv ist und das Land erlaubt ist). Prüfen Sie die Warnungen oben auf der Modulseite, die Gewichtsgrenzen und die Minimum subtotal. Ohne API-Schlüssel oder wenn DrEnvio keinen Estafeta-Tarif liefert, braucht der Versanddienstleister einen Länderpreis für das Ziel oder eine Ersatzgebühr. Produkte können auf der Produktseite außerdem auf bestimmte Versanddienstleister beschränkt sein.

Live-Tarife erscheinen nicht: Schalten Sie das Debug log ein, laden Sie die Kasse neu und sehen Sie sich das Feld Log auf der Modulseite an. Es nennt den Grund: kein API-Schlüssel; kein Wechselkurs für einen Shop, dessen Standardwährung nicht MXN ist; eine fehlende oder ungültige Postleitzahl; ein abgelehnter API-Schlüssel (DrEnvio HTTP 401 oder 403, prüfen Sie den API-Schlüssel); kein Estafeta-Tarif für die Strecke (das Protokoll listet die Versanddienstleister auf, die DrEnvio zurückgegeben hat); oder ein Tarif in einer anderen Währung als MXN.

Ist IVA im Preis enthalten? Das hängt von Ihrem DrEnvio-Konto ab. Wenn die DrEnvio-Preise IVA bereits enthalten, setzen Sie Tax auf No tax.

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

Die Seite meldet, dass der Versanddienstleister Estafeta nicht gefunden wurde: Der Versanddienstleister wurde unter Shipping > Carriers gelöscht. Setzen Sie das Modul unter Modules > Module Manager zurück, um ihn neu anzulegen. Dasselbe gilt für die Meldung The settings were saved, but the carrier could not be updated.

Die Bestellseite hat keinen Estafeta-Block: Der Block wird nur für Bestellungen mit dem Versanddienstleister Estafeta angezeigt, die aufgegeben wurden, während das Modul installiert war. Eine Deinstallation mit eingeschaltetem Remove data on uninstall löscht die gespeicherten Services.

Deinstallation

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

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