# Mapping d'intégration Sellsy ### Connexion à Sellsy [Suivez ce guide](/guide/sources/connecter-mon-compte-sellsy.md) 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 --- # 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-sellsy.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.