Le connecteur SenSaaS expose votre dossier Sage 100c par une interface web documentée. Ce que le site et les applications SenSaaS utilisent, vos propres outils peuvent l’utiliser : lire des articles, créer un devis, consulter une balance, depuis un site marchand, un outil de reporting ou un automate.
Cette page s’adresse aux intégrateurs et aux éditeurs. Le vocabulaire y est technique à dessein.
En bref
- Interface REST versionnée, préfixe
/v2/, réponses JSON, erreurs normalisées avec un code lisible et un identifiant de corrélation. - Documentation interactive générée depuis le connecteur : chaque opération, ses paramètres et ses réponses, testables depuis le navigateur.
- Plus de 90 objets Sage : articles, familles, tarifs, tiers, contacts, documents de vente, d’achat, de stock et internes, lignes, règlements, écritures, comptes, journaux, analytique, paramètres.
- Huit opérations par objet : lecture par clé, recherche filtrée et triée avec pagination, comptage, création, enregistrement, modification, suppression.
- Opérations métier : transformation de documents, application des barèmes, calcul des taxes, PDF, indicateurs, balances, recherche globale, requêtes de lecture paramétrées.
- Toutes les versions de Sage 100c de 7.0 à 12.1 derrière la même interface : la version installée est détectée par le connecteur.
Authentification et dossiers
Un compte utilisateur SenSaaS s’authentifie et reçoit une session à durée courte, renouvelable. Chaque requête peut viser un ou plusieurs dossiers Sage autorisés pour ce compte ; en écriture, le dossier cible est obligatoire et explicite. Les droits du compte (dossiers, modules, colonnes) s’appliquent à l’interface comme aux écrans.
Trois exemples
Lire des articles d’une famille, triés par référence
POST /v2/articles/recherche
{ "dossier": "BIJOU", "filtres": [{ "champ": "FA_CodeFamille", "op": "=", "valeur": "BAGUES" }],
"tri": [{ "champ": "AR_Ref" }], "limite": 50 }Créer un devis avec deux lignes
POST /v2/documentvente
{ "dossier": "BIJOU", "entete": { "type": "devis", "client": "CARAT", "date": "2026-09-05" },
"lignes": [ { "article": "EM040", "quantite": 2 }, { "commentaire": "Livraison sous 10 jours" } ] }Seuls les champs présents sont écrits ; les autres gardent la valeur calculée par Sage.
Consulter la balance âgée clients
POST /v2/balance/client/agee
{ "dossier": "BIJOU", "date": "2026-09-30" }Erreurs
Chaque erreur renvoie un code stable et un message explicite : DOSSIER.REQUIRED quand le dossier cible manque en écriture, SAGE.LOCK.RECORD quand la pièce est verrouillée par un autre utilisateur, SAGE.READONLY quand l’objet ne se modifie pas, VALIDATION.MODEL quand un champ est invalide. L’identifiant de corrélation figure dans la réponse et dans les journaux du connecteur.
Limites à connaître
- Une opération Sage à la fois par connecteur : les écritures sont sérialisées ; les lectures paramétrées ne le sont pas.
- Le connecteur s’exécute sur le serveur Sage du client : c’est là que vos appels arrivent, avec ses règles réseau.
- Certaines opérations dépendent de la version de Sage installée (par exemple la transformation partielle avec lots nécessite la v9 ou supérieure) ; la réponse le précise.
Journal des changements
Les évolutions de l’interface sont publiées dans les notes de version du connecteur. La version 1 de l’interface reste disponible pendant la période de transition.
Questions fréquentes
Où est la documentation interactive ? Sur chaque connecteur installé, à l’adresse indiquée par l’administrateur. Une version publique de démonstration est en cours de mise en place.
Faut-il une licence pour intégrer ? L’accès utilise un compte SenSaaS du client, soumis à sa licence. Les conditions pour les éditeurs tiers sont précisées sur demande.
Puis-je écrire dans plusieurs dossiers en un appel ? Non. Chaque écriture vise un dossier explicite. Les lectures peuvent porter sur plusieurs dossiers.
Comment tester sans risque ? Sur un dossier de démonstration fourni avec le connecteur, ou sur une copie de votre dossier.
Mis à jour le 5 septembre 2026