Intégrations / ERP / Sage 200
Guide d’intégration de Sage 200 pour l’ordonnancement de la production avec SkyPlanner APS
Ce guide d’intégration de Sage 200 explique aux partenaires et aux équipes informatiques comment connecter Sage 200 Professional et son extension de gestion de production à SkyPlanner APS. L’intégration entre SkyPlanner et Sage 200 fonctionne dans les deux sens :
- Les produits, les stocks en entrepôt, les commandes fournisseurs et les commandes clients sont importés via la Sage 200 REST API.
- Les ordres de fabrication, les opérations et les ressources en main-d’œuvre et en machines sont importés depuis votre extension de gestion de production.
- Les dates planifiées des opérations sont renvoyées vers les ordres de fabrication.
- Les relevés de temps des opérateurs sont renvoyés pour imputer les temps à chaque opération.
Lors de la mise en place, l’équipe SkyPlanner configure l’intégration en fonction de votre environnement Sage 200, puis en assure le support après la mise en production. Ce guide s’adresse aux partenaires et aux développeurs qui souhaitent participer au projet ou développer eux-mêmes à partir de la REST API documentée de SkyPlanner (référence de l’API).
Deux sources au sein d’un même système Sage 200
Un site industriel équipé de Sage 200 repose sur deux couches. L’intégration lit les données des deux.
1. La Sage 200 REST API pour les données commerciales et les stocks. Selon Sage, l’API « lets your application read and modify data in a Sage 200 site » (permet à votre application de lire et de modifier les données du site). Cela couvre les clients, les fournisseurs, les produits, les commandes clients et fournisseurs, ainsi que les comptes généraux. La documentation de référence de Sage 200 Professional (2025.02) regroupe ses ressources sous Cash Book, Commercials, Financials, General, Nominal, POP, Price Book, Purchases, Sales, SOP et Stock. Voici les ressources utiles à l’ordonnancement :
| Ressource | Données contenues |
|---|---|
products | Code, nom, unité de stock, type d’article dans la nomenclature, coût standard |
warehouse_holdings | quantity_in_stock, quantity_on_order, quantity_allocated_bom, free_stock_available, is_default_manufacturing_warehouse |
pop_orders, pop_order_lines | Commandes fournisseurs ouvertes, line_quantity, requested_delivery_dates |
sop_orders, sop_order_lines | Demande client, requested_delivery_date, promised_delivery_date |
warehouses, units | Sites et unités de mesure |
2. L’extension de gestion de production pour les ordres de fabrication. L’API de Sage 200 ne propose aucun point de terminaison pour les ordres de fabrication, les opérations ou les ressources. Les ordres de fabrication sont gérés dans Sicon Works Order Processing, Cim200 ou l’ancien module Sage 200 Manufacturing. L’intégration lit les ordres de fabrication, les opérations et les ressources par le moyen d’accès pris en charge par l’extension, convenu avec vous et votre partenaire Sage 200 lors du cadrage.
Authentification et accès
L’API de Sage 200 « uses OAuth 2.0 with OpenID Connect » (utilise ce protocole avec OpenID Connect), selon le flux d’autorisation par code. La connexion passe par Sage ID.
- Rejoignez le Sage 200 API Developer Programme et demandez vos identifiants.
- Associez un Sage ID à un utilisateur Sage 200 disposant des droits d’accès aux sociétés et aux fonctionnalités nécessaires pour les points de terminaison utilisés.
- Demandez la portée
offline_access: sans elle, aucun jeton de rafraîchissement n’est émis. - Envoyez
Authorization: Bearer <access_token>,X-SiteetX-Companyà chaque requête vers la base de données. Les deux identifiants proviennent de/sites.
URL de base pour Sage 200 Professional : https://api.columbus.sage.com/uk/sage200extra/accounts/v1. Les requêtes utilisent GET, POST, PUT et DELETE, ainsi que les options de requête OData $filter, $select, $top, $skip, $orderby et $expand.
Pour Sage 200 Professional, le prestataire de support du client active l’API. Dans la liste de contrôle de Sage, il confirme que « the API is enabled » (l’API est activée) et que « each required user has a Sage ID assigned. » (chaque utilisateur concerné dispose d’un Sage ID). Dans Sage 200 Standard, l’API est activée par défaut.
La conception doit tenir compte de la durée de validité des jetons. Les jetons d’accès sont valables 8 heures. Les jetons de rafraîchissement sont valables entre 1 et 90 jours, et « The refresh window is measured from the user’s initial sign-in, not from the most recent refresh. » (La période de rafraîchissement est calculée à partir de la connexion initiale de l’utilisateur, et non du dernier rafraîchissement.) Sage précise que la réauthentification « is unavoidable » (est inévitable). Prévoyez une alerte pour renouveler le consentement avant la fin de cette période.
Côté SkyPlanner, la REST API utilise un jeton d’API pour l’authentification (SkyPlanner Settings > API) et sa documentation est disponible dans Swagger/OpenAPI. Le tutoriel d’intégration vous guide dans les premiers appels.
Détection des modifications
La documentation de référence de l’API de Sage 200 ne présente aucune ressource de webhook ou d’abonnement. Les modifications sont détectées par interrogation périodique. Les enregistrements comportent les champs date_time_created et date_time_updated. Chaque interrogation utilise donc $filter sur date_time_updated pour filtrer les résultats, puis $top et $skip pour les paginer.
Interrogez les ordres de fabrication toutes les quelques minutes, et les stocks et les lignes de commandes fournisseurs toutes les heures. SkyPlanner envoie des webhooks lorsque le planning change : la réécriture est donc déclenchée par les événements.
Correspondance des données
| Objet Sage 200 (source) | Objet SkyPlanner | Sens | Fréquence |
|---|---|---|---|
products, units (API) | Produits et matières | Sage 200 → SkyPlanner | Chargement, puis interrogation périodique |
| Composants de nomenclature (extension ou module BOM) | Structure des produits, sous-ensembles, matières par produit | Sage 200 → SkyPlanner | À chaque modification |
| Ressources en main-d’œuvre et en machines, groupes de ressources (extension) | Postes de travail, groupes de postes de travail, personnel | Sage 200 → SkyPlanner | Chargement initial |
| Disponibilité des ressources : arrêts, maintenance, congés (extension) | Horaires d’équipe, absences | Sage 200 → SkyPlanner | Tous les jours |
| Ordres de fabrication et leurs opérations, temps par opération (extension) | Ordres et opérations avec étapes, durées et échéances | Sage 200 → SkyPlanner | Toutes les quelques minutes |
sop_order_lines: requested_delivery_date, promised_delivery_date (API) | Échéances clients | Sage 200 → SkyPlanner | Interrogation périodique |
warehouse_holdings: quantity_in_stock, free_stock_available (API) | Quantités en stock | Sage 200 → SkyPlanner | Toutes les heures |
pop_order_lines: line_quantity, requested_delivery_dates (API) | Commandes fournisseurs avec date de livraison prévue | Sage 200 → SkyPlanner | Toutes les heures |
| Début et fin planifiés de l’opération de l’ordre de fabrication, ressource affectée | Début, fin et poste de travail planifiés par opération | SkyPlanner → Sage 200 | À chaque modification, via webhook |
| Imputation des temps par opération (extension) | Relevés de temps et déclarations des opérateurs | SkyPlanner → Sage 200 | À chaque déclaration ou par équipe |
| Données de contraintes SkyPlanner | Matrice des temps de réglage, outils à capacité limitée, machines et personnel de remplacement | Gérées dans SkyPlanner | Lors de la mise en place |
Schémas d’intégration
1. Chargement initial des données de base. Récupérez les produits et les unités depuis l’API, puis les ressources, les groupes de ressources et les opérations de nomenclature depuis l’extension. Un groupe de ressources composé de trois machines identiques peut être représenté par un groupe de postes de travail ou par trois postes de travail.
2. Synchronisation des ordres. Lisez les ordres de fabrication ouverts et leurs opérations depuis l’extension, ainsi que les pop_order_lines ouvertes et les warehouse_holdings depuis l’API. L’ordonnancement tient compte à la fois du stock et des approvisionnements attendus. Le MRP continue de proposer des ordres de fabrication dans Sage 200, et SkyPlanner ordonnance ceux que vous créez.
3. Réécriture du planning. Pour chaque opération placée ou déplacée par le moteur, SkyPlanner renvoie le début, la fin et la ressource planifiés vers l’ordre de fabrication. L’extension conserve ses propres quantités, affectations de stock et calculs de coûts.
4. Déclarations en atelier. Les opérateurs enregistrent leur travail avec SkyPlanner Mobile Confirmations ou Production Timer. Ces relevés de temps maintiennent le planning à jour. Les temps enregistrés sont renvoyés et imputés à l’opération de l’ordre de fabrication : le calcul des coûts dans Sage 200 tient ainsi compte des heures réelles.
Si votre usine enregistre déjà les temps dans Sicon Shop Floor Data Capture ou Cim200 Shop Floor Data Capture, choisissez un seul canal de saisie.
5. Responsabilité des données et règles de gestion des conflits. Consignez-les avant la mise en production :
| Données | Système responsable |
|---|---|
| Produits, nomenclatures, quantités des ordres de fabrication, affectations, coûts | Sage 200 et le module complémentaire |
| Séquence des opérations, heures de début et de fin, affectation aux postes de travail | SkyPlanner |
| Matrice des temps de préparation, besoins en outils et en opérateurs, ressources alternatives | SkyPlanner |
| Enregistrement des temps | Sage 200, alimenté par les relevés de temps de SkyPlanner |
Le graphique de capacité est la principale source de conflits. Si les planificateurs continuent à déplacer les ordres de fabrication ou les opérations dans Sicon Rough Cut Capacity Planning ou Cim200 Graphical Scheduler, deux systèmes pilotent les dates. Confiez à SkyPlanner la gestion des dates des opérations. Avec Autopilot, SkyPlanner recalcule automatiquement l’ordonnancement lorsque la production évolue.
Les étapes habituelles du projet
La mise en œuvre est généralement achevée en quelques semaines après le début de l’accompagnement. Avant cela, validez l’ordonnancement pendant l’essai gratuit de 30 jours, à partir d’un export CSV ou Excel de vos ordres de fabrication en cours. Le projet se déroule ensuite comme suit :
- Cadrage. Confirmez le module complémentaire et sa version, les moyens de lecture des ordres de fabrication et de réécriture des données, les fréquences de synchronisation et le canal d’enregistrement des temps.
- Accès à l’API. Le prestataire chargé du support active l’API de Sage 200, associe un Sage ID à un utilisateur Sage 200 et définit les droits d’accès aux sociétés et aux fonctionnalités.
- Chargement initial. Produits, unités, ressources, groupes de ressources, opérations des nomenclatures et disponibilités.
- Synchronisation des ordres et commandes. Récupération des ordres de fabrication, des lignes de commandes fournisseurs et des stocks par interrogation périodique, avec une alerte de renouvellement du consentement.
- Paramétrage des contraintes dans SkyPlanner. Matrice des temps de préparation, outils, nombre d’opérateurs par opération et machines ou personnel de remplacement.
- Réécriture de l’ordonnancement. Report des dates planifiées des opérations dans les ordres de fabrication ; l’enregistrement des temps est ajouté à cette étape.
- Tests en parallèle et mise en production. Comparez les dates au planning actuel, corrigez les données de base, puis activez la réécriture.
Les points à anticiper pour une intégration Sage 200
- Module abandonné dans une nouvelle version. L’ancien module Sage 200 Manufacturing n’est plus utilisable à partir de Sage 200 Professional 2025 R2. Avant de définir les correspondances de données, confirmez quelle solution de gestion de la production sera utilisée lors de la mise en production.
- Temps opératoires issus des données de coût. Sicon MRP estime les temps de main-d’œuvre et les temps machine à partir des éléments de coût des nomenclatures de Sage 200. Comparez-les d’abord aux temps d’exécution réels.
- Incohérences entre rubriques de coût. Sage précise que les champs Nominal, Overhead Nominal et Overhead Recovery % doivent correspondre entre les opérations des nomenclatures et les rubriques de coût, sinon « there will be cost discrepancies. » (il y aura des écarts de coût).
- Délai de renouvellement. Le délai maximal de 90 jours court à compter de la première connexion. Si le consentement n’est jamais renouvelé, l’intégration s’arrête le même jour chaque trimestre.
- Sites multisociétés. Un site peut héberger plusieurs sociétés : envoyez donc la bonne valeur
X-Companydans chaque requête.
Intégration Sage 200 : qui assure le paramétrage et le support ?
- L’équipe SkyPlanner la paramètre pendant l’accompagnement initial et en assure le support après la mise en production.
- Votre partenaire Sage 200 peut participer. Il connaît votre module complémentaire et active l’API sur Sage 200 Professional.
- Vos propres développeurs peuvent l’enrichir en utilisant la même REST API documentée avec un jeton d’API. Un jeton d’API suffit pour démarrer, et l’équipe SkyPlanner vous aide si nécessaire.
Une fois la connexion établie, le moteur Arcturus calcule l’ordonnancement à partir des ordres de fabrication à jour de Sage 200, puis reporte les dates planifiées sur leurs opérations. SkyPlanner est proposé à partir de 199 € par mois, avec 5 postes de travail inclus et une facturation mensuelle. L’intégration fait l’objet d’un devis préalable, adapté à vos processus et à vos besoins et présenté avec votre abonnement : vous connaissez ainsi le coût total avant de commencer. Consultez les tarifs et les fonctionnalités, puis comparez les possibilités de planification natives de Sage 200 dans notre page sur l’ordonnancement de production avec Sage 200. Vous trouverez une vue d’ensemble sur la page Sage 200 et les autres ERP dans notre rubrique des intégrations ERP.
Les industriels témoignent sur SkyPlanner
2 hgagnées chaque semaine
« Avec SkyPlanner, nous sommes passés d’une planification de la production sur des feuilles Excel à une optimisation de la production en temps réel. »
Kalle Kalliomäki, spécialiste de la chaîne logistique
UTU · Tableaux et appareillages électriques
La planification de la production permet de gagner 2 heures de travail chaque semaine, et une nouvelle file d’opérations est transmise à la ligne en quelques secondes.
1 000 et plusordres de fabrication ordonnancés automatiquement
« Nous maîtrisons la production autrement, et notre compréhension des capacités a atteint un tout autre niveau. »
Hannu Ryynänen, directeur général
Mamec · Mélangeurs industriels, pompes et sous-traitance de haute technologie
Des milliers d’ordres de fabrication sont ordonnancés automatiquement, et toute l’entreprise dispose d’une vue de la production en temps réel.
FAQ
L’API de Sage 200 inclut-elle les ordres de fabrication ?
Non. L’API de Sage 200 Professional couvre notamment les produits, les stocks, les commandes clients et fournisseurs et les finances, mais ne propose aucune ressource pour les ordres de fabrication ou les opérations. Les ordres de fabrication proviennent de votre module complémentaire de production, tel que Sicon Works Order Processing ou Cim200, par le moyen convenu lors du cadrage.
Qui réalise l’intégration Sage 200 ?
L’équipe SkyPlanner paramètre l’intégration bidirectionnelle selon votre configuration Sage 200 pendant l’accompagnement initial, puis en assure le support après la mise en production. Votre partenaire Sage 200 active l’API et peut participer au projet. Vos propres développeurs peuvent aussi réaliser des développements à partir de la REST API documentée de SkyPlanner ; un jeton d’API suffit pour démarrer.
Sage 200 peut-il transmettre les modifications en temps réel ?
L’API de Sage 200 ne dispose pas de webhooks. Les stocks et les commandes fournisseurs sont récupérés par interrogation périodique sur date_time_updated, et les ordres de fabrication sont lus dans votre module complémentaire à quelques minutes d’intervalle. Dans l’autre sens, les webhooks de SkyPlanner transmettent les modifications de l’ordonnancement dès qu’elles se produisent.
Peut-on tester SkyPlanner avant de réaliser l’intégration ?
Oui. L’essai gratuit de 30 jours permet d’utiliser jusqu’à 20 postes de travail et d’importer vos ordres de fabrication au format CSV ou Excel, sans carte bancaire. Démarrez l’essai ou contactez notre équipe commerciale pour cadrer l’intégration.
