Importer ses fichiers CFONB dans Inqom par API 

Sommaire

Pré-requis

1. Paramétrer le compte CFONB (compte manuel EBICS) sur Inqom

A) Listing des comptes d'un dossier

B) Import de l'IBAN

2. Paramétrer votre banque CFONB 

A) Liste des appels pour récupérer les ID nécessaires à l'association de votre banque CFONB

B) Activer et associer un compte comptable au compte bancaire avec cet appel API

3. Intégrer un fichier CFONB

A) Fichier « 1 IBAN = 1 dossier »

B) Fichier multi-comptes et multi-dossiers

C) Cas d’un IBAN non reconnu

Astuce : Quel appel choisir ?

---

Pré-requis

• Un accès à Inqom avec les droits Système ou expert comptable,

• Un fichier CFONB 120 valide, généré par votre banque ou votre outil,

• Les IBAN des comptes concernés,

• Les IDs Inqom des dossiers concernés (cf. article récupération des IDs Inqom),

• Le mapping des banques par dossier (cf. GET / Banks all).

---

 

1. Paramétrer le compte CFONB (compte manuel EBICS) sur Inqom

⚠️ Un même iban ne peut pas être lié à 2 comptes différents. Vérifiez qu'il n'a pas déjà été utilisé (cf. vérification des comptes).

A) Listing des comptes d'un dossier

Vérifiez que l’IBAN n’est pas déjà utilisé. Vous pouvez lister les comptes d’un dossier avec :

GET /api/app/banking/enterprises/{enterpriseId}/accounts

cf. documentation.

B) Import de l'Iban

Renseignez le compte bancaire en faisant cet appel : 

POST /api/app/banking/enterprises/{enterpriseId}/manual/ebics/accounts

Avec body (exemple) :

{

 "Iban": "FR76XXXXXXXXXXXXXXXXX",

 "BankName": "Ma Banque",

 "IsCfonbControlActive": true

}

⚠️ IsCfonbControlActive* est un champ obligatoire, assurez-vous qu’il soit actif pour pouvoir utiliser la fonctionnalité CFONB. 

cf. documentation.

2. Paramétrer votre banque CFONB 

 

A) Liste des appels pour récupérer les ID nécessaires à l'association de votre banque CFONB : 

• BankAccountId, lien de la documentation : GET Banking accounts

GET /api/app/banking/enterprises/{enterpriseId}/accounts

• Account and SubAccountId, lien de la documentation : GET Book id's

GET /api/app/enterprises/{enterpriseId}/BookAccount/All

• JournalId, lien de la documentation : GET journals

GET /api/app/enterprises/{enterpriseId}/journals/all

B) Activer et associer un compte comptable au compte bancaire avec cet appel API

POST /api/app/enterprises/{enterpriseId}/v2/associations/bank-accounts/{bankAccountId}

Avec body (exemple) :

{

 "EnterpriseId": 12345,

 "BankAccountId": 678,

 "AccountId": 41100,

 "SubAccountId": 0,

 "JournalId": 0,

 "SyncStartDate": "2026-10-12T08:41:17.345Z"

}

• Documentation technique : POST Bank Association

3. Intégrer un fichier CFONB

Deux appels sont disponibles selon le contenu du fichier CFONB: 

Cas	Appel API	Portée
Un IBAN = un dossier	POST .../ebics/accounts/{accountId}/import	Un compte d’un dossier
Plusieurs IBAN et plusieurs dossiers	POST .../ebics/accounts/import	Tous les dossiers du cabinet

Pré-requis communs pour intégrer un fichier CFONB sur Inqom

• Le compte manuel EBICS est créé, activé et lié à un compte comptable (étape 1).
• Le fichier respecte la structure CFONB 120 colonnes.

A) Fichier « 1 IBAN = 1 dossier »

Cet appel importe les mouvements d’un compte précis d’un dossier, désigné dans l’URL. Le fichier peut contenir plusieurs comptes : Inqom ne retient que les mouvements dont l’IBAN correspond à celui du compte accountId. Les autres comptes du fichier ne sont pas intégrés par cet appel.

Pré-requis spécifiques à cet appel : 

• Le compte a été créé avec IsCfonbControlActive à "true". 
• Le compte est activé et lié à un compte comptable (étape 1).

Endpoint

POST /api/app/banking/enterprises/{enterpriseId}/manual/ebics/accounts/{accountId}/import

• Corps de la requête : multipart/form-data avec le fichier,

   

• Lien de la documentation : POST CFONB file importation for a specific bankaccount

Règle de rapprochement :

Seul l’IBAN du fichier qui correspond au compte accountId est pris en compte.

B) Fichier multi-comptes et multi-dossiers

Le fichier regroupe les mouvements de plusieurs comptes, répartis sur différents dossiers. Aucun dossier ni compte n’est précisé dans l’URL : Inqom dispatche les mouvements.

Endpoint

POST /api/app/banking/ebics/accounts/import

• Corps de la requête : multipart/form-data avec le fichier,

• Lien de la documentation : POST CFONB global file importation

Règle de dispatch

Le dispatch s’effectue à la maille de l’utilisateur dont le jeton est utilisé pour l’appel. Inqom rapproche l’IBAN de chaque compte présent dans le fichier avec les IBAN des dossiers accessibles à cet utilisateur. Le périmètre dépend de son rôle :

Pour que les mouvements d’un IBAN soient intégrés :

• le compte manuel EBICS portant cet IBAN doit exister dans un dossier (étape 1) ;
• ce dossier doit faire partie du périmètre de l’utilisateur, selon le tableau ci-dessus.

C) Cas d’un IBAN non reconnu

Si le fichier contient un IBAN qui ne correspond à aucun dossier de l’utilisateur, les lignes de cet IBAN sont ignorées et l’import continue avec l’IBAN suivant. Le fichier n’est donc pas rejeté dans son ensemble.

Astuce : Quel appel choisir ?