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.
| Information | Contrôle proposé |
|---|---|
| Référence externe | Retrouver la même vente lors d’une reprise. |
| Tiers | Vérifier existence et conditions applicables. |
| Article et dépôt | Utiliser les codes reconnus dans le dossier cible. |
| Montants | Rapprocher lignes, remises, frais et arrondis. |
| Pièce Sage | Conserver 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énement | Attendu dans le dossier cible |
|---|---|
| Nord reçoit WEB-10482 | Création de la pièce Nord BC000017. |
| Nord reçoit de nouveau WEB-10482 | Retour de BC000017. Le nombre de pièces reste stable. |
| Sud reçoit WEB-10482 | Création de la pièce Sud BC000003. La vente Nord reste distincte. |
| Sud reçoit WEB-10483 avec SKU-ABSENT | Rejet 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.