Mapping d'intégration Sellsy
Connexion à Sellsy
Suivez ce guide 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 |
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
Mis à jour le : 04/06/2026
Merci !