Multidevise/Documentation utilisateur

Avec le module Multidevise, synchronisez vos taux de conversion automatiquement et gagnez du temps en ajoutant ensuite les prix devisé sur vos commandes, propales et factures.

Informations pratiques

Ce module est disponible à partir de la version 3.5 de Dolibarr jusqu'en 3.9 (INTÉGRÉ EN DÉVELOPPEMENT DANS LA 4.0 ET EN STABLE EN 5.0). Pour fonctionner, ce module a besoin du module complémentaire "abricot" (module fournis automatiquement avec le module Multidevise). Le module abricot ne requiert pas son activation pour fonctionner et n'a aucun impact fonctionnel et structurel sur Dolibarr. Celui-ci contient un ensemble de programmes et fonctions indispensable au bon fonctionnement de Multidevise. Il doit être placer dans le répertoire htdocs de Dolibarr.

Attention ce module n'est pas compatible avec le module "Arrondi montant total".

Plateforme de test

Disponible sur Dolistore

Vidéo tutoriel : Youtube

Nécessite l'installation du module Abricot (Collection de fonctions et de classes utilisées par certains de nos modules en extension du comportement de base de Dolibarr. À installer comme un module standard).

Fonctionnalité du module

Taux de conversion

Les taux de conversion sont automatiquement chargés à l'activation du module via une API sur internet. Vous avez la possibilité de modifier les taux de conversion manuellement dans la partie administration du module.

Association devise au tiers

Lors de la création d’une fiche tiers, le module permet de lui associer une devise. La devise est alors automatiquement reprise lors de la création d’un document pour ce tiers.

devisetiers

Compte bancaire en devise

Lors de l’ajout d’un règlement, si la devise du compte bancaire est identique à celle du tiers, il n’y a alors pas de calcul de perte ou de gain de conversion de devise.

Prix d’achat fournisseur devisé

La variable BUY_PRICE_IN_CURRENCY vous permet de déterminer tacitement la devise des prix d'achats fournisseur. Celle-ci est à renseigné dans Acceuil => Configuration -> Divers.

• Si la valeur est à 1 => On considère les prix d’achat fournisseur comme étant dans la devise du fournisseur associé donc PU HT = PU devisé / Taux.
• Si la valeur est à 0 => On considère les prix d’achat fournisseur comme étant dans la devise global de Dolibarr donc PU HT = PU devisé * Taux.

Association de devise à un document

Vous pouvez associer une devise spécifique à un document. Le taux de conversion est alors stocké dans le document au moment de la création (s'il y a une mise à jour du taux entre la création de la commande et la facturation, le taux n'aura pas la même valeur sur la facture).

Ajout de ligne à un document

• Ligne libre => Conversion à la volée du prix devisé en fonction du taux du document.
• Ligne produit => Conversion automatique lors du traitement de l'ajout (invisible pour l'utilisateur).

Prise en compte du multi-langues

Si le multi-langue est activé dans votre Dolibarr, lors de la génération du document dans la langue associé au tiers, dans le PDF les prix devisés s'afficheront automatiquement à ma place des prix standards.

Enregistrement de règlement

Lors de l’enregistrement d’un règlement, le module calcule le prix devisé et/ou le prix standard en fonction de la devise du paiement reçu. Il viendra s’ajouter dans la note du règlement, le montant de perte ou de gain suite à l’enregistrement du paiement dans le cas ou le taux de conversion aurait variés entre la réception du paiement et la création de la facture.

Utilisation du module par un exemple

• Nous sommes une entreprise française utilisant la devise euro et nous commercialisons des bouteilles d'eau au prix unitaire de 2€. Nous avons affaire à un prospect Américain utilisant la devise dollars US (USD).

• Nous effectuons une proposition commerciale en ajoutant une ligne de 10 bouteilles d'eau. S'affiche alors le taux et le montant de la devise de notre prospect, mais aussi le 'P.U de la devise' et le total de la devise HT en double affichage avec les devises que nous utilisons.

• Cliquez sur générer et sur la loupe pour pouvoir visualiser le PDF de la propale.

• Le prospect semble avoir accepté la proposition, il faut donc créer une facture en choisissant la devise dollars US. Si la devise est renseignée sur le tiers, elle est automatiquement sélectionnée.

• Quand on enregistre un ou plusieurs paiements pour une facture, on peut voir dans la note soit le montant des gains, soit le montant des pertes, dû aux taux de conversion.

Actu du module et Mise à jour

• V2.5.2 le 23/08/2016 : correctif

• Le module Multidevise est intégré dans le cœur de Dolibarr, en expérimental dans la version 4.0.

• V2.5.3 le 26/08/2016 : correctif

• 24/11/2016 : correctif

• 23/01/2017 : correctif

• 01/02/2017 : correctif

• 08/02/2017 : correctif

• 1/03/2017 : correctif

• Mars 2017 : le module multidevise est stabilisé dans la version 5.0 de Dolibarr

• 20/03/2017 : correctif

• 27/03/2017 : correctif

• 4/04/2017 : correctif

• 10/04/2017 : correctif

• 22/05/2017 : correctif

---

Multicurrency

With the Multicurrency module synchronize your conversion rate automatically and save time then adding the price currency on your orders, and invoices propales.

This module is available from version 3.5

Additional Information

This module works in partnership with the "apricot" module (supplied automatically with the Multicurrency module). The apricot module does not require activation to work and has no functional and structural impact on Dolibarr. It contains a set of programs and functions essential to the functioning of multicurrency. It must be placed in the htdocs directory of Dolibarr.

Feature of the modulated

Conversion rate

The conversion rates are automatically loaded in an activation of the API module via the Internet. You can change the conversion rate manually in the administration of the module.

Currency Association third

When creating a record third, the module allows to associate a currency. The currency is automatically resumed when creating a document to the third party.

Bank account in foreign currency

When adding a regulation, if the currency of the bank account is identical to that of others, then there is no calculation of loss or gain currency conversion.

Purchase price supplier Devisé

The BUY_PRICE_IN_CURRENCY variable lets you determine tacitly motto of supplier purchase prices. This is specified in Home => Configuration -> Miscellaneous.

• If the value is 1 => Consider the purchase price as a supplier in the local currency thus associated PU PU HT = Currency / Rate provider.
• If the value is 0 => Consider the purchase price as supplier in the global currency Dolibarr therefore PU = PU currency * HT rate.

Association currency to a record

You can associate a specific currency at a document. The conversion rate is then stored in the document creation time (if there is an update rate between the creation of the order and billing rate will not have the same value on the invoice) .

Adding a document online

• Free Online => Conversion on the fly price currency according to the rate of the document.
• Product Line => Automatic conversion when processing the addition (invisible to the user).

Taking into account the multi-lingual

If the multi-language enabled in your Dolibarr, when generating the document in the language associated with the third in the PDF price currency will be automatically displayed in my place of standard prices.

Registration Regulation

When recording a settlement, the module calculates the price currency and / or the standard price depending on the currency of payment received. It will be added in the note of the Regulation, the amount of loss or gain due to the recording of the payment in case the conversion rate would have varied between receipt of payment and invoice creation.

Illustration of an example in stages :

• We are a French company using the euro currency and we sell bottled water at a price of € 2. We are dealing with a prospect using American currency U.S. dollars (USD).
• We make a business proposition by adding a line of 10 bottles of water. Then displays the rate and amount of the currency of our prospect, but also the PU of the currency and the total currency HT dual display currency we use.
• Click on the magnifying glass and generate in order to view the PDF of the propale.
• The prospect seems to have accepted the proposal, it is necessary to create an invoice by choosing the U.S. dollar currency. If the currency is entered on the third, it is automatically selected.
• When recording one or more payments for an invoice, we can see in the note of the amount of gains or the losses due to conversion rates.