# Mapping d'intégration Sellsy

### Connexion à Sellsy

[Suivez ce guide](https://help.fincome.co/guide/sources/connecter-mon-compte-sellsy) pour établir la connexion à l'API Sellsy.

### Données synchronisées

| **Entité**            | **Champs clés synchronisés**                                                                                         |
| --------------------- | -------------------------------------------------------------------------------------------------------------------- |
| Clients               | id, nom, email                                                                                                       |
| Produits (Products)   | id, nom\_ou\_référence                                                                                               |
| Tarifs (Prices)       | id, montant\_HT, devise                                                                                              |
| Factures (Invoices)   | id, client\_lié, date\_d’émission, statut, numéro, quantité, montant\_HT, remises, TVA, période, devise, description |
| Avoirs (Crédit Notes) | même structure que les factures mais avec des montants négatifs                                                      |

***

### Fonctionnement détaillé de l'intégration

* Mapping structuré : chaque entité Sellsy est traduite selon un mapping champ par champ
* Filtrage intelligent des produits : seuls les articles non archivés et de type compatible sont importés
* Lignes de facture : chaque ligne est analysée individuellement pour détecter remises, TVA, quantité, description, etc.
* Montants convertis : les montants HT et les remises sont aussi restitués en devise de base
* Périodes de facturation : Fincome identifie les périodes (period\_start / period\_end) lorsqu’elles sont renseignées dans Sellsy
* Remontée des avoirs : les avoirs sont importés avec leurs lignes et associés à leurs factures d’origine

***

### À savoir

* Durée de la première synchronisation : quelques minutes à plusieurs heures selon le volume
* Synchronisation quotidienne : toutes les nuits automatiquement
* Modifications manuelles : jamais écrasées par une resynchronisation
* Ratelimit API Sellsy : géré automatiquement par Fincome
* Montants négatifs pour les avoirs : interprétés automatiquement

***

### Vue d'ensemble de l'intégration

| **Élément**                   | **Détail**                                                         |
| ----------------------------- | ------------------------------------------------------------------ |
| Méthode d’intégration         | OAuth 2.0 ou API token                                             |
| Entités prises en charge      | Clients, Produits, Tarifs, Factures, Avoirs                        |
| Fréquence de synchronisation  | Quotidienne (nuit)                                                 |
| Portée de l’import initial    | Toutes les données disponibles dans Sellsy                         |
| Méthode de synchronisation    | API REST + pagination                                              |
| Suppression de données Sellsy | Non propagée (les suppressions dans Sellsy ne sont pas répliquées) |

***

### Paramètres de données

| **Comportement / Réglage** | **Fonctionnement dans Fincome**                                 |
| -------------------------- | --------------------------------------------------------------- |
| Produits archivés          | Exclusion automatique                                           |
| Lignes de factures         | Import complet avec remises, TVA, périodes, descriptions        |
| Calculs HT et TTC          | Automatique (champ amount\_tax\_exc, tax\_amount)               |
| Conversion de devise       | Appliquée en fonction du champ currency\_code + date de facture |
| Traitement des avoirs      | Montants inversés, mais structure identique aux factures        |
| Données manuelles          | Modifiables sans être écrasées lors d’une nouvelle synchro      |

***

### Mapping technique (Sellsy → Fincome)

#### Clients

| Champ Sellsy | Champ Fincome |
| ------------ | ------------- |
| id           | original\_id  |
| name         | name          |
| email        | email         |

#### Produits & Tarifs

| Champ Sellsy      | Champ Fincome       |
| ----------------- | ------------------- |
| id (produit)      | original\_id        |
| name ou reference | name                |
| price\_excl\_tax  | amount              |
| currency\_code    | currency\_code      |
| id                | product\_id (tarif) |

#### Factures

| Champ Sellsy | Champ Fincome   |
| ------------ | --------------- |
| id           | original\_id    |
| date         | date            |
| number       | invoice\_number |
| status       | status          |
| company\_id  | customer\_id    |

#### Lignes de facture

| Champ Sellsy     | Champ Fincome                           |
| ---------------- | --------------------------------------- |
| id               | original\_id (ligne)                    |
| quantity         | quantity                                |
| amount\_tax\_exc | amount\_excluding\_tax\_after\_discount |
| tax\_amount      | tax\_amount                             |
| description      | description                             |
| period\_start    | period\_start                           |
| period\_end      | period\_end                             |
| currency\_code   | currency\_code                          |

#### Avoirs (Crédit Notes)

Même structure que les factures, avec :

* Montants négatifs
* Statuts spécifiques aux avoirs
* Références aux mêmes types de lignes

***

### 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