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

![](https://storage.crisp.chat/users/helpdesk/website/-/6/2/0/e/620ea71851239000/logosellsy_17fthh4.png =100x68)
# Connexion à Sellsy

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