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 (Products)
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
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.
À 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
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)
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