VibeFox Econt for OpenCart — Aide

Prérequis

OpenCart : 3.0.x (testé avec 3.0.5.0) ou 4.0.2 et ultérieur (testé avec 4.1.0.3).

PHP : 8.0 ou ultérieur.

Pays : la Bulgarie et la Roumanie doivent être activées dans System > Localisation > Countries.

Econt : aucun contrat ni clé API n'est nécessaire. La liste des bureaux est une nomenclature publique d'Econt. Seul le code pays est envoyé à Econt, aucune donnée client. Renseignez un identifiant et un mot de passe e-Econt uniquement si Econt demande à votre boutique une autorisation. La connexion e-Econt est décrite sur la page développeurs d'Econt (econt.com/developers).

Clé de licence VibeFox : achetée sur vibefox.net. Une clé fonctionne sur un seul domaine.

Installation

Le téléchargement est un seul fichier zip contenant les paquets pour les deux versions d'OpenCart. Décompressez-le sur votre ordinateur. Il contient README.txt, le paquet OpenCart 3 vfd_econt-oc3-(version).ocmod.zip et le paquet OpenCart 4 vfd_econt.ocmod.zip. N'installez que le paquet correspondant à votre version d'OpenCart. La clé de licence est la même pour les deux versions.

OpenCart 3

1. Dans l'administration, allez dans Extensions > Installer, cliquez sur Upload et choisissez le fichier vfd_econt-oc3-(version).ocmod.zip. L'extension n'ajoute aucune modification OCMOD : vous n'avez donc pas à actualiser Extensions > Modifications. Au lieu de l'installateur, vous pouvez aussi copier le contenu du dossier upload de ce paquet dans le dossier racine de votre boutique.

2. Allez dans Extensions > Extensions et choisissez le type d'extension Shipping. Repérez VibeFox Econt et cliquez sur Install (le bouton vert +).

3. Cliquez sur Edit (le bouton en forme de crayon) pour ouvrir la page des paramètres.

4. Saisissez votre clé de licence VibeFox dans License key, dans le bloc de licence en haut de la page Edit, puis cliquez sur Activate (voir License key).

5. Définissez les tarifs par pays et vérifiez les autres options (voir Configuration), activez Enable/Disable et cliquez sur Save. Cliquez sur Load offices from Econt now pour tester la connexion.

OpenCart 4

1. Dans l'administration, allez dans Extensions > Installer, cliquez sur Upload et choisissez le fichier vfd_econt.ocmod.zip. Ne renommez pas le fichier : OpenCart 4 prend le code de l'extension dans le nom du fichier, et un paquet renommé ne fonctionne pas.

2. Le paquet apparaît dans la liste des extensions installées, sur la même page. Cliquez sur Install (le bouton vert +) à côté.

3. Allez dans Extensions > Extensions et choisissez le type d'extension Shipping. Repérez VibeFox Econt, cliquez sur Install (le bouton vert +), puis sur Edit (le bouton en forme de crayon).

4. Saisissez la clé de licence et les paramètres comme aux étapes 4 et 5 pour OpenCart 3. La page des paramètres et ses champs sont les mêmes dans les deux versions.

Après l'installation, la méthode reste désactivée tant que vous n'avez pas activé Enable/Disable et enregistré. Si vous réinstallez l'extension après une désinstallation, les paramètres conservés sont de nouveau utilisés.

Configuration

Tous les paramètres se trouvent sur la page de l'extension : Extensions > Extensions > Shipping > VibeFox Econt > Edit. Les sections sont listées à gauche. Un bouton Save enregistre la page entière sans la recharger. Seuls les utilisateurs administrateurs disposant de l'autorisation de modification pour cette extension peuvent enregistrer les paramètres, charger les bureaux ou vider le journal.

En haut de la page, l'extension affiche des avertissements : l'API de démonstration est activée, aucun tarif n'est défini pour la Bulgarie ou la Roumanie (la méthode n'est alors jamais affichée), la dernière requête de bureaux pour un pays a échoué, ou votre boutique n'a pas de classe de poids avec l'unité kg (les poids des produits sont alors lus selon le nom de leur unité : kg, g, lb ou oz). Les champs numériques acceptent la virgule décimale, par exemple 5,99. Si un champ numérique contient autre chose qu'un nombre ou un nombre négatif, ou si Minimum weight (kg) est supérieur à Maximum weight (kg), une erreur indique le champ et rien n'est enregistré. Il en va de même pour un Name vide ou de plus de 64 caractères, un Sort order qui n'est pas un nombre entier, ou une classe de taxe ou une zone géographique inconnue.

Général

Enable/Disable : affiche ou masque la livraison Econt au paiement. Par défaut : désactivé.

Name : le nom du mode de livraison affiché dans le panier et au paiement. Par défaut : Econt Express. Obligatoire, 64 caractères maximum.

Sort order : la position parmi les modes de livraison au paiement. Un nombre entier.

Tax class : la classe de taxe du tarif de livraison, ou --- None --- (par défaut). OpenCart ajoute cette taxe aux tarifs ci-dessous. Avec --- None ---, les tarifs sont définitifs.

Liste des bureaux Econt

Les bureaux et les Econtomats sont chargés depuis l'API Econt et mis en cache pendant 24 heures.

Demo API : utilise l'API de démonstration d'Econt avec des données de test. Laissez-la désactivée sur une boutique en production. Les bureaux de démonstration ont des identifiants différents des vrais. En mode démonstration, le compte de test public d'Econt est utilisé si aucun identifiant n'est défini.

Econt username : facultatif. Votre identifiant e-Econt pour l'autorisation HTTP Basic.

Econt password : facultatif. Il est stocké dans la base de données de la boutique et n'est jamais écrit dans le journal. Après l'enregistrement, le champ reste vide et affiche Saved - leave empty to keep it. Saisissez une nouvelle valeur uniquement pour la modifier.

Remove the saved password : activez cette option et cliquez sur Save pour supprimer le mot de passe enregistré.

Office list : indique le nombre de bureaux mis en cache par pays et la date de leur chargement. Le bouton Load offices from Econt now recharge immédiatement les listes de la Bulgarie et de la Roumanie et affiche le résultat par pays. Si un chargement échoue, les bureaux du dernier chargement réussi sont conservés. Sans ce bouton, la liste est chargée automatiquement lors du premier paiement. Modifier Demo API, l'identifiant ou le mot de passe vide les listes en cache.

Sélecteur de bureau au paiement

Show : les points que les clients peuvent choisir.

City order : affiche d'abord les plus grandes villes (Sofia, Plovdiv, Varna, Bucarest et d'autres). Désactivé, les villes sont triées par ordre alphabétique. Par défaut : activé.

City list width : la largeur CSS de la liste des villes, par exemple 100% ou 300px. Par défaut : 100%.

Office list width : la largeur CSS de la liste des bureaux, par exemple 100% ou 400px. Par défaut : 100%.

Tarifs (le titre de la section affiche la devise par défaut de votre boutique)

Les tarifs sont exprimés dans la devise par défaut de votre boutique, hors taxes. L'extension ne demande pas de taux en temps réel à Econt. La Bulgarie utilise l'euro depuis le 1er janvier 2026 : une boutique bulgare saisit donc normalement des tarifs en EUR.

Price per country : un pays par ligne (ou séparés par des virgules) : code pays, deux-points, tarif, par exemple BG:5.99 et RO:8.99 (ce sont les valeurs par défaut). La virgule décimale est acceptée : BG:5,99. Un tarif de 0 signifie livraison gratuite. Si le champ est vide, les tarifs par défaut BG:5.99 et RO:8.99 sont utilisés. Les entrées dans un autre format sont ignorées et signalées dans un avertissement à l'enregistrement. Le reste est enregistré.

Calculation : Per order (par défaut) facture le tarif une seule fois. Per item (price x quantity) le multiplie par le nombre d'articles à expédier.

Price for other countries : utilisé pour un pays Econt (Bulgarie ou Roumanie) qui ne figure pas ci-dessus. Vide ou 0 masque la méthode pour ce pays.

Conditions

Le sous-total du panier désigne les produits à expédier, après le coupon et avant la taxe.

Free shipping from : le sous-total du panier à partir duquel la livraison est gratuite. Laissez vide pour ne jamais offrir la livraison gratuite.

Minimum subtotal : affiche la méthode seulement si le sous-total du panier atteint au moins ce montant. Laissez vide pour toujours l'afficher.

Minimum weight (kg) : masque la méthode pour les paniers plus légers. Les poids des produits sont convertis de leur classe de poids en kg. Laissez vide pour aucune limite.

Maximum weight (kg) : masque la méthode pour les paniers plus lourds. Laissez vide pour aucune limite.

Disponibilité

Econt livre uniquement en Bulgarie et en Roumanie. Normalement, la zone géographique détermine où la méthode est proposée ; avec Ignore geo zone, ce sont les pays sélectionnés qui décident.

Geo zone : propose Econt uniquement aux adresses de cette zone géographique. All Zones (par défaut) signifie partout en Bulgarie et en Roumanie. Les zones géographiques se gèrent dans System > Localisation > Geo Zones. La zone géographique n'est pas utilisée avec Ignore geo zone.

Ignore geo zone : la zone géographique n'est pas vérifiée. Econt est proposée dans les pays ci-dessous, que l'adresse se trouve ou non dans la zone géographique.

Countries : Bulgarie et/ou Roumanie. Utilisé uniquement avec Ignore geo zone. Aucun pays sélectionné signifie tous les pays Econt.

Avancé

Debug log : écrit les messages de débogage dans storage/logs/vfd_ecn_debug.log.php (sous OpenCart 4, system/storage/logs/vfd_ecn_debug.log.php). Le fichier ne peut pas être lu depuis le web. Lorsqu'il atteint 5 Mo, un nouveau journal est démarré. Les erreurs et avertissements de l'API (Econt injoignable, aucun bureau, commande sans bureau) sont toujours consignés. Aucun mot de passe ni donnée client n'est écrit.

Log : affiche la taille et les dernières entrées du journal. Cliquez sur Clear log pour le vider.

Remove data on uninstall : si cette option est activée, la désinstallation de l'extension supprime les paramètres Econt, le journal et les choix des paiements inachevés. Si elle est désactivée, les paramètres sont conservés pour une réinstallation. Les bureaux enregistrés dans les commandes sont toujours conservés.

Import / Export

Export : cliquez sur Download JSON pour enregistrer les paramètres dans un fichier JSON. Le mot de passe n'est pas exporté.

Import : collez un JSON exporté précédemment et cliquez sur Import pour restaurer les paramètres, par exemple sur une autre boutique. Les valeurs sont vérifiées comme lors d'un enregistrement normal. Le mot de passe enregistré est conservé.

Fonctionnement au paiement

La méthode n'est proposée que pour la Bulgarie et la Roumanie. Lorsqu'OpenCart affiche les modes de livraison, il demande à l'extension le tarif Econt. Avec Ignore geo zone, la zone géographique n'est pas vérifiée et la méthode n'est proposée que pour les Countries sélectionnés (aucun sélectionné = Bulgarie et Roumanie). Sinon, si une Geo zone est définie, l'adresse doit s'y trouver. Seuls les produits dont Requires Shipping est réglé sur Yes comptent : les autres produits n'ajoutent pas de poids et ne sont pas inclus dans le sous-total. L'extension vérifie les limites de poids et le sous-total minimum, puis prend le tarif du pays. Si le sous-total du panier atteint Free shipping from, le tarif est de 0. Si aucune liste de bureaux n'est disponible pour le pays, la méthode est masquée, car la livraison se fait toujours dans un bureau. Le tarif est calculé dans votre devise par défaut et affiché au client dans sa devise, avec la taxe de la Tax class sélectionnée.

Lorsque le client sélectionne Econt, deux listes apparaissent sous la méthode : City et Office / Econtomat. La liste des bureaux n'est chargée qu'une fois par page, uniquement lorsque Econt est sélectionné. Les Econtomats sont signalés dans la liste. Le choix est enregistré immédiatement. Si la liste des bureaux ne peut pas être chargée, le client voit le message Econt offices cannot be loaded right now. Please try again in a few minutes or choose another shipping method.

Lorsque le client clique sur Continue à l'étape du mode de livraison, l'extension vérifie côté serveur qu'un bureau est choisi et qu'il existe dans la liste Econt pour le pays de livraison (filtrée selon Show). Sans bureau, le client voit Please select an Econt office or Econtomat. Un bureau absent de la liste est refusé avec le message The selected Econt office is not available for the shipping country. Please select it again. Le nom du bureau est toujours repris de la liste Econt, et non du navigateur.

Sur OpenCart 4, le client clique sur Choose dans le bloc du mode de livraison de la page de paiement et choisit Econt dans la fenêtre Shipping method options. Les listes City et Office / Econtomat apparaissent dans cette fenêtre, sous la méthode, et fonctionnent comme décrit ci-dessus. Le bouton Continue de la fenêtre ne permet pas de continuer sans bureau valide, avec les mêmes messages.

La liste des bureaux est mise en cache pendant 24 heures, séparément pour l'API en direct et l'API de démonstration, et pour chaque pays. Si Econt est injoignable, la dernière liste valide est utilisée et Econt n'est plus interrogée pendant 10 minutes. Le délai d'attente de l'API est de 15 secondes. La liste des bureaux provient de https://ee.econt.com/services/ (en direct) ou de https://demo.econt.com/ee/services/ (démonstration).

L'extension n'utilise que des tarifs fixes. Elle ne demande pas de taux en temps réel à Econt, ne crée ni lettres de transport ni étiquettes, ne commande pas de coursiers, ne suit pas les colis, ne gère pas le paiement à la livraison et ne livre pas à une adresse. Seules la Bulgarie et la Roumanie disposent d'une liste de bureaux.

Points de retrait

Lors de la passation de la commande, le bureau choisi au paiement est enregistré avec la commande : la ville, le nom et l'adresse du bureau, ainsi que le code du bureau Econt. Utilisez le code du bureau lorsque vous créez l'expédition dans e-Econt.

Client : le bureau est ajouté au mode de livraison de la commande, par exemple Econt Express - Econt office / Econtomat: city, office (address) (128 caractères maximum ; sous OpenCart 4, le texte n'est pas raccourci). Il apparaît ainsi dans l'historique des commandes du client, dans les e-mails de commande, sur la facture et dans la commande de l'administration. OpenCart 4 conserve une seule commande pour le paiement et la met à jour à chaque nouvelle confirmation du client ; le bureau de la commande est mis à jour avec elle.

Page de commande de l'administration : dans Sales > Orders, le panneau Econt office / Econtomat situé au-dessus de l'historique affiche le bureau et son code, même si la méthode est désactivée ultérieurement. Sous Change, choisissez une autre ville et un autre bureau du pays de la commande, puis cliquez sur Save. Le panneau affiche Saved., le texte du mode de livraison de la commande est mis à jour, et une note dans l'historique de la commande (non envoyée au client) consigne l'ancien et le nouveau bureau. Si vous cliquez sur Save sans choisir de bureau, le panneau indique Select a city and an office first - nothing was changed. Un bureau absent de la liste du pays de la commande est refusé avec le message The selected Econt office is not available for the shipping country - nothing was changed. Tout utilisateur administrateur disposant de l'autorisation de modification des commandes peut changer le bureau ; l'accès aux paramètres de l'extension n'est pas nécessaire. Si la liste des bureaux ne peut pas être chargée, le panneau affiche Econt offices cannot be loaded right now. Une commande passée sans bureau affiche No Econt office is saved for this order., et le journal contient une erreur pour elle.

Les noms des bureaux sont affichés dans la langue locale (cyrillique pour la Bulgarie) lorsque la langue de la boutique est le bulgare ou le roumain, et en anglais sinon.

Clé de licence

L'extension fonctionne avec une clé de licence VibeFox obtenue sur vibefox.net. Le bloc de licence License — VibeFox Econt est le premier bloc de la page Extensions > Extensions > Shipping > VibeFox Econt > Edit, au-dessus des paramètres. Saisissez la clé dans License key et cliquez sur Activate. Ensuite, le bloc affiche la clé masquée, le statut (par exemple la date jusqu'à laquelle la licence est active et votre domaine) et les boutons Check now pour vérifier à nouveau le statut, Change key pour saisir une autre clé et Remove key pour retirer la clé de cette boutique. Plus bas figurent la ligne Product: opencart-shipping-econt et le lien Manage licenses and domains in your account, qui ouvre votre compte vibefox.net. Seuls les utilisateurs administrateurs disposant de l'autorisation Modify pour l'extension peuvent modifier la clé. Les textes du bloc suivent la langue de l'administration (l'anglais et le russe sont inclus).

Si la clé n'est pas acceptée, le bloc indique la raison, par exemple Key not found, This key belongs to another product, Domain limit reached ou License expired on suivi d'une date. Après un changement d'adresse de la boutique, ou après avoir libéré un emplacement de domaine dans votre compte, cliquez sur Check now. Si le serveur de licences est injoignable, l'extension continue de fonctionner avec le dernier statut connu.

Une clé fonctionne sur un seul domaine : l'adresse de la boutique issue de la configuration d'OpenCart. Retirer la clé de la boutique ne libère pas son emplacement de domaine. Libérez-le dans votre compte vibefox.net.

Sans clé active, le mode de livraison Econt n'est pas affiché aux clients au paiement et aucun tarif n'est calculé. Un utilisateur administrateur connecté à l'administration dans le même navigateur voit toujours la méthode dans la boutique, marquée (unlicensed — visible to admins only), ce qui vous permet de configurer et de tester l'extension avant d'acheter une clé. Sur OpenCart 4, cet aperçu n'est pas disponible : la boutique ne voit pas la connexion à l'administration, donc sans clé active la méthode est masquée pour tout le monde. Après avoir ouvert une fois la page Edit, un rappel apparaît sur le Dashboard de l'administration. Fermez-le avec × pour le masquer pendant 7 jours. Les commandes existantes ne sont pas affectées.

Lorsqu'une licence expire, l'extension continue de fonctionner, mais les mises à jour et le support nécessitent un renouvellement. Le statut est vérifié à nouveau automatiquement lorsque vous ouvrez le Dashboard de l'administration ou la page Edit : une fois par jour pendant les 14 premiers jours après la saisie de la clé, puis une fois par semaine. Aucune tâche cron n'est nécessaire. La désinstallation de l'extension supprime toujours la clé de licence et le statut de licence.

Dépannage

Econt n'apparaît pas au paiement : vérifiez que la licence est active et que Enable/Disable est activé, et que le pays de livraison est la Bulgarie ou la Roumanie (activé dans System > Localisation > Countries). Vérifiez Geo zone (ou Ignore geo zone et Countries), qu'un tarif est défini pour le pays, les limites de poids et Minimum subtotal. Vérifiez la ligne Office list des paramètres : la méthode est masquée tant qu'aucune liste de bureaux n'est disponible pour le pays. Vérifiez que les produits ont Requires Shipping réglé sur Yes.

La liste des bureaux ne se charge pas : cliquez sur Load offices from Econt now et lisez le résultat, ou l'avertissement en haut de la page des paramètres. Les erreurs sont toujours écrites dans le journal ; activez Debug log pour plus de détails et consultez le champ Log. Si Econt exige une autorisation pour votre boutique, renseignez Econt username et Econt password.

Les clients voient des bureaux de test : Demo API est activée. Désactivez-la sur une boutique en production.

Dans quelle devise sont les tarifs ? Dans la devise par défaut de votre boutique, hors taxes. Les clients les voient dans leur devise.

La taxe s'ajoute au tarif : une classe de taxe est sélectionnée. Réglez Tax class sur --- None --- si vos tarifs incluent déjà la TVA.

La page affiche « Warning: You do not have permission to modify VibeFox Econt! » : votre groupe d'utilisateurs administrateurs ne peut que consulter les paramètres. Accordez à ce groupe l'autorisation de modification pour extension/shipping/vfd_econt (OpenCart 3) ou extension/vfd_econt/shipping/vfd_econt (OpenCart 4) dans System > Users > User Groups.

Désinstallation

Allez dans Extensions > Extensions, choisissez le type Shipping et cliquez sur Uninstall (le bouton rouge −) à côté de VibeFox Econt. La clé de licence et le statut de licence de cette extension sont toujours supprimés. OpenCart réinitialise toujours Enable/Disable, Sort order, Tax class et Geo zone. L'extension supprime toujours ses événements et les listes de bureaux en cache. Si Remove data on uninstall est activé, les autres paramètres, le journal et les choix des paiements inachevés sont également supprimés. Si l'option est désactivée, les paramètres sont conservés et réutilisés lors d'une nouvelle installation de l'extension. Les bureaux enregistrés dans les commandes sont toujours conservés, et les commandes existantes gardent leur mode de livraison et leur coût.

Sur OpenCart 4, pour supprimer aussi les fichiers de l'extension, allez dans Extensions > Installer après la désinstallation et cliquez sur Uninstall (le bouton orange −) à côté de VibeFox Econt dans la liste des extensions installées, puis sur Delete (le bouton rouge en forme de corbeille) pour supprimer le paquet téléchargé.

Econt est une marque déposée de son propriétaire. Cette extension n'est pas affiliée à Econt et n'est pas approuvée par Econt.