Prérequis
- Installez l’application 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 pour la configuration côté Avalara.
- Dans le Stripe Dashboard, allez dans Settings > Tax > Integrations et confirmez qu’Avalara est sélectionné comme fournisseur de calcul de taxe et que « Use automatic tax » est activé (ON).
- Effectuez l’enregistrement fiscal dans les juridictions applicables pour la sales tax, la TVA et la GST.
- Connectez votre compte Stripe à Metronome.
- Liez chaque client Metronome à son Stripe customer ID.
- Assurez-vous que chaque client Stripe a une Customer Address définie et est marqué comme Taxable.
Le champ Customer Address est l’objet
address sur l’objet Customer de Stripe, qui détermine la juridiction fiscale. L’absence d’attribution d’une Customer Address entraîne l’échec de l’application de la taxe.Étape 1 : Créer le champ personnalisé TaxCode
Pour transmettre les métadonnées de taxe de Metronome à Stripe :- Créez un champ personnalisé sur l’entité Product dans Metronome nommé
TaxCode(la casse exacte est requise par la spécification de métadonnées d’Avalara). - Pour chaque produit, définissez la valeur de
TaxCodesur le tax code Avalara correspondant. Parcourez les codes disponibles dans le catalogue de tax codes Avalara.
Étape 2 : Créer des mappings d’entité
- Allez dans Connections > Integrations > Stripe > Edit Mapping.
- Ajoutez le mapping suivant :
| Entité vendor Stripe | Clé vendor Stripe | Entité Metronome | Clé Metronome |
|---|---|---|---|
invoiceitem.metadata | TaxCode | ContractProduct | TaxCode |
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.
- 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).Avalara exige que les factures restent en brouillon pour qu’il puisse calculer et appliquer la taxe avant la finalisation.
Tester votre configuration
- Utilisez votre sandbox Metronome (connecté à votre Sandbox Stripe) pour tester.
- Créez un client avec un Stripe customer ID valide et une Customer Address.
- Générez une facture dans Metronome et consultez la facture en brouillon dans Stripe.
- 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 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 valeursTaxCode 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.
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.