Le connecteur SenSaaS¶

En bref

Le connecteur est un service Windows installé sur la machine où réside Sage 100c. Il ouvre les données d'un ou de plusieurs dossiers Sage à 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 le profil de droits et les filtres de données que vous avez définis.
Il travaille en arrière-plan : préparation des images des articles, géocodage des adresses des tiers, synchronisation des informations du serveur avec le portail SenSaaS.
Il reste chez vous : les données Sage ne quittent pas la machine, seules les informations d'administration (utilisateurs, dossiers, licence) sont déclarées au portail.

Architecture¶

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

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

    SAGE["Sage 100c<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 (API100c, chargés 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 et les indicateurs.

Prérequis machine¶

Prérequis	Détail
Système	Windows, avec les droits d'administrateur pour l'installation
Sage 100c	Installé sur la même machine (les objets métiers Sage 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 9 en version x86 (Desktop Runtime et ASP.NET Core Runtime) — installé automatiquement par l'installeur s'il manque
SQL Server	Les bases des dossiers Sage, plus une base propre à SenSaaS (`Sensaas` par défaut)
Réseau	Un port HTTPS ouvert (443 par défaut), ou le réseau privé EasyConnect si vous ne souhaitez ouvrir aucun port entrant

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, à activer explicitement depuis l'écran Serveur Web de l'outil de configuration ; il permet de parcourir la documentation des opérations et d'exécuter des requêtes.
L'impression des documents à partir de modèles que vous fournissez, 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.

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 est l'ancienne version, figée et dépréciée. Elle reste maintenue six mois après la mise à disposition générale de la v2, le temps que les clients existants migrent.

Aller plus loin¶

Page	Ce que vous y trouvez
Installer le connecteur	Installeur, service Windows, ports, mise à jour, désinstallation
Licence	Code machine, licence en ligne, activation, quota B2B
Sécurité	HTTPS, jetons, hôtes autorisés, fichier de configuration chiffré
Journalisation	Où lire les journaux, niveaux, mode détaillé
Modèles d'impression	Fichiers de modèles, dossier par dossier Sage
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