Intégrations / ERP / Exact
Guide d’intégration d’Exact Online pour l’ordonnancement de la production avec SkyPlanner APS
Ce guide d’intégration d’Exact Online explique aux partenaires Exact et aux équipes informatiques comment connecter Exact Online Manufacturing à SkyPlanner APS. L’intégration entre SkyPlanner et Exact Online fonctionne dans les deux sens :
- Les ordres de fabrication, les étapes des gammes, les besoins en matières, les postes de charge, les opérations et les nomenclatures sont importés via la REST API d’Exact Online.
- Les articles, les niveaux de stock, les commandes fournisseurs et les commandes clients sont importés. Les modifications sont transmises par les webhooks d’Exact Online.
- Les dates de début et de fin planifiées sont renvoyées vers chaque étape de gamme et vers l’ordre de fabrication.
- Les temps saisis par les opérateurs sont enregistrés sous forme d’écritures de temps, et les quantités terminées sous forme de réceptions d’ordres de fabrication.
L’équipe SkyPlanner configure l’intégration en fonction de votre environnement Exact Online lors de la mise en place et 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 une solution à partir de la REST API documentée de SkyPlanner (référence de l’API). Une courte section consacrée à Exact Globe+ figure à la fin.
La REST API d’Exact Online pour la fabrication
Exact Online donne accès à ses données via une REST API unique, dont les ressources sont regroupées par service. Le chemin de base est /api/v1/{division}/<service>/<resource>, où la division correspond à la société dans Exact Online. La référence de la REST API répertorie les ressources suivantes du service manufacturing pour l’ordonnancement :
| Ressource | Données disponibles | Méthodes |
|---|---|---|
manufacturing/ShopOrders | Numéro d’ordre de fabrication, article, PlannedQuantity, PlannedStartDate, PlannedDate, statut, indicateur de lancement | GET, POST, PUT, DELETE |
manufacturing/ShopOrderRoutingStepPlans | Étape de gamme par ordre de fabrication : opération, Workcenter, LineNumber, PlannedStartDate, PlannedEndDate, PlannedSetupHours, PlannedRunHours | GET, POST, PUT, DELETE |
manufacturing/ShopOrderMaterialPlans | Lignes de matières par ordre de fabrication | GET, POST, PUT, DELETE |
manufacturing/Workcenters | Code, type, zone de production, capacité, tarifs | GET, POST, PUT, DELETE |
manufacturing/Operations, OperationResources | Opérations et poste de charge associé à chacune, temps de réglage et d’exécution | GET, POST, PUT, DELETE |
manufacturing/BillOfMaterialVersions, BillOfMaterialMaterials, BillOfMaterialRoutings | Versions de nomenclature, composants et gamme de fabrication | GET, POST, PUT, DELETE |
manufacturing/TimeTransactions | Heures imputées par ordre de fabrication et étape de gamme | GET, POST, PUT, DELETE |
manufacturing/ShopOrderReceipts | Quantités terminées réceptionnées pour un ordre de fabrication | GET, POST |
manufacturing/MaterialIssues | Matières sorties pour un ordre de fabrication | GET, POST |
manufacturing/ShopOrderPriorities | Mode de priorité par ordre de fabrication | GET, PUT |
Ressources des autres services :
| Ressource | Données disponibles |
|---|---|
logistics/Items | Données de base des articles |
inventory/ItemWarehouses | Stock par article et entrepôt |
purchaseorder/PurchaseOrders, PurchaseOrderLines | Commandes fournisseurs en cours et dates de réception |
salesorder/SalesOrders, SalesOrderLines | Demande client et dates de livraison |
Authentification et accès
Exact Online utilise OAuth 2.0 avec le flux d’autorisation par code et des jetons de renouvellement. Exact précise : « Before you can start integration with Exact Online, you must first register your app in the App Store. » (Avant de commencer l’intégration avec Exact Online, vous devez enregistrer votre application dans l’App Store.) (Aide Exact Online) L’enregistrement d’applications nécessite un abonnement Exact Online Developer (Exact App Store).
- L’intégration est enregistrée en tant qu’application avec une URI de redirection.
- Un utilisateur Exact Online disposant des droits d’accès à la fabrication, aux stocks et aux achats donne son consentement une seule fois.
- Chaque requête envoie
Authorization: Bearer <access_token>et inclut la division dans le chemin. - Les jetons d’accès sont renouvelés à l’aide du jeton de renouvellement. Exact limite la fréquence des demandes de nouveaux jetons : conservez donc le jeton en cache jusqu’à son expiration.
Exact limite également le nombre d’appels par minute et par jour pour chaque application et chaque société, et demande d’effectuer les appels de façon séquentielle plutôt qu’en parallèle. Les limites en vigueur figurent dans l’article d’Exact sur les limites de l’API. L’intégration en tient compte : les lectures sont filtrées avec $filter et $select, et la Sync API est utilisée pour les modifications en masse.
Côté SkyPlanner, l’authentification à la REST API repose sur un jeton API transmis dans l’en-tête Authorization-Token (paramètres de SkyPlanner > API). Cette API est documentée dans Swagger/OpenAPI. Le tutoriel d’intégration vous guide dans vos premiers appels.
Webhooks et interrogation périodique
Les webhooks d’Exact Online envoient une requête POST à votre URL de rappel lorsqu’un sujet auquel vous êtes abonné est modifié. Cette requête est signée avec un hachage HMAC SHA256 (webhooks). Les sujets comprennent Items, StockPosition, PurchaseOrders, PurchaseOrderLines, SalesOrders et SalesOrderLines. Ils transmettent à SkyPlanner les changements de stock, d’achats et de demande dès qu’ils surviennent.
Les ordres de fabrication et les étapes de gamme sont lus à intervalles réguliers. Filtrez ShopOrders et ShopOrderRoutingStepPlans sur Modified et utilisez la Sync API pour les lectures en masse (restrictions de l’API).
SkyPlanner envoie ses propres webhooks lorsque le planning change. Le renvoi des données vers Exact Online est donc déclenché par ces événements.
Correspondance des données
| Ressource Exact Online | Objet SkyPlanner | Sens du transfert | Fréquence |
|---|---|---|---|
Items | Produits et matières | Exact Online → SkyPlanner | Chargement, puis webhook |
BillOfMaterialVersions, BillOfMaterialMaterials | Structure du produit, sous-ensembles, matières par produit | Exact Online → SkyPlanner | À chaque modification |
Workcenters, OperationResources | Postes de travail, groupes de postes de travail | Exact Online → SkyPlanner | Chargement initial |
Operations, BillOfMaterialRoutings | Étapes de fabrication avec temps de réglage et d’exécution | Exact Online → SkyPlanner | À chaque modification |
ShopOrders | Ordres avec quantité et date d’échéance | Exact Online → SkyPlanner | À quelques minutes d’intervalle |
ShopOrderRoutingStepPlans | Opérations avec ordre d’exécution, poste de charge et heures de réglage et d’exécution | Exact Online → SkyPlanner | À quelques minutes d’intervalle |
ShopOrderMaterialPlans | Matières par opération | Exact Online → SkyPlanner | À quelques minutes d’intervalle |
ItemWarehouses, StockPosition | Quantités en stock | Exact Online → SkyPlanner | Webhook |
PurchaseOrderLines | Commandes d’achat avec date de livraison prévue | Exact Online → SkyPlanner | Webhook |
SalesOrderLines | Dates de livraison client et priorité | Exact Online → SkyPlanner | Webhook |
ShopOrderRoutingStepPlans : PlannedStartDate, PlannedEndDate, Workcenter (PUT) | Début, fin et poste de travail prévus pour chaque opération | SkyPlanner → Exact Online | À chaque modification, par webhook |
ShopOrders : PlannedStartDate, PlannedDate (PUT) | Début et fin de l’ordre de fabrication | SkyPlanner → Exact Online | À chaque modification, par webhook |
TimeTransactions (POST) | Relevés de temps et déclarations des opérateurs | SkyPlanner → Exact Online | À chaque déclaration ou par équipe |
ShopOrderReceipts (POST) | Quantité terminée à la dernière opération | SkyPlanner → Exact Online | À chaque déclaration |
| Non stocké dans Exact Online | Matrice des temps de réglage, outils gérés comme ressources à capacité finie, opérateurs par opération, postes de travail de remplacement, horaires d’équipe | Géré dans SkyPlanner | Mise en route |
Schémas d’intégration
1. Chargement initial des données de base. Lisez Workcenters, Operations et OperationResources, puis les articles et les versions de nomenclature avec leurs gammes de fabrication. Un poste de charge comportant trois machines devient trois postes de travail ou un groupe de postes de travail. Les horaires d’équipe, les absences et les heures supplémentaires se paramètrent dans SkyPlanner, car le poste de charge d’Exact ne contient qu’une seule valeur de capacité.
2. Synchronisation des ordres. Lisez les ShopOrders ouverts avec leurs ShopOrderRoutingStepPlans et ShopOrderMaterialPlans, ainsi que les stocks et les lignes de commandes d’achat. L’ordonnancement vérifie à la fois les stocks et les achats attendus. Le MRP continue de proposer des ordres dans Exact Online, et SkyPlanner ordonnance les ordres de fabrication que vous créez.
3. Renvoi du planning. Pour chaque opération de gamme placée ou déplacée par le moteur, SkyPlanner envoie une requête PUT à ShopOrderRoutingStepPlans avec PlannedStartDate, PlannedEndDate et Workcenter. Les champs PlannedStartDate et PlannedDate de l’ordre de fabrication suivent les dates de la première et de la dernière opération. Exact Online conserve la gestion des quantités, des besoins en matières et du calcul des coûts.
4. Déclarations en atelier. Les opérateurs déclarent leur travail avec SkyPlanner Mobile Confirmations ou Production Timer, et les relevés de temps maintiennent le planning à jour. Les heures saisies sont enregistrées sous forme de TimeTransactions sur l’ordre de fabrication et l’opération de gamme, en réglage ou en exécution. La déclaration finale crée un enregistrement ShopOrderReceipts pour la quantité terminée. Si votre usine saisit déjà les temps dans Shop Floor Control, retenez un seul canal de saisie.
5. Responsabilité des données et règles de gestion des conflits. Consignez ces règles avant la mise en production :
| Données | Système responsable |
|---|---|
| Articles, nomenclatures, quantités des ordres de fabrication, besoins en matières, coûts | Exact Online |
| Séquence des opérations de gamme, heures de début et de fin, affectation aux postes de charge | SkyPlanner |
| Matrice des temps de réglage, outils, opérateurs par opération, ressources de remplacement, horaires d’équipe | SkyPlanner |
| Écritures de temps et réceptions de production | Exact Online, alimenté par SkyPlanner |
Les modifications manuelles des dates sont la principale source de conflits. Si les planificateurs continuent de modifier les dates des ordres de fabrication dans Exact Online, deux systèmes gèrent les mêmes dates. Confiez à SkyPlanner la gestion des dates des opérations de gamme. Avec Autopilot, SkyPlanner recalcule automatiquement le planning lorsque la production évolue.
Étapes types du projet
La mise en œuvre est normalement achevée en quelques semaines après le début de la mise en route. Au préalable, validez le planning pendant l’essai gratuit de 30 jours à partir d’un export CSV ou Excel des ordres de fabrication ouverts et de leurs opérations de gamme. Le projet suit ensuite les étapes suivantes :
- Cadrage. Confirmez l’édition, les divisions, les fréquences de synchronisation, le canal de saisie des temps et l’enregistrement des réceptions de production.
- Application et consentement. Enregistrez l’application ; un utilisateur d’Exact Online accorde ensuite le consentement OAuth pour chaque division.
- Chargement initial. Postes de charge, opérations, articles, versions de nomenclature et gammes de fabrication.
- Synchronisation des ordres. Synchronisez les ordres de fabrication, les plans des opérations de gamme et les besoins en matières à intervalles réguliers, et les stocks et achats par webhook.
- Paramétrage des contraintes dans SkyPlanner. Horaires d’équipe, matrice des temps de réglage, outils, nombre d’opérateurs par opération et machines ou personnel de remplacement.
- Renvoi du planning. Envoyez à Exact Online les dates prévues des opérations de gamme, puis les écritures de temps et les réceptions de production.
- Tests en parallèle et mise en production. Comparez les dates au planning actuel, corrigez les données de base, puis activez le renvoi des données.
Les points à prévoir pour une intégration avec Exact Online
- Durée des opérations de gamme.
PlannedSetupHoursetPlannedRunHoursproviennent de la gamme de fabrication associée à la nomenclature. Comparez-les d’abord aux durées réelles. - Regroupement des postes de charge. Exact stocke une seule valeur de capacité par poste de charge. Décidez pour chacun s’il doit devenir un poste de travail, plusieurs postes ou un groupe.
- Calendriers. Les horaires d’équipe, les jours fériés et les absences sont gérés dans SkyPlanner. Paramétrez-les avant le premier ordonnancement.
- Quota d’appels. Exact limite les appels par application et par société et exige des appels séquentiels. Utilisez les webhooks lorsque les sujets correspondants existent,
$filtersurModifiedet Sync API pour les lectures en masse. - Divisions multiples. Chaque division d’Exact Online correspond à une société, avec son propre chemin d’accès et son propre consentement. Associez chaque usine à sa division.
- Ordres de fabrication lancés. Convenez des statuts pour lesquels SkyPlanner peut modifier les dates : ordres ouverts et lancés, ou uniquement ordres ouverts.
- Un seul système responsable des dates. Cessez de modifier manuellement les dates dans Exact Online dès que SkyPlanner gère les dates des opérations de gamme.
Exact Globe+
Exact Globe+ est l’ERP d’Exact commercialisé et déployé par les partenaires Exact Globe+. Selon Exact, il « koppelt eenvoudig en snel met andere systemen » (se connecte facilement et rapidement à d’autres systèmes) (Exact Globe+). SkyPlanner ordonnance les ordres de fabrication d’Exact Globe+ selon le même principe : il reçoit les ordres de fabrication, les gammes, les ressources et les stocks, puis renvoie les dates prévues et les heures saisies. Votre partenaire Exact Globe+ et l’équipe SkyPlanner définissent l’interface et les objets à mettre à jour lors du cadrage.
Intégration avec Exact Online : qui assure le paramétrage et le support ?
- L’équipe SkyPlanner la paramètre pendant la mise en route et en assure le support après la mise en production.
- Votre partenaire Exact peut participer. Il connaît vos éditions, vos divisions et votre paramétrage de production.
- Vos développeurs peuvent étendre l’intégration en s’appuyant sur la REST API documentée de SkyPlanner. Un jeton API suffit pour démarrer, et l’équipe SkyPlanner vous accompagne si nécessaire.
Une fois la connexion établie, le moteur Arcturus ordonnance les ordres de fabrication d’Exact Online à partir des données en temps réel, et les dates prévues sont inscrites sur chaque opération de gamme. 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, présenté avec votre abonnement : vous connaissez ainsi le coût total avant de commencer. Consultez les tarifs, les fonctionnalités et la comparaison avec la planification native d’Exact Online dans notre page sur l’ordonnancement à capacité finie avec Exact Online. Vous trouverez une vue d’ensemble sur la page Exact Online et les autres ERP dans la rubrique des intégrations ERP.
Avis d’industriels sur SkyPlanner
Moins d’arrêtsdus aux ruptures de matières
« La valeur que SkyPlanner nous apporte, c’est un outil qui fonctionne au quotidien, notamment pour fixer les dates de livraison. »
Tommi Männistö, responsable de la planification de la production
Eskomatic · Usinage en sous-traitance
L’ordonnancement automatique de la charge permet de fixer des dates de livraison plus précises, et les arrêts de production dus aux ruptures de matières ont fortement diminué.
Des milliers (1 000 et plus)d’ordres de fabrication ordonnancés automatiquement
« Nous maîtrisons la production d’une tout autre façon, et notre compréhension de la capacité 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 en temps réel de la production.
FAQ
L’API d’Exact Online donne-t-elle accès aux ordres de fabrication et aux opérations des gammes ?
Oui. Le service de fabrication expose les ressources ShopOrders, ShopOrderRoutingStepPlans, ShopOrderMaterialPlans, Workcenters, Operations ainsi que les nomenclatures, toutes accessibles en lecture et en écriture. Les temps sont enregistrés via TimeTransactions et les quantités produites via ShopOrderReceipts.
Comment les dates planifiées sont-elles renvoyées dans Exact Online ?
Pour chaque opération qu’il place ou déplace, SkyPlanner envoie une requête PUT à ShopOrderRoutingStepPlans avec PlannedStartDate, PlannedEndDate et Workcenter. Les champs PlannedStartDate et PlannedDate de l’ordre de fabrication sont mis à jour en conséquence.
Qui met en place l’intégration avec Exact Online ?
Lors de la mise en place, l’équipe SkyPlanner configure l’intégration bidirectionnelle selon votre configuration Exact Online, puis en assure le support après la mise en production. Votre partenaire Exact peut y participer. Vos propres développeurs peuvent aussi s’appuyer sur la REST API documentée de SkyPlanner : un jeton API suffit pour commencer.
Exact Online peut-il transmettre les modifications en temps réel ?
Les webhooks d’Exact Online transmettent les modifications concernant les articles, les niveaux de stock, les commandes fournisseurs et les commandes clients. Les ordres de fabrication et les opérations des gammes sont lus à intervalles rapprochés au moyen de requêtes filtrées. Dans l’autre sens, les webhooks de SkyPlanner transmettent les modifications du planning dès qu’elles surviennent.
Peut-on tester SkyPlanner avant de mettre en place 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 l’équipe commerciale pour cadrer l’intégration.