Aller au contenu principal

Mise à jour API V24.7.32.11

Mise à jour effectuée en décembre 2024.

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/

É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

Comptabilité

Comptes collectifs

La notion de compte collectif a été ajoutée à l’API. Tout d’abord, l’endpoint suivant a été créé afin de pouvoir récupérer les différents comptes collectifs (code, nom et intitulé).

  • GET /v1/compta/comptes/collectifs

En complément, la propriété "CptColl" a été intégrée en réponse des appels relatifs à la récupération et création de comptes :

  • GET /v1/compta/comptes/… (clients, fournisseurs ou généraux)
  • POST /v1/compta/comptes/… (clients, fournisseurs ou généraux)

Quantité

L’endpoint suivant a été créé afin de pouvoir récupérer les informations relatives aux quantités (Code, libellé, Prix unitaire minimum, Prix unitaire maximum, Quantité minimum, Quantité maximum, Nombre décimal).

  • GET /v1/compta/paramètres/quantite

En complément, les propriétés "GestionQté : true/false", "UnitéQté1 : string", "UnitéQté2 : string" ont été intégrées en réponse de l’endpoint de récupération des comptes généraux :

  • GET /v1/compta/comptes/généraux

La notion de quantité a par conséquent été intégrée dans l’endpoint de création d’écriture :

  • POST /v1/compta/ecriture

Récupération des échéances et de l’analytique

Il est maintenant possible de récupérer les échéances et l’historique analytique des Grands Livres (généraux, clients et fournisseurs) en spécifiant dans la requête les propriétés suivantes : "RecupererEcheances: true" et "RecupererAnalytique: true".

À-nouveaux

La propriété "RecupererANouveau : true/false" a été ajoutée dans la requête des endpoints de récupération des balances et des grands livres, permettant ainsi de récupérer les écritures saisies dans le journal À-nouveaux.

  • GET /v1/compta/balance/…
  • GET /v1/compta/grandlivre/…

Récupération des échéances et de l’analytique

Les appels sur l’endpoint GET /v1/compta/journal indiquent maintenant si les numéros de factures sont actifs via la propriété "NumeroFacture : true/false".

Récupération des échéances et de l’analytique

La longueur des comptes est dorénavant limitée à 13 caractères (en comptant la racine pour les comptes tiers).

Gestion

Relations

Deux nouveaux endpoints liés aux Relations ont été ajoutés :

  • GET /v1/relations/{id} : récupérer tous les types de relations existants ;
  • DELETE /v1/relations/{id} : supprimer une relation par son identifiant.

D’autres endpoints permettant de récupérer ou de créer des relations sur le dossier indiqué en paramètre ont été intégrés :

  • GET /v1/dossiers/{code}/relations : Récupérer toutes les relations d’un dossier à partir de son code ;
  • POST /v1/dossiers/{code}/relations/dossiers/{codeDossier} : Créer une relation vers un dossier ;
  • POST /v1/dossiers/{code}/relations/associe/dossiers/{codeDossier} : Créer une relation de type associé vers un dossier ;
  • POST /v1/dossiers/{code}/relations/correspondants/{idCorrespondant} : créer une relation vers un correspondant via son identifiant ;
  • POST /v1/dossiers/{code}/relations/associe/correspondants/{idCorrespondant} : créer une relation de type associé vers un correspondant via son identifiant ;
  • POST /v1/dossiers/{code}/relations/correspondants/{codeCorrespondant} : Créer une relation vers un correspondant via son code ;
  • POST v1/dossiers/{code}/relations/associe/correspondants/{codeCorrespondant} : Créer une relation de type associé vers un correspondant via son code ;
  • POST /v1/dossiers/{code}/relations/banque/dossiers/{codeDossier} : Créer une relation de type banque vers un dossier de genre banque ;
  • POST /v1/dossiers/{code}/relations/banque/propre-au-dossier : Créer une relation de type banque vers une banque propre au dossier.

POST /v2/sessions/dossier

Une V2 de l’API est mise à disposition. Celle-ci comporte l’endpoint POST /v2/sessions/dossier qui, par rapport au endpoint de la V1, présente une réponse similaire aux endpoints d’authentification.

{
"UUID": "string",
"Identite": {
  "Type": "System",
  "Code": "string",
  "Email": "string",
  "Prenom": "string",
  "Nom": "string"
},
"OptionsWeb": [
  {
    "Option": 0,
    "Libelle": "string",
    "Valeur": true }
],
"VariablesSession": {
  "additionalProp1": "string",
  "additionalProp2": "string",
  "additionalProp3": "string"
  }
}

L’endpoint de la V1 est marquée comme obsolète et ne sera plus mise à jour mais restera toujours fonctionnelle.
Pour accéder à la liste des endpoints de la version 2 depuis le swagger, sélectionner V2 dans la liste déroulante Select a definition en haut à droite de la page.

Récupération des utilisateurs i-Suite Expert

Un nouvel endpoint permet de récupérer la liste des utilisateurs i-Suite Expert du dossier en cours : GET /v1/utilisateurs. Les informations personnelles comme l’adresse mail et leurs options et rôles sont reçues en réponse de l’appel.

Document diffusable

Pour les documents intégrés dans la GED via l’endpoint GET /v1/ged/documents, il est désormais possible d’indiquer dans la requête si le document peut être diffusé ou non via la propriété "Diffusable : true/false".

Supprimer un document de la GED

Un nouvel endpoint permettant de supprimer des documents de la GED à partir de leur identifiant est disponible : DELETE /v1/ged/documents.

Liste des activités

La liste des activités du menu Généralités - Divers - Activités peuvent maintenant être récupérées à partir de l’endpoint suivant : GET /v1/activités.

Nom des correspondants

La propriété NomMarital a été renommée NomNaissance sur les endpoints liés aux correspondants :

  • GET /v1/correspondants
  • PATCH /v1/correspondants
  • DELETE /v1/correspondants

POST /v1/ged/documents/filtrer

Il est maintenant possible de filtrer les documents par critères (exemple : TYPEDOC="BULLETIN" ; PERIODE="01/2024").

UUID

Un bouton AUTHORIZE a été intégré en haut à droite du swagger, permettant de définir l'UUID utilisé pour la session. Une fois connecté, l'UUID est envoyé automatiquement aux endpoints en header des requêtes. L’UUID peut être déterminé pour chaque endpoint à partir des icônes cadenas.

Informations du swagger

La version d’i-Suite Expert disponible en téléchargement est affichée à la suite de la version installée.

Corrections

Comptabilité

Publication du dossier

Le message d’erreur "La connexion à la base du dossier n'est pas initialisée !" permet d’informer que le dossier n’est pas existant ou n’a pas été publié pour les appels liés à la comptabilité.

Format de date

Afin de répondre aux problématiques de paramètres régionaux de format de date et heure, le format de date dd/MM/yyyy est maintenant forcé afin d’éviter les erreurs de conversion de format.

POST /v1/compta/comptes/…

Le cycle de compte est maintenant bien renseigné lors de la création de comptes (généraux, fournisseurs ou clients).

POST /v1/compta/grandlivre/…

La génération de doublons lors de la récupération de Grands Livres (généraux, fournisseurs ou clients) a été corrigée.

POST /v1/compta/fec

L’export de fichier FEC est de nouveau fonctionnel.

POST /v1/compta/ecriture

DATE

L’API contrôle désormais que la date d'écriture ne soit pas antérieure à la date d'édition définitive.

ARRONDIS

Les montants des écritures pouvaient être arrondis à tort.

SAISIE EN GRILLE

Le séparateur entre les écritures ne s'affichait pas dans la saisie en grille de Comptabilité Expert après la création d’écritures par l’API.

RÉFÉRENCE GED

Les espaces apparaissant en début et en fin de chaîne lors de l’enregistrement de la valeur de la référence GED (ReferenceGed) ont été retirés.

RÉVISION

Si un compte était créé depuis l’endpoint POST /v1/compta/comptes/… (généraux, fournisseurs ou clients) et qu’une écriture était créée avec ce même compte, alors celui-ci n’était pas visible dans la révision.

COMPTE

La valeur Compte de la requête est maintenant automatiquement convertie en majuscule si celle-ci a été renseignée en minuscule.

SYNCHRONISATION DES ÉCHÉANCES ET DE L’ANALYTIQUE

Les objets Analytiques et Échéances de la requête sont à présent correctement synchronisés.

ANALYTIQUE

Le message d’erreur "Object reference not set to an instance of an object" qui survenait à tort lors de l’ajout d’une écriture avec analytique a été retiré.

GUILLEMET

L’erreur 400 n’est plus retournée si un guillemet était présent dans le libellé.

MONTANTS NÉGATIFS DES ÉCHÉANCES

Les montants négatifs sont maintenant permis au niveau des échéances.

DATE PAR DÉFAUT

La date du jour même est désormais reprise comme date par défaut dans la requête.

Gestion

GET /v1/dossiers/{code}

En cas de code dossier inexistant, l’erreur 404 est maintenant envoyée en réponse de l’appel au lieu de l’erreur 500.

GET /v1/ged/documents/{{IDDOC}}

La propriété Arborescence ne renvoie désormais plus null en réponse de l’appel.

Articles associés