NsMajTaux met à jour automatiquement, chaque jour, les taux de change des devises utilisées dans Dolibarr (module Multi-devises). Plus besoin de saisir les taux à la main avant d’établir un devis ou une facture dans une autre devise.
Source par défaut : les taux de référence publiés chaque jour par la Banque centrale européenne (BCE), gratuitement et sans inscription.
Option « hors zone européenne » : les taux de toutes les devises du monde sont obtenus auprès du service Fixer d’apilayer.com, avec un jeton d’accès.
La mise à jour est faite par une tâche planifiée de Dolibarr, créée à l’activation du module.
Compatible Multi-société.
Le module ne modifie pas le Core de Dolibarr.
2. Prérequis et installation
2.1 Prérequis
Élément
Version / état
Dolibarr
19.0 à 24.0
PHP
7.4 à 8.3
Framework NSINFO (module « NSINFO », gratuit)
Installé et activé
Module Multi-devises
Activé, avec les devises utilisées déclarées
Module Travaux planifiés
Activé, et exécuté régulièrement sur le serveur
Le framework NSINFO est obligatoire. Si le module « NSINFO » n’est pas installé et activé, l’activation de NsMajTaux est refusée avec le message : « Le framework NSINFO est obligatoire : le module « NSINFO » (nsinfo) doit être installé et activé avant d’activer le module « Mise à jour des taux de change ». » Voir la page framework NSINFO.
2.2 Installation
Installer et activer le module NSINFO.
Depuis Accueil > Configuration > Modules/Applications > Déployer/Installer un module externe, envoyer l’archive module_nsmajtaux-X.Y.Z.zip (voir installer un module).
Dans la liste des modules, famille NSINFO, activer « Mise à jour des taux de change ».
À l’activation, le module crée la tâche planifiée « Mise à jour des taux de change des monnaies utilisées » (une fois par jour) et renseigne l’adresse du fichier de taux de la BCE.
2.3 Mise à jour / réactivation
Après une mise à jour du module, désactiver puis réactiver le module. La tâche planifiée est alors recréée ; les réglages (source des taux, jeton d’accès) sont conservés.
3. Configuration
Page de réglages : Configuration > Modules, roue crantée du module (voir activation et paramètres), onglets Réglages, ChangeLog et À propos. Réservée aux administrateurs.
En tête de page, l’interrupteur « Activer la gestion des pays hors zone européenne » choisit la source des taux. Le champ affiché en dessous dépend de sa position :
Interrupteur
Source des taux
Champ affiché
Désactivé
Banque centrale européenne
Liens XML Banque centrale européenne (BCE), bouton Enregistrer
Activé
Service Fixer d’apilayer.com
Jeton d’accès à l’API, avec le lien vers apilayer.com, bouton Modifier
3.1 Taux de la BCE (interrupteur désactivé)
Le champ contient l’adresse du fichier des taux publiés chaque jour par la BCE ; elle est renseignée à l’activation et n’a normalement pas à être modifiée.
Les taux de la BCE sont exprimés par rapport à l’euro : cette source convient lorsque la devise principale de la société est l’euro.
Seules les devises publiées par la BCE (une trentaine : dollar américain, livre sterling, franc suisse, yen…) sont mises à jour.
3.2 Toutes les devises du monde (interrupteur activé)
Créer un compte sur apilayer.com et s’abonner au service Fixer (une formule gratuite existe, avec un nombre limité de requêtes par mois).
Copier la clé d’accès fournie, la coller dans le champ Jeton d’accès à l’API et cliquer sur Modifier.
Chaque devise utilisée dans Dolibarr est convertie depuis la devise principale de la société : la devise principale peut donc être autre que l’euro.
Chaque devise compte pour une requête par jour (par devise et par société en multi-société) : vérifier que la formule choisie chez apilayer.com couvre le nombre de requêtes.
4. Droits d’accès
Le module ne crée aucune permission ni entrée de menu. Sa configuration est réservée aux administrateurs. Les taux enregistrés sont ceux du module Multi-devises, utilisés par tous les documents.
5. Fonctionnement
5.1 Tâche planifiée
La tâche « Mise à jour des taux de change des monnaies utilisées » est visible dans Accueil > Configuration > Travaux planifiés. Elle s’exécute une fois par jour.
Elle peut être lancée à la main avec le bouton Exécuter de la liste des travaux planifiés, par exemple après un changement de réglage.
Les travaux planifiés de Dolibarr ne s’exécutent que si le serveur les déclenche régulièrement (tâche cron du serveur) : voir la documentation du module Travaux planifiés.
5.2 Taux enregistrés
À chaque exécution, un nouveau taux daté est ajouté pour chaque devise mise à jour : l’historique des taux reste consultable dans le module Multi-devises, et Dolibarr utilise le plus récent.
Seules les devises déclarées dans Dolibarr (module Multi-devises) sont mises à jour ; il n’est pas nécessaire de les choisir dans le module.
Ancien cédi ghanéen (GHC) : son taux est calculé à partir du nouveau cédi (GHS), un nouveau cédi valant 10 anciens.
5.3 Multi-société
Avec la gestion des pays hors zone européenne, les taux sont mis à jour pour chaque société, par rapport à sa propre devise principale.
Avec les taux de la BCE, la mise à jour n’est pas prévue pour plusieurs sociétés : en multi-société, activer la gestion des pays hors zone européenne.
6. Limites connues et FAQ
Les taux ne sont pas mis à jour.
Vérifier que la tâche planifiée est active et que les travaux planifiés sont bien déclenchés par le serveur (date de dernière exécution dans la liste des travaux planifiés).
Vérifier que la devise est déclarée dans le module Multi-devises.
Taux de la BCE : la devise doit faire partie de celles publiées par la BCE ; sinon, activer la gestion des pays hors zone européenne.
apilayer.com : vérifier le jeton d’accès et le nombre de requêtes restant sur l’abonnement.
Les taux semblent faux.
Avec les taux de la BCE, la devise principale de la société doit être l’euro. Pour une autre devise principale, activer la gestion des pays hors zone européenne.
La tâche planifiée a disparu ou s’est réinitialisée.
Elle est recréée à chaque réactivation du module : désactiver puis réactiver le module, puis vérifier qu’elle est active.
Autres limites
Une erreur du service de taux (site indisponible, jeton invalide ou quota épuisé) n’est pas signalée par la tâche planifiée. Avec apilayer.com, un taux vide ou nul peut alors être enregistré : contrôler de temps en temps la date et la valeur des derniers taux dans le module Multi-devises.
Si le module « NSINFO » est désactivé après coup, la page de réglages n’est plus utilisable.
