Dépannage

Commencez toujours par :

cd "C:\Program Files\Maillon\Sage100"
.\maillon-sage100.exe status

La commande affiche le chemin de la configuration, l'adresse d'écoute, les dossiers, le nombre de clés actives et l'état du relais ou du tunnel. Les erreurs du service sont aussi visibles dans l'Observateur d'événements de Windows (journal Application).

Installation

« maillon-sage100.exe not found » au lancement de install.ps1 : le paramètre -SourceDir doit pointer vers le dossier win-x86 décompressé.

Le script est bloqué par la stratégie d'exécution : lancez Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass dans la même fenêtre, puis relancez l'installation.

Le service démarre puis s'arrête : l'adresse d'écoute est probablement déjà utilisée (IIS écoute souvent sur des ports proches). Changez urls dans le bloc http de la configuration, puis Restart-Service MaillonSage100.

Dossiers

SQL connection FAILED lors de dossier test :

• vérifiez le nom exact de l'instance (SERVEUR\INSTANCE) et de la base ;
• vérifiez que le login maillon_reader a bien le rôle db_datareader sur cette base ;
• si SQL Server est sur une autre machine, vérifiez que le protocole TCP/IP est activé et que le pare-feu autorise la connexion.

Des tables marquées MISSING : la base n'est pas une base Sage 100 complète, ou il s'agit d'une version non prise en charge.

Écriture

L'écriture est refusée alors que la clé a les bons droits : le dossier n'est peut-être configuré qu'en lecture. dossier list doit afficher SQL + Objets Metiers ; sinon, lancez dossier set-om.

Erreur à l'ouverture des Objets Métiers : vérifiez que le runtime objets100c_100.exe est installé sur la même machine, que sa licence est active, que les chemins .gcm et .mae sont accessibles depuis le compte du service, et que l'utilisateur Sage n'est pas bloqué.

« Référence incorrecte », « L'article X appartient à la famille Y »... : ce sont des refus de Sage lui-même, renvoyés tels quels. Corrigez la demande comme vous le feriez dans le logiciel.

Une facture ne peut pas être réglée : avec la loi anti-fraude, une facture de vente doit être validée dans Sage avant son règlement ; les Objets Métiers ne savent pas la valider.

Délettrer une écriture : non disponible, les Objets Métiers de Sage ne le permettent pas. Faites-le dans Sage.

Accès distant

Le relais ne se connecte pas : vérifiez que le serveur peut joindre relais.maillon.dev en sortie (port 443), que le jeton commence bien par s100r_ et qu'il n'a pas été révoqué dans la console.

Le tunnel ne démarre pas : cloudflared doit être installé, ou son chemin indiqué avec tunnel set --cloudflared C:\chemin\cloudflared.exe.

Assistant

L'assistant ne voit aucun outil : vérifiez l'adresse (elle se termine par /mcp) et l'en-tête Authorization: Bearer s100_.... Une clé révoquée ou mal copiée renvoie une erreur 401.

L'assistant ne voit pas certains outils : c'est normal, il ne voit que ceux autorisés par les droits de la clé. Créez une clé avec les droits nécessaires.

Obtenir de l'aide

Écrivez à support@maillon.dev en joignant la sortie de status (elle ne contient aucun mot de passe ni aucune clé) et, si possible, l'extrait de l'Observateur d'événements.