nous contacter

Blog · Technique & intégrations

n8n et Sellsy : synchroniser devis, clients et compta sans ressaisie

n8n et Sellsy : reliez devis, clients et factures à vos autres outils par l'API v2. Accès OAuth, webhooks, 3 workflows types et pièges à éviter.

Publié le 2 novembre 2026

Illustration n8n et Sellsy : les devis, les clients et les factures Sellsy synchronisés par n8n avec le CRM, la compta et la messagerie
Illustration : GetBatch

Relier n8n et Sellsy permet de faire circuler les devis, les fiches clients et les factures entre Sellsy et le reste de vos outils (CRM, compta, messagerie, gestion de projet) sans que personne ne recopie quoi que ce soit. n8n n’a pas de nœud Sellsy intégré : on passe par l’API v2 de Sellsy, avec un accès OAuth et le nœud HTTP Request, ou par un nœud communautaire. Ce n’est pas plus compliqué, à condition de bien régler l’accès, la pagination et les webhooks. Voici comment nous construisons ces connexions, les trois workflows que nous livrons le plus souvent, et ce que la sortie de n8n 3.0 change pour vous.

Pourquoi connecter Sellsy à n8n ?

Sellsy réunit le CRM, les devis, la facturation et le suivi des paiements. C’est pratique tant que tout se passe dans Sellsy. Dès qu’un devis signé doit déclencher un projet, qu’un client existe déjà dans un autre CRM ou que l’expert-comptable travaille sur un autre logiciel, quelqu’un ressaisit. C’est là que les erreurs arrivent : un client en double, une adresse de facturation périmée, un devis signé que l’équipe de production découvre trois jours plus tard.

Les connecteurs natifs couvrent les cas standards. Ils s’arrêtent quand il faut une règle métier : ne créer le projet que pour certains produits, prévenir le commercial seulement au-delà d’un montant, rapprocher un client par son SIREN plutôt que par son nom. n8n sert précisément à écrire ces règles, et nous l’hébergeons chez vous, sur un serveur en France.

Le contexte réglementaire pousse dans le même sens. Depuis le 1er septembre 2026, toutes les entreprises assujetties à la TVA doivent pouvoir recevoir des factures électroniques, et l’obligation d’émettre s’étendra aux PME et micro-entreprises au 1er septembre 2027, comme le résume Previssima. Des données clients propres et synchronisées (raison sociale, SIREN, adresse) deviennent une condition pour que ces flux passent sans rejet.

n8n a-t-il un nœud Sellsy ?

Non, pas dans la bibliothèque officielle. Le paquet des nœuds intégrés de n8n ne contient aucun nœud Sellsy, contrairement à Make qui propose un module Sellsy. Vous avez donc deux options.

OptionAvantagesLimitesNotre usage
Nœud HTTP Request + identifiant OAuth2Rien à installer, couvre toute l’API, survit aux mises à jour de n8nIl faut lire la documentation de l’API pour chaque appelProduction
Nœud communautaire n8n-nodes-sellsy423 opérations prêtes, un déclencheur Sellsy, pagination automatiqueVersion 0.1.0, testée avec n8n 2.42.4, dépend d’un éditeur tiersPrototype

Le nœud communautaire est un bon accélérateur pour explorer l’API. Ses auteurs indiquent avoir exercé ses 423 opérations sur un compte d’essai Sellsy. Pour un flux qui tourne tous les jours chez un client, nous préférons le nœud HTTP Request : moins de dépendances, et rien qui casse le jour où n8n change ses règles sur les paquets communautaires. C’est justement ce qui arrive avec n8n 3.0 (voir plus bas).

Comment connecter n8n à l’API Sellsy v2 ?

Connexion n8n Sellsy : un accès API personnel créé dans Sellsy, un jeton OAuth obtenu par client credentials, puis les appels à l'API v2 depuis n8n La connexion n8n Sellsy en trois temps : l’accès API, le jeton OAuth, puis les appels à l’API v2.

1. Créer un accès API « Personnel » dans Sellsy

Dans Sellsy, ouvrez Réglages > Portail développeur > API V2 et créez un accès. Sellsy propose trois types d’accès, et un seul convient à un serveur n8n :

  • Personnel : accepte le flux OAuth « client credentials », celui qu’utilise un serveur sans intervention humaine. C’est celui qu’il faut.
  • Privé : impose une autorisation avec code et PKCE, pensée pour une application où un utilisateur se connecte.
  • Public : réservé aux éditeurs partenaires, avec validation par Sellsy.

Ces distinctions sont reprises dans la documentation du nœud communautaire Sellsy et dans l’aide Sellsy sur les types d’accès. Deux points à retenir : l’accès hérite des droits de l’utilisateur qui le crée, et le secret client ne s’affiche qu’une fois. Nous créons donc l’accès depuis un utilisateur technique dédié, avec les seuls droits nécessaires, et nous rangeons le secret dans le coffre de mots de passe du client.

2. Déclarer l’identifiant OAuth2 dans n8n

Dans n8n, créez un identifiant de type OAuth2 API :

  • Grant Type : Client Credentials ;
  • Access Token URL : https://login.sellsy.com/oauth2/access-tokens ;
  • Client ID et Client Secret : ceux de l’accès Sellsy ;
  • Authentication : Body.

n8n demande et renouvelle le jeton tout seul. Pour vérifier la connexion, un nœud HTTP Request en GET https://api.sellsy.com/v2/scopes avec cet identifiant doit renvoyer la liste des droits accordés.

Sous le capot, l’échange est un simple appel, utile pour tester depuis un terminal :

curl -X POST https://login.sellsy.com/oauth2/access-tokens \
  -d grant_type=client_credentials \
  -d client_id="$SELLSY_CLIENT_ID" \
  -d client_secret="$SELLSY_CLIENT_SECRET"

3. Partager l’identifiant au bon endroit

Depuis n8n 2.46, publiée le 27 octobre 2026, chacun peut utiliser ses identifiants personnels dans les projets d’équipe sans les partager. D’après le journal des changements de n8n, un coéquipier qui n’a pas le droit d’utiliser un identifiant ne peut plus exécuter ni publier le workflow qui s’en sert, et les données des exécutions concernées lui sont masquées. Conséquence pratique : un identifiant Sellsy rattaché au compte personnel d’un salarié bloquera ses collègues le jour où ils devront corriger le flux. Nous plaçons toujours l’identifiant Sellsy dans le projet de l’équipe, au nom de l’utilisateur technique.

4. Lire les listes page par page

Les listes et recherches de l’API v2 (par exemple /companies/search, /estimates/search, /invoices/search) sont paginées par curseur : chaque réponse donne dans pagination.offset le curseur de la page suivante. Dans le nœud HTTP Request, activez Pagination avec ces réglages :

Mode                : Update a Parameter in Each Request
Type / Name / Value : Query, offset, {{ $response.body.pagination.offset }}
Complete When       : Other
Complete Expression : {{ $response.body.data.length < 100 }}
Query               : limit = 100

Réglez Interval Between Requests à quelques centaines de millisecondes sur les gros volumes, et activez Retry On Fail sur le nœud : une API qui répond trop vite « trop de requêtes » se gère par une nouvelle tentative, pas par une alerte à 3 h du matin.

Quels workflows n8n Sellsy mettre en place ?

Trois workflows n8n Sellsy : devis signé vers projet et équipe, synchronisation des clients avec le CRM, factures vers la compta et les relances Les trois flux n8n Sellsy que nous livrons le plus souvent, avec la vérification humaine là où l’argent est en jeu.

1. Devis signé : lancer le projet sans attendre

Un webhook Sellsy prévient n8n quand le statut d’un devis change. Si le devis passe en « accepté », le workflow lit le devis complet (GET /estimates/{id}), crée le projet dans l’outil de l’équipe (Trello, Asana, Notion ou une simple liste SharePoint), ouvre le dossier partagé et prévient le responsable sur Teams ou Slack avec le montant et les lignes du devis. Le commercial n’a plus à transmettre quoi que ce soit.

2. Clients : une seule fiche, à jour partout

Quand une fiche arrive d’un autre outil (HubSpot, Pipedrive, formulaire du site), le workflow cherche d’abord l’entreprise dans Sellsy avec /companies/search. Nous rapprochons par SIREN quand il existe, puis par domaine de l’adresse email, et seulement en dernier recours par le nom. Si l’entreprise existe, on met à jour ; sinon, on crée. Ce contrôle évite la première source de doublons : « Dupont SAS » et « DUPONT » enregistrés comme deux clients.

3. Factures : alimenter la compta et les relances

Chaque nuit, un workflow liste les factures émises ou payées depuis la veille (/invoices/search) et les envoie là où elles sont attendues : le logiciel de l’expert-comptable, un tableau de trésorerie, ou un agent de relance. Nous détaillons ce dernier cas dans notre article sur l’agent IA de relance des factures, et le pendant côté fournisseurs dans n8n et Pennylane.

Une règle que nous appliquons partout : n8n ne crée jamais une facture définitive tout seul. La numérotation des factures est séquentielle et une facture validée ne s’efface pas. Le workflow prépare des brouillons, un humain valide.

Comment déclencher n8n en temps réel avec les webhooks Sellsy ?

L’API v2 expose la liste des événements disponibles (GET /webhooks/events) : entreprise créée, statut de devis modifié, facture payée, etc. Vous créez un webhook Sellsy qui pointe vers l’adresse d’un nœud Webhook de n8n. Deux conditions :

  1. L’adresse doit être joignable depuis internet, en HTTPS. C’est le cas d’un n8n auto-hébergé derrière un reverse proxy, comme ceux que nous installons ; ce n’est pas le cas d’un n8n lancé sur un poste de travail.
  2. Le webhook ne suffit pas. Un événement peut se perdre (serveur redémarré, panne réseau). Nous ajoutons toujours un rattrapage : un workflow planifié qui relit les objets modifiés depuis la dernière exécution et traite ceux qui ont manqué. Les traitements doivent donc être idempotents : traiter deux fois le même devis ne doit pas créer deux projets. Une table de suivi (identifiant Sellsy, date de traitement) dans Postgres ou dans une Data Table n8n suffit.

Le nœud communautaire fournit un déclencheur Sellsy Trigger qui enregistre et supprime le webhook tout seul à l’activation du workflow. C’est confortable, avec la même réserve que plus haut sur les paquets communautaires.

Quels pièges éviter avec l’API Sellsy ?

  • Les droits trop larges. L’accès personnel reprend les droits de son créateur. Créé depuis le compte du dirigeant, il ouvre toute la base à n8n. Un utilisateur technique aux droits limités réduit l’exposition.
  • Les montants. Vérifiez toujours si un champ est HT ou TTC et dans quelle devise avant de l’envoyer à la compta. Un contrôle simple (HT + TVA = TTC, à l’arrondi près) dans un nœud Code arrête la plupart des erreurs.
  • Les identifiants Sellsy en dur. Les identifiants de taxes, d’unités ou de modèles de documents changent d’un compte à l’autre. Nous les lisons par l’API au démarrage du flux ou les gardons dans des variables, jamais dans le corps des nœuds.
  • Le silence. Un flux qui échoue sans prévenir est pire qu’un flux absent. Chaque workflow Sellsy que nous livrons est rattaché à un workflow d’erreur qui envoie une alerte avec le nom du flux, l’objet concerné et le message de Sellsy.

Pour aller plus loin sur l’architecture des connexions entre outils métier, voyez notre article sur les intégrations aux outils métier et la liste des outils que nous connectons.

Qu’est-ce que n8n 3.0 change pour une intégration Sellsy ?

n8n a publié le 27 octobre 2026 la première bêta de n8n 3.0, avec une version stable annoncée pour début décembre. Selon la liste officielle des changements incompatibles, trois points touchent directement les flux Sellsy :

Changement en n8n 3.0Impact sur un flux SellsyCe que nous faisons
N8N_UNVERIFIED_PACKAGES_ENABLED passe à false par défaut : les nœuds communautaires non vérifiés ne se chargent plusUn workflow bâti sur un nœud Sellsy non vérifié s’arrête après la mise à jourNœud HTTP Request en production, ou variable remise à true en connaissance de cause
Les nœuds Function, Function Item, Cron et Interval sont supprimésLes anciens flux de synchronisation planifiés échouentCode node et Schedule Trigger dès la construction
Le délai des tâches du nœud Code (N8N_RUNNERS_TASK_TIMEOUT) passe de 300 à 60 secondesUn gros traitement de factures en une seule tâche peut échouerTraitement par lots, ou délai fixé explicitement

Avant de monter de version, le menu Settings > Migration Report de n8n liste les workflows concernés. Nous détaillons la routine complète dans mettre à jour n8n sous Docker. Si vous construisez vos flux Sellsy maintenant, faites-le directement avec les nœuds qui restent en version 3 : vous n’aurez rien à migrer en décembre.

Combien de temps pour connecter Sellsy à n8n ?

Le branchement technique (accès API, identifiant, premier appel) se fait dans la journée. Ce qui prend du temps, ce sont les règles : quand un client est-il un doublon, quel statut de devis déclenche quoi, qui valide. Pour un premier flux bien défini, comme le devis signé qui lance le projet, comptez quelques jours entre l’atelier de cadrage et la mise en production, tests compris. Une automatisation ciblée de ce type se situe le plus souvent autour de 2 000 €, sur devis. C’est le travail que fait notre agence n8n : cadrer les règles avec vous, construire les flux sur votre serveur, puis les surveiller.

Questions fréquentes

Faut-il un abonnement Sellsy particulier pour utiliser l’API ?

L’accès à l’API v2 se crée depuis le portail développeur de votre compte Sellsy. Les modules disponibles (devis, facturation, CRM) dépendent de votre abonnement : l’API ne donne accès qu’aux objets de votre offre. Vérifiez avec Sellsy si un module vous manque.

Peut-on utiliser Make plutôt que n8n avec Sellsy ?

Oui, Make propose un module Sellsy prêt à l’emploi, ce qui va plus vite pour les cas simples. n8n devient intéressant quand les règles se compliquent, quand le volume fait grimper la facture Make ou quand vous voulez héberger les données chez vous. Nous livrons sur les deux.

Les données Sellsy passent-elles hors de France avec n8n ?

Pas si n8n est auto-hébergé sur un serveur en France, comme nous le faisons. Les données transitent entre Sellsy et votre serveur. Si un flux appelle un modèle d’IA, c’est ce modèle qu’il faut choisir avec soin.

Que se passe-t-il si Sellsy modifie son API ?

L’API v2 est versionnée et Sellsy publie un journal des changements. Un flux construit avec le nœud HTTP Request se corrige en modifiant un appel. Avec un nœud communautaire, il faut attendre que son éditeur le mette à jour, ou basculer sur HTTP Request.

Relier Sellsy au reste de vos outils supprime une ressaisie que personne ne regrette, à condition de soigner l’accès, les doublons et la surveillance. Notre agence n8n installe ces flux sur un serveur en France, les documente et les maintient, y compris lors du passage à n8n 3.0. Parlons de vos devis et de vos factures.

→À lire ensuite