Connecter Sellsy à votre logiciel métier

Que contient l'API v2 de Sellsy ?

L'API v2 de Sellsy est une API REST qui ouvre les objets commerciaux et comptables du compte : sociétés, particuliers, opportunités, devis, commandes, factures, avoirs, factures d'acompte, abonnements et livraisons. Son changelog officiel montre un rythme soutenu : il affiche la version 2.305.0 au 12 octobre 2026, et plusieurs versions publiées depuis juin 2026 concernent la facture électronique.

Quelques ajouts récents montrent ce qu'un logiciel métier peut piloter dans Sellsy :

• Conversion : un prospect, société ou particulier, passe en client par un appel dédié (version 2.223.0).
• Abonnements : modification et suppression d'échéances, avec un plafond de 500 échéances par abonnement.
• Livraisons : liste, recherche et lecture d'un bon de livraison.
• Règlements : enregistrement d'un paiement sur une facture depuis la version 2.274.0 du 1er juillet 2026.

Le même changelog signale des changements cassants, comme celui du 17 août 2026 (version 2.285.1), qui modifie un champ de la réponse des abonnements. Une intégration Sellsy se surveille donc dans la durée.

Personnel, Privé ou Public : quel accès API Sellsy créer ?

L'accès se crée dans Sellsy par Menu, Réglages, Portail développeur, onglet API V2, bouton « Créer un accès API ». On y nomme l'accès, on choisit le collaborateur rattaché, puis on coche les autorisations (scopes). Le Client ID et le Client Secret de l'accès se copient ensuite depuis le Portail développeur, et le jeton s'obtient en OAuth 2.0 auprès de login.sellsy.com.

Pour relier un logiciel métier à votre propre compte, l'accès Personnel est la voie habituelle. Selon le centre d'aide Sellsy, ses jetons deviennent inutilisables si le collaborateur rattaché est désactivé ou supprimé : l'attacher au compte d'un commercial, c'est programmer une panne pour le jour de son départ.

Combien de requêtes par jour selon votre formule Sellsy ?

Sur sa page des offres, relevée en octobre 2026, Sellsy affiche un quota quotidien de requêtes API pour chaque formule des gammes Vente & Facturation et Sellsy Vente :

Ces volumes laissent de la marge à la plupart des PME : pousser 300 factures par jour n'en consomme qu'une petite partie. Le danger vient d'un script qui relirait toutes les sociétés toutes les cinq minutes. La page des offres ne précise ni limite par seconde ni quota pour la gamme Sellsy Facturation seule : deux points à faire confirmer par Sellsy avant une reprise massive.

Que faut-il savoir des webhooks Sellsy ?

Un webhook Sellsy envoie une requête vers l'adresse de votre choix quand une action se produit dans le compte, par exemple la création d'un client ou la mise à jour d'un document. Seul un administrateur peut le configurer, dans Réglages, Portail développeurs, Webhooks, en version Slack ou HTTP.

• Objets concernés : le centre d'aide cite notamment collaborateurs, tiers, contacts, articles, factures, devis, commandes, opportunités, tickets, projets et dépenses.
• Format : le centre d'aide décrit un contenu envoyé au format « form-urlencoded » ; depuis la version 2.183.0 (mars 2025), le changelog de l'API prévoit, pour les webhooks créés par l'API, une option de contenu JSON et une option d'inclusion de l'objet dans le message.
• Authenticité : l'en-tête X-Webhook-Signature porte une empreinte SHA1 calculée avec une clé de signature personnalisable, que votre service vérifie avant tout traitement.
• Fiabilité : selon le centre d'aide Sellsy, le webhook n'attend pas de réponse et ne gère pas les erreurs.

Cette dernière phrase change la conception : si votre serveur redémarre au moment où une facture est validée, l'événement est perdu. Le webhook sert d'accélérateur, et une relecture planifiée des documents modifiés depuis le dernier passage sert de filet. Le principe est rappelé dans notre définition du webhook.

Facture électronique : ce que l'API Sellsy exige désormais

Sellsy se présente comme Plateforme Agréée pour la facturation électronique, et son API suit la réforme de près. Le changelog officiel en retrace les étapes de 2026 :

1. 17 juin 2026 (2.268.0) : statut d'enregistrement à la facture électronique sur les fiches sociétés.
2. 1er juillet 2026 (2.274.0) : adresse électronique de facturation sur les factures, avoirs, factures d'acompte et factures de situation, et statut de cycle de vie sur les factures et les avoirs.
3. 26 août 2026 (2.289.0) : appels d'activation de l'émission électronique.
4. 5 octobre 2026 (2.302.0) : sur un compte en émission électronique, une facture ne se valide plus sans adresse de facturation complète ; un client entreprise doit avoir un SIREN et un SIRET valides en France, ou un numéro de TVA intracommunautaire ailleurs dans l'Union européenne ; les taux de TVA non conformes sont refusés.

Conséquence pratique : un logiciel métier qui transmettait des fiches clients approximatives verra ses appels rejetés. Le chantier commence alors par la qualité des données dans votre propre outil, avant toute ligne de code côté Sellsy. Le calendrier de la réforme figure dans notre guide de la facture électronique 2026, et l'adaptation d'un outil interne dans notre page sur la facture électronique dans un logiciel métier.

Quatre flux entre un logiciel métier et Sellsy, pas à pas

1. Le chiffrage technique devient devis. Un bureau d'études dimensionne une ventilation dans son outil de calcul ; à la validation, le service d'intégration retrouve la société dans Sellsy par son SIREN, la crée si besoin, puis crée le devis avec les articles et quantités. Le chargé d'affaires l'envoie depuis Sellsy. Voir aussi automatiser vos devis.
2. La première commande convertit le prospect. Quand l'ERP enregistre la première commande d'un prospect, l'appel de conversion le fait passer en client dans Sellsy sans action d'un commercial.
3. Le contrat de maintenance devient abonnement. Un installateur de bornes de recharge signe un contrat annuel dans son outil de suivi de parc ; l'abonnement Sellsy est créé avec ses échéances et la facturation récurrente part de Sellsy.
4. Le règlement remonte sans pointage. Un paiement reçu sur le portail client est enregistré sur la facture Sellsy correspondante ; le service comptable voit la facture réglée sans rapprochement manuel.

Comment se déroule une intégration Sellsy, de l'inventaire à la production ?

1. Inventaire des flux : pour chaque donnée, quel outil fait foi (le client naît-il dans Sellsy ou dans l'ERP ?).
2. Clé de rapprochement : le SIREN, que l'API Sellsy exige désormais pour valider une facture électronique adressée à une entreprise française, devient l'identifiant commun. On recherche toujours avant de créer, ce qui évite les sociétés en double.
3. Accès et secrets : un accès Personnel rattaché à un administrateur durable, des scopes réduits, le secret rangé dans un coffre côté serveur.
4. Tests : les pages publiques de Sellsy consultées en octobre 2026 ne décrivent pas de bac à sable dédié ; on développe sur un compte séparé de la production, puis on bascule avec quelques documents contrôlés.
5. Données personnelles : Sellsy indique héberger les données en France ; côté logiciel métier, on ne copie que les champs utiles des contacts, et le journal garde des identifiants plutôt que des fiches entières.
6. Suivi : journal de chaque appel, alerte quand un document est rejeté, lecture régulière du changelog.

Place de marché, Make ou service d'intégration dédié ?

Avant de développer, regardez ce que Sellsy relie déjà. Sa place de marché annonce plus de 100 applications réparties en 21 catégories : comptabilité (ACD, Sage 100, MyUnisoft, Cegid Loop, Tiime), paiement (Stancer), e-commerce (Amazon Seller, Wix), téléphonie (Aircall, Allo). La page des offres coche aussi une intégration Zapier, et Sellsy présente Make comme un outil low-code bâti sur son API. L'éditeur propose enfin du développement personnalisé par son service Sellsy Services.

Quand le sur-mesure est retenu, YMHB Web écrit un service d'intégration dont le code vous appartient au paiement intégral : hébergé sur votre compte, table de correspondance entre identifiants Sellsy et identifiants de votre logiciel, relecture planifiée en complément des webhooks, documentation des champs échangés. La démarche générale est décrite dans notre page pour connecter ses logiciels par API. Si c'est Sellsy qui ne convient plus, voir les alternatives à Sellsy.