Version de développement
Cette documentation décrit la version « next » (develop), non encore publiée. Pour la version stable, basculez sur « v5 » dans l'en-tête.
Comptabilité

Paramètres de taux de change

Choisir et configurer le fournisseur qui donne les taux de change des transactions en devise étrangère.

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 :

FournisseurPoint de terminaison API
frankfurter.dev - v2https://api.frankfurter.dev/v2/rate/{from_currency}/{to_currency}
frankfurter.devhttps://api.frankfurter.dev/v1/{transaction_date}
exchangerate.hosthttps://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

  1. Ouvrez les Paramètres des taux de change.
  2. Dans Fournisseur de service, choisissez un fournisseur.
  3. Dokos remplit le Point de terminaison API, les Paramètres de la demande et la Clé de résultat.
  4. Pour exchangerate.host, saisissez la Clé d'accès.
  5. 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'adresse https://taux.example.com/2026-06-15?base=USD. Saisissez le point de terminaison https://taux.example.com/{transaction_date}, le paramètre base = {from_currency}, puis les clés de résultat data et {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

  1. Un taux enregistré dans Taux de change de devise pour les deux devises.
  2. L'inverse d'un taux enregistré dans l'autre sens.
  3. 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.