VibeFox Econt for PrestaShop — Aide

Prérequis

PrestaShop : 8.0 à 9.x.

PHP : 8.0 ou ultérieur. Le module refuse de s'installer sur les versions antérieures de PHP.

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. L'identifiant e-Econt est décrit 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

1. Dans le back-office, allez dans Modules > Module Manager et cliquez sur Upload a module. Choisissez le fichier ZIP du module.

2. Une fois le téléchargement terminé, cliquez sur Configure, ou retrouvez plus tard VibeFox Econt dans la liste des modules et cliquez sur Configure.

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

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

À l'installation, le module crée le transporteur Econt Express avec le texte de délai de livraison Delivery to an Econt office or Econtomat. Le transporteur est affecté aux zones de Bulgarie et de Roumanie et à tous les groupes de clients. Vous pouvez modifier les zones, les groupes de clients, le délai de livraison, le logo et les limites de taille dans Shipping > Carriers. Ne définissez pas de prix à cet endroit : le prix provient toujours du module.

Configuration

Tous les réglages se trouvent sur la page du module : Modules > Module Manager > VibeFox Econt > Configure. Chaque section a son propre bouton Save, qui enregistre la page entière. Le tarif et les conditions s'appliquent à toutes les zones du transporteur.

En haut de la page, le module affiche des avertissements : transporteur Econt introuvable, API de démonstration activée, aucun tarif défini pour la Bulgarie ou la Roumanie (le transporteur n'est alors jamais affiché), échec de la dernière demande de bureaux pour un pays, ou unité de poids de votre boutique inconnue du module (les poids sont alors pris en kg ; définissez l'unité dans International > Localization, Local units). 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é.

General

Enable/Disable : active ou désactive la livraison Econt. Il s'agit du même interrupteur que le statut du transporteur dans Shipping > Carriers.

Name : le nom du transporteur affiché dans le panier et à l'étape de paiement. Par défaut : Econt Express. Obligatoire, 64 caractères maximum.

Tax : la règle de taxe du transporteur, ou No tax. PrestaShop ajoute cette taxe au-dessus des tarifs ci-dessous. Avec No tax, 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émo, le compte de test public d'Econt est utilisé lorsqu'aucun identifiant n'est défini.

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

Econt password : facultatif. Enregistré dans la base de données de la boutique et 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. Cochez Remove the saved password et enregistrez pour la supprimer.

Office list : indique combien de bureaux sont en cache par pays et quand ils ont été chargés. Le bouton Load offices from Econt now recharge immédiatement les listes 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 à la première commande. 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). Si l'option est désactivée, les villes sont triées par ordre alphabétique. Par défaut : activée.

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%.

Prix (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. Le module ne demande pas à Econt de tarifs en direct. 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 (avec Ignore zones, les pays hors des zones du transporteur n'ont alors aucun tarif). Les entrées dans un autre format sont ignorées et listées dans un avertissement à l'enregistrement. Le reste est enregistré.

Calculation : Per order 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 dans la liste ci-dessus. Vide ou 0 masque le transporteur dans ce pays.

Conditions

Le sous-total du panier désigne les produits à expédier, après remises, hors taxes.

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 le transporteur uniquement lorsque le sous-total du panier atteint au moins ce montant. Laissez vide pour toujours l'afficher.

Minimum weight (kg) : masque le transporteur pour les paniers plus légers. Les poids des produits sont convertis de l'unité de poids de votre boutique en kg. Laissez vide pour aucune limite.

Maximum weight (kg) : masque le transporteur pour les paniers plus lourds. Laissez vide pour aucune limite.

Disponibilité sans zones d'expédition

Ignore zones : proposer aussi Econt dans les pays ci-dessous lorsque la zone de l'adresse de livraison n'est pas liée au transporteur. Lorsque vous l'activez, le transporteur est lié à chaque zone active, et les zones créées plus tard le sont aussi. Lorsque vous le désactivez à nouveau, le transporteur retrouve les zones qu'il avait auparavant. Les zones déjà liées continuent de fonctionner normalement. Econt n'est toujours proposé que pour la Bulgarie et la Roumanie.

Countries : Bulgarie et/ou Roumanie. Utilisé uniquement avec Ignore zones. Si aucun n'est coché, tous les pays Econt vers lesquels la boutique expédie sont concernés.

Avancé

Debug log : écrit des messages de débogage dans logs/vfd_ecn_debug.log.php, dans le dossier du module. Le fichier ne peut pas être ouvert depuis le web. Les erreurs de l'API sont toujours enregistrées. 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 : lorsque l'option est activée, la désinstallation du module supprime les réglages Econt, le transporteur et le journal. Désactivée, les réglages sont conservés pour une réinstallation. Les bureaux enregistrés dans les commandes sont toujours conservés.

Fonctionnement au paiement

Le transporteur n'est proposé que pour la Bulgarie et la Roumanie. À l'étape de livraison, PrestaShop demande au module le tarif Econt. Seuls les produits physiques comptent : les produits virtuels n'ajoutent aucun poids et ne sont pas inclus dans le sous-total. Le module 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, le transporteur est masqué, car la livraison se fait toujours vers un bureau. Le tarif est calculé dans la devise par défaut, puis affiché dans la devise du panier du client.

Lorsque le client sélectionne Econt, deux listes apparaissent sous le transporteur : City et Office / Econtomat. La liste des bureaux est chargée une fois par page, uniquement lorsque Econt est sélectionné. Les Econtomats sont signalés dans la liste. Le choix est enregistré immédiatement dans le panier. Si la liste des bureaux ne peut pas être chargée, le client voit 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 de livraison, le module vérifie côté serveur qu'un bureau est choisi et qu'il existe dans la liste Econt du 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 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. Le sélecteur fonctionne avec le thème Classic et avec Hummingbird.

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. Si Econt est injoignable, la dernière liste valide est utilisée et Econt n'est plus sollicité 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 https://demo.econt.com/ee/services/ (démonstration).

Si vous modifiez le transporteur dans Shipping > Carriers alors qu'il a déjà des commandes, PrestaShop l'enregistre comme une nouvelle version du transporteur. Le module suit automatiquement la nouvelle version.

Le module n'utilise que des tarifs fixes. Il ne demande pas à Econt de tarifs en direct, 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 pour le panier est enregistré avec la commande : la ville, le nom et l'adresse du bureau, et le code de bureau Econt. Utilisez le code du bureau lorsque vous créez l'expédition dans e-Econt.

Page de commande du back-office : un bloc Econt office / Econtomat affiche le bureau et l'Office code. Sous Change, choisissez une autre ville et un autre bureau du pays de la commande, puis cliquez sur Save. Le changement est enregistré immédiatement, et un message privé de commande consigne l'ancien et le nouveau bureau. Si vous cliquez sur Save sans choisir de bureau, le bloc indique Select a city and an office first - nothing was changed. Tout employé autorisé à modifier les commandes peut changer le bureau ; l'accès à la page du module n'est pas nécessaire. Si la liste des bureaux ne peut pas être chargée, le bloc affiche Econt offices cannot be loaded right now.

Plusieurs commandes à partir d'un même panier : le bureau appartient à la première commande. Une autre commande passée depuis le même panier ne reçoit pas de bureau : une erreur est écrite dans le journal, et son bloc indique que le bureau de ce panier appartient à une autre commande. Convenez du bureau avec le client et créez l'expédition manuellement dans e-Econt.

Client : le bureau est affiché sur la page de commande du client et sur la page de confirmation de commande, et il est ajouté au nom du transporteur dans l'e-mail de confirmation de commande et dans l'e-mail de nouvelle commande adressé à la boutique.

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

Le module fonctionne avec une clé de licence VibeFox obtenue sur vibefox.net. Le bloc de licence License — VibeFox Econt est le premier bloc de Modules > Module Manager > VibeFox Econt > Configure, au-dessus des réglages. 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) ainsi que 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. En dessous figurent la ligne Product: presta-shipping-econt et le lien Manage licenses and domains in your account, qui ouvre votre compte vibefox.net. Seuls les employés disposant de l'autorisation Configure pour le module peuvent modifier la clé. Les textes du bloc suivent la langue du back-office (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, le module continue de fonctionner avec le dernier statut connu.

Une clé fonctionne sur un seul domaine : celui de la boutique principale, y compris dans une configuration multiboutique. Retirer la clé de la boutique ne libère pas son emplacement de domaine. Libérez l'emplacement dans votre compte vibefox.net.

Sans clé active, le transporteur Econt n'est pas affiché aux clients à l'étape de paiement et aucun tarif n'est calculé. La vitrine PrestaShop ne sait pas que vous êtes connecté au back-office, donc le transporteur est masqué pour vous aussi : vous pouvez configurer le module avant d'acheter une clé, mais non le tester au paiement. Un rappel apparaît dans Modules > Module Manager, dans l'onglet Alerts. Les commandes existantes ne sont pas affectées.

Lorsqu'une licence expire, le module continue de fonctionner, mais les mises à jour et le support nécessitent un renouvellement. Le statut est vérifié automatiquement pendant votre travail dans le back-office : 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. Désinstaller ou réinitialiser le module supprime toujours la clé de licence et le statut de la licence.

Dépannage

Econt n'apparaît pas au paiement : vérifiez que la licence est active, que Enable/Disable est activé et que le pays de livraison est la Bulgarie ou la Roumanie. Dans Shipping > Carriers, vérifiez que le transporteur couvre la zone du pays du client et le groupe du client (ou activez Ignore zones et vérifiez Countries). Vérifiez qu'un tarif est défini pour le pays, les limites de poids et Minimum subtotal. Contrôlez la ligne Office list dans les réglages : le transporteur est masqué tant qu'aucune liste de bureaux n'est disponible pour le pays. Les produits peuvent aussi être limités à certains transporteurs sur la page produit.

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 réglages. 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 la devise de leur panier.

La taxe s'ajoute au tarif : le transporteur a une règle de taxe. Réglez Tax sur No tax si vos tarifs incluent déjà la TVA.

La page indique que le transporteur Econt est introuvable : le transporteur a été supprimé dans Shipping > Carriers. Réinitialisez le module dans Modules > Module Manager pour le recréer.

Désinstallation

Allez dans Modules > Module Manager, ouvrez le menu à côté de VibeFox Econt et choisissez Uninstall. La clé de licence et le statut de la licence sont toujours supprimés. Les listes de bureaux en cache sont toujours supprimées. Si Remove data on uninstall est activée, le transporteur est supprimé (les commandes conservent leur historique), ainsi que les réglages et le journal. Si elle est désactivée, le transporteur est seulement désactivé et tous les réglages sont conservés. Réinstaller le module restaure le transporteur enregistré avec le statut qu'il avait. La réinitialisation du module conserve le statut actuel du transporteur. Les bureaux enregistrés dans les commandes sont toujours conservés.

Econt est une marque de son propriétaire respectif. Ce module n'est pas affilié à Econt et n'est pas approuvé par Econt.