Le connecteur SenSaaS

En bref

Le connecteur est un service Windows installé sur la machine où réside Sage 100. Il ouvre les données d'un ou de plusieurs dossiers Sage à la webapp et à l'application SenSaaS, au portail et à vos outils, au travers d'une API REST protégée par HTTPS. Un outil de configuration livré avec lui sert à tout paramétrer : dossiers, utilisateurs, droits, réseau, licence.

Ce que fait le connecteur

Il expose vos dossiers Sage en lecture, et en écriture lorsque cette option est activée, à travers une API web, sans jamais publier directement la base SQL de Sage.
Il applique vos règles d'accès : chaque utilisateur ne voit que les dossiers qui lui sont autorisés, avec ses filtres de données, ses droits sur les documents et ses droits sur chaque opération de l'API, réglés dans l'outil de configuration.
Il travaille en arrière-plan : mise en cache des images des articles, géocodage des adresses des tiers, synchronisation des paramètres du connecteur avec le portail SenSaaS et, si l'option est active, rangement des médias des objets Sage en sous-dossiers.
Il reste chez vous : les données Sage ne sont ni synchronisées ni exportées. Seules les informations d'administration (version, utilisateurs, dossiers déclarés, licence) sont déclarées au portail, et seule l'adresse postale d'un tiers part au service de géocodage, sans nom ni code tiers.

Architecture

flowchart LR
    subgraph Clients
        A["Webapp et application SenSaaS<br/>(navigateur, mobile)"]
        B["Portail SenSaaS"]
        C["Outils tiers, agents"]
    end

    subgraph Machine["Machine Sage 100 (Windows, x86)"]
        S["Connecteur SenSaaS<br/>service ServeurSensaas<br/>API v2 · contrat OpenAPI · outil de test"]
        G["Passerelle objets métiers<br/>API100"]
        CFG[("SenSaaS.config<br/>chiffré")]
        OUT["Outil de configuration"]
    end

    SAGE["Sage 100<br/>Gestion commerciale + Comptabilité"]
    SQL[("SQL Server<br/>bases Sage + base SenSaaS")]

    A -- HTTPS --> S
    B -- HTTPS --> S
    C -- HTTPS --> S
    S --> G --> SAGE
    S --> SQL
    SAGE --- SQL
    S -. lit à chaud .-> CFG
    OUT -- écrit --> CFG
    OUT -- pilote --> S
    OUT --> SQL

Deux chemins d'accès aux données coexistent : les objets métiers Sage (bibliothèque API100, chargée dans le processus du connecteur) pour lire et écrire des entités complètes, et des requêtes SQL sur les bases Sage pour les listes, les recherches, les balances et les indicateurs.

Prérequis machine

Prérequis	Détail
Système	Windows, avec les droits d'administrateur pour l'installation
Sage 100	Installé sur la même machine, objets métiers compris : ils sont chargés dans le connecteur. De la version 7 à la version 12
Architecture	x86 obligatoire : le connecteur et l'outil de configuration sont 32 bits, comme les composants Sage
.NET	.NET 10 en version x86 (Desktop Runtime et ASP.NET Core Runtime), installé par l'installeur s'il manque
SQL Server	Les bases des dossiers Sage, plus une base propre à SenSaaS (`Sensaas` par défaut), que l'assistant de première configuration crée sur l'instance SQL du dossier
Réseau entrant	Le réseau privé EasyConnect, proposé par défaut, qui n'exige aucun port entrant ; ou un port HTTPS ouvert sur le pare-feu
Réseau sortant	HTTPS vers le portail SenSaaS (licence, synchronisation), vers le réseau EasyConnect s'il est utilisé, et vers le serveur d'identité SenSaaS pour valider les jetons de connexion par la webapp

Machine 32 bits imposée

Les composants Sage sont fournis en 32 bits. Le connecteur est donc compilé en x86 et doit s'exécuter dans un processus 32 bits : c'est la cause la plus fréquente de l'erreur BadImageFormatException décrite dans Dépannage.

Ce que le connecteur expose

L'API SenSaaS v2 (/v2/…), avec une réponse toujours enveloppée (success, data, meta) et des erreurs normalisées. Voir la référence de l'API.
Le contrat de l'API au format OpenAPI, accessible en permanence et sans authentification.
Un outil de test de l'API dans le navigateur, sur l'adresse /test, à activer explicitement depuis l'écran Serveur Web de l'outil de configuration. Il présente les documents "API SenSaaS v1" et "API SenSaaS v2" et permet d'exécuter des requêtes avec un jeton.
L'impression des documents en PDF à partir de modèles propres à chaque dossier Sage, décrite dans Modèles d'impression.

Capture à venir

Outil de test de l'API du connecteur - identifiant connecteur/outil-test-api. L'image sera ajoutée lors de la prochaine campagne de captures.

L'outil de test n'est pas destiné à la production

Il expose la documentation et les schémas de l'API et permet d'exécuter des requêtes. Ne l'activez qu'en environnement de confiance, le temps d'un diagnostic.

Deux façons de se connecter

Le connecteur accepte les deux en parallèle, sans réglage pour en désactiver une :

la connexion directe : identifiant et mot de passe d'un utilisateur du connecteur, qui obtient un jeton émis par le connecteur lui-même ;
la connexion par la webapp SenSaaS : la webapp présente un jeton délivré par le serveur d'identité SenSaaS, que le connecteur associe à l'utilisateur actif de même adresse email.

Dans les deux cas, ce sont les droits de l'utilisateur du connecteur qui s'appliquent. Le détail est dans Sécurité.

Les protocoles v1 et v2

Le connecteur sert deux générations d'API en parallèle :

v2 est la version cible : routes /v2/…, réponses sous enveloppe, erreurs au format ProblemDetails, sélection des dossiers par le paramètre targets.
v1 regroupe les routes historiques, hors /v2. Elles sont obsolètes : conservées pour la compatibilité avec l'ancienne version de la webapp, elles portent les en-têtes Deprecation et Sunset, et leur retrait est prévu au 1er janvier 2027, date révisable selon le calendrier de déploiement réel.

Aller plus loin

Page	Ce que vous y trouvez
Installer le connecteur	Installeur, service Windows, EasyConnect, ports, mise à jour, désinstallation
Licence	Code machine, licence en ligne, cache signé, quota B2B
Sécurité	HTTPS, deux modes de connexion, droits appliqués, fichier de configuration chiffré
Journalisation	Où lire les journaux, niveaux, mode détaillé
Modèles d'impression	Bibliothèque de modèles, préparation par dossier Sage, erreurs PDF
Dépannage	Symptômes fréquents, causes et correctifs
Outil de configuration	Un article par écran
Référence de l'API	Authentification, conventions, groupes d'opérations