# 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. Référence API consultée le 9 septembre 2026. Les sections « contrat HOLCO » décrivent la spécification de collecte et les critères de recette ; le catalogue effectif du compte se découvre via tools/list. ## 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](https://developers.cegid.com/docreference/BusinessUnits/Loop-Api-Management-Docs/GetStart.html), [API Standard Expert](https://developers.cegid.com/docreference/BusinessUnits/CPA_APIM_STD_DOC/index.html). 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](https://developers.cegid.com/docreference/BusinessUnits/Loop-Api-Management-Docs/Subscription.html), [paramètres de lecture](https://developers.cegid.com/docreference/BusinessUnits/Loop-Api-Management-Docs/Journal.html). ## 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](https://developers.cegid.com/docreference/BusinessUnits/Loop-Api-Management-Docs/DossierComplet.html). `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](https://developers.cegid.com/docreference/BusinessUnits/Loop-Api-Management-Docs/etablissement.html). ### 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](https://developers.cegid.com/docreference/BusinessUnits/Loop-Api-Management-Docs/Compte.html). `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](https://developers.cegid.com/docreference/BusinessUnits/Loop-Api-Management-Docs/Journal.html). ### 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](https://developers.cegid.com/docreference/BusinessUnits/Loop-Api-Management-Docs/tiersFournisseur.html). ### 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](https://developers.cegid.com/docreference/BusinessUnits/Loop-Api-Management-Docs/Balance.html). ### É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](https://developers.cegid.com/docreference/BusinessUnits/Loop-Api-Management-Docs/EcritureComptable.html). ## 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](https://developers.cegid.com/docreference/BusinessUnits/Loop-Api-Management-Docs/SinkSubscriptionAPI.html). 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](https://developers.cegid.com/docreference/BusinessUnits/Loop-Api-Management-Docs/Dataformat.html). ## 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](https://developers.cegid.com/docreference/BusinessUnits/Loop-Api-Management-Docs/ExportFec.html). ## Exemple de requête éditeur ```http GET /loop-api-publiques/journal?codeDossier=DOSSIER_DEMO&skip=0&take=50 HTTP/1.1 Host: api.cegid.com Ocp-Apim-Subscription-Key: x-apikey: 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.