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

# Avalara

> Découvrez comment configurer Avalara AvaTax comme fournisseur de taxe avec Metronome et la facturation Stripe.

Si vous utilisez **Stripe** comme fournisseur de facturation, Avalara s'intègre via Stripe plutôt que directement avec Metronome via l'[application Avalara AvaTax](https://marketplace.stripe.com/apps/avalara-avatax) depuis le Stripe App Marketplace. Cela utilise le [framework d'applications de taxe tierces](https://docs.stripe.com/tax/third-party-apps) de Stripe pour un calcul de taxe en ligne.

## Prérequis

1. Installez l'[**application Avalara AvaTax**](https://marketplace.stripe.com/apps/avalara-avatax) dans votre dashboard Stripe. Connectez votre compte Avalara à Stripe et vérifiez la connexion dans les deux dashboards. Consultez la [page d'intégration Stripe d'Avalara](https://www.avalara.com/us/en/products/integrations/stripe-invoicing.html) pour la configuration côté Avalara.
2. Dans le Stripe Dashboard, allez dans [**Settings > Tax > Integrations**](https://dashboard.stripe.com/settings/tax/integrations) et confirmez qu'Avalara est sélectionné comme fournisseur de calcul de taxe et que « Use automatic tax » est activé (**ON**).
   1. [Effectuez l'enregistrement fiscal](https://docs.stripe.com/tax/registering) dans les juridictions applicables pour la sales tax, la TVA et la GST.
3. [Connectez votre compte Stripe](/fr/integrations/invoice-integrations/stripe) à Metronome.
4. Liez chaque client Metronome à son Stripe customer ID.
5. Assurez-vous que chaque client Stripe a une [**Customer Address**](https://docs.stripe.com/api/customers/object#customer_object-address) définie et est marqué comme **Taxable**.

<Note>
  Le champ Customer Address est l'objet `address` sur l'[objet Customer de Stripe](https://docs.stripe.com/api/customers/object#customer_object-address), qui détermine la juridiction fiscale. L'absence d'attribution d'une Customer Address entraîne l'échec de l'application de la taxe.
</Note>

## Étape 1 : Créer le champ personnalisé TaxCode

Pour transmettre les métadonnées de taxe de Metronome à Stripe :

1. Créez un [champ personnalisé](/fr/api-reference/custom-fields) sur l'entité **Product** dans Metronome nommé `TaxCode` (la casse exacte est requise par la [spécification de métadonnées d'Avalara](https://knowledge.avalara.com/bundle/ymp1659710033243_ymp1659710033243/page/Invoice_line_item_metadata.html)).
2. Pour chaque produit, définissez la valeur de `TaxCode` sur le tax code Avalara correspondant. Parcourez les codes disponibles dans le [catalogue de tax codes Avalara](https://taxcode.avatax.avalara.com/).

## Étape 2 : Créer des mappings d'entité

1. Allez dans **Connections > Integrations > Stripe > Edit Mapping**.
2. Ajoutez le mapping suivant :

| Entité vendor Stripe   | Clé vendor Stripe | Entité Metronome  | Clé Metronome |
| ---------------------- | ----------------- | ----------------- | ------------- |
| `invoiceitem.metadata` | `TaxCode`         | `ContractProduct` | `TaxCode`     |

<Note>
  Si une ligne n'a pas de tax code spécifié, la sales tax standard de l'État s'appliquera pour la juridiction du client. Définir explicitement les tax codes garantit une classification précise.
</Note>

3. Cliquez sur **Save**.

## Étape 3 : Configurer les paramètres de facture

Réglez **« Leave invoices as drafts »** sur **ON** dans les paramètres de votre intégration Stripe (sous **Connections > Integrations > Stripe > Settings**).

<Note>
  Avalara exige que les factures restent en brouillon pour qu'il puisse calculer et appliquer la taxe avant la finalisation.
</Note>

## Tester votre configuration

1. Utilisez votre **sandbox Metronome** (connecté à votre **Sandbox Stripe**) pour tester.
2. Créez un client avec un Stripe customer ID valide et une [Customer Address](https://docs.stripe.com/api/customers/object#customer_object-address).
3. Générez une facture dans Metronome et consultez la facture en brouillon dans Stripe.
4. Confirmez que les lignes de taxe apparaissent sur la facture Stripe finalisée après qu'Avalara l'ait traitée.

## FAQ et dépannage

**Q : Mes factures échouent ou sont finalisées sans taxe — que dois-je vérifier ?**

Commencez par confirmer que le client Stripe dispose d'informations de localisation suffisantes pour calculer avec précision les taux de taxe applicables. Assurez-vous que la [Customer Address](https://docs.stripe.com/api/customers/object#customer_object-address) et la tax location sont définies. Vérifiez ensuite que le paramètre « Leave invoices as drafts » est sur **ON** dans les paramètres de votre intégration Stripe, et que votre mapping d'entité est configuré avec des valeurs `TaxCode` sur vos produits Metronome.

Si tout semble correct, contactez votre représentant Metronome pour vérifier votre configuration fiscale.

**Q : La taxe est calculée, mais le taux semble incorrect ou s'affiche à 0 %.**

Avalara détermine les taux de taxe en fonction de l'adresse du client et du tax code attribué à la ligne. Certains produits — comme les SaaS dans certains États — peuvent être exonérés de taxe, ce qui entraîne un taux de 0 %. Vérifiez le tax code que vous avez attribué en consultant le [catalogue de tax codes Avalara](https://taxcode.avatax.avalara.com/).

Si le taux semble toujours incorrect, contactez directement le support Avalara, car la précision des taux de taxe est gérée de leur côté.

**Q : Que se passe-t-il si je n'attribue pas de `TaxCode` à un produit ?**

Si une ligne n'a pas de `TaxCode` défini dans ses métadonnées, Avalara applique un taux de taxe par défaut. Cela peut entraîner une classification fiscale incorrecte. Il est recommandé d'attribuer toujours un tax code explicite.

**Q : Dois-je définir un comportement de taxe par défaut dans Stripe ?**

Dans le dashboard Stripe, assurez-vous d'avoir un comportement de taxe par défaut sélectionné pour garantir que la taxe est correctement ajoutée à chaque facture.