Guide d'intégration Sellsy
Bienvenue dans le guide d’intégration de Sellsy avec Fincome. Ce document vous guide étape par étape pour connecter vos données de facturation Sellsy à Fincome.
Prérequis
Avant de commencer, assurez-vous que :
Vous êtes administrateur de votre compte Sellsy
Vous avez un accès API actif (ou une connexion OAuth si activée)
Vous êtes connecté à votre compte Fincome
Vous avez accès aux modules Clients, Produits, Factures, Avoirs dans Sellsy
Présentation de l'intégration
L’intégration Sellsy permet de synchroniser automatiquement les entités suivantes :
Clients (entreprises)
Produits & Tarifs
Factures
Avoirs (crédit notes)
Fincome transforme ces données pour produire des indicateurs financiers utiles, même en l’absence d’abonnements :
Chiffre d’affaires net mensuel
Analyse des remises
Comparatif HT / TTC
Suivi des paiements en multi-devises
Cohortes de facturation client
Étapes d'intégration
1. Connexion à Sellsy depuis Fincome
Connectez-vous à votre compte Fincome.
Accédez à l'onglet Données.
Cliquez sur Connecter un nouveau système de facturation :
Sélectionnez Sellsy dans la liste
Suivez les instructions OAuth (ou renseignez vos identifiants API si nécessaire)
Une fois l’accès validé, la synchronisation initiale démarre automatiquement.
2. Données synchronisées
Clients
ID, nom, email
Produits & Tarifs
Produit : ID, nom ou référence
Prix : ID, montant HT, devise
Factures
ID, client lié, date d’émission, statut, numéro
Lignes : 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
Aucun abonnement requis : même sans gestion d’abonnements dans Sellsy, Fincome peut reconstituer la récurrence client
À 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
Besoin d’aide ?
Notre équipe support est disponible via le chat de l’application ou par email : [email protected]
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