Récupérer le(s) companyId et les id dossiers par API

1) Equivalence des noms d'id cabinet et id dossier

Selon les APIs que vous appelerez, l'id du cabinet ou du dossier pourront revêtir différents noms :

Cabinet 1 CompanyId 1 = id 1
├─ Dossier client A Id A = enterpriseId A = accountingFolderId A = dossierId A

├─ Dossier client B Id B = enterpriseId B = accountingFolderId B = dossierId B

└─ Dossier client C Id C = enterpriseId C = accountingFolderId C = dossierId C

2) Récupérer l'id du cabinet et les id des dossiers pour un user

Je suis partenaire et je veux que mon intégration liste les dossiers du user qui installe mon connecteur.

Base URL :

• Prod : https://api.inqom.com
• Recette : https://api-staging.inqom.com 

Une fois l'étape de l'authentification faite, passer par l’API Provisioning :

1. GET https://api.inqom.com/provisioning/users/internal-access pour récupérer le companyId (si "AccessType":"Company" alors companyId="Id" et si "AccessType":"Pme" alors companyId="CompanyId")
2. GET https://api.inqom.com/provisioning/companies/{companyId}/accounting-folders pour récupérer la liste des dossiers auxquels le user est affecté (et tous les dossiers du cabinet si le cabinet utilise un compte system pour sa connexion). 

Nous vous conseillons d'inclure "Name" + "Siren" dans votre listpicker qui demandra à l'utilisateur de choisir le(s) dossier(s) qu'il souhaite connecter à votre solution. Cela vous permettra de vous prémunir d'une d'erreur de nommage de la Société ou bien de nom similaire. 

3) Récupérer l'id de mon/mes cabinet(s) et les id de tous mes dossiers

Je suis un cabinet ou une PME et je veux récupérer la liste complète des id de mes dossiers.

Pré-requis : Si ce n'est pas encore le cas, demander à votre contact Inqom de vous créer un compte System pour votre/vos cabinet(s) que vous souhaitez requêter. Pour cela, fournissez-nous une adresse mail générique pour laquelle vous pourrez récupérer les mails reçus. En effet, lorsque nous vous créerons ce compte System, un mail Inqom qui vous sera automatiquement envoyé pour que vous puissiez configurer son mot de passe associé.

Une fois l'étape de l'authentification faite avec votre compte System, passer par l’API Provisioning :

1. Je récupère directement mon/mes companyId auprès de mon chargé de projet Inqom ou bien j'effectue l'appel GET https://api.inqom.com/provisioning/users/internal-access décrit ci-dessus pour les partenaires.

2. GET https://api.inqom.com/provisioning/companies/{companyId}/accounting-folders vous retournera la liste de vos dossiers sous cette forme :
   

   [
     {
       "ExternalId": "string",
       "Id": 0,
       "Siren": "string",
       "Nic": "string",
       "Name": "string",
       "UniqueName": "string",
       "ContractType": "Normal",
       "CreatedAt": "2026-02-09T17:29:55.148Z",
       "Status": "Active",
       "AccountingType": "Engagement",
       "CompanyId": 0,
       "StateMode": "Active",
       "OwnerCompanyId": 0
     }
   ]