Integrationen / ERP / proALPHA ERP
proALPHA Schnittstelle: Leitfaden für die Feinplanung mit SkyPlanner APS
Dieser Integrationsleitfaden zeigt Partnern und IT-Teams, wie sie Proalpha ERP mit SkyPlanner APS verbinden. Die Schnittstelle zwischen SkyPlanner und Proalpha überträgt Daten in beide Richtungen:
- Artikel, Fertigungsaufträge mit ihren Arbeitsgängen, Ressourcen, Kalender, Bestände und Bestellungen werden eingelesen.
- Geplanter Beginn und geplantes Ende je Arbeitsgang werden über setWorkOrderOperationDates zurückgeschrieben.
- Änderungen an der Ressourcenzuordnung werden über changeWorkOrderOperationResource zurückgeschrieben.
- Rückmeldungen der Bediener werden über operationDataEntry zurückgeschrieben.
- SkyPlanner-Webhooks übertragen Planänderungen, sobald sie auftreten.
Das SkyPlanner-Team stimmt die Schnittstelle beim Onboarding auf Ihre Proalpha-Umgebung ab und betreut sie auch nach dem Go-live. Dieser Leitfaden richtet sich an Partner und Entwickler, die daran mitwirken oder selbst auf Basis der dokumentierten REST API von SkyPlanner entwickeln möchten (API-Referenz).
Die Proalpha-Schnittstellen
Proalpha ERP läuft auf Progress OpenEdge. Mit Release 9 wurde die Plattform auf OpenEdge 12 umgestellt. (Proalpha) Für die Feinplanung sind vier Schnittstellen relevant.
- Proalpha ERP REST APIs. Das öffentliche Proalpha API Portal führt 108 OpenAPI 3.0-Spezifikationen unter
api/web/v1auf. Über diese APIs werden Daten zurückgeschrieben sowie Artikel und Bestände gelesen. - Integration Workbench (INWB). Laut Proalpha gilt für INWB: „is a central platform which connects different IT systems, machines, sites“ (ist eine zentrale Plattform, die verschiedene IT-Systeme, Maschinen und Standorte verbindet) und „converts the data into the format of the target system.“ (wandelt die Daten in das Format des Zielsystems um). (Proalpha) INWB empfängt pAX-Nachrichten über
POST /api/web/v1/inwb/message. Nutzen Sie INWB, um Fertigungsaufträge aus Proalpha zu übertragen und in Proalpha einzulesen. - Proalpha Integration Platform. Die im April 2026 angekündigte Plattform basiert auf n8n und „will be available to customers either on-premises or in the cloud.“ (wird Kunden wahlweise vor Ort oder in der Cloud zur Verfügung stehen). Proalpha „will rely on an API-centric reference architecture and REST interfaces.“ (wird auf eine API-zentrierte Referenzarchitektur und REST-Schnittstellen setzen). (Proalpha)
- EDI und Dateiexporte. INWB verarbeitet branchenspezifische Dateiformate. Für die Testphase mit SkyPlanner reichen Dateiexporte aus.
Die Endpunkte für die Fertigung
| Proalpha API | Endpunkt | Verwendung in der Integration |
|---|---|---|
| Production Workorder Operation Dates API V1 | POST /api/web/v1/pps/prod/setWorkOrderOperationDates | Geplanter Beginn und geplantes Ende je Arbeitsgang (guid, startTimePoint, endTimePoint) |
| Production Workorder Operation Resource API V1 | POST /api/web/v1/pps/prod/changeWorkOrderOperationResource | In der Planung ausgewählte Ressource (guid, resourceGUID) |
| Production Workorder Operation API V1 | POST /api/web/v1/pps/prod/operationDataEntry/{combined, setup, process} | Rückmeldungen: postingQty, scrapQty, finishOperation, employeeID, resourceTime |
| Part API | GET/POST /api/web/v1/master/part | Artikel mit partNumber, partType, quantityUnitCode |
| Material API V1 | GET /api/web/v1/mawi/MRPArea/{mrpAreaGuid}/part/{partGuid}/stock | Bestand je MRP-Bereich |
Authentifizierung
Die veröffentlichten Proalpha-Spezifikationen verwenden HTTP-Basic-Authentifizierung. Die Endpunkte sind umgebungsspezifisch und liegen unter {schema}://{host}:{port}/api/web/v1/... auf Ihrem Proalpha-Server oder in der Proalpha Cloud. Legen Sie einen eigenen technischen Benutzer an, dessen Berechtigungen auf die Objekte in der Zuordnungstabelle beschränkt sind. Planen Sie mit Ihrem IT-Team den Netzwerkzugriff aus der SkyPlanner-Cloud auf diesen Endpunkt.
Bei SkyPlanner erfolgt die Authentifizierung an der REST API mit einem API-Token (SkyPlanner Settings > API). Die API ist in Swagger/OpenAPI dokumentiert. Für den Einstieg genügt ein API-Token. Das Integrationstutorial führt Sie durch die ersten Aufrufe.
Ereignisse und Polling
Das Proalpha API Portal führt keine API zum Abonnieren von Webhooks auf. Änderungen aus Proalpha werden über folgende Wege übertragen:
- einen INWB-Nachrichtenfluss, der neue und geänderte Fertigungsaufträge mit ihren Arbeitsgängen sendet
- einen n8n-Workflow auf der Proalpha Integration Platform
- zeitgesteuerte Abfragen der Material API für Bestandsdaten
SkyPlanner sendet Webhooks, wenn sich der Status oder der Plan ändert. Damit erfolgt das Zurückschreiben nach Proalpha ereignisgesteuert.
Datenzuordnung
| Proalpha-Objekt oder API | SkyPlanner-Objekt | Richtung | Häufigkeit |
|---|---|---|---|
| Part (Part API) | Produkte und Materialien | Proalpha → SkyPlanner | Erstimport, danach bei Änderungen |
| Produktprozessmodell: process, activities; Stücklistenpositionen des Fertigungsauftrags | Produktstruktur, Unterprodukte, Prozessschritte | Proalpha → SkyPlanner | Erstimport, danach bei Änderungen |
| Fertigungsauftrag mit Menge und Fälligkeitstermin | Auftrag und Arbeitsgänge mit Fälligkeitstermin und Priorität | Proalpha → SkyPlanner | Per Push über INWB oder n8n oder alle paar Minuten |
| Arbeitsgänge des Fertigungsauftrags: targetSetupTime, targetProcessTime, resource | Prozessschritte mit Rüstzeiten und Bearbeitungsdauern | Proalpha → SkyPlanner | Zusammen mit dem Fertigungsauftrag |
| Ressourcen, Ressourcengruppen, alternative Ressourcengruppen | Arbeitsstationen, Arbeitsstationsgruppen, alternative Arbeitsstationen | Proalpha → SkyPlanner | Erstimport |
| Zeitblöcke im Ressourcenkalender mit intensity und overloadIntensity | Schichten und Wirkungsgrade der Arbeitsstationen | Proalpha → SkyPlanner | Erstimport; danach täglich oder Pflege in SkyPlanner |
| Bestand je MRP-Bereich | Materialbestand | Proalpha → SkyPlanner | Stündlich oder vor jedem Planungslauf |
| Bestellungen mit Lieferdatum | Materialzugang zum Lieferdatum | Proalpha → SkyPlanner | Stündlich oder vor jedem Planungslauf |
| setWorkOrderOperationDates | Geplanter Beginn und geplantes Ende je Arbeitsgang | SkyPlanner → Proalpha | Bei Planänderungen über einen SkyPlanner-Webhook |
| changeWorkOrderOperationResource | Von der Planungsengine ausgewählte Arbeitsstation | SkyPlanner → Proalpha | Bei Planänderungen |
| operationDataEntry (setup, process, combined) | Zeitbuchungen und Mengen aus Mobile Confirmations | SkyPlanner → Proalpha | Je Rückmeldung oder je Schicht |
| Planungsregeln in SkyPlanner | Rüstzeitmatrix, Werkzeuge als begrenzt verfügbare Ressourcen, Anzahl der Bediener | Pflege in SkyPlanner | Einrichtung beim Onboarding |
Integrationsmuster
1. Erstimport der Stammdaten. Lesen Sie Artikel über die Part API ein und importieren Sie Ressourcen, Ressourcengruppen und Kalender einmalig über INWB oder einen Dateiexport. Ordnen Sie jede Proalpha-Ressource gezielt einer SkyPlanner-Arbeitsstation zu. Alternative Ressourcengruppen werden zu alternativen Arbeitsstationen.
2. Aufträge synchronisieren. Ein INWB-Nachrichtenfluss oder n8n-Workflow überträgt offene Fertigungsaufträge mit ihren Arbeitsgängen, Sollzeiten und Ressourcen. Die Bestände werden je MRP-Bereich über die Material API abgerufen, offene Bestellungen über INWB. SkyPlanner behandelt bestelltes Material ab dem Liefertermin der Bestellung als verfügbar und aktualisiert den Bestand, sobald die Bestellung den Status Delivered erhält.
3. Planung zurückschreiben. Für jeden Arbeitsgang, den die Planungsengine eingeplant oder verschoben hat, ruft die Schnittstelle setWorkOrderOperationDates mit der guid des Arbeitsgangs sowie Start und Ende auf. Hat die Planungsengine eine andere Ressource gewählt, folgt changeWorkOrderOperationResource.
4. Rückmeldungen aus der Fertigung. Mitarbeitende erfassen ihre Arbeit mit SkyPlanner Mobile Confirmations oder dem Production Timer. Die Zeitbuchungen halten den Plan aktuell und werden über operationDataEntry an Proalpha übermittelt. Wenn Ihr Werk bereits über BDE-Terminals rückmeldet, nutzen Sie nur einen Rückmeldekanal, um doppelte Buchungen zu vermeiden.
5. Datenhoheit und Konfliktregeln. Halten Sie diese vor dem Produktivstart schriftlich fest:
| Daten | Führendes System |
|---|---|
| Teile, Prozessmodelle, Mengen, Status der Fertigungsaufträge | Proalpha |
| Reihenfolge der Arbeitsgänge, Start- und Endzeiten, Ressourcenzuordnung | SkyPlanner |
| Rüstzeitmatrix, Werkzeuge, Anzahl der Bediener | SkyPlanner |
| Schichten und Abwesenheiten | Ein System, das bei der Anforderungsaufnahme festgelegt wird |
| Rückmeldungen und Bestandsbuchungen | Proalpha, versorgt durch SkyPlanner-Zeitbuchungen oder BDE |
Wenn Proalpha APS oder Feinplanung aktiv ist, legen Sie fest, welches System die Termine der Arbeitsgänge vorgibt. Schreiben zwei Planungssysteme dieselben Termine, überschreiben sie sich gegenseitig. Mit Autopilot plant SkyPlanner automatisch neu, wenn sich in der Produktion etwas ändert.
Typische Projektschritte
Die Implementierung ist in der Regel innerhalb weniger Wochen nach Beginn des Onboardings abgeschlossen. Davor testen Sie SkyPlanner 30 Tage kostenlos mit Ihren eigenen Daten. Exportieren Sie offene Fertigungsaufträge, Arbeitsgänge und Ressourcen aus Proalpha als CSV- oder Excel-Datei, importieren Sie diese und prüfen Sie den Plan.
- Mapping-Workshop. Legen Sie mit Ihrem Proalpha-Partner die Zuordnungstabelle, die Regeln zur Datenhoheit, die Synchronisierungsintervalle und den Rückmeldekanal fest.
- Schnittstellen einrichten. Aktivieren Sie die REST APIs und INWB-Nachrichtenflüsse, legen Sie den technischen Benutzer an und geben Sie den Netzwerkzugriff frei. Zuerst im Testsystem, dann im Produktivsystem.
- Erstimport. Teile, Ressourcen, Ressourcengruppen und Kalender.
- Aufträge, Bestände und Bestellungen synchronisieren. Fertigungsaufträge per Push über INWB oder n8n übertragen, Bestände per Polling abrufen – jeweils mit Wiederholungsversuchen bei Fehlern.
- Planungsbedingungen in SkyPlanner einrichten. Rüstzeitmatrix, Werkzeuge, Anzahl der Bediener und alternative Arbeitsstationen.
- Planung zurückschreiben. setWorkOrderOperationDates und changeWorkOrderOperationResource; operationDataEntry wird in diesem Schritt ergänzt.
- Parallelbetrieb. Vergleichen Sie die Termine aus SkyPlanner mit dem aktuellen Plan und korrigieren Sie die Stammdaten.
- Produktivstart. Aktivieren Sie das Zurückschreiben, sobald die Daten übereinstimmen.
Was Sie bei einer Proalpha-Integration einplanen sollten
- Kein Arbeitsplanobjekt. Proalpha plant auf Basis von Produktprozessmodellen. Werkzeuge, die aus SAP- oder Business Central-Projekten übernommen werden, suchen nach Arbeitsplänen und erfassen dadurch nicht alle Daten. Lesen Sie die Arbeitsgänge und Stücklistenpositionen direkt am Fertigungsauftrag aus.
- Intensität im Kalender. Kalenderblöcke enthalten intensity und overloadIntensity. Bilden Sie diese auf Schichten und Wirkungsgrade in SkyPlanner ab, statt nur die Stundenwerte zu übernehmen.
- Maßeinheiten. Prüfen Sie quantityUnitCode und ob die Sollrüstzeit pro Auftrag oder pro Stück gilt. Falsche Einheiten verfälschen jede Dauer.
- Beim Kunden gehostete Endpunkte. Die REST-Schicht läuft auf Ihrem Proalpha-Server. Firewalls, Ports und Zertifikate bestimmen, wann das Projekt starten kann. Kümmern Sie sich deshalb frühzeitig um die nötigen Freigaben und Zertifikate.
- Release-Stand. Klären Sie mit Ihrem Partner, welche REST APIs Ihr Proalpha-Release bereitstellt, bevor Sie das Mapping festlegen.
- Dokumentation mit Anmeldung. Die Onlinehilfe von Proalpha ist über das Documentation Portal zugänglich und erfordert eine Anmeldung. Klären Sie Feldnamen mit Ihrem Partner, statt sie zu erraten.
Die Proalpha-Integration: Wer übernimmt Einrichtung und Support?
- Das SkyPlanner-Team richtet die Integration beim Onboarding ein und betreut sie nach dem Produktivstart. Jede Proalpha-Installation ist anders modelliert. Dieses Wissen fließt in die Einrichtung ein.
- Ihr Proalpha-Partner kann mitwirken. Er kennt Ihre Prozessmodelle, INWB-Nachrichtenflüsse und Ihren Release-Stand und kann den API-Zugang einrichten. SkyPlanner stellt die REST API, die Swagger/OpenAPI-Dokumentation und Webhooks bereit.
- Ihre eigenen Entwickler können darauf aufbauen. Sie nutzen dieselbe REST API mit einem API-Token. Das SkyPlanner-Team unterstützt sie bei Bedarf. Die Produktdokumentation ist unter SkyPlanner-Dokumentation öffentlich zugänglich.
SkyPlanner ist ab 199 € pro Monat erhältlich, inklusive 5 Arbeitsstationen und bei monatlicher Abrechnung. Sie erhalten vorab ein Angebot, das Ihren Tarif und die auf Ihre Abläufe und Anforderungen abgestimmte Integration umfasst. So kennen Sie die Gesamtkosten, bevor Sie starten. Wie Proalpha Kapazitäten plant, erfahren Sie unter Bietet proALPHA eine Feinplanung?. Einen Überblick finden Sie auf der proALPHA-Seite, weitere Systeme in der Übersicht der ERP-Integrationen.
Erfahrungen von Fertigungsunternehmen mit SkyPlanner
2 hjede Woche eingespart
„Mit SkyPlanner haben wir unsere Produktionsplanung von Excel-Tabellen auf die Optimierung der Produktion in Echtzeit umgestellt.“
Kalle Kalliomäki, Supply-Chain-Spezialist
UTU · Elektrische Schalttafeln und Schaltanlagen
Die Produktionsplanung spart jede Woche 2 Stunden Arbeitszeit, und eine neue Auftragsreihenfolge erreicht die Fertigungslinie innerhalb von Sekunden.
+90%Produktionseffizienz
„Die Effizienz in der Produktion ist um 90% gestiegen.“
Abdul Rucyinga, IT-Leiter
Laboratory & Allied · Pharmazeutische Fertigung
Die Produktionseffizienz ist um 90% gestiegen. Ein optimierter Plan für drei Monate über alle Arbeitsstationen hinweg lässt sich in weniger als 30 Minuten erstellen.
99,2%Liefertreue
„SkyPlanner hat Engpässe sichtbar gemacht und für mehr Klarheit in der Produktionssteuerung gesorgt.“
Toni Tuori, Produktionsleiter
Piristeel · Dachsicherheits- und Regenwassersysteme
Die Liefertreue erreichte dieses Jahr 99,2%, und die Feinplanung spart täglich bis zu vier Stunden Arbeitszeit.
WenigerStillstände durch Materialmangel
„Der Mehrwert von SkyPlanner liegt für uns darin, dass es im täglichen Einsatz funktioniert – besonders beim Festlegen von Lieferterminen.“
Tommi Männistö, Leiter Produktionsplanung
Eskomatic · Lohnzerspanung
Die automatische Belegungsplanung ermöglicht genauere Liefertermine, und die Produktionsstillstände durch Materialmangel sind stark zurückgegangen.
Häufige Fragen
Welche Proalpha-Schnittstellen nutzt die Integration?
Die Proalpha REST APIs für Teile, Bestände und das Zurückschreiben von Terminen, Ressourcen und Rückmeldungen. INWB-Nachrichtenflüsse oder die n8n-basierte Integration Platform übertragen Fertigungsaufträge mit ihren Arbeitsgängen. Für die Testphase und Massenimporte werden Dateiexporte genutzt.
Wo werden die geplanten Termine in Proalpha gespeichert?
Am Arbeitsgang des Fertigungsauftrags, über setWorkOrderOperationDates mit Start- und Endzeitpunkt. Hat die Planungsengine den Arbeitsgang auf eine andere Maschine verschoben, aktualisiert changeWorkOrderOperationResource die Ressource.
Unterstützt Proalpha Webhooks?
Das Proalpha API Portal führt keine API zum Abonnieren von Webhooks auf. Änderungen gelangen über INWB-Nachrichtenflüsse, n8n-Workflows oder Polling zu SkyPlanner. Die eigenen Webhooks von SkyPlanner ermöglichen das ereignisgesteuerte Zurückschreiben.
Können Rückmeldungen der Mitarbeitenden in Proalpha gebucht werden?
Ja. Zeitbuchungen aus SkyPlanner Mobile Confirmations werden über operationDataEntry mit Menge, Mitarbeiterzeit und Ressourcenzeit gebucht. Nutzen Sie nur einen Rückmeldekanal, wenn auch BDE-Terminals im Einsatz sind.
Brauchen wir Proalpha APS, und was gilt, wenn wir es bereits einsetzen?
Sie benötigen es nicht. SkyPlanner erstellt die Feinplanung selbst aus Ihren Fertigungsaufträgen, Arbeitsgängen und Ressourcen und berücksichtigt dabei die verfügbaren Kapazitäten. Autopilot hält den Plan aktuell. Wenn Proalpha APS aktiv ist, legen Sie bei der Anforderungsaufnahme fest, welches System die Termine der Arbeitsgänge vorgibt. SkyPlanner schreibt dann nur die Termine, für die es zuständig ist. So überschreiben sich die beiden Planungen nie gegenseitig.
Können wir SkyPlanner testen, bevor wir die Integration aufbauen?
Ja. In der kostenlosen 30-tägigen Testphase können Sie bis zu 20 Arbeitsstationen mit einem CSV- oder Excel-Export Ihrer Fertigungsaufträge testen. Eine Kreditkarte ist nicht erforderlich. Jetzt testen oder mit dem Vertrieb sprechen, um die Anforderungen an die Integration aufzunehmen.
