Dépannage : problèmes fréquents

Causes classiques d'un appel qui échoue

• pare-feu qui bloque l'agent ;
• mise à jour d'Acomba en cours ;
• coupure Internet chez le client ;
• service Windows du connecteur arrêté ;
• erreur renvoyée par l'ERP lui-même (donnée invalide, client inexistant, compte GL désactivé...).

Lire le message d'erreur pour localiser le problème

• Si l'erreur commence par « Erreur gérée par le WebAPI publique [CreateTask] » : la requête n'a pas atteint l'agent du client — le problème est entre vous et le HUB (licence, service arrêté, aucun agent à l'écoute).
• « Aucun connecteur OnlineERP (Service Windows) n'a été trouvé, ni localement ni sur le hub distant », ou la tâche « sans réponse depuis 120 secondes », ou l'agent « en mode maintenance » : voir L'agent Conexio ne répond pas.
• « ERREUR – Aucun client (Service Windows) trouvé pour le code de licence spécifié » ou « Il semble n'y avoir aucun client OnlineERP / ERP Connector à l'écoute pour votre Code licence » : l'agent n'est pas connecté au HUB. Le plus souvent, le poste qui héberge l'agent est éteint, le service Windows est arrêté, ou le poste n'a plus accès à Internet (réseau, pare-feu). Vérifiez que le service tourne (voir Redémarrer le service), puis la connexion (voir Valider que tout est bien connecté).
  • Seule exception : un vieux connecteur OnlineERP (légataire) encore réglé sur une ancienne adresse de HUB (voir Changer le HUB).
• Erreur retournée par l'ERP : le format des endpoints Entity est Erreur du Connecteur ERP. Détail : ERREUR – [Message de l'erreur] — le message vient d'Acomba/Avantage/Sage 50, corrigez la donnée en conséquence.

Codes HTTP utiles

• 401 : code licence ou clé secrète invalide, licence expirée ou pas encore active.
• 429 : quota de requêtes dépassé (limites par minute/heure/jour selon la licence).
• 400 « Erreur recu du connecteur Back-end » : la demande a échoué chez le connecteur, et le détail dit pourquoi. Un agent hors ligne, sans réponse (120 s) ou en maintenance donne ce code : voir L'agent Conexio ne répond pas.
• 502 / 504 : le serveur central est injoignable ou n'a pas répondu dans son délai ; réessayez plus tard.
• 503 « No backend available » : aucun serveur central n'est assigné à la licence ; écrivez-nous.

Redémarrer le service du connecteur

Avec l'agent Conexio : voir Gérer le service (Gestionnaire de service ou services.msc). Les captures ci-dessous montrent le connecteur OnlineERP (légataire).

Méthode 1 : par l'application de l'agent

Ouvrir le gestionnaire via l'icône bureau :

Onglet « Gestion du service » → bouton Redémarrer le service (ou Arrêter puis Démarrer) :

Méthode 2 : par les services Windows

Windows + R → services.msc :

Trouver le service du connecteur (« Solution Infomédia - OnlineERP - ... Connector - Serveur ») → clic droit → Redémarrer :

Valider que tout est bien connecté

Avec l'agent Conexio : page Configuration de l'interface locale, bloc Diagnostics de connexion (voir Gérer le service).

Avec OnlineERP (légataire) : ouvrir le gestionnaire (icône bureau, ou raccourci vers OnlineERP_BackEndServer.exe avec l'argument -MODE_GESTION_SERVICE) → Fichier > Options → « Tester connexion Acomba » et « Tester Code Licence ».

Si le problème persiste : supportprogweb@solutioninfomedia.com.