Connecter et configurer Acomba
Le connecteur parle à Acomba par son SDK : des bibliothèques Windows installées avec Acomba, qui permettent à un logiciel tiers de lire et d'écrire les données (clients, factures, produits…). Cette page rassemble ce qu'il faut préparer côté Acomba, les valeurs à saisir dans la connexion, et les gestes à connaître ensuite.
Prérequis
- Acomba est installé sur le serveur où tourne le connecteur. Le SDK ne traverse pas le réseau : le connecteur charge les bibliothèques d'Acomba localement. Les données de la compagnie, elles, peuvent être sur un autre poste (voir les chemins plus bas).
- Le connecteur est arrimé à une version précise d'Acomba. Avant toute mise à jour d'Acomba, voir Mise à jour d'Acomba.
1. Installer (activer) le SDK d'Acomba
À faire une fois, sur le serveur, avec Acomba ouvert normalement.
- Menu Info > À propos d'Acomba.
- Cliquez le bouton info : l'utilitaire WRINFO s'ouvre.
- Allez à l'onglet SDK (le 2ᵉ onglet).
- Vérifiez le répertoire d'installation du SDK — le chemin standard est
C:\fortune\sdk\. - Cliquez Sauvegarder la configuration.
- Un message confirme la réussite ; fermez WRINFO.
Si l'onglet SDK affiche En utilisation, un logiciel tient le SDK en ce moment et la sauvegarde échouera. Fermez (ou arrêtez) les connecteurs et logiciels qui parlent à Acomba, puis recommencez. Le connecteur lui-même en fait partie : arrêtez son service le temps de l'opération.
2. L'usager Acomba
Créez dans Acomba un usager dédié au connecteur (par exemple AgentExtract), plutôt
que d'emprunter le compte d'une personne :
- ses droits ne changent pas quand quelqu'un quitte l'entreprise ;
- les modifications faites par l'API sont identifiables dans Acomba ;
- son mot de passe n'expire pas au mauvais moment.
Donnez-lui les droits suffisants pour ce que l'intégration fera : la lecture seule suffit
pour des extractions (GET), mais il faudra des droits de création et de modification dès
que l'intégration écrira (POST, PUT). Le plus simple est de créer tout de suite l'usager
final avec ses droits définitifs.
Le détail — où se trouvent les droits dans Acomba, et quel onglet porte quelles entités — est
sur sa propre page : Les droits de l'usager Acomba. À retenir dès
maintenant : les factures, les commandes, les soumissions et les achats (SupplierOrder)
dépendent tous de l'onglet Facturation, et un droit manquant se manifeste le plus souvent
par des enregistrements vides plutôt que par une erreur.
3. Les deux chemins
La connexion Acomba demande deux chemins, souvent confondus :
| Chemin | C'est quoi | Exemple |
|---|---|---|
| Chemin logiciel | Le dossier d'installation d'Acomba sur le serveur, celui qui contient les bibliothèques du SDK | C:\FORTUNE |
| Chemin compagnie | Le dossier des données de la compagnie (le .DTA) | C:\F1000.DTA\MaCompagnie ou \serveur\partage\F1000.DTA\MaCompagnie |
Quand les données sont sur un autre poste, écrivez le chemin en UNC (\nomduposte\partage\…),
jamais en lettre de lecteur mappé (F:\…). Un lecteur mappé appartient à la session d'un
utilisateur ; le connecteur tourne comme service Windows, sans session, et ne voit pas
ces lettres. C'est la première cause de « chemin introuvable » alors que tout fonctionne
dans l'Explorateur.
Dans ce cas, il faut aussi fournir un usager réseau (compte Windows du domaine) qui a
accès au partage — un compte permanent, dédié, dont le mot de passe n'expire pas
(par exemple AgentConnect).
4. Où saisir la connexion
- Agent ERPConnector : dans le portail client, page Info Connexion (fiche de la compagnie).
- Connecteur OnlineERP (légataire) : sur le serveur, fenêtre Options, onglet Connexion ERP — voir Options et connexions OnlineERP.
Les valeurs sont les mêmes dans les deux cas : chemin logiciel, chemin compagnie, usager et mot de passe Acomba, et l'usager réseau si les données sont distantes.
5. Tester
- Depuis la fiche de connexion, le bouton Tester fait ouvrir la compagnie par le connecteur avec les valeurs saisies. Un test réussi confirme les chemins, l'usager et le SDK d'un coup.
- Depuis l'API, un
GET /api/Entity/CompanyInfoest le premier appel à faire : il retourne le nom de la compagnie ouverte.
Un test qui échoue nomme en général la cause : chemin introuvable (revoir l'UNC et l'usager réseau), usager ou mot de passe refusé, ou SDK absent (revenir à l'étape 1).
Mise à jour d'Acomba
Une mise à jour d'Acomba s'applique à la main, sur le serveur ; elle ne peut pas être poussée par le connecteur. Deux précautions :
- Libérer le SDK avant : le connecteur tient le SDK tant qu'il tourne, et l'installateur d'Acomba peut se bloquer. Arrêtez le service du connecteur (OnlineERP) ou terminez le processus d'exécution des tâches (agent ERPConnector) le temps de la mise à jour.
- Vérifier la compatibilité : le connecteur est arrimé à une version précise d'Acomba. En cas de doute, validez avec le support avant d'appliquer une version majeure.
Le détail : Mise à jour manuelle d'Acomba.
Erreurs fréquentes
- « Votre version de l'application n'est pas à jour » (erreur #41) : la version d'Acomba ne correspond pas à celle des fichiers de la société — voir Erreurs Acomba.
- « Cette application n'est pas installée » (erreur #136) : le chemin logiciel ne correspond pas au répertoire du SDK — voir Erreurs Acomba.
- « Filer error : XX » à la création : une propriété requise manque ou est invalide dans la requête — voir Erreur FILER_ERROR.
- Les autres codes, et la liste complète : Erreurs Acomba.