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
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
4 - Le serveur distant a retourné une erreur : Passerelle incorrecte 502
Pour résoudre cette erreur, il est important de vérifier plusieurs éléments : le libellé et le compte de vos fournisseurs et clients ainsi que les détails des comptes comptables sur lesquels sont affectées les lignes d’écritures qui partent vers ACD.
Pour chacun de ces éléments, il faudra vous assurer qu’ils ne comportent ni apostrophe, ni accent, ni virgule.
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”. Faites défiler la liste de vos fournisseurs pour vous assurer que les libellés de ces derniers ne comportent ni apostrophe, ni accent, ni virgule. Si un fournisseur comporte l’un de ces caractères, cliquez sur le petit crayon à droite du libellé.
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”. Faites défiler la liste de vos comptes fournisseurs et clients pour vous assurer que les libellés de ces derniers ne comportent ni apostrophe, ni accent, ni virgule. Si un compte comporte l’un de ces caractères, cliquez sur le petit crayon à droite du compte.
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”. Faites défiler la liste de vos comptes comptables pour vous assurer que les libellés de ces derniers ne comportent ni apostrophe, ni accent, ni virgule. Si un compte comporte l’un de ces caractères, 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, veuillez contacter votre support ACD en fournissant les détails de l'erreur renvoyée par Chaintrust qui s'affiche sur votre interface Chaintrust.
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.