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
id
original_id
name
name
Produits & Tarifs
id (produit)
original_id
name ou reference
name
price_excl_tax
amount
currency_code
currency_code
id
product_id (tarif)
Factures
id
original_id
date
date
number
invoice_number
status
status
company_id
customer_id
Lignes de facture
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