Intégrations / ERP / MRPeasy
Guide d’intégration de MRPeasy pour l’ordonnancement de la production avec SkyPlanner APS
Ce guide d’intégration de MRPeasy explique aux consultants et aux équipes informatiques comment relier MRPeasy à SkyPlanner APS. L’intégration entre SkyPlanner et MRPeasy fonctionne dans les deux sens via la REST API de MRPeasy :
- Les ordres de fabrication, gammes de fabrication, nomenclatures, groupes de postes de travail, postes de travail, articles, stocks et commandes fournisseurs sont importés dans SkyPlanner.
- Les dates planifiées et l’avancement sont renvoyés vers chaque ordre de fabrication.
- Les webhooks de SkyPlanner transmettent les modifications du planning dès qu’elles surviennent.
SkyPlanner a déjà été intégré à MRPeasy dans le cadre de projets clients. Lors de la mise en place, l’équipe SkyPlanner adapte l’intégration à votre configuration MRPeasy, puis en assure le support après la mise en service. Ce guide s’adresse aux consultants et aux développeurs qui souhaitent y participer ou développer eux-mêmes une intégration à partir de la REST API documentée de SkyPlanner (référence de l’API).
La REST API de MRPeasy : v1 et v2
MRPeasy est un produit cloud unique, sans version installée sur site. Tous les clients utilisent donc la même API. Il en existe deux versions :
- REST API v1 (OpenAPI 1.0, serveur
https://api.mrpeasy.com/rest/v1) est l’API utilisée en production. Elle couvre/items,/boms,/routings,/manufacturing-orders,/work-centers,/work-center-types,/customer-orders,/purchase-orders,/stock/inventory,/lots,/unitset les rapports de production tels que/report/production/operations. - REST API v2 (OpenAPI 2.0.0, serveur
https://api.mrpeasy.com/rest/v2) en est au début de son développement. Elle ajoute/workstation-groupsavecwork_hoursetholidays,/workstationsavecproductivityetidle,/inventory,/stock-movementet PATCH. Les ordres de fabrication restent sur la v1.
Attention aux dénominations. Dans l’interface MRPeasy, un Workstation group correspond à work-center-types dans la v1 (type_id). Un Workstation correspond à work-centers (center_id). Les opérations d’une gamme de fabrication sont rattachées à un groupe via type_id, et non à une machine.
L’API est incluse dans l’offre Unlimited de MRPeasy, pour les comptes payants. MRPeasy précise également : « Our Support Department cannot help you using the API. » (Notre service d’assistance ne peut pas vous aider à utiliser l’API.) Il faut donc désigner un responsable de l’intégration : SkyPlanner, votre consultant MRPeasy ou votre développeur. C’est précisément ce travail que l’équipe SkyPlanner prend en charge lors de la mise en place.
Authentification et limites
MRPeasy utilise l’authentification HTTP Basic : Authorization: Basic base64(api-key:api-secret). La clé et le secret sont créés dans Settings → Integration → API access. Supprimer la clé désactive l’API.
Ces limites déterminent la conception de la synchronisation :
- Une seule requête à la fois par client : les requêtes sont traitées séquentiellement.
- Au maximum 100 requêtes par tranche de 10 secondes. Au-delà, l’API renvoie le code 429.
- Les listes renvoient 100 enregistrements par défaut, et jusqu’à 1 000 avec l’en-tête
Range. L’en-têteContent-Rangede la réponse indique le total.
Côté SkyPlanner, l’authentification à la REST API se fait avec un jeton API (SkyPlanner Settings > API). L’API est documentée dans Swagger/OpenAPI. Le tutoriel d’intégration vous guide dans vos premiers appels.
Événements et interrogation périodique
La page des tarifs de MRPeasy mentionne « API, webhooks (for paid accounts) » (API et webhooks pour les comptes payants), mais les spécifications v1 et v2 ne documentent aucun événement webhook pour les ordres de fabrication. L’intégration interroge donc MRPeasy de façon incrémentale :
- Les ordres de fabrication sont filtrés selon les statuts Not scheduled (15), Scheduled (20), In progress (30) et Paused (35).
- Les commandes fournisseurs et les stocks sont récupérés à intervalles définis ou avant chaque calcul du planning.
- Les données de base sont récupérées à chaque modification ou chaque nuit.
Une interrogation séquentielle avec filtrage reste largement en deçà de la limite de 100 requêtes par tranche de 10 secondes. Dans l’autre sens, les webhooks de SkyPlanner transmettent les modifications du planning dès qu’elles surviennent. Le renvoi des données vers MRPeasy est donc déclenché par les événements.
Correspondance des données
| Objet MRPeasy (point de terminaison) | Objet SkyPlanner | Sens | Fréquence |
|---|---|---|---|
Item, Unit of measurement (/items, /units) | Produits et matières | MRPeasy → SkyPlanner | Chargement initial, puis chaque nuit |
BOM avec ses composants (/boms) | Structure du produit, sous-produits, matières par produit | MRPeasy → SkyPlanner | Chargement initial, puis à chaque modification |
Opérations de la gamme de fabrication (/routings) : type_id, fixed_time, variable_time, variable_quantity | Étapes de fabrication avec durées, temps de réglage et taille de lot | MRPeasy → SkyPlanner | Chargement initial, puis à chaque modification |
Workstation group (/work-center-types ; v2 /workstation-groups) | Groupes de postes de travail, horaires d’équipe | MRPeasy → SkyPlanner | Chargement initial, rarement ensuite |
Workstation (/work-centers ; v2 /workstations : productivity, idle) | Postes de travail, rendements, absences | MRPeasy → SkyPlanner | Chargement initial, puis chaque jour pour les périodes d’inactivité |
Manufacturing Order avec opérations, due_date (/manufacturing-orders) | Ordres et opérations | MRPeasy → SkyPlanner | Interrogation toutes les quelques minutes |
Inventory, Stock lots (/stock/inventory, /lots) | Quantités en stock | MRPeasy → SkyPlanner | Chaque heure ou à chaque calcul du planning |
Purchase Order (/purchase-orders) | Matières attendues avec date de livraison prévue | MRPeasy → SkyPlanner | Chaque heure ou à chaque calcul du planning |
Champs due_date et custom_<id> de Manufacturing Order (PUT /manufacturing-orders/{id}) | Début planifié, fin planifiée, avancement | SkyPlanner → MRPeasy | À chaque modification du planning, via un webhook SkyPlanner |
| Absent de MRPeasy | Matrice des temps de changement, outillages gérés comme ressources à capacité finie, nombres d’opérateurs, postes de travail alternatifs | Gérés dans SkyPlanner | Configurés lors de la mise en place |
Schémas d’intégration
1. Chargement initial des données de base. Récupérez les articles, unités, nomenclatures et gammes de fabrication depuis la v1, ainsi que les groupes de postes de travail et les postes de travail depuis la v1 ou la v2. Récupérez les calendriers via /workstation-groups en v2 (work_hours, holidays) ou définissez les horaires d’équipe directement dans SkyPlanner. Associez chaque groupe Active processing à un groupe de postes de travail SkyPlanner, en y rattachant ses postes de travail.
2. Synchronisation des ordres et commandes. Récupérez les ordres de fabrication ouverts avec leurs opérations, ainsi que les commandes fournisseurs ouvertes et les stocks. SkyPlanner considère les matières commandées comme disponibles à la date de livraison de la commande fournisseur et met le stock à jour lorsque celle-ci passe au statut Delivered. À chaque recalcul du planning, les stocks et les achats attendus sont vérifiés.
3. Renvoi du planning vers MRPeasy. PUT /manufacturing-orders/{id} prend en charge code, quantity, due_date et assigned_id, ainsi que les champs personnalisés sous la forme custom_<id>. Lorsque cela a été convenu, SkyPlanner inscrit la fin planifiée dans due_date. Le début planifié, la fin planifiée et l’avancement sont inscrits dans les champs personnalisés de MRPeasy. Les services commerciaux et achats disposent ainsi du planning réel dans MRPeasy. L’enchaînement détaillé des opérations et le poste affecté à chacune restent dans SkyPlanner, qui sert de vue de pilotage pour l’atelier.
4. Ordres créés en dehors de MRPeasy. Si des ordres sont créés via l’API, POST /manufacturing-orders accepte no_scheduling et no_bookings. Utilisez ces paramètres pour que MRPeasy ne réserve pas les postes de travail déjà ordonnancés par SkyPlanner.
5. Déclarations en atelier. Les opérateurs enregistrent leur travail avec SkyPlanner Mobile Confirmations, Production Timer ou Quick Log Mode. Les relevés de temps maintiennent le planning à jour. Choisissez un seul canal de déclaration. Utiliser en parallèle Internet-kiosk de MRPeasy et SkyPlanner pour les mêmes opérations crée deux versions de la réalité.
6. Responsabilités et règles de gestion des conflits. Consignez-les avant la mise en service :
| Données | Système responsable |
|---|---|
| Articles, nomenclatures, gammes de fabrication, quantités, stocks, approvisionnements | MRPeasy |
| Enchaînement des opérations, heures de début et de fin, affectation aux postes de travail | SkyPlanner |
| Matrice des temps de changement, outillages, nombres d’opérateurs, ressources alternatives | SkyPlanner |
| Horaires d’équipe et absences | Un seul système, choisi lors du cadrage |
| Avancement des ordres et travail enregistré | SkyPlanner, avec une synthèse sur l’ordre de fabrication |
Flux de conception à la commande. Dans un projet MRPeasy livré, chaque projet client est représenté par un produit principal et un à trois produits semi-finis. Chacun possède sa propre nomenclature et sa propre gamme de fabrication dans MRPeasy, et l’ordre de fabrication existe dans les deux systèmes. Conservez un identifiant commun stable pour chaque ordre afin que les mises à jour ne créent jamais de doublons.
Étapes habituelles du projet
La mise en œuvre est généralement achevée dans les semaines qui suivent le début de l’accompagnement. Avant cette étape, l’essai gratuit de 30 jours vous permet de travailler avec vos propres données, quelle que soit votre formule MRPeasy. Depuis les vues en liste de MRPeasy, exportez au format CSV les articles, nomenclatures, gammes de fabrication, postes de travail et ordres de fabrication ouverts, puis importez-les et validez le planning.
Le projet comprend les étapes suivantes :
- Vérification de la formule. Vérifiez que votre formule MRPeasy inclut l’API, puis créez la clé API et le secret.
- Correspondance des données. Définissez la table de correspondance, les règles de responsabilité sur les données, les champs personnalisés à mettre à jour en retour et le canal de déclaration.
- Chargement initial. Articles, unités, nomenclatures, gammes de fabrication, groupes de postes de travail, postes de travail et calendriers.
- Synchronisation des ordres de fabrication et des commandes fournisseurs. Interrogation périodique incrémentale par statut, avec gestion des réponses 429.
- Paramétrage des contraintes dans SkyPlanner. Matrice des temps de changement, outillages, nombre d’opérateurs et postes de travail de remplacement.
- Écriture en retour. Dates d’échéance et champs personnalisés de chaque Manufacturing Order.
- Tests en parallèle. Utilisez SkyPlanner en parallèle du planning de production actuel, comparez les dates et corrigez les données de base.
- Mise en service. Activez l’écriture en retour une fois les données concordantes.
Les points à prévoir pour une intégration MRPeasy
- Les champs de temps diffèrent selon l’interface. Les champs Setup time, Cycle time et Capacity de l’interface utilisateur correspondent respectivement à
fixed_time,variable_timeetvariable_quantitydans l’API. Une capacité supérieure à 1 indique un traitement par lot, comme dans un four. Représentez-le par une opération par lot, et non par un cycle plus long. - Groupes Passive processing. Les groupes de séchage et de refroidissement fonctionnent 24/7 sans limite de capacité. Représentez-les par des temps d’attente, et non par des postes de travail à capacité limitée.
- Les calendriers sont absents de la v1.
work-centersrenvoie uniquementcenter_id,type_id,codeettitle. Utilisez la v2 ou gérez les horaires d’équipe dans SkyPlanner. - Temps d’arrêt. Les temps d’arrêt des postes de travail regroupent les périodes de maintenance et d’indisponibilité. Synchronisez-les, sinon SkyPlanner planifiera du travail sur une machine à l’arrêt.
- Les gammes de fabrication renvoient à des groupes. MRPeasy sélectionne la machine qui offre la meilleure disponibilité. Dans SkyPlanner, les postes de travail du groupe deviennent des alternatives réelles entre lesquelles le moteur choisit.
Intégration MRPeasy : qui assure le paramétrage et le support ?
Le travail consiste à établir les correspondances pour vos gammes de fabrication, vos groupes de postes de travail et votre flux de commandes, ainsi qu’à définir les contraintes absentes de MRPeasy : matrice des temps de réglage, outils, nombre d’opérateurs et ressources de remplacement.
- L’équipe SkyPlanner assure le paramétrage pendant l’accompagnement initial, puis le support après la mise en service. Chaque usine utilise MRPeasy à sa manière : ce savoir-faire est pris en compte à cette étape. Le support MRPeasy ne couvrant pas les travaux liés à l’API, il est important qu’une seule équipe soit responsable de l’intégration.
- Votre consultant MRPeasy ou votre partenaire d’intégration peut la réaliser. Dans le cadre d’un projet MRPeasy déjà livré, un partenaire d’intégration a relié les deux systèmes via leurs REST API respectives. SkyPlanner fournit la REST API, la documentation Swagger/OpenAPI et les webhooks.
- Vos propres développeurs peuvent s’appuyer sur cette API avec un jeton API. Ce jeton suffit pour commencer, et l’équipe SkyPlanner vous aide si nécessaire. La documentation produit, qui couvre notamment les commandes d’achat et l’API des produits et des matières, est disponible dans la documentation SkyPlanner.
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, en complément de votre formule. Vous connaissez ainsi le coût total avant de commencer. Consultez les tarifs, les fonctionnalités et la comparaison avec l’outil d’ordonnancement de MRPeasy dans la page Ordonnancement à capacité finie avec MRPeasy. La page MRPeasy présente une vue d’ensemble ; les autres ERP figurent dans la rubrique des intégrations ERP.
Les industriels donnent leur avis sur SkyPlanner
2 hgagnées chaque semaine
« Grâce à SkyPlanner, notre planification de la production est passée des feuilles Excel à l’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.
+90 %d’efficacité en production
« L’efficacité en production a augmenté de 90 %. »
Abdul Rucyinga, responsable informatique
Laboratory & Allied · Fabrication pharmaceutique
L’efficacité en production a augmenté de 90 %, et il faut moins de 30 minutes pour établir un planning optimisé sur trois mois couvrant tous les postes de travail.
6 moisde visibilité sur la capacité disponible pour les commerciaux
« SkyPlanner fournit une base fiable pour l’ensemble de la planification de la production. »
Anu Järvinen, responsable de production
Fredman Operations · Papiers d’emballage aptes au contact alimentaire
Les commerciaux connaissent la capacité disponible six mois à l’avance, et les demandes de modification du planning obtiennent une réponse en quelques secondes, contre une heure ou plus auparavant.
FAQ
MRPeasy dispose-t-il d’une API, et quelle formule faut-il choisir ?
Oui. MRPeasy propose une REST API, dont la v1 est en production et la v2 en développement, aux comptes payants disposant de la formule Unlimited. L’authentification utilise HTTP Basic avec une clé API et un secret accessibles dans Settings → Integration → API access.
SkyPlanner peut-il renvoyer le planning dans MRPeasy ?
Oui. SkyPlanner met à jour chaque Manufacturing Order via PUT /manufacturing-orders/{id}, en renseignant la date d’échéance et les champs personnalisés de début prévu, de fin prévue et d’avancement. L’ordonnancement détaillé des opérations reste dans SkyPlanner, où les opérateurs travaillent à partir de leur propre file d’opérations.
MRPeasy transmet-il les modifications en temps réel ?
Les spécifications de l’API ne documentent aucun événement webhook pour les ordres de fabrication. SkyPlanner interroge donc les ordres ouverts par statut à intervalles de quelques minutes. Les webhooks de SkyPlanner transmettent les modifications du planning dès qu’elles surviennent.
Qui réalise l’intégration MRPeasy ?
L’équipe SkyPlanner configure l’intégration bidirectionnelle pendant l’accompagnement initial et en assure le support après la mise en service. Votre consultant MRPeasy, un partenaire d’intégration ou vos développeurs peuvent également la réaliser en s’appuyant sur la REST API documentée de SkyPlanner.
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 avec des imports CSV depuis MRPeasy, quelle que soit votre formule MRPeasy, sans carte bancaire. Démarrez l’essai ou contactez l’équipe commerciale pour cadrer l’intégration.
