Paramètres de taux de change
Paramètres de taux de change
Les Paramètres des taux de change indiquent à Dokos quel service en ligne donne les taux de change. Dokos utilise ce service quand il ne trouve pas de taux enregistré dans Taux de change de devise.
Ouvrez le formulaire depuis la barre latérale Paramètres de Dokos, section Autres paramètres, ou à l'adresse /desk/currency-exchange-settings.
Fournisseurs disponibles
Le champ Fournisseur de service propose quatre choix :
| Fournisseur | Point de terminaison API |
|---|---|
| frankfurter.dev - v2 | https://api.frankfurter.dev/v2/rate/{from_currency}/{to_currency} |
| frankfurter.dev | https://api.frankfurter.dev/v1/{transaction_date} |
| exchangerate.host | https://api.exchangerate.host/convert. Ce service demande une Clé d'accès. |
| Personnalisé | Vous saisissez vous-même l'URL, les paramètres et la clé de résultat. |
À l'installation, Dokos choisit frankfurter.dev - v2.
Configurer un fournisseur
- Ouvrez les Paramètres des taux de change.
- Dans Fournisseur de service, choisissez un fournisseur.
- Dokos remplit le Point de terminaison API, les Paramètres de la demande et la Clé de résultat.
- Pour exchangerate.host, saisissez la Clé d'accès.
- Enregistrez.
À l'enregistrement, Dokos teste le service avec un taux USD vers INR à la date du jour. Si le test réussit, le champ Exemple d'URL montre l'URL appelée. Sinon, Dokos affiche l'erreur et n'enregistre pas.
Avec frankfurter.dev - v2, le formulaire contient :
- Point de terminaison API :
https://api.frankfurter.dev/v2/rate/{from_currency}/{to_currency} - Paramètres :
date={transaction_date} - Clé de résultat :
rate
La case Utiliser le protocoles HTTP remplace https:// par http://. Elle n'apparaît pas pour un fournisseur Personnalisé.
Fournisseur personnalisé
Trois variables sont disponibles dans le point de terminaison, la clé de résultat et les valeurs des paramètres : {from_currency}, {to_currency} et {transaction_date}.
La table Clé de résultat donne le chemin du taux dans la réponse JSON, une clé par ligne.
Exemple fictif : un service répond
{"data": {"EUR": 0.92}}à l'adressehttps://taux.example.com/2026-06-15?base=USD. Saisissez le point de terminaisonhttps://taux.example.com/{transaction_date}, le paramètrebase={from_currency}, puis les clés de résultatdataet{to_currency}.
Désactiver la récupération automatique
Cochez Désactivé pour ne plus appeler le service. Votre configuration est conservée. Dokos utilise alors seulement les taux enregistrés dans Taux de change de devise. S'il n'en trouve pas, le taux vaut 0.
Ordre de recherche d'un taux
- Un taux enregistré dans Taux de change de devise pour les deux devises.
- L'inverse d'un taux enregistré dans l'autre sens.
- Le service configuré ici, si les paramètres ne sont pas désactivés.
Seuls les utilisateurs système peuvent obtenir un taux auprès du service. Dokos garde le taux obtenu en cache pendant 6 heures. Le cache est vidé à chaque enregistrement des paramètres.
Les options Autoriser les taux de change obsolètes et Age maximum du taux (jours) des Paramètres de comptabilité règlent l'âge maximum d'un taux enregistré.
Qui peut modifier ces paramètres ?
Le rôle Responsable système peut modifier les paramètres. Le rôle Comptable peut seulement les consulter.