Mise à jour effectuée en octobre 2026.
Tous les appels possibles peuvent être consultés dans le swagger accessible depuis votre plateforme i-Suite Expert :
https://{Adresse URL iSuite du cabinet}/{CNX du cabinet}/api/swagger/
Informations à ne pas manquer
Créer et gérer une clé API depuis le portail i-Suite Expert
Une nouvelle rubrique Mes clés API est disponible dans le Portail Client (icône du profil utilisateur - Mes clés API) afin de faciliter la connexion de logiciels et services tiers au dossier de l’entreprise, sans avoir à utiliser les identifiants i‑Suite Expert.
Depuis cette interface, il est possible de générer une ou plusieurs clés API en définissant un libellé et une durée de validité adaptée à chaque usage. La fenêtre permet également de consulter l’URL de base à transmettre au prestataire ou au logiciel concerné, de copier la clé lors de sa création et de révoquer à tout moment un accès.
Pour plus d'informations, consulter la documentation dédiée Créer et gérer une clé API depuis le portail i-Suite Expert.
Évolutions apportées à l'API
La liste déroulante ci-dessous présente les modifications apportées à l’API, classées selon le statut des tâches.
Améliorations
Gestion
Filtres dossiers - Pagination
Afin d’optimiser le retour de données volumineuses, les endpoints GET /v2/dossiers et POST /v2/dossiers/filtrer prennent désormais en charge les paramètres limit (nombre de résultats par page, 250 par défaut, 500 maximum) et offset (nombre total de pages), permettant ainsi de parcourir les résultats par lots. Les réponses incluent également les informations de pagination (limit, offset, total) pour faciliter la récupération de l’ensemble des données.
Référence : 1979585
Comptabilité
POST /v2/compta/ecriture/ecritures
Cet endpoint a été ajouté permettant désormais de créer une écriture comptable complète en un seul appel (détermination du dossier et du plan de classement, intégration du document en GED et liaison à l’écriture), simplifiant l’utilisation de l’API tout en conservant le fonctionnement de la V1 lorsque les paramètres optionnels ne sont pas renseignés.
Référence : 1978014
POST /v1/compta/ecritures
Ce nouvel endpoint permet de créer plusieurs écritures comptables en une seule requête. Les informations attendues sont identiques à ceux de la création unitaire.
Référence : 1977571
Révision comptable - Écriture créée par API
Dans la Révision d'ACD COMPTA, un libellé indique désormais l'origine des écritures intégrées via l'API : « Écriture API intégrée le JJ/MM/AAAA par "XXXXXXXXXX" ».
Référence : 1979508
POST /v2/compta/parametres/analytique
Ce nouvel endpoint permet la création de sections analytiques via l'API sur le même principe que celui appliqué dans ACD COMPTA En cas d’analytique non activée, l’API retourne le message d’erreur attendu. Cet endpoint est également disponible en V1.
Référence : 1974476
Gestion de l'analytique
Les endpoints de comptabilité tiennent désormais compte de l’activation de la gestion analytique du dossier. Lorsque l’analytique n’est pas activée pour le dossier en cours, GET /compta/paramètres/analytique retourne le message « La gestion de l’analytique n’est pas activée sur le dossier. » et GET /compta/comptes ne renvoie plus les rubriques ActivationAnalytique et CleRepartition.
Référence : 1979093
GET /v1/compta/comptes/... (fournisseurs, clients)
L’endpoint de récupération des comptes Fournisseur et Clients a été enrichi afin de retourner le paramétrage TVA associé à chaque compte (type de TVA, masque de saisie, autoliquidation), en respectant les règles d’affichage liées à la comptabilité.
Cette évolution permet de distinguer une TVA sur encaissement d'une TVA au débit lors de l’exploitation des données comptables.
{
...
"TypeTva" : "Debit",
"Autoliquidiation" : false,
"Masque de saisie" : " "
}
Référence : 1983465 / 1983025
Autoliquidation TVA
POST /v1/compta/comptes/... (clients, fournisseurs, generaux, collectifs)
Les endpoints de récupération de comptes retournent désormais la propriété Autoliquidation (true / false) pour chaque compte comptable, afin d’indiquer explicitement si celui-ci est soumis à l’autoliquidation de TVA.
Référence : 1978396
POST /v1/compta/balance/... (clients, fournisseurs, generaux)
Les endpoints de récupération de la balance proposent désormais un paramètre AutoliquidationTVA (true / false) dans le corps de la requête permettant de filtrer la réponse.
Référence : 1983024
GET /v1/compta/journal
L’endpoint de récupération des journaux retourne désormais la propriété PeriodeDerniereSaisie (mois et année de la dernière saisie).
Référence : 1981561
Corrections
Comptabilité
POST /v2/compta/ecriture
COMPTES INEXISTANTS
Lors de la création d’écritures par API, les comptes inexistants sont désormais créés automatiquement dans le dossier comptable comme lors d’un import IN dans le programme, permettant ainsi l’intégration directe des écritures sans intervention préalable.
Référence : 1981943
HARMONISATION V1 & V2
L’endpoint a été enrichi afin d’aligner son format de réponse sur celui de la V1, avec le retour de l’identifiant de l’écriture créée (codeEcriture) dès la création.
La documentation Swagger a également été complétée avec la description de l’endpoint, les modèles de requête, le détail des champs ainsi que des exemples de requêtes et de réponses pour faciliter son intégration.
Référence : 1982339
GÉNÉRATION D'ÉCRITURE AVEC ANALYTIQUE
La propriété Quantite2 est de nouveau prise en compte dans les ventilations analytiques, évitant ainsi le message « La somme des quantités analytiques (Q1=XXX, Q2=0) ne correspond pas à la quantité de la ligne ».
Cette correction a étalement été appliquée sur la création d'écriture en V1.
Référence : 1982167
Contrôle des dates (balance et grand livre)
Les endpoints des Balance (POST /v1/compta/balance/...) et Grand Livre (POST /v1/compta/grandlivre/...) gèrent désormais correctement les contrôles de dates pour les dossiers avec ou sans historique. Le message « Les dates sont incorrectes ! » n’est plus retourné lorsque les dates transmises sont valides.
Référence : 1983304
POST /v1/compta/balance/... (clients, fournisseurs, generaux)
EXERCICE N-2
Les endpoints de récupération des balances retournent désormais correctement les données sur les exercices N-2 et antérieurs. Le message « Object of type 'System.String' cannot be converted to type 'System.Double' » n’est donc désormais plus retourné.
Référence : 1982639
POST /v1/compta/journal
En cas d’échec de génération lié à une erreur serveur, l’API retourne désormais un statut HTTP 500 avec le JSON CodeRetour = 0 et Description = KO, au lieu d’un retour 200 / OK malgré la présence de messages dans listeErreurs.
Référence : 1981102
Message d'erreur - Connexion SSL
Une correction a été apportée afin de corriger le message d'erreur « The SSL connection could not be established, see inner exception. » qui se produisait de manière aléatoire sur les endpoints de comptabilité.
Référence : 1982084
Message d'erreur - Communs de comptabilité
Les informations techniques associées au message « Impossible de communiquer avec les communs de comptabilité » sont désormais répertoriées dans les logs i-Suite Expert lorsque le trace est activé.
Référence : 1979176
Base Access et MariaDB - Insertion d'écritures
Les guillemets présents dans les libellés d'écritures sont désormais correctement gérés et ne produisent plus d'erreur sur les endpoints de génération d'écritures en environnement ACCESS comme en MariaDB.
Référence : 1981304
POST /v1/compta/ecriture/lettrage
Un contrôle préalable du lettrage a été ajouté sur l’ensemble des lignes transmises au endpoint POST /v1/compta/ecriture/lettrage.
Si au moins une ligne est déjà lettrée, l’opération est désormais refusée et un message identifiant les lignes concernées est retourné, garantissant la préservation des lettrages existants et l’intégrité des rapprochements comptables.
Référence : 1983656 - En cours de développement