> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.fincome.co/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Mapping d'intégration Hyperline

![](https://storage.crisp.chat/users/helpdesk/website/-/6/2/0/e/620ea71851239000/hyperlinecologo_1q9oxgu.jpeg =100x100)
# Connexion à Hyperline

[Suivez ce guide](https://help.fincome.co/fr/article/connecter-mon-compte-hyperline-zbabt7/) 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, 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