Fincome API documentation

Fincome API | Fincome technical documentationdocs.fincome.co

L’API Fincome vous permet d’importer et de gérer les données de votre compte Fincome. Elle est accessible depuis l’interface (Réglages > Développeurs), où vous pouvez créer une clé secrète pour l’authentification.

En transmettant vos données au format JSON via nos endpoints dédiés, vous pouvez exploiter toutes les analyses Fincome (MRR, ARR, churn, revenue recognition...) comme si vos données provenaient d’une intégration native.

Cette méthode est particulièrement utile si :

• vous gérez vos factures dans un ERP interne non connecté,
• vous souhaitez automatiser l’import sans manipulation de fichiers,
• ou si vous migrez depuis un autre système de facturation.

Recommandations clés

Format attendu

Les données doivent être envoyées au format JSON standardisé, respectant le schéma requis par Fincome. Chaque facture doit contenir :

• un identifiant unique,
• l’ID du client associé,
• une date d’émission,
• un statut de paiement (open, paid, unpaid),
• et un montant HT. Assurez-vous de respecter les formats de date standards (ISO 8601) et les valeurs de statut valides.

Endpoints à utiliser

Tous les endpoints commencent par https://api2.fincome.co/product/v1/import/invoicing/. Envoyez vos objets dans cet ordre, pour que chaque objet puisse référencer le précédent :

• customer → vos clients
• product et price → vos produits et leurs prix
• subscription → les abonnements
• invoice et invoice_line_item → les factures et leurs lignes
• credit_note et credit_note_line_item → les avoirs et leurs lignes

Une fois l'import terminé, appelez une fois POST /v1/utils/refresh pour mettre à jour vos dashboards.

Chaque facture doit référencer un abonnement et un client existants afin d’être correctement rattachée dans Fincome.

Cas d’usage concret Par exemple, vous pouvez exporter les factures mensuelles de votre ERP interne au format JSON, puis les intégrer dans Fincome via l’API. Vos revenus seront ainsi pris en compte dans Fincome même si votre système de facturation n’est pas connecté en direct.

Point d’attention : Veillez à bien respecter le mapping des champs requis. Chaque enregistrement doit comporter des identifiants uniques (pour éviter les doublons), des dates correctement formatées, des montants facturés cohérents, et des statuts conformes aux attentes de Fincome. Un mapping correct garantit que vos données seront intégrées sans erreur et analysées correctement par la plateforme.

Limites d'appels et gros volumes

L'API accepte 5 requêtes par seconde et 200 requêtes par minute par compte. Au-delà, elle renvoie une erreur 429. Pour une reprise d'historique importante, prévenez le support avant de commencer. Tout est détaillé dans Limites d'appels de l'API Fincome (rate limit, erreur 429).

Business case

Chez Soeman, l’équipe technique a choisi d’intégrer Fincome via l’API afin de simplifier la gestion des données financières et d’offrir à la direction une vision fiable et en temps réel de ses KPI clés : ARR, MRR, churn, rétention.

Nous avons choisi l’API car c’est plus simple, automatisé et en temps réel. Cela nous évite les imports manuels via des fichiers CSV et permet à notre solution de transmettre automatiquement les informations.
Samuel Burey, Responsable technique chez Soeman

Grâce à cette intégration, Soeman a automatisé l’envoi de ses données, gagné en fiabilité, et supprimé toute manipulation manuelle. Un exemple concret de la puissance de l’API Fincome pour les entreprises à revenus récurrents.

🔗 Lire le témoignage complet : Retour d’expérience – Intégration API Fincome chez Soeman

Mis à jour le : 25/09/2026