PERSYSTDocs
Connecteurs

Connecter EBP Gestion Commerciale à Persyst

Préparer l’accès API EBP SaaS, connecter un dossier et ouvrir ses outils de lecture aux membres autorisés.

Persyst permet de consulter EBP Gestion Commerciale SaaS depuis un assistant compatible MCP. Un administrateur connecte un dossier avec son application EBP ; il ouvre ensuite la source et les outils nécessaires aux personnes ou équipes concernées.

Le connecteur est en lecture seule. Il couvre les articles, l’identité des clients et fournisseurs, les stocks, les documents de vente et d’achat et certains référentiels. Consultez aussi la présentation du connecteur EBP.

Préparer l’accès EBP

Vérifiez avec EBP que votre abonnement donne accès à l’API Gestion Commerciale SaaS. Le centre d’aide EBP indique qu’un contrat d’assistance est nécessaire pour accéder au module API Rest. Les licences et conditions EBP restent applicables.

Préparez quatre valeurs auprès du portail développeur EBP et du responsable de votre application :

Valeur dans PersystÀ préparer
Client ID EBPIdentifiant de l’application OAuth EBP
Client Secret EBPSecret de cette même application
Clé d’abonnement EBPClé d’abonnement à l’API Gestion Commerciale, envoyée par le serveur comme ebp-subscription-key
Identifiant du dossier EBPIdentifiant natif du dossier à partager, issu de l’opération EBP de liste des dossiers

Faites autoriser par EBP l’URL de redirection de votre application. Pour le service Persyst hébergé standard :

https://api.persyst.ai/integrations/ebp/callback

La documentation d’authentification EBP explique la procédure d’autorisation de cette URL. Pour un autre déploiement Persyst, utilisez l’adresse API de ce déploiement suivie de /integrations/ebp/callback ; en local, EBP_CALLBACK_URL permet de la configurer. Une URL locale doit aussi être acceptée par EBP pour tester le consentement.

L’autorisation OAuth utilise les scopes openid profile offline_access. Elle demande un consentement interactif : les identifiants de l’application seuls ne remplacent pas l’autorisation d’un compte ayant accès au dossier.

Trouver l’identifiant du dossier

Depuis le portail ou un client API autorisé, utilisez l’opération Obtenir les dossiers de gestion :

GET https://api-developpeurs.ebp.com/gescom/api/v1/Folders

Relevez l’id correspondant au bon nom dans folders, en parcourant les pages si nécessaire. Ne confondez pas cet identifiant EBP avec le sourceId que Persyst attribuera à la connexion. Les assistants n’ont pas à recevoir le jeton OAuth ou la clé d’abonnement.

Connecter le dossier dans Persyst

  1. Dans Sources de données → Ajouter une source, choisissez EBP.
  2. Renseignez les quatre valeurs préparées ci-dessus dans le formulaire Persyst.
  3. Cliquez sur Autoriser dans EBP et autorisez le compte EBP qui peut lire le dossier choisi.
  4. Au retour, vérifiez le nom EBP · nom du dossier. Persyst vérifie le dossier auprès de l’API avant d’activer la connexion.
  5. Dans Gestion des accès, ouvrez la source aux bénéficiaires et sélectionnez leurs outils.

Créez une source par dossier pour séparer leurs accès. Les membres consultent la source avec la connexion partagée et les droits Persyst accordés ; ils n’utilisent pas leur propre identité EBP pour ces lectures. Les droits du compte qui a autorisé la connexion limitent ce que l’API peut retourner.

Les secrets sont stockés chiffrés côté serveur. Saisissez-les dans le formulaire, jamais dans une conversation avec votre assistant.

Choisir les outils autorisés

OutilUsage
list_ebp_foldersIdentifier les sources et dossiers accessibles au membre
ebp_apiRechercher les opérations, décrire leurs paramètres et champs, puis lire avec le droit métier correspondant
read_ebp_itemsArticles, familles, caractéristiques et stocks globaux
read_ebp_customersIdentité commerciale des clients et prospects
read_ebp_suppliersIdentité et statut des fournisseurs
read_ebp_stockStocks réels et virtuels par article et dépôt
read_ebp_salesDocuments de vente, par type et période, avec lignes en option
read_ebp_purchasesDocuments d’achat et références fournisseur, minimums, multiples et délais
read_ebp_reference_dataFamilles, sous-familles, groupes et dépôts

Le catalogue ebp_api ne donne pas à lui seul accès à toutes les données. Par exemple, lire les stocks via ce catalogue exige aussi read_ebp_stock. Les droits sont vérifiés à chaque appel ; retirer un accès empêche les lectures suivantes. Les appels sont tracés dans le suivi d’utilisation Persyst.

Interroger le catalogue API depuis l’assistant

Le parcours technique conseillé est le suivant :

  1. Appeler list_ebp_folders et retenir le sourceId Persyst de la source voulue.
  2. Appeler ebp_api avec action: "search" et une recherche comme stock.
  3. Utiliser action: "describe" avec l’operation trouvée pour obtenir ses paramètres, puis action: "fields" pour les champs connus.
  4. Lire avec l’outil métier ou action: "read", les colonnes nécessaires et un filtre validé.
  5. Si nextOffset est présent, lire la page suivante ; ne pas présenter une page partielle comme un total exhaustif.

Les onze opérations sont items, customers, suppliers, stock, sales, purchases, families, subfamilies, groups, storehouses et supplier_items. Exemple de lecture de stock après identification de la source :

{
  "sourceId": "<sourceId Persyst>",
  "action": "read",
  "operation": "stock",
  "parameters": {
    "columns": ["ItemId", "StorehouseId", "RealStock", "VirtualStock"],
    "limit": 25,
    "offset": 0
  }
}

La lecture renvoie notamment results, total, offset, returned, nextOffset, partial et retrievedAt. Les ventes et achats acceptent documentType, toDate, durationDays (30 par défaut) et withLines. Utilisez les types de document définis par EBP, sans en deviner la signification.

Champs et limites

Le catalogue expose un sous-ensemble connu des colonnes, avec schemaComplete: false. Il ne constitue pas un export exhaustif du schéma EBP. La documentation EBP décrit l’export du schéma depuis l’application ; il sert de référence pour étendre le connecteur, pas d’URL à appeler librement depuis l’assistant.

  • Une page par appel : 25 lignes par défaut, 100 au maximum, décalage maximal de 100 000.
  • Une réponse API est bornée à 2 Mio et chaque requête à 15 secondes. Réduisez les colonnes ou la taille de page si nécessaire.
  • Tables, colonnes, routes et filtres sont explicitement pris en charge. Pas d’URL, SQL ou YAML libre fourni par l’assistant.
  • Pas d’écriture, de PDF, de calcul de prévision, d’accès comptable, HUBBIX ou Bâtiment dans cette version.

Vérifier et maintenir la connexion

Testez avec une référence connue et un membre autorisé : demandez le stock d’un article ou les documents d’une période courte. Vérifiez aussi qu’un membre sans accès ne voit pas la source. Le guide Connecter votre assistant présente les étapes côté IA.

Si EBP refuse l’autorisation ou si le renouvellement du jeton ne peut pas aboutir, Persyst demande une reconnexion. Ouvrez Connexion de la source → Reconnecter : la source conserve son dossier et ses accès. Les refresh tokens EBP sont rotatifs ; ne réutilisez pas dans un autre script les jetons gérés par Persyst. Une connexion longtemps inutilisée peut nécessiter un nouveau consentement.

Si une clé d’abonnement ou les identifiants de l’application changent, préparez une nouvelle connexion avec ces valeurs, réattribuez les accès puis retirez l’ancienne source.

Référence : API Gestion Commerciale et authentification EBP.

SILAE

Obtenir les identifiants API SILAE et choisir les dossiers de paie et les outils autorisés.

GLPI

Préparer l’API GLPI, connecter un compte technique et partager les tickets par entité et groupe depuis votre IA.

Sur cette page

Préparer l’accès EBPTrouver l’identifiant du dossierConnecter le dossier dans PersystChoisir les outils autorisésInterroger le catalogue API depuis l’assistantChamps et limitesVérifier et maintenir la connexion