Aller au contenu
Intégration API

Sage 100 : choisir une passerelle et cadrer les échanges

Jérémy Chomel Dawap
  • Publié le : 20 janvier 2024
  • Mis à jour le : 20 novembre 2026
  • Temps de lecture : 10 minutes
Portrait de Jérémy Chomel

Demandez au fournisseur du connecteur de créer une commande dans le dossier Sage 100 de recette, puis de retrouver la pièce depuis la référence de la boutique. Faites le même essai dans le dossier d’une seconde société avec la même référence. Une lecture de catalogue réussie n’apporte aucune preuve sur le rattachement d’une pièce ni sur son suivi par l’ADV.

Le choix se joue entre les Objets Métiers, la passerelle REST d’un fournisseur et un import supporté pour la pièce voulue. En intégration de Sage à votre SI, Dawap cadre les flux et l’application métier pendant que le partenaire Sage confirme l’installation, les licences, le paramétrage et les habilitations de chaque dossier.

Constituer la fiche d’accès Sage 100

Relevez la version Sage, les modules et la version des Objets Métiers ou du connecteur. Demandez l’environnement de recette, le mode d’hébergement, le nom du dossier et les habilitations nécessaires. Une licence de l’application ne prouve pas que l’interface souhaitée est installée et utilisable.

La documentation officielle de connexion distingue les bases sur site et Sage Partner Cloud. Certaines propriétés dépendent de la version des Objets Métiers. Faites valider le mode de connexion retenu plutôt que de copier un exemple ancien sans examiner son contexte.

Choisir Objets Métiers, REST partenaire ou fichiers

Objets Métiers : une dépendance à qualifier

Les Objets Métiers donnent un accès aux fonctionnalités de Sage 100 dans leur environnement compatible. Leur utilisation exige les composants et références adaptés. Un backend web peut s’appuyer sur un service intermédiaire qui encapsule cet accès et limite les opérations autorisées.

Passerelle REST : vérifier son contrat propre

Demandez au fournisseur son OpenAPI ou sa documentation équivalente. Vérifiez les méthodes, les ressources couvertes, l’authentification, les erreurs, les limites et le support de la version installée. Une route REST de ce fournisseur ne doit pas être présentée comme un endpoint commun à tous les Sage 100.

Imports : accepter un délai pour mieux contrôler le lot

Le format d’import et d’export paramétrable de Sage 100 se qualifie pour le document visé. Quand l’ADV peut attendre la fin d’un lot, reliez le fichier envoyé au compte rendu et aux pièces effectivement créées. La présence d’un fichier déposé ne dit rien sur son acceptation ligne par ligne. Passez par les mécanismes supportés pour conserver les contrôles de Gestion Commerciale.

Comprendre une connexion documentée en C#

Le court exemple ci-dessous illustre l’ouverture d’une base comptable sur site avec les Objets Métiers 100c à partir de la version 3. Il adapte les propriétés documentées par Sage ; les valeurs viennent ici de la configuration. Les références aux composants, l’installation, la gestion des exceptions et la fermeture doivent être adaptées au projet. Il ne crée aucun document et n’a pas été exécuté sur votre environnement.

var accounting = new BSCPTAApplication100c();
accounting.CompanyServer = configuration.Server;
accounting.CompanyDatabaseName = configuration.Database;
accounting.Loggable.UserName = configuration.SageUser;
accounting.Loggable.UserPwd = secretStore.ReadSagePassword();
accounting.Open();

Les classes configuration et secretStore représentent votre code, pas des classes Sage. Une connexion SPC demande son contexte propre : ne réutilisez pas les paramètres sur site comme s’ils formaient un appel OAuth REST. Consultez les sections correspondantes de la documentation avant de choisir les identifiants.

Définir les correspondances articles, tiers et dépôts

Utilisez une référence stable pour chaque article et chaque tiers. La désignation commerciale n’est pas une clé. Si deux boutiques emploient des SKU différents pour la même référence Sage, conservez une table de correspondance explicite avec le canal et la variante.

Pour les stocks, distinguez quantité physique, réservation, préparation et disponibilité proposée à la vente. Une disponibilité globale n’explique pas quel dépôt peut expédier. Il faut intégrer les règles de l’entreprise, le WMS éventuel et les marges de sécurité avant de publier un chiffre aux canaux.

Écrire une commande complète plutôt qu’un assemblage de lignes

La création doit préserver le tiers, le dépôt, les articles, les quantités, les unités, les remises, les taxes et les frais. Le contrat doit préciser si la pièce et ses lignes sont validées ensemble ou si une écriture partielle peut subsister.

Choisissez un résultat métier observable : numéro de pièce obtenu, statut de validation et éventuelles lignes refusées. Un accusé de réception du middleware peut seulement signifier que le travail attend dans une file ; il ne doit pas être présenté au commerce comme une commande créée dans Sage.

InformationContrôle proposé
Référence externeRetrouver la même vente lors d’une reprise.
TiersVérifier existence et conditions applicables.
Article et dépôtUtiliser les codes reconnus dans le dossier cible.
MontantsRapprocher lignes, remises, frais et arrondis.
Pièce SageConserver le numéro et le résultat de validation.

Donner un contrat stable au middleware

Le contrat d’application peut utiliser une commande normalisée puis la traduire vers la passerelle choisie. L’exemple JSON suivant est une proposition interne, sans attribution à Sage ou au partenaire historique NetMinds. Les noms et validations doivent être définis dans votre propre documentation.

{
  "source": "boutique-fr",
  "external_order_id": "WEB-10482",
  "target_company": "societe-recette",
  "customer_code": "CLI-42",
  "warehouse_code": "DEPOT-1",
  "lines": [{"article_code": "ART-100", "quantity": 2}]
}

La réponse interne doit distinguer reçu, créé, rejeté et résultat incertain. La documentation de la passerelle fournit ensuite les appels concrets. Une collection Postman reproductible ne peut être préparée qu’une fois cette interface et ses droits connus.

Traiter le timeout avant de réessayer

Imaginez une commande dont l’appel expire après envoi. La pièce peut avoir été créée malgré l’absence de réponse. Recherchez la référence externe ou rapprochez le résultat avec les moyens documentés. Si le fournisseur ne permet pas cette vérification, suspendez la reprise automatique et demandez un contrôle.

Un client absent ou un code taxe invalide demande une correction de données. Une panne temporaire peut justifier une nouvelle tentative limitée. La clé doit rester liée à l’opération métier, pas changer avec chaque tentative. Ne supposez pas que la passerelle honore un en-tête d’idempotence sans preuve.

Valider un jeu de recette avec l’ADV et la logistique

Dans ce jeu de recette fictif, les sociétés Nord et Sud exploitent chacune une boutique dont la numérotation peut recommencer à la même valeur. Le middleware réserve une clé composée du dossier cible, du canal et de la référence de commande. L’ADV compare le résultat dans chaque dossier, avec les identifiants de pièce renvoyés par le raccordement.

ÉvénementAttendu dans le dossier cible
Nord reçoit WEB-10482Création de la pièce Nord BC000017.
Nord reçoit de nouveau WEB-10482Retour de BC000017. Le nombre de pièces reste stable.
Sud reçoit WEB-10482Création de la pièce Sud BC000003. La vente Nord reste distincte.
Sud reçoit WEB-10483 avec SKU-ABSENTRejet transmis à l’ADV. Aucune pièce ouverte pour ce document.

Sur quatre événements, attendez deux pièces, une reprise de résultat et un rejet. Pour refaire l’essai, remplacez les numéros fictifs par ceux qu’attribue votre dossier de recette et rapprochez-les avec la référence externe. Si l’interface ne restitue le résultat qu’en fin de lot, vérifiez que tous les rejets restent rattachables à leur commande. Si le contrat exige une confirmation immédiate pour l’ADV, l’import périodique sort du périmètre.

NetMinds : relier Sage 100c et les canaux de vente

Chez Pixminds, NetMinds utilisait une API REST exposée par un partenaire technique sur Sage 100c. L’application sur mesure articulait des données ERP, des échanges marketplace et des fonctions de pilotage. L’architecture API de NetMinds pour Pixminds décrit le rôle de cette passerelle dans le projet.

Pour un nouveau projet, cette organisation peut être reproduite avec les interfaces compatibles de votre environnement. La relation se construit entre vos équipes, le prestataire ERP et Dawap ; elle ne dépend pas d’une promesse de REST natif sur toute version cloud.

Prolonger le cadrage technique

Le guide adaptateur et SDK approfondit la séparation entre backend web et interface ERP. Le plan de reprise des commandes aide à définir les états et le rapprochement après incident.

Priorisez une seule chaîne mesurable avant les extensions CRM, BI et achats. La documentation de livraison doit réunir le contrat fournisseur, les correspondances, les tests et la responsabilité de maintenance après montée de version.

Conclusion : Rendre chaque échange vérifiable

Pour le premier atelier, apportez la version Sage et les licences du dossier, un export de commande anonymisée et le délai dans lequel l’ADV doit obtenir son numéro de pièce. Le partenaire Sage peut alors confirmer les interfaces disponibles, et Dawap chiffrer le raccordement sur la base du chemin qui passe la recette.

Portrait de Jérémy Chomel

Quel accès est disponible sur vos dossiers Sage 100 ?

Vérifions avec votre partenaire Sage la couverture d’une pièce réelle et le contrôle attendu par votre ADV.

Qualifier mon raccordement Sage 100

Articles recommandés

Flux Sage 100 et Sage X3 : sources de vérité, rejets et replay Intégration API Connecter Sage : interfaces de 100, X3, Active et Intacct Lire l'article
  • 6 octobre 2024
  • Lecture ~12 min

Sage 100, X3, Active et Intacct utilisent des interfaces différentes. Ce guide aide à identifier les accès documentés, les responsabilités du partenaire ERP et les preuves nécessaires avant de connecter commandes, stocks ou finance. NetMinds illustre une intégration Sage 100c via une passerelle REST et une application sur mesure.

SDK API ERP Sage sous Symfony Intégration API Adaptateur Sage et Symfony : séparer SDK, passerelle et SI Lire l'article
  • 24 janvier 2025
  • Lecture ~7 min

Un SDK Sage, une passerelle REST et un adaptateur Symfony répondent à des responsabilités différentes. Découvrez comment isoler la dépendance ERP, définir un contrat métier, traiter un résultat incertain et préparer la maintenance. Les exemples PHP sont des propositions d’architecture, distinctes des interfaces officielles.

Sage API et e-commerce multi-boutiques : commandes et stocks Intégration API Sage et e-commerce multi-boutiques : commandes et stocks Lire l'article
  • 15 février 2024
  • Lecture ~8 min

Plusieurs boutiques imposent des clés de vente distinctes, des correspondances de variantes et des règles de disponibilité partagées. Ce guide explique comment transmettre les commandes à Sage, rapprocher les montants et traiter les retours. Un scénario de timeout montre pourquoi une création doit être vérifiée avant toute reprise.

Sage API et marketplaces : catalogue, stock et commandes Intégration API Sage et marketplaces : catalogue, disponibilité et commandes Lire l'article
  • 15 février 2024
  • Lecture ~8 min

Une intégration marketplace doit préserver les références d’offre et de vente, calculer la disponibilité et transmettre les bons statuts logistiques. Ce guide distingue les scénarios actuels de la référence historique NetMinds : Sage 100c via REST partenaire, lecture Amazon MWS et échanges HTTP/XML avec Fnac.

Quel accès est disponible sur vos dossiers Sage 100 ?

Vérifions avec votre partenaire Sage la couverture d’une pièce réelle et le contrôle attendu par votre ADV.

Qualifier mon raccordement Sage 100