Voici la documentation d'ACD contenant la liste de tous les prérequis nécessaires pour faire fonctionner l’API. N’hésitez pas à y jeter un œil :
Retrouvez ici la liste des solutions pour l’ensemble des erreurs les plus communes rencontrées avec l’API ACD.
1 - Erreur 403 : Vous n’avez pas les droits d’accès à cette ressource
2 - La connexion à la base du dossier n'est pas initialisée !
3 - La référence d'objet n'est pas définie à une instance d'un objet
4 - Erreur 502 : Passerelle incorrecte : Le serveur distant a retourné une erreur
5 - Impossible de se connecter aux communs de la comptabilité
6 - Le format de la chaîne d'entrée est incorrect.
7 - le nom du serveur SQL est invalide.
8 - Plan de classement introuvable
9 - Dossier introuvable en comptabilité
1 - Erreur 403 : Vous n’avez pas les droits d’accès à cette ressource
Pour assurer le bon fonctionnement de l’API, il est essentiel de publier votre dossier sur I-Suite, mais aussi de vérifier que la GED est bien reliée à la comptabilité.
Pour publier votre dossier sur I-suite, suivez les étapes suivantes :
Accéder à l’interface ACD, puis rendez-vous dans l’onglet “I-suite Expert”.
Sélectionnez ensuite “gestion du partage”. Une fenêtre s’ouvre, cliquez alors sur le bouton “activer” puis confirmez en sélectionnant “valider”.
Pour vérifier que la GED est bien reliée à la comptabilité :
Vous devez paramétrer le plan de classement GED des documents liés aux écritures afin de pouvoir utiliser l’endpoint GET /V1/compta/planClassementEcriture/{codeJournal} et récupérer les plans de classement paramétrés.
Cela peut se faire à 3 niveaux sur votre interface ACD :
- Au niveau du journal. Pour ce faire, rendez-vous dans l’onglet “Fichier” puis “GedExpert”. Une pop-up apparaît, il vous suffit alors de paramétrer les détails requis.
- Au niveau de la fiche cabinet. Pour récupérer un plan de classement qui n'est pas paramétré dans le journal, rendez-vous dans l'onglet “Fichier”, puis “Cabinet”, ensuite “Signalétique”, et enfin dans “Paramètres” puis “GedExpert”. Une pop-up apparaît, il vous suffit alors de paramétrer les détails requis.
- Dans la section multi-cabinets. Pour récupérer un plan de classement qui ne serait pas paramétré dans le journal, rendez-vous “Fichier” puis “paramétrages”, et enfin sur “GED Expert”. Une pop-up apparaît, il vous suffit alors de paramétrer le plan de classement de la fonction CSAI
2 - La connexion à la base du dossier n'est pas initialisée !
Ce message d’erreur signifie que le dossier n’est pas publié sur I-Suite.
→ À lire aussi : publier un dossier sur I-suite
Si l'erreur persiste, vous pouvez, dans un premier temps, essayer de dépublier et republier le dossier concerné. Si cela ne fonctionne pas, contactez notre support sur ops@chaintrust.io afin de demander la déconnexion de votre API puis reconnectez l’API depuis votre interface Chaintrust.
→ Voir notre notice pour la mise en place de l’API
Dans le cas où l’erreur subsisterait, il sera alors nécessaire de contacter directement le support ACD.
3 - La référence d'objet n'est pas définie à une instance d'un objet
Chaintrust vous permet d’envoyer les dates d’échéances et numéros de factures sur ACD.
Afin que votre import soit réussit, assurez-vous que les paramètres d’envoi des dates d’échéance et des références sont identiques sur Chaintrust et sur ACD.
Autrement dit, si l’envoi de la date d’échéance est activé sur Chaintrust alors, il doit également être activé sur votre dossier sur ACD. De même pour le numéro de facture.
À savoir - Lors de la connexion de votre API, l’envoi de la date d’échéance est désactivé par défaut et l’envoi du numéro de facture est activé par défaut.
Étape 1 : Activer l’envoi de la date d’échéance et du numéro de facture depuis Chaintrust
Au niveau de votre fiduciaire
Vous retrouvez ces options dans l’onglet “paramètres” de votre fiduciaire.
La mise en place de l’envoi de la date d’échéance et du numéro de facture peut être effectué à tout moment depuis votre espace. Il vous suffit, dans les paramètres de votre fiduciaire, de cocher ou décocher l’option souhaitée. Cliquez ensuite sur le bouton “sauvegarder” pour enregistrer vos modifications.
À savoir :
- Seuls les administrateurs et les managers peuvent accéder aux paramètres de la fiduciaire.
- Si vous désactivez l’une des options, elle sera aussi désactivée sur l’ensemble de vos dossiers.
Au niveau d’un dossier
Vous pouvez par ailleurs ajuster ces paramètres par dossier.
À savoir : si vous souhaitez activer la date d’échéance ou le numéro de facture sur un dossier, il est nécessaire que l’envoi soit aussi activé à échelle de la fiduciaire.
Sélectionnez une société.
Rendez-vous dans les “paramètres société” du dossier puis dans l’onglet “paramètres” et cochez ou décochez les options souhaitées.
Étape 2 : activer l’envoi de la date d’échéance et du numéro de facture depuis ACD
Au niveau de votre fiduciaire
Une fois connecté sur ACD, cliquez sur l’onglet “fichier” puis sur “cabinet”.
Une pop-pup apparaît. Cliquez sur “paramètres”.
Cliquez alors sur l’onglet “saisie” et cochez les cases suivantes :
- Gestion du numéro de facture.
- Gestion de l’échéancier.
Au niveau d’un dossier
Rendez-vous sur le dossier souhaité. Cliquez sur “fichier” puis sur “paramètres”.
Une pop-up apparaît. Cliquez sur l’onglet “saisie”.
- Dans le champ “gestion de l’échéancier”, cochez “oui” pour l’activer, “non” pour le désactiver ;
- Dans le champ “gestion du numéro de facture”, cochez “oui” pour l’activer, “non” pour le désactiver.
Cliquez ensuite sur le bouton “fermer” pour enregistrer vos modifications.
À savoir : Si l'erreur persiste, vous pouvez, dans un premier temps, essayer de dépublier et republier le dossier concerné. Si cela ne fonctionne pas, contactez notre support sur ops@chaintrust.io afin de demander la déconnexion de votre API puis reconnectez l’API depuis votre interface Chaintrust.
→ À lire aussi : Connecter ACD à Chaintrust
⚠️ N’oubliez pas d'activer également le journal de ventes depuis votre interface ACD.
4 - Le serveur distant a retourné une erreur : Passerelle incorrecte 502
L’API ACD ne prend pas en charge les caractères spéciaux. Si vos libellés contiennent des apostrophes, accents, virgules, tirets, slashs ou autres caractères similaires, l’import de vos écritures en comptabilité sera bloqué.
⚠️ Pour éviter tout rejet, utilisez uniquement des lettres (a-z) et des chiffres (0-9) lors de la personnalisation des libellés. N’insérez pas de dates, car elles incluent des caractères interdits comme “-” ou “/”.
Pour résoudre cette erreur, il est donc important de vérifier : le libellé et le compte de vos fournisseurs et clients ainsi que les détails des comptes comptables.
Pour effectuer ces vérifications, rendez-vous dans l’onglet “Plan Comptable” de votre dossier et suivez les étapes ci-dessous :
1. Vérifier les libellés fournisseurs
Sélectionnez l’onglet “fournisseur” et parcourez la liste pour vérifier que leurs libellés ne contiennent aucun caractère spécial. Si un libellé en contient, cliquez sur le petit crayon à droite.
Une pop-up apparaît, vous pouvez alors modifier le libellé fournisseur en retirant les caractères spéciaux. N’oubliez pas de sauvegarder.
À savoir : le procédé est le même pour la vérification de vos libellés clients.
2. Vérifier les comptes fournisseurs / clients
Sélectionnez l’onglet “codes tiers” et parcourez la liste pour vérifier que vos comptes fournisseurs et clients ne contiennent aucun caractère spécial. Si un libellé en contient, cliquez sur le petit crayon à droite.
Une pop-up apparaît, vous pouvez alors modifier le compte en retirant les caractères spéciaux. N’oubliez pas de sauvegarder.
3. Vérifier les libellés des comptes comptables
Sélectionnez l’onglet “Gestion des comptes” et parcourez la liste pour vérifier que leurs libellés ne contiennent aucun caractère spécial. Si un libellé en contient, cliquez sur le petit crayon dans la colonne “actions”.
Une pop-up apparaît, vous pouvez alors modifier le libellé du compte en retirant les caractères spéciaux. N’oubliez pas de sauvegarder.
5 - Impossible de se connecter aux communs de la comptabilité
S’il est impossible de se connecter aux communs de la comptabilité, cela signifie que votre version I-Suite n’est pas à jour.
Pour vérifier la version que vous utilisez, entrez l'URL de votre compte I-Suite dans votre navigateur ; la version s'affiche en bas à droite.
Pour mettre à jour la version I-suite, mettez-vous en relation avec votre service IT.
À savoir : Si le problème persiste malgré la mise à jour ou si vous avez déjà la dernière version, cela signifie que vous êtes en AOD (ACD On Demand). Dans ce cas, contactez ACD et mettez-le en relation avec votre prestataire ou responsable informatique.
6 - Le format de la chaîne d'entrée est incorrect
Si le format de la chaîne d’entrée est incorrect, cela indique que les erreurs proviennent d’ACD. Dans ce cas, voici les manipulations à effectuer sur vos dossiers pour ne plus rencontrer ce problème :
Étape 1 :
Cliquez sur “I-Suite Expert”, puis “Gestion du partage du dossier dans I-suite Expert” et cliquez sur “Désactiver”.
Étape 2 :
Dans la fiche “Paramètres”, dans l'onglet “Général”, cliquez sur "ComptaExpert".
Décochez ensuite l'option "Reprise niveau cabinet", puis cochez-la à nouveau.
Enfin, fermez la fiche « Paramètres ».
Étape 3 :
Dans ComptaExpert, cliquez sur “I-Suite Expert”, puis sur “Gestion du partage du dossier dans I-suite Expert”. Ensuite cliquez sur “Activer” en bas à droite.
Cliquez ensuite sur activer en bas à droite
Une pop-up s’ouvre, cliquez sur “Oui”
7 - Le nom du serveur SQL est invalide.
Si le nom du serveur SQL est invalide, cela indique que les erreurs proviennent d’ACD. Dans ce cas, veuillez contacter votre support ACD en fournissant les détails de l'erreur renvoyée par Chaintrust qui s'affiche sur votre interface Chaintrust.
8 - Plan de classement introuvable
Si le plan de classement est introuvable, suivez les étapes suivantes.
Rendez-vous sur le dossier souhaité. Cliquez sur “fichier” puis sur “paramètres”.
Une pop-up apparaît, cliquez sur l’onglet “GedExpert” puis sur “Plan de classement”.
À savoir : Le plan de classement des fichiers d'export FEC doit impérativement correspondre à celui du journal d’achat ou de vente.
9 - Dossier introuvable en comptabilité
Lors de l'importation ou du traitement d'un dossier, un message peut indiquer qu’il est introuvable en comptabilité.
ACD fonctionne avec deux bases de données distinctes :
1️⃣ La base GRC (Gestion de la Relation Client) – où sont enregistrés tous les dossiers clients.
2️⃣ La base de production (Comptabilité) – où sont gérés les dossiers comptables.
Un dossier peut être présent dans la base GRC sans être encore créé en comptabilité. Cela signifie que la comptabilité du dossier n’a pas encore été ouverte par le cabinet. Tant que cette action n’est pas réalisée, l’importation des écritures reste impossible.
Il sera donc nécessaire d’ouvrir le dossier dans la base de production, c’est à dire, en compatibilité, pour importer vos écritures.