> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qwoty.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Devises et taxes

> Configurez les devises dans lesquelles vous établissez des devis et les taux de taxe que vous appliquez dans votre espace de travail.

Qwoty sépare la configuration des devises et des taxes en deux pages dédiées dans les paramètres de votre espace de travail. Ces deux éléments sont définis une seule fois au niveau de l'espace de travail, puis utilisés lors de la création des devis.

<Note>
  Vous devez avoir le rôle **Administrateur** pour ajouter, modifier ou supprimer des devises et des taxes.
</Note>

## Devises et taxes

Les devises définissent **les unités monétaires** dans lesquelles vous pouvez fixer vos prix. Les taxes définissent **les prélèvements** que vous appliquez en plus (ou en déduction) de ces prix. Qwoty les garde séparés car ils évoluent pour des raisons différentes — vous pouvez ajouter une devise lors de l'ouverture d'un nouveau marché, tandis que les taxes changent chaque fois qu'un pays met à jour ses règles fiscales.

| Paramètre   | Ce qu'il contrôle                                     | Où le trouver                               |
| ----------- | ----------------------------------------------------- | ------------------------------------------- |
| **Devises** | Devises disponibles pour la tarification et les devis | **Paramètres → Espace de travail → Devise** |
| **Taxes**   | Types de taxes et taux appliqués sur les devis        | **Paramètres → Espace de travail → Taxe**   |

## Gérer les devises

Les devises sont disponibles au niveau de l'espace de travail. Chaque devis est émis dans une seule devise, choisie lors de la création du devis.

### Accéder à l'écran des devises

<Steps>
  <Step title="Ouvrir les paramètres">
    Dans la barre latérale gauche, cliquez sur **Paramètres**.
  </Step>

  <Step title="Accéder à Devise">
    Dans la section **Espace de travail**, cliquez sur **Devise**. Vous verrez la liste des devises activées dans votre espace de travail.
  </Step>
</Steps>

### Ajouter une devise

<Steps>
  <Step title="Ouvrir le formulaire de devise">
    Cliquez sur **+ Nouvelle devise** (ou l'action d'ajout équivalente) en haut de la liste des devises.
  </Step>

  <Step title="Sélectionner une devise">
    Dans **Informations générales**, cliquez sur le menu déroulant **Devise**. Qwoty affiche une liste consultable des devises mondiales avec leur code ISO et leur symbole natif — par exemple :

    * Lek albanais (ALL) — L
    * Dollar australien (AUD) — A\$
    * Peso argentin (ARS) — \$
    * Dinar bahreïni (BHD) — د.ب

    Utilisez le champ de recherche pour filtrer par nom ou par code.
  </Step>

  <Step title="Définir le statut">
    Dans le panneau de droite, activez **Actif** pour rendre la devise disponible pour les nouveaux devis. Les devises inactives restent dans la liste mais ne peuvent pas être sélectionnées.
  </Step>

  <Step title="Ajouter un nom d'API (facultatif)">
    Renseignez le champ **Nom d'API** si vous devez référencer cette devise de manière programmatique dans des intégrations ou des webhooks. Cet identifiant est distinct du code ISO.
  </Step>

  <Step title="Définir comme valeur par défaut (facultatif)">
    Définissez **Est par défaut** sur `true` si cette devise doit être la valeur par défaut pour les nouveaux devis. Une seule devise peut être la valeur par défaut à la fois — définir une nouvelle valeur par défaut supprime ce statut de la précédente.
  </Step>

  <Step title="Enregistrer">
    Cliquez sur **Enregistrer** dans le coin supérieur droit. La devise apparaît dans votre liste et devient disponible sur les modèles de devis et les devis.
  </Step>
</Steps>

<Warning>
  Une fois un devis créé, sa devise est verrouillée. Pour changer de devise, dupliquez le devis et sélectionnez une devise différente lors de la création.
</Warning>

## Gérer les taxes

Les taxes sont configurées par pays et peuvent s'appliquer sous forme de pourcentage (calculé automatiquement sur les totaux du devis) ou de montant fixe (défini manuellement par transaction).

### Accéder à l'écran des taxes

<Steps>
  <Step title="Ouvrir les paramètres">
    Dans la barre latérale gauche, cliquez sur **Paramètres**.
  </Step>

  <Step title="Accéder à Taxe">
    Dans la section **Espace de travail**, cliquez sur **Taxe**. Vous verrez la liste des taxes configurées dans votre espace de travail.
  </Step>
</Steps>

### Types de taxes

Lorsque vous ajoutez une taxe, vous choisissez d'abord un **Type** parmi quatre valeurs prédéfinies. Le type détermine les champs que le formulaire vous demande de renseigner.

| Type              | Cas d'usage                                                                       | Modes disponibles      |
| ----------------- | --------------------------------------------------------------------------------- | ---------------------- |
| **TVA**           | Taxe sur la valeur ajoutée (la plupart de l'Europe, de nombreuses autres régions) | Pourcentage uniquement |
| **TPS**           | Taxe sur les produits et services (Australie, Canada, Inde, Nouvelle-Zélande)     | Pourcentage uniquement |
| **Taxe de vente** | Taxe de vente locale aux États-Unis                                               | Pourcentage uniquement |
| **Personnalisé**  | Tout autre prélèvement non couvert par les trois types ci-dessus                  | Pourcentage ou montant |

<Info>
  Choisissez **Personnalisé** lorsque vous devez configurer une taxe à montant fixe (par exemple, un droit de timbre ou une contribution réglementaire qui n'est pas un pourcentage du total).
</Info>

### Modes de calcul

Qwoty prend en charge deux modes de calcul :

* **Pourcentage** — Le montant de la taxe est calculé automatiquement en pourcentage de la base taxable. Vous saisissez un **Taux** (par exemple, `20` pour 20 %).
* **Montant** — La taxe est une valeur fixe que vous configurez manuellement, soit directement sur le devis, soit via des calculs spécifiques. Vous saisissez une **Devise** et un **Montant** (par exemple, `15` EUR).

<Note>
  Le mode pourcentage est disponible pour tous les types de taxes. Le mode montant est uniquement disponible lorsque le **Type** est défini sur **Personnalisé**. La TVA, la TPS et la taxe de vente sont toujours basées sur un pourcentage.
</Note>

### Ajouter une taxe

<Steps>
  <Step title="Ouvrir le formulaire de taxe">
    Cliquez sur **+ Nouvelle taxe** (ou l'action d'ajout équivalente) en haut de la liste des taxes.
  </Step>

  <Step title="Choisir le type de taxe">
    Dans **Informations générales**, sélectionnez le **Type** dans le menu déroulant : `TVA`, `TPS`, `Taxe de vente` ou `Personnalisé`.

    <Tip>
      Si vous choisissez **Personnalisé**, un champ **Nom** apparaît pour que vous puissiez nommer la taxe vous-même (par exemple, `Éco-participation`). Pour la TVA, la TPS et la taxe de vente, le nom est dérivé du type.
    </Tip>
  </Step>

  <Step title="Sélectionner le pays">
    Choisissez le **Pays** auquel cette taxe s'applique. Une configuration de taxe est associée à un seul pays — créez des entrées séparées pour chaque juridiction.
  </Step>

  <Step title="Choisir le mode de calcul">
    Cliquez sur **Pourcentage** ou **Montant**.

    * **Pourcentage** est le mode par défaut et le seul disponible pour la TVA, la TPS et la taxe de vente.
    * **Montant** est uniquement cliquable lorsque le type est **Personnalisé**.
  </Step>

  <Step title="Configurer le mode">
    <Tabs>
      <Tab title="Mode pourcentage">
        Saisissez le pourcentage dans le champ **Taux**. Par exemple, `20` pour une TVA de 20 %.
      </Tab>

      <Tab title="Mode montant">
        * Sélectionnez la **Devise** dans laquelle le montant est libellé.
        * Saisissez la valeur fixe du **Montant** (par exemple, `15`).
      </Tab>
    </Tabs>
  </Step>

  <Step title="Enregistrer">
    Cliquez sur **Enregistrer** pour créer la taxe. Elle devient disponible pour la sélection sur les devis et les modèles de devis.
  </Step>
</Steps>

### Appliquer une taxe à un devis

Les taxes sont appliquées au niveau de la ligne du devis ou au niveau du devis, selon la configuration du modèle.

* **Taxe par défaut par modèle** — définissez une taxe dans un modèle de devis afin que les nouveaux devis l'héritent.
* **Remplacement sur un devis** — un commercial peut remplacer ou ajouter des taxes lors de la modification d'un devis, selon ses permissions.
* **Taxes par ligne** — différentes lignes du même devis peuvent utiliser des taux de taxe différents (utile pour les catalogues à taux mixtes).

<Info>
  Les taxes transitent tout au long du cycle devis-revenus : elles apparaissent sur le devis, dans la vue Dealroom publiée, sur le document signé et finalement sur la commande.
</Info>

## Questions fréquentes

<AccordionGroup>
  <Accordion title="Puis-je changer la devise d'un devis après sa création ?">
    Non. La devise est verrouillée lors de la création du devis pour éviter les incohérences de tarification. Dupliquez le devis si vous devez l'émettre dans une autre devise.
  </Accordion>

  <Accordion title="Un client peut-il voir les prix dans sa propre devise automatiquement ?">
    Qwoty affiche le devis dans la devise choisie lors de sa création. Si vous avez besoin du même devis dans une devise différente, dupliquez le devis et changez la devise en haut du formulaire.
  </Accordion>

  <Accordion title="Puis-je désactiver une devise ?">
    Oui — définissez **Actif** sur `Inactif` sur une devise pour empêcher les nouveaux devis de l'utiliser. Les devis existants conservent leur devise d'origine.
  </Accordion>

  <Accordion title="Pourquoi le mode Montant est-il grisé pour la TVA, la TPS et la taxe de vente ?">
    Ces trois types de taxes sont toujours calculés en pourcentage de la base taxable. Pour utiliser une taxe à montant fixe, choisissez **Personnalisé** comme type.
  </Accordion>

  <Accordion title="Puis-je appliquer plusieurs taxes sur le même devis ?">
    Oui. Vous pouvez appliquer des taxes différentes sur des lignes différentes (par exemple, 20 % de TVA sur les produits, 0 % de TVA sur les services), et le total est la somme de toutes les taxes au niveau des lignes.
  </Accordion>

  <Accordion title="À quoi sert le champ Nom d'API ?">
    C'est un identifiant technique utilisé par les intégrations et les appels API pour référencer la devise ou la taxe. Utilisez une chaîne courte et unique sans espaces ni caractères spéciaux. Il est facultatif si vous ne prévoyez pas d'utiliser l'API.
  </Accordion>

  <Accordion title="Que se passe-t-il si je supprime une taxe utilisée sur des devis existants ?">
    Vous ne pouvez pas supprimer une taxe tant qu'elle est référencée par des devis ou des commandes actifs. Désactivez-la ou réaffectez les devis concernés à une nouvelle taxe au préalable.
  </Accordion>
</AccordionGroup>

## Voir aussi

<CardGroup cols={2}>
  <Card title="Paramètres généraux de l'espace de travail" icon="building" href="/user-guide/settings/workspace/general">
    Configurez la langue, le pays et d'autres paramètres par défaut de l'espace de travail.
  </Card>

  <Card title="Paramètres des devis" icon="hashtag" href="/user-guide/settings/workspace/quote-settings">
    Personnalisez la numérotation des devis et la résolution des associations.
  </Card>

  <Card title="Unités commerciales" icon="building-user" href="/user-guide/settings/workspace/business-units">
    Ajoutez des numéros de TVA par entité juridique et gérez la configuration fiscale multi-entités.
  </Card>

  <Card title="Types de tarification" icon="tag" href="/user-guide/catalog/reference/pricing-types">
    Découvrez comment les prix, les devises et les taxes se combinent sur les lignes de devis.
  </Card>
</CardGroup>