VibeFox Econt for OpenCart — Hilfe

Anforderungen

OpenCart: 3.0.x (getestet mit 3.0.5.0) oder 4.0.2 und neuer (getestet mit 4.1.0.3).

PHP: 8.0 oder neuer.

Länder: Bulgarien und Rumänien müssen unter System > Localisation > Countries aktiviert sein.

Econt: Es ist kein Vertrag und kein API-Schlüssel 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 Ihren Shop um eine Autorisierung bittet. Der e-Econt-Login ist auf der Entwicklerseite von Econt beschrieben (econt.com/developers).

VibeFox-Lizenzschlüssel: wird auf vibefox.net gekauft. Ein Schlüssel funktioniert auf einer Domain.

Installation

Der Download ist eine einzige ZIP-Datei mit den Paketen für beide OpenCart-Versionen. Entpacken Sie sie auf Ihrem Computer. Sie enthält README.txt, das OpenCart-3-Paket vfd_econt-oc3-(Version).ocmod.zip und das OpenCart-4-Paket vfd_econt.ocmod.zip. Installieren Sie nur das Paket für Ihre OpenCart-Version. Der Lizenzschlüssel ist für beide Versionen gleich.

OpenCart 3

1. Gehen Sie im Administrationsbereich zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei vfd_econt-oc3-(Version).ocmod.zip. Die Erweiterung fügt keine OCMOD-Modifikationen hinzu, daher müssen Sie Extensions > Modifications nicht aktualisieren. Statt des Installers können Sie den Inhalt des Ordners upload aus diesem Paket auch in das Stammverzeichnis Ihres Shops kopieren.

2. Gehen Sie zu Extensions > Extensions und wählen Sie den Erweiterungstyp Shipping. Suchen Sie VibeFox Econt und klicken Sie auf Install (die grüne +-Schaltfläche).

3. Klicken Sie auf Edit (die Stift-Schaltfläche), um die Einstellungsseite zu öffnen.

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

5. Legen Sie die Preise je Land fest und prüfen Sie die übrigen Optionen (siehe Configuration), aktivieren Sie Enable/Disable und klicken Sie auf Save. Klicken Sie auf Load offices from Econt now, um die Verbindung zu testen.

OpenCart 4

1. Gehen Sie im Administrationsbereich zu Extensions > Installer, klicken Sie auf Upload und wählen Sie die Datei vfd_econt.ocmod.zip. Benennen Sie die Datei nicht um: OpenCart 4 übernimmt den Erweiterungscode aus dem Dateinamen, und ein umbenanntes Paket funktioniert nicht.

2. Das Paket erscheint auf derselben Seite in der Liste der installierten Erweiterungen. Klicken Sie daneben auf Install (die grüne +-Schaltfläche).

3. Gehen Sie zu Extensions > Extensions und wählen Sie den Erweiterungstyp Shipping. Suchen Sie VibeFox Econt, klicken Sie auf Install (die grüne +-Schaltfläche) und danach auf Edit (die Stift-Schaltfläche).

4. Geben Sie den Lizenzschlüssel und die Einstellungen wie in den Schritten 4 und 5 für OpenCart 3 ein. Die Einstellungsseite und ihre Felder sind in beiden Versionen gleich.

Nach der Installation ist die Methode ausgeschaltet, bis Sie Enable/Disable aktivieren und speichern. Wenn Sie die Erweiterung nach einer Deinstallation erneut installieren, werden die aufbewahrten Einstellungen wieder verwendet.

Konfiguration

Alle Einstellungen befinden sich auf der Seite der Erweiterung: Extensions > Extensions > Shipping > VibeFox Econt > Edit. Die Abschnitte sind links aufgelistet. Eine Schaltfläche Save speichert die gesamte Seite ohne Neuladen. Nur Administratoren mit der Bearbeitungsberechtigung für diese Erweiterung können die Einstellungen speichern, die Filialen laden oder das Protokoll leeren.

Oben auf der Seite zeigt die Erweiterung Warnungen an: Die Demo-API ist aktiviert, für Bulgarien oder Rumänien ist kein Preis festgelegt (die Methode wird dann nie angezeigt), die letzte Filialabfrage für ein Land ist fehlgeschlagen, oder Ihr Shop hat keine Gewichtsklasse mit der Einheit kg (Produktgewichte werden dann anhand ihres Einheitennamens gelesen: kg, g, lb oder oz). Zahlenfelder akzeptieren ein Dezimalkomma, zum Beispiel 5,99. Enthält ein Zahlenfeld etwas, das keine Zahl oder keine negative Zahl ist, oder ist Minimum weight (kg) größer als Maximum weight (kg), nennt eine Fehlermeldung das Feld und es wird nichts gespeichert. Dasselbe gilt für einen leeren Name oder einen mit mehr als 64 Zeichen, eine Sort order, die keine ganze Zahl ist, oder eine unbekannte Steuerklasse oder Geo-Zone.

Allgemein

Enable/Disable: zeigt die Econt-Lieferung an der Kasse an oder blendet sie aus. Standard: aus.

Name: der Name der Versandart, der im Warenkorb und an der Kasse angezeigt wird. Standard: Econt Express. Pflichtfeld, höchstens 64 Zeichen.

Sort order: die Position unter den Versandarten an der Kasse. Eine ganze Zahl.

Tax class: die Steuerklasse des Versandpreises oder --- None --- (Standard). OpenCart fügt diese Steuer auf die unten stehenden Preise auf. Mit --- None --- sind die Preise endgültig.

Econt-Filialliste

Filialen und Econtomats werden über die Econt-API geladen und 24 Stunden zwischengespeichert.

Demo API: verwendet die Demo-API von Econt mit Testdaten. Lassen Sie sie in einem Live-Shop ausgeschaltet. Demo-Filialen haben andere IDs als die echten. Im Demomodus wird das öffentliche Testkonto von Econt verwendet, wenn kein Login eingestellt ist.

Econt username: optional. Ihr e-Econt-Login für die HTTP-Basisauthentifizierung.

Econt password: optional. Wird in der Datenbank des Shops 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.

Remove the saved password: aktivieren Sie die Option und klicken Sie auf Save, um das gespeicherte Passwort 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 für Bulgarien und Rumänien sofort neu und zeigt das Ergebnis je Land an. Schlägt ein Laden fehl, bleiben die Filialen des letzten erfolgreichen Ladevorgangs erhalten. Ohne diese Schaltfläche wird die Liste beim ersten Checkout automatisch geladen. Wenn Sie Demo API, den Benutzernamen oder das Passwort ändern, werden die zwischengespeicherten Listen gelöscht.

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: an.

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 Steuer. Die Erweiterung fragt bei Econt keine aktuellen Kurse ab. Bulgarien verwendet seit dem 1. Januar 2026 den Euro, daher geben bulgarische Shops in der Regel 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 (dies sind die Standardwerte). Ein Dezimalkomma ist ebenfalls möglich: BG:5,99. Ein Preis von 0 bedeutet kostenlose Lieferung. Ist das Feld leer, werden die Standardpreise BG:5.99 und RO:8.99 verwendet. Einträge in einem anderen Format werden ignoriert und beim Speichern in einer Warnung aufgeführt. Der Rest wird gespeichert.

Calculation: Per order (Standard) 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 die Methode dort aus.

Bedingungen

Warenkorb-Zwischensumme bedeutet die Produkte, die versendet werden müssen, nach dem Gutschein und vor der Steuer.

Free shipping from: die Warenkorb-Zwischensumme, ab der die Lieferung kostenlos ist. Leer lassen, um nie kostenlose Lieferung anzubieten.

Minimum subtotal: zeigt die Methode nur, wenn die Warenkorb-Zwischensumme mindestens diesen Betrag erreicht. Leer lassen, um sie immer anzuzeigen.

Minimum weight (kg): blendet die Methode bei leichteren Warenkörben aus. Produktgewichte werden von ihrer Gewichtsklasse in kg umgerechnet. Leer lassen für keine Begrenzung.

Maximum weight (kg): blendet die Methode bei schwereren Warenkörben aus. Leer lassen für keine Begrenzung.

Verfügbarkeit

Econt liefert nur nach Bulgarien und Rumänien. Normalerweise entscheidet die Geo-Zone, wo die Methode angeboten wird; mit Ignore geo zone entscheiden stattdessen die ausgewählten Länder.

Geo zone: bietet Econt nur für Adressen in dieser Geo-Zone an. All Zones (Standard) bedeutet überall in Bulgarien und Rumänien. Geo-Zonen werden unter System > Localisation > Geo Zones verwaltet. Die Geo-Zone wird bei Ignore geo zone nicht verwendet.

Ignore geo zone: die Geo-Zone wird nicht geprüft. Econt wird in den unten genannten Ländern angeboten, unabhängig davon, ob die Adresse in der Geo-Zone liegt.

Countries: Bulgarien und/oder Rumänien. Wird nur mit Ignore geo zone verwendet. Ist kein Land ausgewählt, gelten alle Econt-Länder.

Erweitert

Debug log: schreibt Debug-Meldungen in storage/logs/vfd_ecn_debug.log.php (in OpenCart 4 system/storage/logs/vfd_ecn_debug.log.php). Die Datei kann nicht über das Web gelesen werden. Erreicht sie 5 MB, wird ein neues Protokoll begonnen. API-Fehler und Warnungen (Econt nicht erreichbar, keine Filialen, eine Bestellung ohne Filiale) 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 aktiviert, löscht die Deinstallation der Erweiterung die Econt-Einstellungen, das Protokoll und die Auswahl nicht abgeschlossener Checkouts. Ist sie aus, bleiben die Einstellungen für eine erneute Installation erhalten. In Bestellungen gespeicherte Filialen bleiben immer erhalten.

Import / Export

Export: Klicken Sie auf Download JSON, um die Einstellungen als JSON-Datei zu speichern. Das Passwort wird nicht exportiert.

Import: Fügen Sie zuvor exportiertes JSON ein und klicken Sie auf Import, um die Einstellungen wiederherzustellen, zum Beispiel in einem anderen Shop. Die Werte werden wie bei einem normalen Speichern geprüft. Das gespeicherte Passwort bleibt erhalten.

So funktioniert es an der Kasse

Die Methode wird nur für Bulgarien und Rumänien angeboten. Wenn OpenCart die Versandarten anzeigt, fragt es die Erweiterung nach dem Econt-Preis. Mit Ignore geo zone wird die Geo-Zone nicht geprüft, und die Methode wird nur für die ausgewählten Countries angeboten (keines ausgewählt = Bulgarien und Rumänien). Andernfalls muss die Adresse in einer festgelegten Geo zone liegen. Nur Produkte mit Requires Shipping auf Yes zählen: andere Produkte erhöhen das Gewicht nicht und sind nicht in der Zwischensumme enthalten. Die Erweiterung prüft die Gewichtsgrenzen und die Mindestzwischensumme und nimmt dann den Preis für das Land. Erreicht die Warenkorb-Zwischensumme Free shipping from, beträgt der Preis 0. Ist für das Land keine Filialliste verfügbar, wird die Methode ausgeblendet, weil die Lieferung immer an eine Filiale geht. Der Preis wird in Ihrer Standardwährung berechnet und dem Kunden in seiner Währung mit der Steuer der gewählten Tax class angezeigt.

Wenn der Kunde Econt auswählt, erscheinen unter der Methode zwei Listen: City und Office / Econtomat. Die Filialliste wird pro Seite einmal geladen, nur wenn Econt ausgewählt ist. Econtomats sind in der Liste markiert. Die Auswahl wird sofort gespeichert. Kann die Filialliste nicht geladen werden, sieht der Kunde die Meldung Econt offices cannot be loaded right now. Please try again in a few minutes or choose another shipping method.

Klickt der Kunde im Schritt der Versandart auf Continue, prüft die Erweiterung auf dem Server, ob eine Filiale gewählt wurde und ob sie in der Econt-Liste für das Lieferland existiert (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.

Auf OpenCart 4 klickt der Kunde im Versandart-Block der Kassenseite auf Choose und wählt Econt im Fenster Shipping method options. Die Listen City und Office / Econtomat erscheinen in diesem Fenster unter der Methode und funktionieren wie oben beschrieben. Die Schaltfläche Continue des Fensters geht ohne gültige Filiale nicht weiter, mit denselben Meldungen.

Die Filialliste wird 24 Stunden zwischengespeichert, getrennt für die Live- und die Demo-API und für jedes Land. Ist Econt nicht erreichbar, wird die letzte korrekte Liste verwendet, und Econt wird 10 Minuten lang nicht erneut abgefragt. Das Zeitlimit der API beträgt 15 Sekunden. Die Filialliste stammt von https://ee.econt.com/services/ (live) oder https://demo.econt.com/ee/services/ (Demo).

Die Erweiterung verwendet nur feste Preise. Sie fragt bei Econt keine aktuellen Preise ab, erstellt keine Frachtbriefe oder Etiketten, beauftragt keine Kuriere, verfolgt keine Pakete, übernimmt keine Nachnahmezahlung und liefert nicht an eine Adresse. Nur Bulgarien und Rumänien haben eine Filialliste.

Abholpunkte

Bei der Bestellung wird die an der Kasse gewählte Filiale mit der Bestellung gespeichert: die Stadt, der Filialname und die Adresse sowie der Econt-Filialcode. Verwenden Sie den Filialcode, wenn Sie den Versand in e-Econt erstellen.

Kunde: die Filiale wird der Versandart der Bestellung hinzugefügt, zum Beispiel Econt Express - Econt office / Econtomat: city, office (address) (höchstens 128 Zeichen; in OpenCart 4 wird der Text nicht gekürzt). So erscheint sie in der Bestellhistorie des Kunden, in den Bestell-E-Mails, auf der Rechnung und im Administrationsbereich. OpenCart 4 behält für die Kasse eine einzige Bestellung und aktualisiert sie jedes Mal, wenn der Kunde erneut bestätigt; die Filiale der Bestellung wird dabei mit aktualisiert.

Bestellseite im Administrationsbereich: unter Sales > Orders zeigt das Feld Econt office / Econtomat über dem Verlauf die Filiale und ihren Filialcode an, auch wenn die Methode später deaktiviert wird. Wählen Sie unter Change eine andere Stadt und Filiale des Landes der Bestellung und klicken Sie auf Save. Das Feld zeigt Saved., der Text der Versandart der Bestellung wird aktualisiert, und ein Hinweis im Bestellverlauf (nicht an den Kunden gesendet) hält die alte und die neue Filiale fest. Klicken Sie auf Save, ohne eine Filiale zu wählen, zeigt das Feld Select a city and an office first - nothing was changed. Eine Filiale, die nicht in der Liste für das Land der Bestellung steht, wird mit The selected Econt office is not available for the shipping country - nothing was changed. abgelehnt. Jeder Administrator mit der Bearbeitungsberechtigung für Bestellungen kann die Filiale ändern; Zugriff auf die Einstellungen der Erweiterung ist nicht nötig. Kann die Filialliste nicht geladen werden, zeigt das Feld Econt offices cannot be loaded right now. Eine Bestellung ohne Filiale zeigt No Econt office is saved for this order., und das Protokoll enthält dafür einen Fehler.

Filialnamen werden in der Landessprache angezeigt (kyrillisch für Bulgarien), wenn die Shopsprache Bulgarisch oder Rumänisch ist, und sonst auf Englisch.

Lizenzschlüssel

Die Erweiterung funktioniert mit einem VibeFox-Lizenzschlüssel von vibefox.net. Der Lizenzblock License — VibeFox Econt ist der erste Block auf Extensions > Extensions > Shipping > VibeFox Econt > Edit, über den Einstellungen. Tragen 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 aktiv ist, und Ihre Domain) sowie die Schaltflächen Check now zur erneuten Statusprüfung, Change key zur Eingabe eines anderen Schlüssels und Remove key zum Entfernen des Schlüssels aus diesem Shop. Darunter stehen die Zeile Product: opencart-shipping-econt und der Link Manage licenses and domains in your account, der Ihr vibefox.net-Konto öffnet. Nur Administratoren mit der Berechtigung Modify für die Erweiterung können den Schlüssel ändern. Die Texte des Blocks folgen der Administratorsprache (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 Shopadresse oder nachdem Sie in Ihrem Konto einen Domainplatz freigegeben haben, klicken Sie auf Check now. Ist der Lizenzserver nicht erreichbar, arbeitet die Erweiterung mit dem zuletzt bekannten Status weiter.

Ein Schlüssel funktioniert auf einer Domain: der Shopadresse aus der OpenCart-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 einen aktiven Schlüssel wird die Econt-Versandart Kunden an der Kasse nicht angezeigt, und es wird kein Tarif berechnet. Ein Administrator, der im Administrationsbereich im selben Browser angemeldet ist, sieht die Methode weiterhin im Shop, markiert mit (unlicensed — visible to admins only), sodass Sie die Erweiterung vor dem Kauf eines Schlüssels einrichten und testen können. Auf OpenCart 4 ist diese Vorschau nicht verfügbar: Der Shop sieht die Administrator-Anmeldung nicht, daher ist die Methode ohne aktiven Schlüssel für alle ausgeblendet. Nachdem Sie die Seite Edit einmal geöffnet haben, erscheint ein Hinweis auf dem Dashboard des Administrationsbereichs. Schließen Sie ihn mit ×, um ihn 7 Tage lang auszublenden. Bestehende Bestellungen sind nicht betroffen.

Läuft eine Lizenz ab, arbeitet die Erweiterung weiter, Updates und Support benötigen jedoch eine Verlängerung. Der Status wird beim Öffnen des Dashboard des Administrationsbereichs oder der Seite Edit 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. Die Deinstallation der Erweiterung entfernt immer den Lizenzschlüssel und den Lizenzstatus.

Fehlerbehebung

Econt erscheint nicht an der Kasse: Prüfen Sie, ob die Lizenz aktiv ist und Enable/Disable eingeschaltet ist, und ob das Lieferland Bulgarien oder Rumänien ist (aktiviert unter System > Localisation > Countries). Prüfen Sie Geo zone (oder Ignore geo zone und Countries), ob für das Land ein Preis festgelegt ist, die Gewichtsgrenzen und Minimum subtotal. Prüfen Sie in den Einstellungen die Zeile Office list: Die Methode wird ausgeblendet, solange für das Land keine Filialliste verfügbar ist. Prüfen Sie, ob die Produkte Requires Shipping auf Yes haben.

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 ins Protokoll geschrieben; aktivieren Sie Debug log für mehr Details und sehen Sie sich das Feld Log an. Verlangt Econt für Ihren Shop eine Autorisierung, tragen Sie Econt username und Econt password ein.

Kunden sehen Testfilialen: Demo API ist aktiviert. Schalten Sie sie in einem Live-Shop aus.

In welcher Währung sind die Preise? In der Standardwährung Ihres Shops, ohne Steuer. Kunden sehen sie in ihrer Währung.

Die Steuer wird auf den Preis aufgeschlagen: Eine Steuerklasse ist ausgewählt. Stellen Sie Tax class auf --- None ---, wenn Ihre Preise die Mehrwertsteuer bereits enthalten.

Die Seite zeigt „Warning: You do not have permission to modify VibeFox Econt!“: Ihre Administrator-Benutzergruppe darf die Einstellungen nur ansehen. Geben Sie der Gruppe die Bearbeitungsberechtigung für extension/shipping/vfd_econt (OpenCart 3) oder extension/vfd_econt/shipping/vfd_econt (OpenCart 4) unter System > Users > User Groups.

Deinstallation

Gehen Sie zu Extensions > Extensions, wählen Sie den Typ Shipping und klicken Sie neben VibeFox Econt auf Uninstall (die rote −-Schaltfläche). Der Lizenzschlüssel und der Lizenzstatus dieser Erweiterung werden immer entfernt. OpenCart setzt Enable/Disable, Sort order, Tax class und Geo zone immer zurück. Die Erweiterung entfernt immer ihre Ereignisse und die zwischengespeicherten Filiallisten. Ist Remove data on uninstall aktiviert, werden auch die übrigen Einstellungen, das Protokoll und die Auswahl nicht abgeschlossener Checkouts gelöscht. Ist die Option aus, bleiben die Einstellungen erhalten und werden bei einer erneuten Installation wieder verwendet. In Bestellungen gespeicherte Filialen bleiben immer erhalten, und bestehende Bestellungen behalten ihre Versandart und ihre Kosten.

Um auf OpenCart 4 auch die Dateien der Erweiterung zu entfernen, gehen Sie nach der Deinstallation zu Extensions > Installer und klicken neben VibeFox Econt in der Liste der installierten Erweiterungen auf Uninstall (die orangefarbene −-Schaltfläche) und danach auf Delete (die rote Papierkorb-Schaltfläche), um das hochgeladene Paket zu entfernen.

Econt ist eine Marke ihres jeweiligen Inhabers. Diese Erweiterung ist nicht mit Econt verbunden und wird nicht von Econt unterstützt.