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

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

Mis à jour le : 01/06/2026