Connecter Acomba GO

S’applique àAcomba GO

Acomba GO est la version infonuagique d'Acomba (ACCEO). Le connecteur y accède par l'API ACCEO Connecté, de nuage à nuage : rien à installer chez vous, aucun agent, aucun SDK. Cette page rassemble ce qu'il faut préparer dans Acomba GO, les cinq valeurs à saisir dans le portail, comment tester, et les erreurs les plus fréquentes.

Acomba GO n'est pas Acomba

Ce n'est pas le même système que Acomba (le logiciel installé) : entités, identifiants et règles diffèrent, et une entreprise ne passe de l'un à l'autre que par une migration. Si votre comptabilité est tenue dans Acomba (desktop), c'est la page Connecter et configurer Acomba qui s'applique.

Prérequis

• Votre compagnie est tenue dans Acomba GO et ACCEO Connecté est activé pour cette compagnie (activation faite avec ACCEO ; le code de compagnie vous est alors transmis par courriel).
• ACCEO Connecté n'est pas offert quand la comptabilité est tenue dans Acomba (desktop), même si vous utilisez d'autres modules Acomba GO.
• Un usager Acomba GO avec les droits d'administration de la compagnie, pour afficher la clé et gérer les développeurs externes.

1. La clé ACCEO Connecté de la compagnie

Chaque compagnie Acomba GO a sa propre clé ACCEO Connecté (un identifiant unique, de la forme d'un GUID). C'est elle qui dit à l'API quelle compagnie ouvrir.

1. Dans Acomba GO, ouvrez la Configuration de la compagnie.
2. Allez à l'onglet ACCEO Connecté.
3. Cliquez « Afficher ma clé ACCEO Connecté » et copiez la valeur.

C'est le champ Clé ACCEO Connecté de la compagnie du portail.

2. Le code de compagnie

Le code de compagnie (4 à 8 caractères, par exemple S002) est transmis par courriel par ACCEO au moment de l'activation d'ACCEO Connecté. Si vous ne le retrouvez pas, demandez-le au support ACCEO : il n'est pas affiché dans l'application.

Deux « codes de compagnie »

Le portail vous demande aussi un code compagnie ERPConnector (par exemple PROD_01) : c'est un code que vous choisissez pour nommer cette connexion dans l'API, sans lien avec le code ACCEO. Les deux champs sont distincts.

3. Le développeur externe

L'API n'accepte un appel que d'un développeur externe autorisé sur la compagnie. Le connecteur s'identifie avec un tel développeur : son identifiant, sa clé secrète et sa clé de développement.

1. Dans Acomba GO, ouvrez « Gérer mes développeurs externes » (aussi nommé SnapX).
2. Ajoutez le développeur : choisissez un identifiant (15 caractères au plus) et une clé secrète.
3. Dans la fiche du développeur, cliquez « Générer une clé » : c'est la clé de développement, générée une seule fois — conservez-la.
4. Cochez chaque module auquel le connecteur doit accéder : comptabilité (comptes et écritures), clients, fournisseurs, produits, facturation, encaissements et paiements, selon ce que votre intégration lit ou écrit.

Un module non coché répond NO_ACCESS

La connexion réussira même si des modules manquent : c'est à l'appel de l'entité que l'API refuse (400, règle NO_ACCESS). Si une entité précise échoue alors que CompanyInfo fonctionne, revenez cocher le module correspondant.

4. Où saisir la connexion

Dans le portail ERPConnector, au moment de connecter une compagnie Acomba GO — dans le wizard de mise en service, dans le dossier de mise en service, ou dans la page Info Connexion d'une compagnie — choisissez le type Acomba GO et remplissez les cinq valeurs :

Champ du portail	Où le trouver
Clé ACCEO Connecté de la compagnie	étape 1
Code de compagnie	étape 2, courriel d'activation
Identifiant du développeur externe	étape 3
Clé secrète du développeur externe	étape 3
Clé de développement	étape 3, bouton « Générer une clé »

Les clés sont stockées chiffrées côté serveur. Le dossier de mise en service ne demande pas d'installer l'agent pour une connexion Acomba GO : le connecteur appelle l'API directement depuis nos serveurs.

5. Tester

• Depuis la fiche de connexion, le bouton Tester la connexion fait un GET /api/Entity/CompanyInfo par la passerelle avec les valeurs saisies. Un test réussi affiche le nom de la compagnie (NomEntreprise) et confirme d'un coup la clé, le code de compagnie et le développeur externe.
• Depuis l'API, le même appel est le premier à faire :

GET https://gateway.erpconnector.ca/api/Entity/CompanyInfo
Authorization: Basic base64(CODE_LICENCE:api_key_…)
COMPANY_CODE: PROD_01

La réponse est une page à un élément : la fiche est dans Data[0].

Erreurs fréquentes

• 401 « La session a expiré » dès le premier appel : la clé ACCEO Connecté, le code de compagnie ou le développeur externe est refusé — revoyez les trois valeurs. Le connecteur gère lui-même le renouvellement de session ; ce message au premier appel est une erreur d'identification, pas une expiration.
• 400 NO_ACCESS sur une entité : le module correspondant n'est pas coché pour le développeur externe (étape 3).
• CIE_INACTIVE / CIELINK_INACTIVE : la compagnie ou son lien ACCEO Connecté est inactif — à réactiver dans Acomba GO ou avec ACCEO.
• INV_DEVKEY / DEVKEY_INACTIVE : la clé de développement est erronée ou a été régénérée ; saisissez la clé courante.
• TOO_MANY_CIE_LINK : l'identifiant du développeur est lié plus d'une fois à la même compagnie ; gardez un seul lien.
• Développeur verrouillé : trois clés secrètes erronées de suite verrouillent le développeur externe une vingtaine de minutes. Attendez avant de retester.
• Les comptes GL reviennent sans solde : c'est normal dans Acomba GO, voir Comptes GL : pas de solde par période.