> ## 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.

# Anrok

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

[Anrok](https://www.anrok.com/) est une plateforme de conformité fiscale. Metronome s'intègre à Anrok via Stripe — Anrok fonctionne comme un fournisseur Stripe Tax via l'[application Stripe Anrok](https://marketplace.stripe.com/apps/anrok).

La principale différence est qu'Anrok gère le calcul de la taxe et la conformité plutôt que le moteur natif de Stripe.

## Prérequis

1. Installez l'[**application Anrok**](https://marketplace.stripe.com/apps/anrok) dans votre dashboard Stripe depuis le Stripe App Marketplace.
2. **Configurez Anrok** pour se connecter à votre compte Stripe. Suivez les instructions de configuration d'Anrok sur [anrok.com/integrations/stripe](https://anrok.com/integrations/stripe). Dans le Stripe Dashboard, allez dans **Settings > Tax > [Integrations](https://dashboard.stripe.com/settings/tax/integrations)** et confirmez qu'Anrok est sélectionné comme fournisseur de calcul de taxe et que « Use automatic tax » est activé (**ON**). Consultez le [guide des applications de taxe tierces de Stripe](https://docs.stripe.com/tax/third-party-apps) pour plus de détails.
   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**.
6. Une fois la configuration terminée, informez-en votre représentant Metronome pour qu'il puisse activer l'application de la taxe sur votre compte.

<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 des produits Stripe

Anrok utilise le produit Stripe sur chaque ligne de facture pour déterminer le traitement fiscal. Créez des produits Stripe et attribuez les [tax codes](https://docs.stripe.com/tax/tax-codes) appropriés.

Si un produit Stripe n'a pas de tax code attribué, Anrok se rabat sur une classification de produit par défaut. Cependant, il est recommandé d'attribuer explicitement les tax codes pour plus de précision.

## Étape 2 : Créer le champ personnalisé Stripe Product ID dans Metronome

1. Créez un [champ personnalisé](/fr/api-reference/custom-fields) `stripe_product_id` sur l'entité **Product** dans Metronome.
2. Pour chaque produit Metronome, définissez la valeur de `stripe_product_id` sur l'ID de produit Stripe correspondant.

Consultez [Stripe Tax Étape 2](/fr/integrations/tax-integrations/stripe-tax#step-2-create-the-stripe-product-id-custom-field-in-metronome) pour des instructions détaillées.

## Étape 3 : Configurer le mapping d'entité

Configurez le mapping d'entité dans Metronome pour transmettre l'ID du produit à Stripe :

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

| Entité vendor Stripe | Clé vendor Stripe | Entité Metronome  | Clé Metronome       |
| -------------------- | ----------------- | ----------------- | ------------------- |
| `invoiceitem.price`  | `product`         | `ContractProduct` | `stripe_product_id` |

3. Cliquez sur **Save**.

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

**Pour les factures à terme échu (factures d'usage de fin de période) :**

Anrok calcule la taxe en ligne via l'application Stripe. Vous n'avez pas besoin d'activer « Leave invoices as drafts » pour ce flow.

**Pour la facturation par seuil ([recharges de solde prépayé](/fr/guides/customers-billing/optimize-customer-experience/prepaid-balance-thresholds), spend thresholds) :**

Définissez `tax_type: "STRIPE"` et `payment_type: "INVOICE"` dans le `payment_gate_config`. Consultez la [documentation Stripe Tax threshold billing](/fr/integrations/tax-integrations/stripe-tax#threshold-billing) pour le payload exact d'API.

## Tester votre configuration

1. Utilisez votre **sandbox Metronome** (connecté au **mode test 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 et vérifiez dans Stripe qu'Anrok a appliqué la taxe.
4. Confirmez que les lignes de taxe apparaissent sur la facture Stripe finalisée.

## FAQ et dépannage

**Q : Mes factures échouent ou sont finalisées sans taxe — que dois-je vérifier ?**
Les causes les plus courantes sont une [Customer Address](https://docs.stripe.com/api/customers/object#customer_object-address) manquante sur le client Stripe ou un mapping d'entité incomplet dans Metronome. Commencez par confirmer que le client Stripe dispose d'informations de localisation suffisantes pour calculer avec précision les taux de taxe applicables. Vérifiez ensuite si le mapping d'entité est complet dans Metronome. Si les deux sont vérifiés et que la taxe n'est toujours pas appliquée, contactez votre représentant Metronome pour vérifier la configuration de votre compte.

**Q : Puis-je utiliser Anrok pour la conformité et Stripe Tax pour le calcul ?**

Oui. De nombreux clients utilisent Stripe Tax pour le calcul réel de la taxe et Anrok pour la conformité fiscale, la déclaration et le reporting. Dans ce cas, suivez le [guide de configuration de Stripe Tax](/fr/integrations/tax-integrations/stripe-tax) — Anrok récupère automatiquement les données de transaction de Stripe à des fins de conformité.

**Q : Comment vérifier qu'Anrok fonctionne ?**

Après avoir généré et finalisé une facture, vérifiez l'objet facture Stripe. Vous devriez voir :

```json theme={null}
{
  "automatic_tax": {
    "enabled": true,
    "provider": "anrok",
    "disabled_reason": null,
    "liability": {
      "type": "self"
    },
    "status": "complete"
  }
}
```

Si vous voyez `"enabled": false` ou `"provider": null`, l'intégration n'est pas active. Vérifiez que l'[application Anrok est installée](https://marketplace.stripe.com/apps/anrok) dans Stripe. Sinon, contactez votre représentant Metronome pour l'automatisation des taxes.

**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.