Synchronisation des revenus Stripe

Disponible

Cette intégration est active et prête à l'emploi sur tous les plans Pro.

Importe automatiquement vos encaissements Stripe en tant que factures enregistrées dans Frihet. Idéal pour les entreprises SaaS qui encaissent avec Stripe et ont besoin de maintenir leur facturation en ordre.

À quoi ça sert ?

Si vous encaissez avec Stripe et que vous souhaitez que ces encaissements apparaissent comme des factures dans Frihet sans les créer manuellement :

• Importation automatique — Chaque facture payée dans Stripe est convertie en une facture dans Frihet
• Synchronisation incrémentielle — N'importe que les nouveaux encaissements depuis la dernière synchronisation
• Déduplication — Une facture n'est jamais dupliquée, même si vous exécutez l'importation plusieurs fois
• Compatible VeriFactu — Les factures importées passent par la chaîne de hachage et la numérotation sans-saut (gap-free)

Différence avec l'intégration Stripe

	Stripe (OAuth)	Synchronisation des revenus Stripe
Connexion	OAuth (rediriger vers Stripe)	Clé API restreinte
Direction	Bidirectionnelle	Unidirectionnel Stripe → Frihet
Type	Paiements + abonnements + Connect	Uniquement les factures payées
Factures	Automatique par webhook	Importation à la demande + auto-synchronisation
Cas d'utilisation	Encaisser depuis Frihet	Enregistrer les encaissements Stripe dans Frihet

Utilisez Revenue Sync si : vous encaissez directement depuis Stripe (Dashboard, Billing, etc.) et que vous souhaitez que ces encaissements apparaissent dans Frihet pour votre comptabilité et vos déclarations.

Prérequis

• Compte Stripe actif — Créez-en un sur stripe.com
• Clé API restreinte — Avec des permissions de lecture seule sur les factures et les clients (invoices et customers)
• Frihet Pro ou supérieur — Non disponible avec le plan Free

Configurer la synchronisation des revenus Stripe

Étape 1 : Créez une clé API restreinte dans Stripe

1. Allez dans Stripe Dashboard → Developers → API Keys
2. Cliquez sur Create restricted key
3. Nom : Frihet Revenue Sync
4. Permissions requises :
   • Invoices → Read
   • Customers → Read
5. Copiez la clé (rk_live_...)

Étape 2 : Connectez-vous à Frihet

1. Allez dans Paramètres → Intégrations
2. Recherchez Synchronisation des revenus Stripe
3. Cliquez sur Connecter
4. Collez votre clé API restreinte
5. Sélectionnez la date à partir de laquelle vous souhaitez importer
6. Cliquez sur Enregistrer et connecter

Étape 3 : Importez les factures

1. Cliquez sur Importer maintenant
2. Frihet consultera les factures payées dans Stripe depuis la date sélectionnée
3. Chaque facture est créée en tant que brouillon et marquée comme payée
4. La numérotation sans-saut (gap-free) et le hachage VeriFactu sont appliqués automatiquement

Étape 4 : Activez l'auto-synchronisation (facultatif)

1. Dans l'onglet de configuration, activez Auto-sync
2. Frihet importera automatiquement les nouveaux encaissements toutes les 6 heures
3. Seules les nouvelles factures sont importées (synchronisation incrémentielle)

Comment ça fonctionne

Importation manuelle

1. Vous cliquez sur Importer maintenant
2. Frihet consulte GET /v1/invoices?status=paid dans Stripe
3. Pour chaque facture qui n'existe pas encore dans Frihet (par stripeInvoiceId) :
   • Crée une facture brouillon avec les données du client
   • La marque comme payée
   • Les déclencheurs Firestore sont exécutés : numérotation et hachage VeriFactu
4. Résultat : factures prêtes pour votre livre de comptes et vos déclarations

Auto-synchronisation (toutes les 6 heures)

1. Toutes les 6 heures, une fonction programmée est exécutée
2. Elle consulte uniquement les factures depuis lastSync (incrémentiel)
3. Importe automatiquement les nouvelles
4. Met à jour lastSync avec la date actuelle
5. Si elle détecte que votre clé API a expiré, elle marque l'intégration comme requiresReconnect

Déduplication

Chaque facture importée enregistre l'ID de facture Stripe (stripeInvoiceId) dans ses métadonnées. Si vous tentez d'importer la même facture deux fois, Frihet l'ignore automatiquement.

Mappage des données

Stripe	Frihet
invoice.customer_name ou customer_email	Nom du client
invoice.number	Référence (dans le concept)
line_items[].description	Lignes de la facture
line_items[].amount	Montant par ligne
invoice.tax	Impôts (le cas échéant)
invoice.created	Date de la facture
invoice.id	stripeInvoiceId (métadonnée)

Sécurité

• Clé API restreinte — Lecture seule des factures et des clients (invoices et customers). Pas d'accès à l'argent.
• Chiffrement AES-256-GCM — Votre clé API est stockée chiffrée sur le serveur
• Déconnexion instantanée — Révoquez l'accès dans les Paramètres quand vous le souhaitez
• Aucune donnée en transit — La communication avec Stripe est en HTTPS, la clé n'est jamais exposée au frontend

Déconnecter

1. Allez dans Paramètres → Intégrations
2. Recherchez Synchronisation des revenus Stripe
3. Cliquez sur Déconnecter
4. Confirmez l'action

Les factures déjà importées restent dans Frihet. Elles ne sont pas supprimées lors de la déconnexion.

Dépannage

"Aucune facture n'a été importée"

• Vérifiez que votre clé API dispose des permissions de lecture sur Invoices et Customers
• Assurez-vous que la date d'importation est antérieure à vos encaissements
• Seules les factures avec le statut paid dans Stripe sont importées
• Vérifiez que vous n'êtes pas en mode test de Stripe (utilisez les clés live)

"Reconnectez votre compte"

• Votre clé API a expiré ou a été révoquée
• Allez dans Stripe Dashboard → API Keys et créez-en une nouvelle
• Déconnectez et reconnectez-vous dans Frihet avec la nouvelle clé

"Facture en double"

• Cela ne devrait pas arriver. La déduplication par stripeInvoiceId l'empêche
• Si vous constatez des doublons, contactez le support

"Les montants ne correspondent pas"

• Frihet importe le montant tel que rapporté par Stripe
• Les commissions de Stripe ne sont pas déduites de la facture (elles constituent une dépense séparée)
• Vérifiez la devise : Stripe rapporte en centimes, Frihet convertit automatiquement

Prochaines étapes

• Utilisez Stripe pour encaisser directement
• Configurez les liens de paiement avec Stripe Connect
• Connectez également WooCommerce si vous avez une boutique

---

Suivant : Stripe Connect - Liens de paiement dans vos factures