Passer au contenu
Français
Portail client
Accéder à inqom.com
  • Il n'y a aucune suggestion car le champ de recherche est vide.

Récupération de données comptables par API (FEC, balances, écritures)

Liste et enchaînement des endpoints à appeler pour exporter les données comptables d'un dossier avec les API Inqom.

Sommaire

A) Exporter un FEC
Lancer la génération de l’export
Récupérer le résultat
B) Exporter des balances
C) Récupérer des écritures
Lecture directe
Synchronisation incrémentale

A) Exporter un FEC

Pour exporter un FEC via l'API Inqom, vous devez suivre un processus asynchrone en deux étapes.

1) Lancer la génération de l'export

POST https://api.inqom.com/api/app/enterprises/{enterpriseId}/Entries/exports/enqueue-fec

Vous pouvez préciser le type d'export avec les paramètres (None pour un FEC standard ou StandardAnalytic pour un FEC incluant l'analytique) -> documentation de l'endpoint.


2) Récupérer le résultat

GET https://api.inqom.com/api/app/enterprises/{enterpriseId}/Entries/exports/{bookExportId}

Cette requête vous renverra le statut de l'export (Pending → InProgress → Success / Error) ainsi que l'URL de téléchargement une fois l'export terminé -> documentation de l'endpoint.

Exemple de réponse :

{
  "Id": 18452,
  "EnterpriseId": 32781,
  "FileId": 956247,
  "FileName": "FEC_2025_32781.txt",
  "FileUrl": "https://storage.inqom.com/exports/32781/FEC_2025_32781.txt?sv=2025-01-05&se=2026-08-24T15%3A45%3A00Z&sr=b&sp=r&sig=exampleSignature",
  "UserId": 12874,
  "BookExportType": "Fec",
  "EntryLinesCount": 18436,
  "StartDate": "2025-01-01T00:00:00Z",
  "EndDate": "2025-12-31T23:59:59Z",
  "BookMaxUpdatedAt": "2026-02-12T09:47:31Z",
  "BookMaxValueDate": "2025-12-31T00:00:00Z",
  "CreatedAt": "2026-08-24T13:12:48Z",
  "EntriesCreatedAfter": null,
  "Status": "Completed",
  "WithAnalytics": false,
  "WithQuantities": false,
  "WithSellingPrice": false,
  "WithDueDate": false,
  "ExcludeEntriesOnSitJournal": true,
  "KeepDetailedEntryLinesLabels": true,
  "ExportFileAttachmentType": "None",
  "EntriesUpdatedAfter": null,
  "IncludeOnlyValidatedEntries": true
}

💡 L'export étant asynchrone, il est impératif d'interroger le statut avant de tenter de récupérer le fichier. Une fois disponible, l'URL de téléchargement doit être consommée rapidement.

B) Exporter des balances

POST https://api.inqom.com/api/app/enterprises/{enterpriseId}/balances/by-query

-> Documentation de l'endpoint.

Principaux paramètres pour le corps de la requête (JSON) :

  • Current/Start et Current/End : définissent la période souhaitée.
  • Filter : permet de filtrer (ex : UnBalanced pour les comptes non soldés, AllAccount pour tous les comptes).
  • ANouveauFilter : pour inclure ou non les à-nouveaux (Normal, Without, Only).
  • Aggregation : utiliser AuxDetailed pour une granularité auxiliaire.

💡 Contrairement à l'export FEC, cet endpoint renvoie directement les données au format JSON dans le corps de la réponse ce qui vous permet de traiter le détail des soldes débiteurs et créditeurs par compte.

C) Récupérer des écritures


Deux approches sont possibles selon votre besoin : une lecture directe ou une synchronisation incrémentale.


1) Lecture directe

GET https://api.inqom.com/v1/dossiers/{dossierId}/entry-lines

-> Documentation de l'endpoint.


💡Comme le volume peut être important, il est indispensable de paginer vos appels en utilisant pageNumber et pageSize. Vous pouvez d'abord utiliser GET https://api.inqom.com/v1/dossiers/{dossierId}/entry-lines/count pour dimensionner votre pagination -> documentation de l'endpoint.


2. Synchronisation incrémentale


Si votre objectif est de maintenir une base de données synchronisée, privilégiez les endpoints de changement qui ne renvoient que le delta avec :

GET https://api.inqom.com/v1/dossiers/{dossierId}/entry-lines/changes

-> Documentation de l'endpoint.

Paramètres :

💡Lors de vos intégrations ou lectures, assurez-vous de toujours gérer les identifiants uniques (entryId ou entryLineId) pour éviter les doublons dans vos propres systèmes. entrepriseId=dossierId, il s'agit de l'id du dossier que vous pourrez retrouver en suivant cette méthode.