Références consultées le 9 septembre 2026

Référence éditeur et spécification de collecte. Les sections « contrat HOLCO » définissent le traitement cible et sa recette ; les outils du compte se découvrent via tools/list.

HOLCO MCP · Documentation développeur

Cegid — Loop et extraction comptable

Dossiers, comptes, tiers, balances, écritures ciblées et flux de masse : une stratégie de collecte adaptée au contrat Loop.

Produit, accès et identité du dossier

Cette fiche porte sur Cegid Loop et la base https://api.cegid.com/loop-api-publiques/. Cegid Expert possède sa propre API Standard ; ses routes et habilitations doivent être traitées séparément. Guide Loop, API Standard Expert.

Les appels Loop portent Ocp-Apim-Subscription-Key et x-apikey — ce dernier associe la clé API et son secret selon la configuration Cegid. L’abonnement et les habilitations se configurent dans les portails éditeur et LoopHub. L’offre souscrite détermine le périmètre API. Le paramètre codeDossier sélectionne le dossier ; il ne remplace pas le contrôle d’autorisation. Souscription, paramètres de lecture.

Inventaire des données

Dossiers et établissements

GET /DossierComplet?codeDossier=… expose le contexte du dossier, notamment son identifiant, sa révision et ses informations légales. Conserver le code dossier comme clé de routage, et l’identifiant source comme identité de l’objet. Dossier complet.

GET /etablissementComplet permet de récupérer les établissements. La collecte doit préserver leur relation au dossier pour éviter de mélanger une balance d’établissement et une balance de société. Établissements.

Comptes et journaux

GET /compte constitue le plan de comptes ; le contrat HOLCO vise numéro, libellé, type, identité et révision, puis les relations utiles aux tiers et à la TVA. Les paramètres filter, sort, skip et take encadrent l’extraction. Comptes.

GET /journal fournit les journaux. Conserver objectId, revisionId, code, libelle, type et les relations de contrepartie. Le contrat de lecture permet aussi une sélection de champs. Les types doivent être conservés avec leur valeur source, sans déduire le type uniquement du code du journal. Journaux.

Tiers fournisseurs

La lecture des tiers fournisseurs expose identité, raison sociale, coordonnées, références légales, paramètres de TVA et de règlement. La fiche éditeur présente des variantes de casse entre tableau de route et exemple d’URL : reprendre le contrat technique de l’environnement lors du raccordement. HOLCO doit collecter les champs nécessaires au rapprochement, sans importer systématiquement tous les contacts et RIB dans le contexte d’un modèle. Tiers fournisseurs.

Balances

GET /getBalanceGeneral et GET /getBalanceGeneralDeveloped couvrent les balances générales et développées. Définir codeDossier, la période ou les dates, puis les bornes de comptes et l’établissement si nécessaire. Les résultats incluent numéro, libellé, débit, crédit et solde. Conserver la forme brute puis normaliser les montants en décimaux exacts. Balances.

Écritures ciblées

GET /EcritureComptable est une recherche ciblée, limitée à 100 écritures et aux écritures générales et d’à-nouveau. Un filtre codeLettrage ou ecritureOrigine est requis ; des critères secondaires affinent journal, pièce, date ou compte. Ce point d’entrée n’est pas un export exhaustif du grand livre. Le volume doit être collecté par une stratégie dédiée. Écritures comptables.

Extraction de masse : Sink

Le mécanisme Sink s’appuie sur des abonnements et une destination de fichiers, notamment S3 selon la configuration documentée. L’initialisation du périmètre et les filtres doivent être configurés explicitement. Le traitement cible HOLCO distingue chargement initial, consommation des événements et rapprochement de fin de lot. Abonnements Sink.

Les événements distinguent insertion, modification et suppression. Pour les écritures, une modification peut prendre la forme suppression puis insertion ; miseAJour permet de distinguer cette séquence d’une suppression réelle. Les grands objets peuvent être fragmentés et contenir une ligne technique d’équilibrage : la reconstitution doit précéder les calculs métier. Les types 1 et 5 correspondent au périmètre général et à-nouveau ; les autres types ne doivent pas être intégrés implicitement à une balance comptable. Format des fichiers.

Export FEC : génération puis téléchargement

Le contrat éditeur présente POST /exportFec, puis GET /statutExport et GET /fichierExport, avec un demandeId. Il s’agit d’un export provisoire et d’une API en préversion, à valider avec Cegid avant usage en production. La génération est une opération asynchrone : conserver l’identifiant de demande avant tout nouvel essai. Une réponse de quota n’appelle pas une boucle de relance immédiate. Export FEC.

Exemple de requête éditeur

GET /loop-api-publiques/journal?codeDossier=DOSSIER_DEMO&skip=0&take=50 HTTP/1.1
Host: api.cegid.com
Ocp-Apim-Subscription-Key: <CLE_ABONNEMENT>
x-apikey: <CLE_API_ET_SECRET>
Accept: application/json

Les marqueurs sont fictifs. Les secrets restent dans la configuration du connecteur, jamais dans les arguments métiers transmis au LLM.

Contrat HOLCO de reprise et recette

Identifier chaque objet par cabinet, dossier, type et identifiant source ; conserver revisionId comme valeur opaque. Une modification partielle ne doit pas effacer les champs absents. Pour les événements, gérer les doublons, l’arrivée différée et les fragments avant de marquer un lot complet. Séparer un échec d’authentification d’un périmètre vide.

La recette cible couvre : plusieurs établissements, tiers auxiliaires, filtre d’écriture atteignant la limite, remplacement suppression/insertion, écriture fragmentée, changement de révision et export asynchrone en erreur. Comparer le grand livre reconstitué à la balance du même dossier et de la même période. Conserver l’écart et sa cause ; ne pas compenser automatiquement les montants pour obtenir un contrôle vert.