Mapping d'intégration Hyperline
Connexion à Hyperline
Suivez ce guide pour établir la connexion avec l'API Hyperline.
Données synchronisées
Entité Hyperline | Champs clés synchronisés |
|---|---|
Clients (Customers) | id, nom, email, pays, code_postal |
Produits (Product) | 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 une périodicité de facturation. |
Abonnements (Subscriptions) | id, client_id, statut, date_début, date_fin, valeur_mensuelle, date_fin_engagement |
Factures (Invoices) | id, date_émission, statut |
Lignes de facture (Invoice Line Items) | montants_nets, remises, taxes, devises, période_début, période_fin, revenue_type |
Avoirs (Credit Notes) | id, factureliée, dateémission, statut |
Lignes d’avoir (Credit Note Lines) | ligne_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.
- 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.
- Type de la ligne de facture (one-off ou subscription) : en fonction de règle propres à Hyperline
- lorsqu’un produit est rattaché à un abonnement avec une récurrence, la ligne est identifiée comme « recurring » ;
- lorsqu’un produit n’est pas rattaché à un abonnement, ou à un abonnement sans récurrence, la ligne est identifiée comme « one-off » ;
- lorsqu’un produit est rattaché à un abonnement récurrent et correspond à de l’usage, la ligne est identifiée comme « variable ».
À 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 type de la ligne de facture, 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 |
Abonnements
Champ Hyperline | Champ Fincome |
|---|---|
id | original_id |
customer_id | customer_id |
status | status |
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 |
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) |
revenue_type | type (sub ou one-off) |
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 le : 18/06/2026
Merci !