VibeFox Econt 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.
Econt: Ein Econt-Vertrag oder ein API-Schlüssel ist nicht nötig. Die Filialliste ist ein öffentliches Verzeichnis von Econt. Nur der Ländercode wird an Econt gesendet, keine Kundendaten. Tragen Sie einen e-Econt-Benutzernamen und ein Passwort nur ein, wenn Econt von Ihrem Shop eine Autorisierung verlangt. Der e-Econt-Login wird auf der Entwicklerseite von Econt beschrieben (econt.com/developers).
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 aus.
2. Wenn der Upload abgeschlossen ist, klicken Sie auf Configure, oder suchen Sie später VibeFox Econt in der Modulliste und klicken Sie auf Configure.
3. Tragen Sie Ihren VibeFox-Lizenzschlüssel unter License key im Lizenzblock oben auf der Seite Configure ein und klicken Sie auf Activate (siehe Lizenzschlüssel).
4. Legen Sie die Preise je Land fest und prüfen Sie die übrigen Optionen (siehe Konfiguration), dann klicken Sie auf Save. Klicken Sie auf Load offices from Econt now, um die Verbindung zu testen.
Bei der Installation legt das Modul den Versanddienst Econt Express mit dem Lieferzeittext Delivery to an Econt office or Econtomat an. Der Versanddienst wird den Zonen Bulgariens und Rumäniens sowie 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 aus dem Modul.
Konfiguration
Alle Einstellungen befinden sich auf der Modulseite: Modules > Module Manager > VibeFox Econt > Configure. Jeder Abschnitt hat eine eigene Schaltfläche Save, die die ganze Seite speichert. Preis und Bedingungen gelten für alle Zonen des Versanddienstes.
Oben auf der Seite zeigt das Modul Warnungen an: Der Econt-Versanddienst wurde nicht gefunden, die Demo-API ist aktiv, für Bulgarien oder Rumänien ist kein Preis festgelegt (der Versanddienst wird dann nie angezeigt), die letzte Filialabfrage für ein Land ist fehlgeschlagen, oder die Gewichtseinheit Ihres Shops ist dem Modul nicht bekannt (Gewichte werden dann als kg behandelt; stellen Sie die Einheit unter International > Localization, Local units ein). Zahlenfelder akzeptieren ein Dezimalkomma, zum Beispiel 5,99. Wenn ein Zahlenfeld etwas enthält, das keine Zahl oder keine negative Zahl ist, oder Minimum weight (kg) größer als Maximum weight (kg) ist, nennt eine Fehlermeldung das Feld und nichts wird gespeichert.
General
Enable/Disable: schaltet die Econt-Zustellung ein oder aus. Dies ist derselbe Schalter wie der Status des Versanddienstes unter Shipping > Carriers.
Name: der Name des Versanddienstes, der im Warenkorb und an der Kasse angezeigt wird. Standard: Econt Express. Pflichtfeld, höchstens 64 Zeichen.
Tax: die Steuerregel des Versanddienstes oder No tax. PrestaShop schlägt diese Steuer auf die unten stehenden Preise auf. Mit No tax sind die Preise endgültig.
Econt-Filialliste
Filialen und Econtomaten werden über die Econt-API geladen und 24 Stunden zwischengespeichert.
Demo API: nutzt die Demo-API von Econt mit Testdaten. Lassen Sie sie in einem Live-Shop ausgeschaltet. Demo-Filialen haben andere IDs als die echten. Im Demo-Modus wird das öffentliche Testkonto von Econt verwendet, wenn kein Login eingestellt ist.
Econt username: optional. Ihr e-Econt-Login für die HTTP-Basic-Autorisierung.
Econt password: optional. Wird in der Shop-Datenbank gespeichert und nie in das Protokoll geschrieben. 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. Setzen Sie den Haken bei Remove the saved password und speichern Sie, um ihn zu löschen.
Office list: zeigt, wie viele Filialen je Land zwischengespeichert sind und wann sie geladen wurden. Die Schaltfläche Load offices from Econt now lädt die Listen sofort neu und zeigt das Ergebnis je Land. Schlägt ein Ladevorgang fehl, bleiben die Filialen des letzten erfolgreichen Ladevorgangs erhalten. Ohne diese Schaltfläche wird die Liste bei der ersten Kasse automatisch geladen. Eine Änderung von Demo API, des Benutzernamens oder des Passworts löscht die zwischengespeicherten Listen.
Filialauswahl an der Kasse
Show: welche Punkte Kunden auswählen können.
City order: zeigt die größten Städte zuerst (Sofia, Plovdiv, Varna, Bukarest und andere). Ist die Option aus, werden die Städte alphabetisch sortiert. Standard: ein.
City list width: die CSS-Breite der Städteliste, zum Beispiel 100% oder 300px. Standard: 100%.
Office list width: die CSS-Breite der Filialliste, zum Beispiel 100% oder 400px. Standard: 100%.
Preise (der Abschnittstitel zeigt die Standardwährung Ihres Shops)
Die Preise gelten in der Standardwährung Ihres Shops, ohne Steuern. Das Modul fragt bei Econt keine aktuellen Kurse ab. Bulgarien verwendet seit dem 1. Januar 2026 den Euro, daher geben bulgarische Shops normalerweise Preise in EUR ein.
Price per country: ein Land pro Zeile (oder durch Kommas getrennt): Ländercode, Doppelpunkt, Preis, zum Beispiel BG:5.99 und RO:8.99 (das sind die Standardwerte). Ein Dezimalkomma ist ebenfalls möglich: BG:5,99. Ein Preis von 0 bedeutet kostenlose Zustellung. Ist das Feld leer, werden die Standardpreise BG:5.99 und RO:8.99 verwendet (bei Ignore zones erhalten Länder außerhalb der Versanddienst-Zonen dann keinen Preis). Einträge in einem anderen Format werden ignoriert und beim Speichern in einer Warnung aufgelistet. Der Rest wird gespeichert.
Calculation: Per order berechnet den Preis einmal. Per item (price x quantity) multipliziert ihn mit der Anzahl der Artikel, die versendet werden müssen.
Price for other countries: wird für ein Econt-Land (Bulgarien oder Rumänien) verwendet, das oben nicht aufgeführt ist. Leer oder 0 blendet den Versanddienst dort aus.
Bedingungen
Warenkorb-Zwischensumme bedeutet die Produkte, die versendet werden müssen, nach Rabatten und vor Steuern.
Free shipping from: die Warenkorb-Zwischensumme, ab der die Zustellung kostenlos ist. Leer lassen, um nie kostenlose Zustellung anzubieten.
Minimum subtotal: den Versanddienst nur anzeigen, wenn die Warenkorb-Zwischensumme mindestens diesen Betrag erreicht. Leer lassen, um ihn immer anzuzeigen.
Minimum weight (kg): den Versanddienst bei leichteren Warenkörben ausblenden. Produktgewichte werden von der Gewichtseinheit Ihres Shops in kg umgerechnet. Leer lassen für keine Grenze.
Maximum weight (kg): den Versanddienst bei schwereren Warenkörben ausblenden. Leer lassen für keine Grenze.
Verfügbarkeit ohne Versandzonen
Ignore zones: Econt auch in den unten genannten Ländern anbieten, wenn die Zone der Lieferadresse nicht mit dem Versanddienst verknüpft ist. Wenn Sie es einschalten, wird der Versanddienst mit jeder aktiven Zone verknüpft, und auch später angelegte Zonen werden verknüpft. Wenn Sie es wieder ausschalten, erhält der Versanddienst die Zonen zurück, die er vorher hatte. Verknüpfte Zonen funktionieren weiterhin wie gewohnt. Econt wird weiterhin nur für Bulgarien und Rumänien angeboten.
Countries: Bulgarien und/oder Rumänien. Wird nur mit Ignore zones verwendet. Ist nichts angehakt, gelten alle Econt-Länder, in die der Shop liefert.
Erweitert
Debug log: schreibt Debug-Meldungen in logs/vfd_ecn_debug.log.php im Modulordner. Die Datei lässt sich nicht über den Webbrowser öffnen. API-Fehler werden immer protokolliert. Es werden keine Passwörter und keine Kundendaten geschrieben.
Log: zeigt die Größe und die neuesten Einträge des Protokolls. Klicken Sie auf Clear log, um es zu leeren.
Remove data on uninstall: Ist die Option eingeschaltet, löscht die Deinstallation des Moduls die Econt-Einstellungen, den Versanddienst und das Protokoll. Ist sie aus, bleiben die Einstellungen für eine erneute Installation erhalten. Filialen in Bestellungen bleiben immer erhalten.
So funktioniert es an der Kasse
Der Versanddienst wird nur für Bulgarien und Rumänien angeboten. Im Versandschritt fragt PrestaShop das Modul nach dem Econt-Preis. Nur physische Produkte zählen: Virtuelle Produkte haben kein Gewicht und sind nicht in der Zwischensumme enthalten. Das Modul prüft die Gewichtsgrenzen und die Mindestzwischensumme und übernimmt dann den Preis für das Land. Erreicht die Warenkorb-Zwischensumme Free shipping from, beträgt der Preis 0. Gibt es für das Land keine Filialliste, wird der Versanddienst ausgeblendet, weil die Zustellung immer an eine Filiale erfolgt. Der Preis wird in der Standardwährung berechnet und dann in der Warenkorbwährung des Kunden angezeigt.
Wählt der Kunde Econt, erscheinen unter dem Versanddienst zwei Listen: City und Office / Econtomat. Die Filialliste wird pro Seite nur einmal geladen, und zwar nur dann, wenn Econt ausgewählt ist. Econtomaten sind in der Liste markiert. Die Auswahl wird sofort im Warenkorb gespeichert. Kann die Filialliste nicht geladen werden, sieht der Kunde Econt offices cannot be loaded right now. Please try again in a few minutes or choose another shipping method.
Klickt der Kunde im Versandschritt auf Continue, prüft das Modul auf dem Server, ob eine Filiale ausgewählt ist und ob sie in der Econt-Liste für das Lieferland vorhanden ist (gefiltert nach Show). Ohne Filiale sieht der Kunde Please select an Econt office or Econtomat. Eine Filiale, die nicht in der Liste steht, wird mit The selected Econt office is not available for the shipping country. Please select it again. abgelehnt. Der Filialname wird immer aus der Econt-Liste übernommen, nicht aus dem Browser. Die Auswahl funktioniert mit dem Classic-Theme und mit Hummingbird.
Die Filialliste wird 24 Stunden zwischengespeichert, getrennt für die Live- und die Demo-API. Ist Econt nicht erreichbar, wird die letzte funktionierende Liste verwendet, und Econt wird 10 Minuten lang nicht erneut abgefragt. Das API-Zeitlimit beträgt 15 Sekunden. Die Filialliste stammt von https://ee.econt.com/services/ (Live) bzw. https://demo.econt.com/ee/services/ (Demo).
Wenn Sie den Versanddienst unter Shipping > Carriers bearbeiten, nachdem er Bestellungen hat, speichert PrestaShop ihn als neue Version des Versanddienstes. Das Modul folgt der neuen Version automatisch.
Das Modul verwendet nur feste Preise. Es fragt bei Econt keine aktuellen Preise ab, erstellt keine Frachtbriefe oder Etiketten, bestellt keine Kuriere, verfolgt keine Sendungen, übernimmt keine Nachnahme und liefert nicht an eine Adresse. Nur Bulgarien und Rumänien haben eine Filialliste.
Abholpunkte
Bei der Bestellung wird die für den Warenkorb gewählte Filiale mit der Bestellung gespeichert: die Stadt, der Filialname und die Adresse sowie der Econt-Filialcode. Verwenden Sie den Filialcode, wenn Sie die Sendung in e-Econt erstellen.
Bestellseite im Back-Office: ein Block Econt office / Econtomat zeigt die Filiale und den Office code. Unter Change wählen Sie eine andere Stadt und Filiale im Land der Bestellung und klicken auf Save. Die Änderung wird sofort gespeichert, und eine private Bestellnachricht hält die alte und die neue Filiale fest. Klicken Sie auf Save, ohne eine Filiale zu wählen, steht im Block Select a city and an office first - nothing was changed. Jeder Mitarbeiter, der Bestellungen bearbeiten darf, kann die Filiale ändern; dafür ist kein Zugriff auf die Modulseite nötig. Kann die Filialliste nicht geladen werden, zeigt der Block Econt offices cannot be loaded right now.
Mehrere Bestellungen aus einem Warenkorb: Die Filiale gehört zur ersten Bestellung. Eine weitere Bestellung aus demselben Warenkorb erhält keine Filiale: Im Protokoll wird ein Fehler geschrieben, und ihr Block sagt, dass die Filiale dieses Warenkorbs zu einer anderen Bestellung gehört. Vereinbaren Sie die Filiale mit dem Kunden und erstellen Sie die Sendung manuell in e-Econt.
Kunde: Die Filiale wird auf der Bestellseite des Kunden und auf der Bestellbestätigungsseite angezeigt. Sie wird dem Namen des Versanddienstes in der Bestellbestätigungs-E-Mail und in der E-Mail über neue Bestellungen an den Shop hinzugefügt.
Filialnamen werden in der Landessprache angezeigt (kyrillisch für Bulgarien), wenn die Shop-Sprache Bulgarisch oder Rumänisch ist, sonst auf Englisch.
Lizenzschlüssel
Das Modul arbeitet mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox Econt ist der erste Block unter Modules > Module Manager > VibeFox Econt > Configure, über den Einstellungen. Tragen Sie den Schlüssel unter 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-econt 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. Nach einer Änderung der Shop-Adresse oder nachdem Sie einen Domain-Platz in Ihrem Konto freigegeben haben, klicken Sie auf Check now. Ist der Lizenzserver nicht erreichbar, arbeitet das Modul mit dem zuletzt bekannten Status weiter.
Ein Schlüssel funktioniert für eine Domain: die Domain des Hauptshops, auch bei einer Multistore-Installation. 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 aktiven Schlüssel wird der Econt-Versanddienst Kunden an der Kasse nicht angezeigt, und es wird kein Tarif berechnet. Das PrestaShop-Storefront weiß nicht, dass Sie im Back-Office angemeldet sind, daher wird der Versanddienst 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 dem Reiter Alerts. Bestehende Bestellungen sind nicht betroffen.
Läuft eine Lizenz ab, arbeitet das Modul weiter, aber Updates und Support erfordern eine Verlängerung. Der Status wird während der 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. Das Deinstallieren oder Zurücksetzen des Moduls entfernt immer den Lizenzschlüssel und den Lizenzstatus.
Fehlerbehebung
Econt erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv ist, Enable/Disable eingeschaltet ist und das Lieferland Bulgarien oder Rumänien ist. Prüfen Sie unter Shipping > Carriers, ob der Versanddienst die Zone des Kundenlandes und die Kundengruppe abdeckt (oder schalten Sie Ignore zones ein und prüfen Sie Countries). Prüfen Sie, ob für das Land ein Preis festgelegt ist, die Gewichtsgrenzen und Minimum subtotal. Prüfen Sie die Zeile Office list in den Einstellungen: Der Versanddienst wird ausgeblendet, solange für das Land keine Filialliste verfügbar ist. Produkte können auch auf der Produktseite auf bestimmte Versanddienste beschränkt sein.
Die Filialliste wird nicht geladen: Klicken Sie auf Load offices from Econt now und lesen Sie das Ergebnis oder die Warnung oben auf der Einstellungsseite. Fehler werden immer im Protokoll festgehalten; schalten Sie Debug log für mehr Details ein und sehen Sie im Feld Log nach. Verlangt Econt eine Autorisierung für Ihren Shop, tragen Sie Econt username und Econt password ein.
Kunden sehen Testfilialen: Demo API ist eingeschaltet. Schalten Sie es in einem Live-Shop aus.
In welcher Währung sind die Preise? In der Standardwährung Ihres Shops, ohne Steuern. Kunden sehen sie in der Warenkorbwährung.
Auf den Preis wird Steuer aufgeschlagen: Der Versanddienst hat eine Steuerregel. Setzen Sie Tax auf No tax, wenn Ihre Preise die MwSt. bereits enthalten.
Die Seite meldet, dass der Econt-Versanddienst nicht gefunden wurde: Der Versanddienst wurde unter Shipping > Carriers gelöscht. Setzen Sie das Modul unter Modules > Module Manager zurück, um ihn erneut anzulegen.
Deinstallation
Gehen Sie zu Modules > Module Manager, öffnen Sie das Menü neben VibeFox Econt und wählen Sie Uninstall. Der Lizenzschlüssel und der Lizenzstatus werden immer entfernt. Die zwischengespeicherten Filiallisten werden immer entfernt. Ist Remove data on uninstall eingeschaltet, wird der Versanddienst gelöscht (Bestellungen behalten ihren Verlauf), und die Einstellungen und das Protokoll werden entfernt. Ist die Option aus, wird der Versanddienst nur deaktiviert und alle Einstellungen bleiben erhalten. Wird das Modul erneut installiert, wird der gespeicherte Versanddienst mit dem vorherigen Status wiederhergestellt. Das Zurücksetzen des Moduls behält den aktuellen Status des Versanddienstes. Filialen in Bestellungen bleiben immer erhalten.
Econt ist eine Marke ihres jeweiligen Inhabers. Dieses Modul ist nicht mit Econt verbunden und wird von Econt nicht unterstützt.