Relier votre logiciel métier à EBP : API REST des offres SaaS, extensions Open Line et fichiers

EBP en SaaS ou installé : la question qui décide de la méthode

La méthode dépend d'abord du mode de déploiement de votre EBP, car l'éditeur n'ouvre pas les mêmes portes dans les deux cas. La page Produits du portail développeurs d'EBP présente les API REST disponibles « pour les produits EBP Informatique Saas », et la fiche de la Gestion Commerciale ELITE 2025 précise que l'API REST est réservée à l'abonnement SaaS, avec souscription à l'offre de services PREMIUM.

EBP fait partie du groupe Cegid depuis le 17 juillet 2024, date à laquelle Cegid a annoncé avoir conclu son acquisition ; EBP garde sa propre documentation développeur, distincte de celle décrite sur notre page connecter Cegid.

Que couvrent les API REST d'EBP ?

La documentation des API REST d'EBP regroupe sept familles d'API, qui ne font pas toutes la même chose : certaines lisent, d'autres écrivent, d'autres passent par des imports.

Pour la saisie comptable HUBBIX, la documentation détaille le mode de saisie (la valeur documentée est « Provisoire »), le code journal et des lignes portant date, compte général, compte de tiers facultatif, libellé, débit et crédit. Dans cette même API HUBBIX Comptabilité TPE, les listes de tiers, de comptes généraux, d'écritures et d'opérations bancaires se paginent par un paramètre take, qui vaut 100 par défaut ; la documentation ne le décrit pas pour les autres API.

Abonnement, jetons, en-têtes : le parcours imposé par EBP

L'accès aux API d'EBP se fait en deux temps : un abonnement validé par EBP, puis une autorisation OAuth 2.0. Le portail développeurs le décrit ainsi :

1. inscription sur le portail avec ses identifiants EBP ;
2. choix du produit, par exemple Gestion Commerciale SaaS, saisie du nom de la société et acceptation des conditions d'utilisation ;
3. attente de la validation par EBP, après quoi les clés primaire et secondaire apparaissent dans le profil, et l'identifiant client et le secret arrivent par e-mail ;
4. pour une application hébergée sur un serveur, envoi de son adresse de redirection à EBP ;
5. première connexion d'un utilisateur EBP, qui fournit un code d'autorisation valable cinq minutes, échangé contre les jetons.

Chaque appel porte ensuite deux en-têtes, la clé d'abonnement (ebp-subscription-key) et le jeton (Authorization: Bearer), avec les portées openid, profile et offline_access. Le jeton d'accès vaut une heure ; le jeton de rafraîchissement vaut trente jours et ne sert qu'une fois. EBP précise que ses API ne prennent pas en charge l'authentification de machine à machine : un utilisateur consent une première fois, puis le service d'intégration entretient la chaîne de jetons. En comptabilité HUBBIX, l'en-tête tenantid désigne le dossier par son UUID, et les exemples pointent vers un environnement de préproduction. Une charte d'utilisation en huit articles encadre l'usage, mesures de sécurité et sanctions comprises.

Et quand EBP est installé sur vos postes ?

Deux voies restent ouvertes sans passer au SaaS.

Les extensions Open Line. EBP publie une « API pour EBP Gestion Commerciale Open Line » : une bibliothèque .NET dont les espaces de noms couvrent notamment la base de données, les entités, la facturation, les formulaires, les menus et l'import générique. Le tutoriel d'EBP montre le principe : en mode développeur, on crée des tables personnalisées, on génère les interfaces, puis on compile en C# une DLL que le logiciel charge par Paramètres, Société, Extensions liées. Les projets d'exemple couvrent les versions 8.1.1 à 11.0.0, dont une action de panachage d'articles sur les documents de vente. Deux règles du tutoriel comptent : l'identifiant d'une extension ne doit plus changer une fois utilisée, et supprimer une extension efface ses données.

Les fichiers. Selon la fiche ELITE 2025, la gestion commerciale importe et exporte en CSV clients, articles, unités, localisations, fournisseurs et familles, exporte les factures au format Factur-X et les écritures au format du logiciel du cabinet ou au format FEC. Pour un flux quotidien, un dépôt de fichiers programmé, contrôlé à l'import, suffit souvent.

Cinq flux concrets avec EBP

1. Le devis du métreur. Dans une menuiserie, le métreur chiffre sur tablette chez le client ; l'application crée le client s'il n'existe pas, puis le devis dans HUBBIX Gestion Commerciale TPE, où il suit le circuit habituel jusqu'à la facture.
2. La marge par chantier. Chaque soir, un outil lit par la SAAS API Bâtiment les affaires et les documents de vente et d'achat, puis calcule pour chaque affaire l'écart entre vendu et acheté (le filtre exact se valide au cadrage, sur votre dossier). Voir la rentabilité par chantier.
3. Les ventes de la boutique en ligne. Si les catégories d'import de votre offre couvrent le document voulu, la boutique dépose ses ventes par la SAAS API Import, selon un modèle défini une fois ; le service suit le statut d'exécution et relance l'import en cas d'échec.
4. Les justificatifs de dépenses. Une application de notes de frais ajoute la pièce jointe dans HUBBIX Comptabilité TPE et passe l'écriture en mode provisoire : le comptable la valide après contrôle.
5. L'encours en réunion commerciale. Les indicateurs d'encours clients et de taux de transformation des devis de l'API HUBBIX alimentent un tableau de bord de pilotage, sans export manuel.

Ce que la documentation EBP ne règle pas pour vous

• Pas de webhooks. Aucune notification n'est décrite : pour suivre les nouvelles factures, le service interroge EBP avec des filtres, à intervalles réguliers.
• Pas de limites d'appels publiées. La documentation consultée en octobre 2026 n'en mentionne pas : le service espace quand même ses appels et traite chaque refus sans boucler.
• Un jeton de rafraîchissement à usage unique. Il est enregistré à chaque renouvellement, dans un coffre de secrets ; s'il se perd, un utilisateur doit se reconnecter.
• Des imports asynchrones. Une demande d'import n'est réussie qu'une fois son statut confirmé ; le journal garde la trace de chaque demande.
• Les doublons. Une table de correspondance relie vos identifiants à ceux d'EBP et se consulte avant chaque création, pour éliminer les doubles saisies.
• Le RGPD. Clients et tiers sont souvent des personnes physiques : seuls les champs utiles circulent.

Connecteur existant ou développement : comment trancher

Regardez d'abord ce qui existe. EBP référence des applications d'éditeurs partenaires qui synchronisent des informations, stockent des données ou envoient des documents personnalisés. La fiche ELITE 2025 cite des liens avec des solutions e-commerce (Huggii, Atoo Next, ePages, NewOxatis), qui demandent l'offre du partenaire, et une liaison avec GoCardless pour les prélèvements, présentée sur notre page GoCardless.

Le développement se justifie quand l'outil à relier vous est propre : application terrain, portail client, logiciel d'atelier. YMHB Web écrit alors le service d'intégration en technologies standard, après un cadrage sur votre abonnement EBP réel. Le code et la documentation des flux (API utilisées, champs, procédure de renouvellement des jetons) vous sont remis et vous appartiennent au paiement intégral. Si la gestion commerciale elle-même ne suit plus, voyez plutôt les alternatives à EBP.