Relier votre logiciel métier à Cegid : Loop, XRP Sprint, XRP Flex et leurs API

Quel Cegid, quelle API ?

Chaque gamme Cegid a sa documentation et sa clé : identifiez d'abord le produit concerné et qui en détient les accès. Le portail Cegid Developers centralise une partie des API, avec leur description et leur documentation ; d'autres documentations figurent dans l'aide en ligne des produits.

Si vous cherchez à remplacer plutôt qu'à relier, la page alternatives à Cegid compare les options. Cegid détient aussi EBP depuis juillet 2024, dont les API sont décrites sur la page connecter EBP.

Alimenter le dossier Cegid Loop de votre expert-comptable

C'est le cas le plus courant pour une PME : le cabinet tient la comptabilité dans Cegid Loop, et votre logiciel métier produit des ventes ou des achats que quelqu'un ressaisit. La documentation de Cegid indique que ces API sont exposées « aux partenaires et aux clients » pour intégrer Cegid Loop à d'autres solutions.

L'accès se prépare avec le cabinet, en trois étapes décrites par Cegid :

1. l'administrateur du cabinet génère une clé d'API sur Cegid Life : la clé Standard est toujours disponible, la clé Cabinet seulement si le cabinet a acheté ce service, et la clé comme son secret ne s'affichent qu'une fois ;
2. il active cette clé dans le Loop Hub du cabinet ;
3. une clé d'abonnement, générée sur le portail Cegid Developers après souscription au service « Cegid Developers - APIs Cegid Loop » sur Cegid Life, ouvre l'usage des API.

La clé d'API, suivie de son secret, se transmet ensuite dans l'en-tête x-apikey. Pour les essais, Cegid donne aux partenaires accès à un environnement de test nommé CEGIDPARTENAIRES. La documentation conseille enfin une politique de nouvelle tentative, certaines API pouvant être ponctuellement indisponibles.

Écritures, justificatifs, synchronisation : ce que font les API Loop

Import d'écritures. Quatre formats sont acceptés : JSON, FEC, TRA et personnalisé (CSV). Le JSON gère les pièces jointes et les modes de paiement, alors que le FEC et le TRA ne permettent pas de lier une pièce. Le format personnalisé suppose un modèle créé au préalable dans Cegid Loop. Pour les imports FEC, TRA et personnalisé, les fichiers se déposent soit à une URL authentifiée sur le stockage de votre choix, soit dans un stockage Azure dont l'adresse est fournie par l'API getFileUrlDeposit. L'avancement se suit par les statuts et l'historique des imports.

Dépôt de justificatifs. L'API documentaire transmet un fichier à PIA, qui crée ensuite automatiquement les écritures dans le dossier. Seuls les PDF, JPG et PNG sont traités ; un fichier par requête, 50 Mo au plus. Les paramètres donnent le code du dossier (context), le nom du fichier et, pour une facture, son sens (PURCHASE ou SALE). La réponse renvoie le statut C pour un document collecté, W pour un doublon, qui n'est pas traité.

Synchronisation sortante. Pour lire la comptabilité au fil de l'eau, Cegid Loop ne décrit pas de webhooks mais une synchronisation par abonnement : chaque insertion, modification ou suppression sur les objets comptables suivis produit un fichier JSON, déposé dans un stockage Azure Blob ou AWS S3. Seuls les exercices ouverts et le dernier exercice clôturé sont initialisés, et des rapports comptent les enregistrements traités.

D'autres API couvrent le lettrage et le délettrage, la ventilation analytique, l'export FEC, les tiers (clients, fournisseurs, salariés, divers), les journaux, les codes TVA et la balance.

Cegid XRP Sprint : Web API et Cegid Data Service

Pour une entreprise équipée de Cegid XRP Sprint, la documentation publique de Cegid décrit des Web API Finance, MTS et HR consommées avec une clé d'API. La mise en place se fait à deux endroits :

• sur Cegid Life, un administrateur crée la clé d'API et son secret, visible une seule fois ;
• dans Quick Launch Manager, il crée un utilisateur de type clé d'API et lui ouvre l'accès aux applications CegidFinance, CegidMTS ou CegidBHR, dossier par dossier.

La clé et le secret s'échangent contre un jeton d'accès, placé ensuite après le mot Bearer. Une fois l'utilisateur migré vers Cegid Account, la connexion aux Web API par un utilisateur LDAP n'est plus possible : une liaison ancienne fondée sur un compte LDAP est à revoir.

Cegid Data Service (CDS) complète ce dispositif pour la lecture : c'est un outil web qui publie, à partir de vues, des Web API REST au protocole OData, avec les options $select, $filter, $orderby, $skip, $top et $count. L'accès dépend de l'abonnement au bouquet CDS, les autorisations se donnent par dossier, et une requête archivée ne peut plus être réactivée.

Quatre flux types entre une PME et Cegid

1. Les ventes du jour vers le cabinet. Un logiciel de location de matériel clôture sa journée ; le service importe les écritures de ventes en JSON, factures jointes, dans le dossier Cegid Loop, puis contrôle le statut de l'import.
2. Les factures fournisseurs reçues par e-mail. Un robot relève la boîte des achats et dépose chaque PDF par l'API documentaire, avec le sens PURCHASE ; un statut W signale un document déjà reçu. Voir comment automatiser la saisie.
3. La trésorerie du matin. Une vue CDS publiée sur Cegid XRP Sprint alimente chaque matin un tableau de bord de pilotage, sans export de fichier.
4. Une copie comptable pour l'analyse. La synchronisation Loop dépose les changements dans votre stockage S3 ; un traitement les charge dans votre base d'analyse, dans l'ordre de leurs horodatages.

Les points de vigilance avec les API Cegid

• La propriété des clés. Pour Cegid Loop, la clé appartient au cabinet : convenez par écrit de qui la génère, qui peut la révoquer et qui prévenir en cas d'incident.
• Le dossier visé. Selon Cegid, un code de dossier erroné n'empêche pas le traitement d'un document, qui n'apparaît alors pas dans le dossier : le service contrôle ce code avant chaque envoi.
• Les limites d'appels. Cegid publie des limites pour son API de facture électronique eConnect : 500 requêtes par minute par client, ou 20 par minute par identité quand aucun client n'est identifié, avec une réponse 429 et un en-tête Retry-After à respecter. Pour les autres API, les pages consultées n'en mentionnent pas : le service espace quand même ses appels.
• Les reprises. File d'attente, nouvelles tentatives espacées, journal de chaque import et de chaque dépôt, alerte en cas d'échecs répétés : c'est ce qui permet d'éliminer les doubles saisies sans en créer.
• Les données personnelles. Les API Loop exposent aussi des tiers salariés : ne synchronisez que les champs nécessaires, et inscrivez le flux au registre des traitements.

Connecteur, intégrateur ou développement sur mesure ?

Pour Cegid XRP Flex, la page produit évoque une architecture cloud ouverte connectable « via nos API », des connecteurs natifs (cités dans un témoignage client) et une interface native avec des logiciels de trésorerie comme Cegid Exabanque : vérifiez d'abord avec votre intégrateur ce qui existe, et demandez la documentation technique, absente de la page produit. Côté facture électronique, l'API eConnect s'adresse aux équipes techniques des plateformes agréées, pas aux logiciels métier, qui passent par la plateforme choisie par l'entreprise : voir la facture électronique dans un logiciel métier.

Le développement sur mesure se justifie quand le flux part d'un outil propre à votre activité. YMHB Web construit alors le service d'intégration après un cadrage avec vous et, selon le cas, votre cabinet ou votre intégrateur. Vous recevez le code en technologies standard, déposé chez vous, la liste des API et formats utilisés, le journal des échanges et la procédure de renouvellement des clés, le tout à vous au paiement intégral.