# Mapping d'intégration Hyperline
### Connexion à Hyperline
[Suivez ce guide](/guide/sources/connecter-mon-compte-hyperline.md) 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
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://help.fincome.co/ressources/mapping-dintegration-et-api/mapping-dintegration-hyperline.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.