Charger ses données de facturation via API

Résumé Découvrez comment importer vos données de facturation directement dans Fincome via l’API. Idéal si votre outil de facturation (ERP interne, logiciel maison, etc.) n’est pas connecté nativement.

L’API Fincome vous permet d’importer et de gérer les données de votre compte Fincome. Elle est accessible depuis l’interface (menu Réglages > API Developer), 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

• POST /invoices → pour créer de nouvelles factures

• POST /subscriptions → pour créer ou mettre à jour les abonnements associés

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.

Documentation technique API

Fincome API | Fincome technical documentationdocs.fincome.co

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