Mise à jour API V25.22.61.6

Améliorations apportées à l'API

Comptabilité

POST /v1/compta/tiers

Un nouvel endpoint permet désormais de créer un tiers directement sur le dossier en cours. Le tiers créé est automatiquement synchronisé dans la base publiée uniquement si les informations sont conformes à la base de données et à ACD Compta (longueur de champs, champs obligatoires, caractères autorisés, format SIREN et NIC, etc.).

POST /v2/compta/ecriture

Sur l’endpoint de création d’écriture V2, la transmission du code dossier est désormais obligatoire afin de sécuriser l’intégration et garantir que les écritures sont créées exclusivement dans le dossier attendu. En l’absence de ce paramètre, l’appel est refusé avec un message indiquant que le code dossier est requis.

POST /v1/compta/ecriture

La confirmation de création d'une écriture avec succès (HTTP 200) via le endpoint indique désormais le numéro d'écriture créée, permettant une identification, une traçabilité et un suivi fiable des écritures générées via l’API, sans impact sur les usages existants.

POST /v1/compta/comptes/tiers

Le schéma des endpoints de création des tiers précise désormais explicitement les données obligatoires à renseigner.

GET /v1/compta/comptes/... (generaux, tiers, client, fournisseur)

L’endpoint de récupération des comptes inclus désormais pour chaque compte concerné, la liste des unités paramétrées lorsque la Gestion des quantités est active pour le compte. Cette information reflète le paramétrage réel du dossier et permet d’identifier précisément pour chaque compte les unités autorisées lors de la création des écritures.

    "UniteQte1": [
      "string"
    ],
    "UniteQte2": [
      "string"
    ],

POST /v1/compta/balance/... (generaux, clients, fournisseurs)

Les endpoints de récupération de la balance intègrent désormais le champ ANouveau, correspondant au montant du solde des À‑nouveau. La réponse respecte la cohérence comptable ANouveau + Débit − Crédit = Solde, sans impact sur les usages existants.

Corrections apportées à l'API

Comptabilité

Gestion des dossiers non publiés

Lorsqu’un endpoint nécessitant un dossier publié sur i-Suite Expert est appelé et que le dossier n'est pas publié, le message retourné est désormais explicite :
« Connexion à la base de données impossible pour le dossier XXXXX. Merci de publier le dossier sur iSuite depuis le logiciel Comptabilité Expert. », en remplacement de « La connexion à la base du dossier n'est pas initialisée ». 

GET /v1/compta/comptes/... (generaux, tiers, client, fournisseur)

CLÉ DE RÉPARTITION

Pour l’endpoint de récupération des comptes, le cas de clés de répartition inexistantes est à présent correctement géré et ne génère plus d'erreur d'exception “Object reference not set to an instance of an object.” 

UNITÉ

La récupération des unités (UniteQte1, UniteQte2, etc) n'est désormais effectuée que si la gestion des quantités est activée sur le dossier. 

GET /v2/compta/parametres/

De nouvelles versions V2 sans accent ont été ajoutées pour les endpoints paramètres (/v1/compta/paramètres/*) afin de permettre leur utilisation sur des serveurs bloquant les caractères accentués dans les routes. Les versions V1 avec accent sont conservées, et les réponses sont strictement identiques entre V1 et V2. 

Les endpoints concernés sont les suivants :

• GET /v1/compta/paramètres/codesTVA
• GET /v1/compta/paramètres/comptesperiodiques
• GET /v1/compta/paramètres/analytique
• GET /v1/compta/paramètres/quantite

GET /v1/compta/exercices

L’endpoint de récupération des exercices intègre désormais un contrôle renforcé des valeurs de dates afin de garantir leur validité et d’éviter le message suivant : “Year, Month, and Day parameters describe an un-representable DateTime.” 

POST /v1/compta/fec

FORMAT

La génération du FEC via l’API a été revue afin de respecter strictement le format officiel, avec 18 colonnes sans séparateur. 

ECRITURENUM

La valeur de la colonne EcritureNum est à présent similaire à la valeur générée depuis ACD Compta et n'est plus systématiquement égale à P-1.