Comptabilité

Paramètres de taux de change

Configurez le fournisseur de taux de change automatique dans Dokos pour convertir les devises étrangères dans vos transactions.

Paramètres de taux de change

Dokos peut récupérer les taux de change depuis un service en ligne. Vous n'avez alors pas à les saisir à la main. Les Paramètres des taux de change permettent de choisir et de configurer ce service.

Ouvrez ce formulaire avec l'URL /desk/currency-exchange-settings. Vous pouvez aussi le chercher avec Ctrl+K.

Fournisseurs disponibles

Le champ Fournisseur de service propose les choix suivants :

FournisseurDescription
frankfurter.dev - v2Fournisseur par défaut des nouvelles installations. Il utilise l'API v2 de Frankfurter.
frankfurter.devAncienne API v1 de Frankfurter.
exchangerate.hostService alternatif. Il exige une Clé d'accès.
PersonnaliséVous saisissez vous-même l'URL, les paramètres et la clé de résultat de votre fournisseur.
Frankfurter s'appuie sur les taux de référence de la Banque centrale européenne. Il est gratuit et ne demande pas de clé d'API.

Fonctionnement général

Vous saisissez une transaction en devise étrangère. Dokos cherche d'abord un Taux de change de devise saisi à la main, à la date de la transaction ou avant. S'il n'en trouve pas, il interroge le fournisseur configuré. Le taux obtenu est renseigné dans le document. Dokos garde ce taux en cache pendant six heures.

Seuls les utilisateurs système peuvent déclencher une récupération auprès du fournisseur.

Exemple fictif. Votre devise de base est l'EUR. Vous créez une facture de vente en USD pour Maison Verte SARL. Aucun taux USD/EUR n'est saisi à la main. Dokos interroge Frankfurter et renseigne le taux du jour.

Configurer le fournisseur Frankfurter v2

Sur une nouvelle installation, Frankfurter v2 est configuré par défaut. Pour vérifier ou changer la configuration :

  1. Ouvrez /desk/currency-exchange-settings.
  2. Dans le champ Fournisseur de service, sélectionnez frankfurter.dev - v2. Dokos remplit le point de terminaison, les paramètres et la clé de résultat.
  3. Enregistrez. À l'enregistrement, Dokos teste l'appel au fournisseur. Une erreur s'affiche si l'appel échoue ou si la réponse ne contient pas de taux valide.

Après l'enregistrement, le formulaire affiche :

  • Point de terminaison API : https://api.frankfurter.dev/v2/rate/{from_currency}/{to_currency}
  • Paramètres : date (valeur : {transaction_date})
  • Clé de résultat : rate
  • Exemple d'URL : l'URL appelée lors du test.

Pour les fournisseurs autres que « Personnalisé », Dokos renseigne ces valeurs à votre place. La case Utiliser le protocoles HTTP remplace https:// par http://.

Activer ou désactiver la récupération automatique

La case Désactivé suspend la récupération auprès du fournisseur. Votre configuration est conservée.

Dans ce cas, Dokos utilise seulement les taux saisis à la main dans Taux de change de devise (/desk/currency-exchange). Sans taux saisi, le taux de change reste à 0 et vous devez le saisir dans le document.

Qui peut modifier ces paramètres ?

Seul le rôle Gestionnaire système peut modifier les Paramètres des taux de change. Le rôle Comptable peut les consulter, sans les modifier.

En cas de problème

Si le taux de change n'est pas récupéré automatiquement :

  1. Vérifiez que la case Désactivé n'est pas cochée.
  2. Vérifiez qu'un ancien taux saisi à la main n'est pas utilisé à la place (voir ci-dessous).
  3. Enregistrez à nouveau les paramètres. Un message d'erreur s'affiche si le fournisseur ne répond pas.
  4. Vérifiez que la paire de devises est couverte par le fournisseur. Pour Frankfurter, consultez https://frankfurter.dev/currencies/.
Passage de frankfurter.dev à frankfurter.dev - v2 : sélectionnez frankfurter.dev - v2 et enregistrez. Les taux déjà enregistrés dans vos documents ne changent pas.

Lien avec les autres paramètres de comptabilité

Les Paramètres de comptabilité contiennent deux options liées :

  • Autoriser les taux de change obsolètes : cochée par défaut. Dokos utilise le dernier taux saisi à la main, quelle que soit son ancienneté.
  • Age maximum du taux (jours) : visible quand l'option précédente est décochée. Dokos ignore les taux saisis à la main plus anciens que ce nombre de jours. Il interroge alors le fournisseur.