Connecter et enrichir ses données de facturation via l'API Fincome

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.

Partie 1 : Charger des données de facturation

Si Fincome n’est pas connecté à votre outil de paiement ou de facturation, vous pouvez injecter manuellement vos données de facturation via l’API. Ainsi, vous alimentez Fincome avec vos factures et abonnements existants. Points clés :

  • Objectif : Envoyer vos propres données de facturation (factures, abonnements) vers Fincome pour les intégrer aux analyses, par exemple lorsque aucune intégration automatique n’est disponible

  • Format attendu : Donné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, un montant, etc.). Assurez-vous de respecter les formats de date et les valeurs de statut valides (ex. open, paid, unpaid)

  • Endpoints à utiliser : Utilisez l’endpoint POST /invoices pour créer de nouvelles factures, ainsi que POST /subscriptions pour créer ou mettre à jour les abonnements associés. Chaque facture doit référencer un abonnement et un client existant afin d’être correctement rattachée dans Fincome.

Cas d’usage : 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.

Partie 2 : Enrichir vos données métier avec des attributs personnalisés

Vous pouvez également utiliser l’API Fincome pour enrichir vos données métier (clients, abonnements, plans tarifaires) en y ajoutant des attributs personnalisés. Ces informations supplémentaires vous permettent de segmenter et d’analyser vos indicateurs plus finement selon votre contexte métier :

  • Objectif : Ajouter des informations complémentaires à vos données existantes – par exemple le secteur d’activité d’un client, le gestionnaire de compte, la raison de résiliation (churn reason) d’un abonnement, le canal d’acquisition d’un client, etc. – afin d’adapter Fincome à vos besoins spécifiques.

  • Endpoints à utiliser : Pour enrichir ou mettre à jour ces données, utilisez les endpoints POST /clients (pour les clients), POST /subscriptions (pour les abonnements) et POST /plans (pour les offres tarifaires). Incluez vos attributs personnalisés dans le corps JSON de la requête (ils seront stockés comme champs additionnels de l’entité concernée).

Cas d’usage : Vous pouvez par exemple taguer chaque client avec un segment de marché (PME, grande entreprise, etc.), renseigner la raison de churn sur un abonnement résilié, ou indiquer le canal d’acquisition d’un client (ex : Organic, SEA, Partenaire). Ces propriétés personnalisées sont ajoutées lors de la création ou de la mise à jour des enregistrements via l’API.

  • Intérêt : Enrichir vos données métier avec des attributs personnalisés vous permet ensuite de filtrer, comparer et ventiler vos analyses dans Fincome en fonction de ces critères. Par exemple, vous pourrez filtrer le MRR par segment de clientèle ou comparer les taux de churn selon la raison de départ, afin d’obtenir des analyses plus pointues pour piloter votre activité.

Mis à jour