Intégrations / ERP / proALPHA ERP
Guide d’intégration de proALPHA pour l’ordonnancement de la production avec SkyPlanner APS
Ce guide d’intégration de Proalpha explique aux partenaires et aux équipes informatiques comment relier Proalpha ERP à SkyPlanner APS. L’intégration entre SkyPlanner et Proalpha fonctionne dans les deux sens :
- Les articles, les ordres de fabrication et leurs opérations, les ressources, les calendriers, les stocks et les commandes fournisseurs sont importés dans SkyPlanner.
- Les dates de début et de fin planifiées pour chaque opération sont renvoyées via setWorkOrderOperationDates.
- Les changements de ressources sont renvoyés via changeWorkOrderOperationResource.
- Les déclarations des opérateurs sont renvoyées via operationDataEntry.
- Les webhooks de SkyPlanner transmettent les modifications du planning dès qu’elles se produisent.
L’équipe SkyPlanner configure l’intégration en fonction de votre installation Proalpha 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 y participer ou développer eux-mêmes une intégration à partir de la REST API documentée de SkyPlanner (documentation de l’API).
Les interfaces de Proalpha
Proalpha ERP repose sur Progress OpenEdge. Avec Release 9, la plateforme est passée à OpenEdge 12. (Proalpha) Quatre interfaces sont utiles pour l’ordonnancement.
- Proalpha ERP REST APIs. Le portail public des API Proalpha répertorie 108 spécifications OpenAPI 3.0 sous
api/web/v1. Ces API servent à renvoyer les données vers Proalpha et à lire les articles et les stocks. - Integration Workbench (INWB). Selon Proalpha, INWB « is a central platform which connects different IT systems, machines, sites » (est une plateforme centrale qui relie différents systèmes informatiques, machines et sites) et « converts the data into the format of the target system. » (convertit les données au format du système cible). (Proalpha) INWB reçoit les messages pAX via
POST /api/web/v1/inwb/message. Utilisez cette interface pour les flux d’ordres de fabrication entrants et sortants de Proalpha. - Proalpha Integration Platform. Annoncée en avril 2026 et reposant sur n8n, cette plateforme « will be available to customers either on-premises or in the cloud. » (sera proposée aux clients sur site ou dans le cloud). Proalpha « will rely on an API-centric reference architecture and REST interfaces. » (s’appuiera sur une architecture de référence centrée sur les API et sur des interfaces REST). (Proalpha)
- EDI et exports de fichiers. INWB gère les formats de fichiers propres à chaque secteur. Les exports de fichiers suffisent pour l’essai de SkyPlanner.
Les points de terminaison pour la production
| API Proalpha | Point de terminaison | Utilisation dans l’intégration |
|---|---|---|
| Production Workorder Operation Dates API V1 | POST /api/web/v1/pps/prod/setWorkOrderOperationDates | Début et fin planifiés pour chaque opération (guid, startTimePoint, endTimePoint) |
| Production Workorder Operation Resource API V1 | POST /api/web/v1/pps/prod/changeWorkOrderOperationResource | Ressource retenue lors de l’ordonnancement (guid, resourceGUID) |
| Production Workorder Operation API V1 | POST /api/web/v1/pps/prod/operationDataEntry/{combined, setup, process} | Déclarations : postingQty, scrapQty, finishOperation, employeeID, resourceTime |
| Part API | GET/POST /api/web/v1/master/part | Articles avec partNumber, partType, quantityUnitCode |
| Material API V1 | GET /api/web/v1/mawi/MRPArea/{mrpAreaGuid}/part/{partGuid}/stock | Stock par zone MRP |
Authentification
Les spécifications publiées par Proalpha utilisent l’authentification HTTP Basic. Les points de terminaison dépendent de l’environnement : {schema}://{host}:{port}/api/web/v1/..., sur votre serveur Proalpha ou sur Proalpha Cloud. Créez un compte technique dédié dont les droits se limitent aux objets du tableau de correspondance. Prévoyez avec votre équipe informatique l’accès réseau depuis le cloud de SkyPlanner vers ce point de terminaison.
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. Un jeton d’API suffit pour démarrer. Le tutoriel d’intégration vous guide dans vos premiers appels.
Événements et interrogation périodique
Le portail des API Proalpha ne répertorie aucune API d’abonnement aux webhooks. Les modifications sont transmises depuis Proalpha par :
- un flux de messages INWB qui envoie les ordres de fabrication nouveaux ou modifiés avec leurs opérations
- un workflow n8n sur Proalpha Integration Platform
- une interrogation périodique de Material API pour les stocks
SkyPlanner envoie des webhooks lorsque l’état ou le planning change. Le renvoi des données vers Proalpha est donc déclenché par les événements.
Correspondance des données
| Objet ou API Proalpha | Objet SkyPlanner | Sens | Fréquence |
|---|---|---|---|
| Part (Part API) | Produits et matières | Proalpha → SkyPlanner | Chargement initial, puis à chaque modification |
| Modèle de processus du produit : process, activities ; lignes de nomenclature de l’ordre de fabrication | Structure du produit, sous-ensembles, étapes de fabrication | Proalpha → SkyPlanner | Chargement initial, puis à chaque modification |
| Ordre de fabrication (Fertigungsauftrag) avec quantité et date d’échéance | Ordre et opérations avec date d’échéance et priorité | Proalpha → SkyPlanner | Envoi par INWB ou n8n, ou synchronisation à intervalles de quelques minutes |
| Opérations de l’ordre de fabrication : targetSetupTime, targetProcessTime, resource | Étapes de fabrication avec temps de réglage et durées | Proalpha → SkyPlanner | Avec l’ordre de fabrication |
| Ressources, groupes de ressources, groupes de ressources de remplacement | Postes de travail, groupes de postes de travail, postes de travail de remplacement | Proalpha → SkyPlanner | Chargement initial |
| Plages du calendrier des ressources avec intensity et overloadIntensity | Horaires d’équipe et rendements des postes de travail | Proalpha → SkyPlanner | Chargement initial ; mise à jour quotidienne ou gestion dans SkyPlanner |
| Stock par zone MRP | Stock de matières | Proalpha → SkyPlanner | Toutes les heures ou avant chaque calcul du planning |
| Commandes fournisseurs avec date de livraison | Matières attendues à leur date de livraison | Proalpha → SkyPlanner | Toutes les heures ou avant chaque calcul du planning |
| setWorkOrderOperationDates | Début et fin planifiés pour chaque opération | SkyPlanner → Proalpha | À chaque modification du planning, via un webhook SkyPlanner |
| changeWorkOrderOperationResource | Poste de travail choisi par le moteur | SkyPlanner → Proalpha | À chaque modification du planning |
| operationDataEntry (setup, process, combined) | Temps enregistrés et quantités issus de Mobile Confirmations | SkyPlanner → Proalpha | À chaque déclaration ou à chaque relève d’équipe |
| Règles d’ordonnancement de SkyPlanner | Matrice des temps de changement de série, outils à capacité limitée, effectifs d’opérateurs | 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. Lisez les articles via Part API et chargez une seule fois les ressources, les groupes de ressources et les calendriers via INWB ou un export de fichiers. Définissez soigneusement la correspondance entre chaque ressource Proalpha et un poste de travail SkyPlanner. Les groupes de ressources de remplacement deviennent des postes de travail de remplacement.
2. Synchronisation des ordres. Un flux de messages INWB ou un workflow n8n transmet les ordres de fabrication ouverts avec leurs opérations, temps prévus et ressources. Les stocks proviennent de Material API, par zone MRP, et les commandes d’achat ouvertes sont transmises via INWB. SkyPlanner considère les matières commandées comme disponibles à la date de livraison de la commande d’achat et actualise le stock lorsque celle-ci passe au statut Delivered.
3. Écriture du planning dans l’ERP. Pour chaque opération que le moteur a placée ou déplacée, l’intégration appelle setWorkOrderOperationDates avec le guid de l’opération et ses dates de début et de fin. Si le moteur a choisi une autre ressource, un appel à changeWorkOrderOperationResource suit.
4. Déclarations en atelier. Les opérateurs enregistrent leur travail avec SkyPlanner Mobile Confirmations ou Production Timer. Les relevés de temps maintiennent le planning à jour et sont transmis à Proalpha via operationDataEntry. Si votre usine utilise déjà des terminaux PDC pour ses déclarations, conservez un seul canal afin d’éviter les doubles enregistrements.
5. Règles de responsabilité et de gestion des conflits. Formalisez-les avant la mise en production :
| Données | Système responsable |
|---|---|
| Articles, modèles de processus, quantités, statut des ordres de fabrication | Proalpha |
| Séquence des opérations, dates de début et de fin, affectation des ressources | SkyPlanner |
| Matrice des temps de réglage, outils, effectifs d’opérateurs | SkyPlanner |
| Horaires d’équipe et absences | Un seul système, choisi lors du cadrage |
| Déclarations et mouvements de stock | Proalpha, alimenté par les relevés de temps SkyPlanner ou par PDC |
Si Proalpha APS ou Feinplanung est actif, décidez quel système fait autorité pour les dates des opérations. Si deux outils d’ordonnancement écrivent les mêmes dates, chacun écrase les données de l’autre. Avec Autopilot, SkyPlanner recalcule automatiquement l’ordonnancement lorsque la production évolue.
Étapes habituelles du projet
La mise en œuvre s’achève généralement en quelques semaines après le début de l’accompagnement. Au préalable, l’essai gratuit de 30 jours s’effectue avec vos propres données. Exportez depuis Proalpha les ordres de fabrication ouverts, les opérations et les ressources au format CSV ou Excel, importez-les et validez le planning.
- Atelier de correspondance des données. Définissez avec votre partenaire Proalpha la table de correspondance, les règles de responsabilité, les fréquences de synchronisation et le canal de déclaration.
- Configuration des interfaces. Activez les REST APIs et les flux INWB, créez le compte utilisateur technique et ouvrez les accès réseau. Commencez sur le système de test, puis passez en production.
- Chargement initial. Articles, ressources, groupes de ressources et calendriers.
- Synchronisation des ordres, des stocks et des commandes d’achat. Envoi des ordres de fabrication via INWB ou n8n et interrogation périodique des stocks, avec gestion des nouvelles tentatives.
- Paramétrage des contraintes dans SkyPlanner. Matrice des temps de réglage, outils, effectifs d’opérateurs et postes de travail de remplacement.
- Écriture du planning dans l’ERP. setWorkOrderOperationDates et changeWorkOrderOperationResource ; operationDataEntry est ajouté à cette étape.
- Fonctionnement en parallèle. Comparez les dates de SkyPlanner au planning actuel et corrigez les données de base.
- Mise en production. Activez l’écriture dans l’ERP une fois les données concordantes.
Points à anticiper pour une intégration Proalpha
- Pas d’objet de gamme de fabrication. Proalpha planifie à partir des modèles de processus des produits. Les outils repris de projets SAP ou Business Central recherchent des gammes de fabrication et passent à côté de certaines données. Lisez les opérations et les lignes de nomenclature dans l’ordre de fabrication.
- Intensité des calendriers. Les plages du calendrier portent les champs intensity et overloadIntensity. Faites-les correspondre aux horaires d’équipe et aux rendements dans SkyPlanner plutôt que de copier les heures brutes.
- Unités de mesure. Vérifiez quantityUnitCode et déterminez si le temps de réglage prévu s’applique par ordre ou par pièce. Des unités erronées faussent toutes les durées.
- Points de terminaison hébergés chez le client. La couche REST s’exécute sur votre serveur Proalpha. Les pare-feu, les ports et les certificats conditionnent la date de démarrage du projet : préparez ces accès en amont.
- Version installée. Avant de finaliser les correspondances, vérifiez avec votre partenaire quelles REST APIs sont exposées par votre version de Proalpha.
- Documentation accessible après connexion. L’aide en ligne de Proalpha est accessible via Documentation Portal. Faites confirmer les noms des champs par votre partenaire plutôt que de les deviner.
Intégration Proalpha : qui la configure et en assure le support ?
- L’équipe SkyPlanner la configure pendant l’accompagnement et en assure le support après la mise en production. Chaque installation Proalpha est modélisée différemment : c’est là que cette expertise intervient.
- Votre partenaire Proalpha peut participer. Il connaît vos modèles de processus, vos flux INWB et votre version, et peut configurer l’accès aux API. SkyPlanner fournit la REST API, la documentation Swagger/OpenAPI et les webhooks.
- Vos propres développeurs peuvent enrichir l’intégration en utilisant la même REST API avec un jeton API. L’équipe SkyPlanner les accompagne au besoin. La documentation du produit est accessible à tous dans la documentation SkyPlanner.
SkyPlanner est disponible à partir de 199 € par mois, avec 5 postes de travail inclus et une facturation mensuelle. Un devis pour l’intégration, adapté à vos processus et à vos besoins, vous est fourni à l’avance avec votre abonnement : vous connaissez ainsi le coût total avant de commencer. Découvrez comment Proalpha planifie la capacité dans proALPHA propose-t-il l’ordonnancement à capacité finie ?, retrouvez une vue d’ensemble sur la page proALPHA et consultez les autres systèmes dans la rubrique des intégrations ERP.
Avis d’industriels sur SkyPlanner
2 hgagnées chaque semaine
« SkyPlanner nous a fait passer 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 liste d’opérations à réaliser est transmise à la ligne de production 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 l’élaboration d’un planning optimisé sur trois mois pour l’ensemble des postes de travail prend moins de 30 minutes.
99,2 %de respect des délais de livraison
« SkyPlanner nous a donné la visibilité nécessaire pour repérer les goulots d’étranglement et a clarifié la gestion de la production. »
Toni Tuori, responsable de production
Piristeel · Équipements de sécurité pour toitures et systèmes d’évacuation des eaux pluviales
Le taux de respect des délais de livraison a atteint 99,2 % cette année, et l’ordonnancement permet de gagner jusqu’à quatre heures de travail par jour.
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 des charges permet de déterminer des dates de livraison plus précises, et les arrêts de production dus aux ruptures de matières ont fortement diminué.
FAQ
Quelles interfaces Proalpha l’intégration utilise-t-elle ?
Les REST APIs de Proalpha servent à lire les articles et les stocks, ainsi qu’à écrire les dates, les ressources et les déclarations dans l’ERP. Les flux de messages INWB ou Integration Platform, basée sur n8n, transmettent les ordres de fabrication avec leurs opérations. Les exports de fichiers servent pour l’essai et les chargements en masse.
Où les dates planifiées sont-elles enregistrées dans Proalpha ?
Sur l’opération de l’ordre de fabrication, via setWorkOrderOperationDates avec les dates et heures de début et de fin. Si le moteur a déplacé l’opération sur une autre machine, changeWorkOrderOperationResource met à jour la ressource.
Proalpha prend-il en charge les webhooks ?
Proalpha API Portal ne répertorie aucune API d’abonnement aux webhooks. Les modifications parviennent à SkyPlanner via des flux de messages INWB, des workflows n8n ou des interrogations périodiques. Les webhooks propres à SkyPlanner permettent de déclencher l’écriture dans l’ERP à partir d’événements.
Les déclarations des opérateurs peuvent-elles être transmises à Proalpha ?
Oui. Les relevés de temps de SkyPlanner Mobile Confirmations sont transmis via operationDataEntry, avec la quantité, l’employé et le temps d’utilisation de la ressource. Conservez un seul canal de déclaration si des terminaux PDC sont également utilisés.
Avons-nous besoin de Proalpha APS, et que faire si nous l’utilisons déjà ?
Vous n’en avez pas besoin. SkyPlanner réalise lui-même l’ordonnancement à partir de vos ordres de fabrication, opérations et ressources, dans les limites de la capacité disponible. Autopilot le maintient à jour. Si Proalpha APS est actif, décidez lors du cadrage quel système fait autorité pour les dates des opérations. SkyPlanner n’écrit alors que les dates dont il est responsable, afin que les deux plannings n’écrasent jamais les données l’un de l’autre.
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 à partir d’un export CSV ou Excel de vos ordres de fabrication, sans carte bancaire. Démarrez l’essai ou contactez l’équipe commerciale pour cadrer l’intégration.
