Guide d'intégration Hyperline
Bienvenue dans le guide d'intégration de Hyperline avec Fincome. Ce document vous guide pas à pas pour connecter vos données de facturation Hyperline à Fincome.
Prérequis
Avant de commencer, assurez-vous que :
Vous êtes administrateur de votre compte Hyperline.
Vous êtes connecté à la plateforme Hyperline (session active).
Votre environnement autorise les redirections OAuth (HTTPS requis).
Présentation de l'intégration
L'intégration Hyperline permet une synchronisation automatique des éléments suivants dans Fincome :
Clients
Produits et plans
Abonnements
Factures et avoirs
Ces données sont ensuite transformées pour alimenter des indicateurs stratégiques comme le MRR, le churn, les cohortes, les revenus engagés, l’analyse des remises, et bien plus.
Étapes d'intégration
1. Connexion à Hyperline depuis Fincome
Connectez-vous à votre compte Fincome.
Accédez à l'onglet Données.
Cliquez sur Connecter un nouveau système de facturation :
Sélectionnez Hyperline.
Cliquez sur Connecter Hyperline :
Une fenêtre OAuth s’ouvre : connectez-vous à votre compte Hyperline et autorisez l’accès à Fincome.
Une fois la connexion établie, la synchronisation initiale démarre automatiquement.
2. Données synchronisées
Clients
ID, nom, email, pays, code postal
Produits & Plans
ID, nom, propriétés personnalisées
Le plan dans Hyperline (configuration de plusieurs produits à prix spécifiques) n’est pas restitué dans Fincome. Un plan chez Fincome représente un seul produit à un certain prix et périodicité de facturation.
Abonnements
ID, client lié, statut, dates de début/fin, valeur mensuelle, date de fin d’engagement
Factures & Avoirs
Facture : date d’émission, statut.
Lignes de facture : montants nets, remises, taxes, devises, périodes de facturation
Avoir : facture liée, date d’émission, statut
Ligne d’avoir : ligne de facture liée, montants nets
Fonctionnement détaillé de l'intégration
L'intégration avec Hyperline est conçue pour être fluide, fiable et transparente. Voici comment elle fonctionne :
Mapping intelligent des objets : chaque entité Hyperline (client, produit, abonnement, facture) est traduite dans Fincome avec précision champ par champ.
Détection des périodes d'essai : Fincome identifie automatiquement les périodes d'essai à partir de trial_ends_at ou à défaut de contract_start.
MRR granulaire : chaque ligne d’abonnement est suivie individuellement pour refléter les évolutions (upgrade, downgrade...).
Gestion des annulations : les abonnements annulés ou inactifs sont correctement traités, avec les dates d’annulation et de fin effective.
Analyse des remises : les remises issues des coupons Hyperline sont interprétées et ventilées (temporaire vs permanente).
Conversion des devises : toutes les données sont converties dans la devise de référence grâce aux taux de change en vigueur à la date de facturation.
Synchronisation intelligente : les mises à jour dans Hyperline sont détectées et resynchronisées automatiquement. Toute modification manuelle dans Fincome est prioritaire et conservée.
À savoir
Durée de la première synchronisation : plusieurs heures peuvent être nécessaires selon le volume de données.
Synchronisation quotidienne : chaque nuit automatiquement.
Écrasement manuel : toute modification faite dans Fincome prime sur les synchronisations futures.
Ratelimit Hyperline : géré automatiquement par Fincome avec relance après 30 secondes.
Expiration des tokens OAuth : rafraîchissement automatique par Fincome.
Vue d'ensemble de l'intégration
Élément
Détail
Méthode d’intégration
OAuth 2.0 (connexion directe depuis Fincome)
Entités prises en charge
Clients, Produits, Abonnements, Factures, Avoirs
Fréquence de synchronisation
Quotidienne (la nuit)
Portée de l'import initial
Données historiques depuis le 01/01/2007
Méthode de synchronisation
Pagination par curseur avec take et skip
Suppression de données depuis Hyperline
Non supportée – les suppressions dans Hyperline ne sont pas propagées
Paramètres de données
Comportement / Réglage
Fonctionnement dans Fincome
Détection des essais
Basée sur trial_ends_at ou contract_start
Calcul du MRR
À partir du plan de la ligne de produit, ajusté selon la devise et la date
Fin d’engagement contractuel
Issue de contract_end
Gestion des annulations
Basée sur detached_at ou cancel_at
Détail des abonnements
Chaque ligne d’abonnement est suivie séparément
Traitement des remises
Déduit depuis les coupons, temporaire ou permanente
Conversion de devises
Appliquée via currency_code et date de facturation
Resynchronisation
Automatique ; les modifications manuelles ne sont jamais écrasées
Mapping technique (Hyperline → Fincome)
Clients
Champ Hyperline
Champ Fincome
id
original_id
name
name
billing_email
country
country
billing_address.zip
zip_code
Produits & Plans
Champ Hyperline
Champ Fincome
id
original_id
name
name
id
plan.original_id
name
plan.name
id (produit)
plan.product_id
Abonnements
Champ Hyperline
Champ Fincome
id
original_id
customer_id
customer_id
status
status (interprété)
contract_start
trial_start
trial_ends_at / contract_start
trial_end
detached_at / cancel_at
canceled_at
attached_at
deal_closed_date
contract_start / attached_at
subscription_start_date
contract_end
contractual_commitment_end_date
id (plan)
plan_id
calculated
monthly_value / monthly_value_main
Factures & Lignes
Champ Hyperline
Champ Fincome
id
original_id (facture)
emitted_at
date
statut de facturation
status
invoice number
invoice_number
line_items.id
original_id (ligne)
units_count
quantity
amount_excluding_tax
amount_excluding_tax_after_discount
tax_amount
tax_amount
period_start / end
period_start / period_end
coupons
discount_amount(s)
Besoin d’aide ?
Notre équipe support est disponible via le chat de l’application ou par email : [email protected]
Prochaines étapes
Consultez vos KPIs dans les vues MRR, Churn, et Cohortes
Ajoutez d’autres sources de facturation (Stripe, Chargebee, etc.)
Enrichissez vos données clients (segmentation, taille d’entreprise...)
Planifiez une session avec votre Customer Success pour aller plus loin
Mis à jour