Intégrations / ERP / Senior ERP
Guide d’intégration de Senior ERP pour l’ordonnancement de la production avec SkyPlanner APS
Ce guide d’intégration de Senior ERP explique aux partenaires et aux équipes informatiques comment connecter Senior ERP de Senior Sistemas (Gestão Empresarial | ERP XT avec Senior X) à SkyPlanner APS. SkyPlanner échange des données avec Senior ERP dans les deux sens, par les interfaces de Senior :
- SkyPlanner reçoit les ordres de fabrication (OP) avec leurs étapes, les gammes (roteiros), les ressources et centres de ressources, les SKU, les structures de produits, les stocks et les commandes d’achat.
- Les dates de début et de fin prévues pour chaque étape, ainsi que la ressource retenue, sont renvoyées vers l’OP.
- Si vous le souhaitez, les relevés de temps des opérateurs sont renvoyés sous forme de déclarations de production (apontamentos de produção).
- Senior X Events Hub informe SkyPlanner de tout changement de statut d’une étape d’OP. Les webhooks de SkyPlanner transmettent les modifications du planning au fur et à mesure.
Pendant la mise en route, l’équipe SkyPlanner configure l’intégration en fonction de votre installation Senior ERP, puis en assure le support après la mise en production. Ce guide s’adresse aux partenaires et aux développeurs qui souhaitent y participer ou développer eux-mêmes à partir de la REST API documentée de SkyPlanner (documentation de référence de l’API).
Les interfaces d’intégration de Senior ERP
ERP XT est un système hybride. Selon la documentation de Senior, Gestão Empresarial XT « becomes a hybrid system: an on-premises (local) system with integration of cloud solutions » (devient un système hybride : un système sur site intégrant des solutions cloud) (documentation Senior, traduite). Un outil d’ordonnancement utilise trois interfaces de Senior :
- Services web G5 (SOAP). Ces services sont hébergés sur votre serveur Senior et nommés par module (com.senior.g5.co.<module>…). Chacun est publié en trois variantes WSDL : sapiens_Sync, sapiens_Async et sapiens_Scheduled. Les services de production comprennent com.senior.g5.co.mpr.pcp.ordemproducao, qui « calls the same production order generation routine » (appelle la même routine de génération des ordres de fabrication) que l’écran de l’ERP (documentation Senior, traduite), ainsi que des services pour les produits (com.senior.g5.co.ger.cad.produto) et les déclarations de production.
- REST API de Senior X Platform, accessibles sur api.senior.com.br, pour les domaines ERP que Senior expose sur Senior X, comme les produits et les commandes clients (documentation Senior).
- Webhooks Events Hub. Ils se créent dans Senior X, sous Tecnologia > Customização > Events Hub > Webhooks. Manufacturing publie l’événement erp_man/pcp_programacaocontrole/orderProductionStageChangeStatus lorsqu’une étape d’OP change de statut (documentation Senior).
Authentification et accès
- Senior X Platform. L’intégration s’authentifie par une requête POST à platform.senior.com.br sur /t/senior.com.br/bridge/1.0/rest/platform/authentication/actions/Login, avec un identifiant au format user@tenant. La réponse contient un jeton d’accès Bearer et un jeton de renouvellement. L’authentification par clés d’application utilise loginWithKey (clé d’accès, secret, tenant). Les appels REST comportent l’en-tête authorization et un en-tête client_id qui identifie l’application connectée. Celle-ci est enregistrée dans le portail API de Senior et associée à un rôle dans l’ERP.
- Services web G5. Les appels transmettent les paramètres d’utilisateur, de mot de passe et de chiffrement. Avec un jeton Senior X, le jeton remplace le mot de passe (documentation Senior).
- Autorisations. Créez un utilisateur Senior dédié à l’intégration, avec les droits d’accès aux données de PCP, de bureau d’études, de stocks et d’achats qu’elle lit et écrit.
Côté SkyPlanner, la REST API utilise un jeton API dans l’en-tête Authorization-Token (SkyPlanner Settings > API) pour l’authentification. Elle est documentée dans Swagger/OpenAPI. Le tutoriel d’intégration vous guide dans vos premiers appels.
Événements et interrogation périodique
Events Hub couvre les événements de l’atelier : lorsqu’une étape d’OP change de statut, SkyPlanner reçoit le webhook et le planning se met à jour. Les autres données sont récupérées par interrogation périodique. Les lectures, filtrées sur les OP fermes et lancés et sur les modifications récentes, permettent de récupérer les nouveaux travaux. La fréquence est définie pour chaque usine : toutes les quelques minutes pour les OP, jusqu’à une fois par heure pour les stocks.
SkyPlanner envoie des webhooks lorsque l’état ou le planning change. Le renvoi des données est donc déclenché par des événements.
Correspondance des données
| Objet Senior ERP (interface) | Objet SkyPlanner | Sens | Fréquence |
|---|---|---|---|
| SKU : produto et derivação, unités de mesure (services web G5 ou entités Senior X) | Produits et matières | Senior → SkyPlanner | Chargement initial, puis interrogation périodique |
| Structure du produit (engenharia do SKU) | Structure des produits, sous-ensembles, matières par produit | Senior → SkyPlanner | Chargement initial, puis à chaque modification |
| Roteiro avec estágios : séquence, dépendance à l’étape précédente | Étapes du processus dans l’ordre | Senior → SkyPlanner | Chargement initial, puis à chaque modification |
| Recurso : Tempo processo, Tempo setup, Tempo carga e descarga, Tempo transferência, Fator de carga | Postes de travail, durées, temps de réglage et de démontage, rendements | Senior → SkyPlanner | Chargement initial, rarement ensuite |
| Centro de recurso | Groupes de postes de travail | Senior → SkyPlanner | Chargement initial, puis rarement |
| Calendário : Feriados, calendrier de production par équipe | Horaires des équipes et jours chômés | Senior → SkyPlanner | Chaque jour, ou horaires gérés directement dans SkyPlanner |
| Ordens de produção (Firme, Liberada) avec étapes et matières | Ordres et opérations avec échéances et besoins en matières | Senior → SkyPlanner | Interrogation toutes les quelques minutes |
| Statut des étapes d’OP (Events Hub orderProductionStageChangeStatus) | Avancement des opérations | Senior → SkyPlanner | En temps réel par webhook |
| Estoque par SKU | Quantités en stock | Senior → SkyPlanner | Interrogation chaque heure ou à chaque calcul du planning |
| Ordens de compra avec dates de livraison | Commandes d’achat, réceptions de matières par date de livraison | Senior → SkyPlanner | Interrogation toutes les heures ou à chaque calcul du planning |
| Étape d’OP : début et fin prévus, ressource | Début et fin prévus par opération, poste de travail affecté | SkyPlanner → Senior | À chaque modification du planning, par webhook SkyPlanner |
| Apontamento de produção : numOrp, codEtg, seqRot, qtdRel, qtdRfg, dates et heures de début et de fin | Relevés de temps et confirmations des opérateurs | SkyPlanner → Senior | À chaque confirmation ou par équipe, si cette option est retenue |
| Absent de Senior ERP | Matrice des temps de réglage, outils à capacité limitée, opérations à plusieurs opérateurs, machines et personnel de substitution | Géré dans SkyPlanner | Configuré pendant la mise en route |
Schémas d’intégration
1. Chargement initial des données de base. Lisez les SKU, les structures, les roteiros, les recursos, les centros de recurso et le calendrier de production. Définissez avec soin la correspondance des centres de ressources : un centro de recurso comprenant quatre machines devient un groupe de postes de travail ou quatre postes de travail. Convertissez Fator de carga soit en rendement des postes de travail dans SkyPlanner, soit en horaires d’équipe, mais pas les deux.
2. Synchronisation des OP. Lisez les OP aux statuts Firme et Liberada avec leurs étapes et leurs matières, ainsi que les commandes d’achat ouvertes. Le MRP peut encore modifier ou supprimer les OP au statut Planejada : ne les ordonnancez que si vous souhaitez une vision prévisionnelle. SkyPlanner considère les matières commandées comme disponibles à la date de livraison de la commande d’achat et met les stocks à jour lorsque celle-ci passe au statut Delivered.
3. Renvoi du planning. Lorsque le moteur positionne ou déplace une étape, un webhook SkyPlanner déclenche le renvoi des données. Celui-ci renseigne le début et la fin prévus de chaque étape d’OP, ainsi que la ressource retenue : ce sont les mêmes champs que l’ordonnanceur modifie dans Programação de produção. Pendant le cadrage, l’équipe SkyPlanner définit avec vous et votre partenaire Senior le service web à utiliser.
4. Confirmations en atelier. Les opérateurs enregistrent leur travail avec SkyPlanner Mobile Confirmations ou le Production Timer. Ces relevés de temps maintiennent le planning à jour. Vous choisissez de renvoyer ou non les temps réels vers Senior. Si vous le faites, chaque confirmation devient un apontamento de produção sur l’étape d’OP, avec la quantité produite, les rebuts et les heures de début et de fin. Senior n’accepte les déclarations de production que pour les OP au statut Liberada ou Andamento. Si vous effectuez vos déclarations dans Fábrica ao Vivo, SkyPlanner récupère alors l’avancement par Events Hub.
5. Responsabilité des données et gestion des conflits. Consignez ces règles avant la mise en production :
| Données | Système responsable |
|---|---|
| SKU, structures, roteiros, quantités et statut des OP | Senior ERP |
| Séquence des étapes, heures de début et de fin, affectation des ressources | SkyPlanner |
| Matrice des temps de réglage, besoins en outils et en opérateurs, ressources de substitution | SkyPlanner |
| Calendrier de production et horaires d’équipe | Un seul système, choisi pendant le cadrage |
| Déclarations de production, mouvements de stock, calcul des coûts | Senior ERP, avec saisie directe ou transmission à partir des relevés de temps SkyPlanner |
Désignez un seul système pour écrire les dates des étapes. Si les ordonnanceurs continuent de séquencer les mêmes OP dans Programação de produção ou dans le diagramme de Gantt, convenez des OP dont SkyPlanner est responsable.
Les étapes types du projet
La mise en œuvre s’achève généralement dans les semaines qui suivent le début de la mise en route. Au préalable, validez le planning pendant l’essai gratuit de 30 jours, avec les ressources, les roteiros et les OP ouverts exportés de Senior au format CSV ou Excel.
- Correspondance des données. Arrêtez la table de correspondance, les règles de responsabilité, les fréquences de synchronisation et le choix de renvoyer ou non les déclarations de production.
- Accès à Senior. Créez l’utilisateur dédié à l’intégration, enregistrez l’application dans le portail API de Senior et activez les services web G5 ainsi que le webhook Events Hub. Effectuez d’abord les tests dans une base de recette.
- Chargement initial. SKU, structures, roteiros, recursos, centros de recurso, calendrier.
- Synchronisation des OP et des commandes d’achat. Interrogation périodique avec filtres et nouvelles tentatives, complétée par le webhook de statut des étapes.
- 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.
- Renvoi du planning. Dates des étapes et ressources transmises par les webhooks SkyPlanner, ainsi que les déclarations de production si cette option est retenue.
- Tests en parallèle. Faites fonctionner SkyPlanner en parallèle du planning actuel, comparez les dates et corrigez les données de base.
- Mise en production. Activez le retour des données une fois leur cohérence vérifiée.
Les points à prévoir pour une intégration de Senior ERP
- Quatre temps par ressource. Recurso contient les temps de traitement, de réglage, de chargement et déchargement, et de transfert. Les temps de chargement et de transfert peuvent relever de la manutention, et non du temps machine. Définissez leur correspondance pour chaque ressource, sinon toutes les durées seront fausses.
- Un seul temps de réglage par ressource. Le champ Tempo setup de Senior contient une valeur unique. Pendant la mise en route, construisez la matrice des temps de réglage dans SkyPlanner à partir de vos changements de série réels.
- Variantes. Dans Senior, un SKU associe un produit à une derivação, et les roteiros peuvent différer selon la variante. Intégrez le code de la variante aux clés de produit dans SkyPlanner.
- Statuts des OP. Seuls les OP aux statuts Liberada et Andamento acceptent les déclarations de production. Conservez la gestion des changements de statut dans Senior et laissez SkyPlanner les suivre par Events Hub.
- Déploiement hybride. Les services web G5 s’exécutent sur votre serveur Senior et Events Hub sur Senior X. Prévoyez un accès réseau aux deux.
- Format des nombres. Les services web de Senior refusent les nombres avec des séparateurs de milliers et exigent une virgule décimale. Envoyez les nombres dans ce format.
Qui configure et assure le support de l’intégration avec Senior ERP ?
- L’équipe SkyPlanner configure l’intégration lors de la mise en place et en assure le support après la mise en production, pour les services web, les API Senior X et les webhooks Events Hub convenus. Chaque usine utilise Senior ERP à sa manière : c’est là que cette expertise entre en jeu.
- Votre partenaire Senior peut participer. Il connaît votre configuration, vos personnalisations et vos licences. Il peut créer le compte utilisateur dédié à l’intégration, effectuer l’inscription au portail API et configurer les services web aux côtés de l’équipe SkyPlanner.
- Vos propres développeurs peuvent étendre l’intégration en utilisant la REST API de SkyPlanner avec un jeton API. Un jeton API suffit pour démarrer, et l’équipe SkyPlanner vous accompagne si nécessaire. Consultez la documentation d’intégration de SkyPlanner.
SkyPlanner est disponible à partir de 199 € par mois, avec 5 postes de travail inclus et une facturation mensuelle. L’intégration fait l’objet d’un devis établi à l’avance selon vos processus et vos besoins, en même temps que votre abonnement. Consultez les tarifs, la page sur l’ordonnancement à capacité finie avec Senior ERP, la page Senior ERP et la rubrique des intégrations ERP.
Les avis des industriels 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 appareillage é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 · Industrie 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.
1 000 et plusordres de fabrication ordonnancés automatiquement
« Nous maîtrisons la production d’une tout autre manière, et notre compréhension des capacités est désormais à 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.
Moinsd’arrêts dus aux ruptures de matières
« La valeur de SkyPlanner pour nous, c’est d’être 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é.
FAQ
Senior ERP dispose-t-il d’une API pour les ordres de fabrication ?
Oui. Le service web G5 com.senior.g5.co.mpr.pcp.ordemproducao génère les OP avec la même routine que celle utilisée dans l’écran de l’ERP. D’autres services G5 couvrent les produits et les déclarations de production. Senior X Platform y ajoute des API REST avec authentification par jeton Bearer et des webhooks Events Hub.
Senior ERP prend-il en charge les webhooks ?
Oui. Senior X Events Hub envoie des webhooks, notamment orderProductionStageChangeStatus lorsqu’une étape d’un OP change de statut. SkyPlanner l’utilise pour suivre l’avancement en atelier en temps réel, et ses propres webhooks renvoient les modifications de l’ordonnancement.
Comment les dates prévues sont-elles réécrites dans Senior ERP ?
SkyPlanner définit le début et la fin prévus de chaque étape d’un OP ainsi que la ressource retenue, dans les mêmes champs que ceux que le planificateur modifie dans Programação de produção. À chaque modification de l’ordonnancement, un webhook SkyPlanner déclenche la réécriture des données. Celle-ci emprunte le circuit défini pour votre installation Senior par l’équipe SkyPlanner lors du cadrage de la mise en place.
L’intégration fonctionne-t-elle avec Senior X et ERP XT ?
Oui. ERP XT s’exécute sur votre serveur, avec des services cloud sur Senior X. L’intégration utilise les services web G5 sur le serveur, ainsi que les API Senior X et Events Hub dans le cloud.
Pouvons-nous tester SkyPlanner avant de développer l’intégration ?
Oui. L’essai gratuit de 30 jours permet d’utiliser jusqu’à 20 postes de travail avec des imports CSV ou Excel depuis Senior, sans carte bancaire. Démarrez l’essai ou contactez l’équipe commerciale pour cadrer l’intégration.
