# Mapping d'intégration Hyperline ### Connexion à Hyperline [Suivez ce guide](https://help.fincome.co/guide/sources/connecter-mon-compte-hyperline) 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, revenue\_type | | Avoirs (Credit Notes) | id, facture*lié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 | 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