Passer au contenu principal
Anrok 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. 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 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. Dans le Stripe Dashboard, allez dans 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 pour plus de détails.
    1. Effectuez l’enregistrement fiscal dans les juridictions applicables pour la sales tax, la TVA et la GST.
  3. Connectez votre compte Stripe à Metronome.
  4. Liez chaque client Metronome à son Stripe customer ID.
  5. Assurez-vous que chaque client Stripe a une Customer 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.
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 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 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é 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 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 StripeClé vendor StripeEntité MetronomeClé Metronome
invoiceitem.priceproductContractProductstripe_product_id
  1. 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é, spend thresholds) : Définissez tax_type: "STRIPE" et payment_type: "INVOICE" dans le payment_gate_config. Consultez la documentation 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.
  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 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 — 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 : 
{
  "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 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.