Développeurs

Le connecteur SenSaaS expose votre dossier Sage 100 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.
• Médias fichiers joints aux articles, tiers, pièces, écritures comptables, sections analytiques et immobilisations (/v2/medias/…), en lecture, ajout, modification et suppression ; contenu envoyé en JSON encodé en base64, sans limite de taille ni d’extension posée par le connecteur ; rangement optionnel des fichiers dans un dossier par fiche. Détail : Médias des objets Sage.
• Toutes les versions de Sage 100 de la version 7 à la version 12 derrière la même interface : la version installée est détectée par le connecteur.
• Volume près de 500 adresses et plus de 700 opérations, réparties en plus d’une centaine de groupes fonctionnels ; 156 indicateurs de pilotage en 22 familles, comptables compris (/v2/kpi), tableau de bord, balances, cadencier, tarifs calculés, recherche et requêtes de lecture.
• Découverte assistée un serveur MCP (Model Context Protocol) livré avec le connecteur permet à un assistant de code de parcourir les groupes, les opérations et les conventions, puis d’appeler l’API pour écrire l’intégration avec vous.

Documentation de référence

La référence complète de l’API est en ligne dans la documentation SenSaaS :

• Démarrer : adresse de base, POST /v2/auth/login, enveloppe de réponse, paramètres targets, limit et offset, erreurs ProblemDetails, exemples curl et Python.
• Conventions de payload : PascalCase métier sous enveloppe camelCase, écritures partielles, taxonomie des codes d’erreur.
• Indicateurs : les 156 indicateurs en 22 familles, routes /v2/kpi, /v2/kpi/{type}, /v2/kpi/{type}/{code}.
• Serveur MCP : installation, variables d’environnement, les six outils, scénario d’intégration par un assistant.
• Tous les groupes : une page par groupe fonctionnel, générée depuis le contrat OpenAPI du connecteur, avec chaque opération, ses paramètres, ses réponses et un exemple d’appel.

Côté exploitation, les pages Sécurité et Accès et droits décrivent comment l’administrateur crée un compte technique et ce qu’il autorise. Pour les assistants de code, la section Agents présente les serveurs de connaissance disponibles.

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, fonctions, 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

Mis à jour le 9 octobre 2026