Paramètres de taux de change
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.
/desk/currency-exchange-settings.
Vous pouvez aussi le chercher avec Ctrl+K.Fournisseurs disponibles
Le champ Fournisseur de service propose les choix suivants :
| Fournisseur | Description |
|---|---|
| frankfurter.dev - v2 | Fournisseur par défaut des nouvelles installations. Il utilise l'API v2 de Frankfurter. |
| frankfurter.dev | Ancienne API v1 de Frankfurter. |
| exchangerate.host | Service 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. |
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 :
- Ouvrez
/desk/currency-exchange-settings. - 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.
- 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 :
- Vérifiez que la case Désactivé n'est pas cochée.
- Vérifiez qu'un ancien taux saisi à la main n'est pas utilisé à la place (voir ci-dessous).
- Enregistrez à nouveau les paramètres. Un message d'erreur s'affiche si le fournisseur ne répond pas.
- Vérifiez que la paire de devises est couverte par le fournisseur. Pour Frankfurter, consultez https://frankfurter.dev/currencies/.
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.