Integraties / ERP / proALPHA ERP
Integratiehandleiding voor proALPHA productieschema’s maken met SkyPlanner APS
Deze integratiehandleiding voor Proalpha laat partners en IT-teams zien hoe ze Proalpha ERP aan SkyPlanner APS koppelen. De integratie tussen SkyPlanner en Proalpha werkt in beide richtingen:
- Artikelen, productieorders met bewerkingen, productiemiddelen, kalenders, voorraad en inkooporders worden ingelezen.
- De geplande begin- en eindtijd per bewerking worden teruggeschreven via setWorkOrderOperationDates.
- Wijzigingen in toegewezen productiemiddelen worden teruggeschreven via changeWorkOrderOperationResource.
- Terugmeldingen van operators worden teruggeschreven via operationDataEntry.
- Webhooks van SkyPlanner sturen wijzigingen in het productieschema direct door.
Het SkyPlanner-team stemt de integratie tijdens de onboarding af op uw Proalpha-inrichting en biedt ook na de ingebruikname ondersteuning. Deze handleiding is bedoeld voor partners en ontwikkelaars die hieraan willen meewerken of zelf willen bouwen op de gedocumenteerde REST API van SkyPlanner (API-documentatie).
De interfaces van Proalpha
Proalpha ERP draait op Progress OpenEdge. Met Release 9 is het platform overgestapt op OpenEdge 12. (Proalpha) Voor het opstellen van productieschema’s zijn vier interfaces van belang.
- Proalpha ERP REST APIs. Het openbare Proalpha API Portal bevat 108 OpenAPI 3.0-specificaties onder
api/web/v1. Via deze route schrijft u gegevens terug en leest u artikelen en voorraad uit. - Integration Workbench (INWB). Volgens Proalpha geldt voor INWB: “is a central platform which connects different IT systems, machines, sites” (is een centraal platform dat verschillende IT-systemen, machines en locaties verbindt) en “converts the data into the format of the target system.” (zet de gegevens om naar het formaat van het doelsysteem). (Proalpha) INWB ontvangt pAX-berichten via
POST /api/web/v1/inwb/message. Gebruik deze interface om productieorders van en naar Proalpha te sturen. - Proalpha Integration Platform. Dit platform is aangekondigd in april 2026 en wordt aangedreven door n8n. Het “will be available to customers either on-premises or in the cloud.” (zal voor klanten beschikbaar zijn op locatie of in de cloud). Proalpha “will rely on an API-centric reference architecture and REST interfaces.” (zal gebruikmaken van een API-gerichte referentiearchitectuur en REST-interfaces). (Proalpha)
- EDI en bestandsexports. INWB verwerkt branchespecifieke bestandsformaten. Voor de proefperiode van SkyPlanner volstaan bestandsexports.
De endpoints voor productie
| Proalpha API | Endpoint | Gebruik in de integratie |
|---|---|---|
| Production Workorder Operation Dates API V1 | POST /api/web/v1/pps/prod/setWorkOrderOperationDates | Geplande begin- en eindtijd per bewerking (guid, startTimePoint, endTimePoint) |
| Production Workorder Operation Resource API V1 | POST /api/web/v1/pps/prod/changeWorkOrderOperationResource | Productiemiddel dat bij het inplannen is gekozen (guid, resourceGUID) |
| Production Workorder Operation API V1 | POST /api/web/v1/pps/prod/operationDataEntry/{combined, setup, process} | Terugmeldingen: postingQty, scrapQty, finishOperation, employeeID, resourceTime |
| Part API | GET/POST /api/web/v1/master/part | Artikelen met partNumber, partType, quantityUnitCode |
| Material API V1 | GET /api/web/v1/mawi/MRPArea/{mrpAreaGuid}/part/{partGuid}/stock | Voorraad per MRP-gebied |
Authenticatie
De gepubliceerde specificaties van Proalpha gebruiken HTTP Basic-authenticatie. De endpoints zijn omgevingsspecifiek: {schema}://{host}:{port}/api/web/v1/..., op uw Proalpha-server of in Proalpha Cloud. Maak een aparte technische gebruiker aan met uitsluitend rechten voor de objecten in de mappingtabel. Regel samen met uw IT-team de netwerktoegang vanuit de cloud van SkyPlanner naar dat endpoint.
De REST API van SkyPlanner gebruikt een API-token voor authenticatie (SkyPlanner Settings > API) en is gedocumenteerd in Swagger/OpenAPI. Een API-token volstaat om te beginnen. De integratiehandleiding leidt u door de eerste aanroepen.
Events en polling
Het Proalpha API Portal bevat geen API voor webhookabonnementen. Uitgaande wijzigingen worden aangeleverd via:
- een INWB-berichtenstroom die nieuwe en gewijzigde productieorders met hun bewerkingen verstuurt
- een n8n-workflow op het Proalpha Integration Platform
- periodieke polling van de Material API voor voorraadgegevens
SkyPlanner verstuurt webhooks wanneer de status of het productieschema verandert. Het terugschrijven naar Proalpha is dus eventgestuurd.
Gegevensmapping
| Proalpha-object of API | SkyPlanner-object | Richting | Frequentie |
|---|---|---|---|
| Part (Part API) | Producten en materialen | Proalpha → SkyPlanner | Eerste import, daarna bij wijzigingen |
| Productprocesmodel: process, activities; BOM-regels van de productieorder | Productstructuur, deelproducten, processtappen | Proalpha → SkyPlanner | Eerste import, daarna bij wijzigingen |
| Productieorder (Fertigungsauftrag) met aantal en uiterste gereeddatum | Order en taken met uiterste gereeddatum en prioriteit | Proalpha → SkyPlanner | Push via INWB of n8n, of om de paar minuten |
| Bewerkingen van de productieorder: targetSetupTime, targetProcessTime, resource | Processtappen met insteltijden en bewerkingsduren | Proalpha → SkyPlanner | Samen met de productieorder |
| Productiemiddelen, groepen productiemiddelen, alternatieve groepen productiemiddelen | Werkcentra, werkcentrumgroepen, alternatieve werkcentra | Proalpha → SkyPlanner | Eerste import |
| Kalenderblokken voor productiemiddelen met intensity en overloadIntensity | Diensten en efficiëntie per werkcentrum | Proalpha → SkyPlanner | Eerste import; daarna dagelijks of bijgehouden in SkyPlanner |
| Voorraad per MRP-gebied | Materiaalvoorraad | Proalpha → SkyPlanner | Elk uur of vóór elke planningsrun |
| Inkooporders met leverdatum | Binnenkomend materiaal op de leverdatum | Proalpha → SkyPlanner | Elk uur of vóór elke planningsrun |
| setWorkOrderOperationDates | Geplande begin- en eindtijd per bewerking | SkyPlanner → Proalpha | Bij wijzigingen in het productieschema, via een webhook van SkyPlanner |
| changeWorkOrderOperationResource | Werkcentrum dat door de planningsengine is gekozen | SkyPlanner → Proalpha | Bij wijzigingen in het productieschema |
| operationDataEntry (setup, process, combined) | Tijdregistraties en aantallen uit Mobile Confirmations | SkyPlanner → Proalpha | Per terugmelding of per dienst |
| Planningsregels van SkyPlanner | Omsteltijdenmatrix, gereedschappen met beperkte beschikbaarheid, aantallen operators | Beheerd in SkyPlanner | Ingesteld tijdens de onboarding |
Integratiepatronen
1. Eerste import van stamgegevens. Lees artikelen uit via de Part API en importeer productiemiddelen, groepen productiemiddelen en kalenders eenmalig via INWB of een bestandsexport. Bepaal zorgvuldig welk SkyPlanner-werkcentrum bij elk Proalpha-productiemiddel hoort. Alternatieve groepen productiemiddelen worden alternatieve werkcentra.
2. Ordersynchronisatie. Een INWB-berichtenstroom of n8n-workflow verstuurt openstaande productieorders met de bijbehorende bewerkingen, normtijden en productiemiddelen. Voorraadgegevens komen per MRP-gebied uit de Material API; openstaande inkooporders komen via INWB. SkyPlanner beschouwt besteld materiaal als beschikbaar op de leverdatum van de inkooporder en werkt de voorraad bij zodra de inkooporder de status Delivered krijgt.
3. Planning terugschrijven. Voor elke bewerking die de planningsengine heeft ingepland of verplaatst, roept de integratie setWorkOrderOperationDates aan met de guid van de bewerking en het begin- en eindtijdstip. Als de engine een ander productiemiddel heeft gekozen, volgt changeWorkOrderOperationResource.
4. Terugmeldingen van de werkvloer. Operators registreren hun werk met SkyPlanner Mobile Confirmations of de Production Timer. Tijdregistraties houden de planning actueel en worden via operationDataEntry naar Proalpha geboekt. Als uw fabriek al via PDC-terminals terugmeldt, houd dan één kanaal aan om dubbele boekingen te voorkomen.
5. Regels voor gegevensbeheer en conflicten. Leg deze vóór de ingebruikname vast:
| Gegevens | Beheerd door |
|---|---|
| Artikelen, procesmodellen, hoeveelheden, status van productieorders | Proalpha |
| Bewerkingsvolgorde, begin- en eindtijden, toewijzing van productiemiddelen | SkyPlanner |
| Omsteltijdenmatrix, gereedschappen, aantallen operators | SkyPlanner |
| Ploegendiensten en afwezigheden | Eén systeem, gekozen tijdens de scopebepaling |
| Terugmeldingen en voorraadboekingen | Proalpha, gevoed door tijdregistraties uit SkyPlanner of PDC |
Als Proalpha APS of Feinplanung actief is, bepaal dan welk systeem de bewerkingsdatums beheert. Twee planningssystemen die dezelfde datums wegschrijven, overschrijven elkaar. Met Autopilot past SkyPlanner de planning automatisch aan wanneer de productie verandert.
Gebruikelijke projectstappen
De implementatie is doorgaans binnen enkele weken na de start van de onboarding afgerond. Daarvóór gebruikt u tijdens de gratis proefperiode van 30 dagen uw eigen gegevens. Exporteer openstaande productieorders, bewerkingen en productiemiddelen uit Proalpha naar CSV of Excel, importeer ze en controleer de planning.
- Workshop over de mapping. Leg samen met uw Proalpha-partner de mappingtabel, de regels voor gegevensbeheer, de synchronisatiefrequenties en het terugmeldkanaal vast.
- Interfaces instellen. Schakel de REST API’s en INWB-stromen in, maak de technische gebruiker aan en stel de netwerktoegang open. Eerst in de testomgeving, daarna in de productieomgeving.
- Eerste gegevensimport. Artikelen, productiemiddelen, groepen productiemiddelen en kalenders.
- Orders, voorraad en inkooporders synchroniseren. Productieorders worden gepusht via INWB of n8n; voorraad wordt via polling opgehaald. Bij fouten worden de pogingen herhaald.
- Randvoorwaarden instellen in SkyPlanner. Omsteltijdenmatrix, gereedschappen, aantallen operators en alternatieve werkcentra.
- Planning terugschrijven. setWorkOrderOperationDates en changeWorkOrderOperationResource; in deze stap wordt ook operationDataEntry toegevoegd.
- Parallel draaien. Vergelijk de datums van SkyPlanner met de huidige planning en corrigeer de stamgegevens.
- Ingebruikname. Schakel het terugschrijven in zodra de gegevens overeenkomen.
Aandachtspunten bij een Proalpha-integratie
- Geen object voor de bewerkingsvolgorde. Proalpha plant op basis van procesmodellen voor producten. Tools die uit SAP- of Business Central-projecten worden overgenomen, zoeken naar bewerkingsvolgordes en missen daardoor gegevens. Lees de bewerkingen en stuklijstregels uit de productieorder.
- Kalenderintensiteit. Kalenderblokken bevatten intensity en overloadIntensity. Koppel deze aan ploegendiensten en efficiëntiewaarden in SkyPlanner in plaats van de uren zonder meer over te nemen.
- Maateenheden. Controleer quantityUnitCode en ga na of de norminsteltijd per order of per stuk geldt. Verkeerde eenheden vertekenen alle tijdsduren.
- Endpoints op uw eigen server. De REST-laag draait op uw Proalpha-server. Firewalls, poorten en certificaten bepalen wanneer het project kan starten. Regel de toegang daarom op tijd.
- Releaseversie. Controleer met uw partner welke REST API’s uw Proalpha-release beschikbaar stelt voordat u de mapping vastlegt.
- Documentatie waarvoor u moet inloggen. De online help van Proalpha is toegankelijk via het Documentation Portal. Laat uw partner de veldnamen bevestigen in plaats van ernaar te raden.
De Proalpha-integratie: wie richt deze in en biedt ondersteuning?
- Het SkyPlanner-team richt de integratie tijdens de onboarding in en biedt ondersteuning na de ingebruikname. Elke Proalpha-installatie is anders gemodelleerd. Bij de inrichting komt die kennis van pas.
- Uw Proalpha-partner kan meewerken. Uw partner kent uw procesmodellen, INWB-stromen en releaseversie en kan de API-toegang instellen. SkyPlanner levert de REST API, Swagger/OpenAPI-documentatie en webhooks.
- Uw eigen ontwikkelaars kunnen hierop voortbouwen via dezelfde REST API met een API-token. Het SkyPlanner-team helpt waar nodig. De productdocumentatie is openbaar beschikbaar in de SkyPlanner-documentatie.
SkyPlanner is beschikbaar vanaf 199 € per maand, inclusief 5 werkcentra, met maandelijkse facturering. U ontvangt vooraf een offerte voor de integratie, afgestemd op uw processen en behoeften, samen met uw abonnement. Zo kent u de volledige kosten voordat u begint. Lees hoe Proalpha capaciteit plant in Biedt proALPHA capaciteitsplanning binnen de beschikbare capaciteit?, bekijk het overzicht op de proALPHA-pagina en ontdek andere systemen in het overzicht van ERP-integraties.
Ervaringen van fabrikanten met SkyPlanner
2 ubesparing per week
“Met SkyPlanner zijn we voor onze productieplanning overgestapt van Excel-spreadsheets naar realtime optimalisatie van de productie.”
Kalle Kalliomäki, supplychainspecialist
UTU · Elektrische schakelborden en schakelapparatuur
De productieplanning bespaart elke week 2 uur werktijd en een nieuwe werklijst is binnen enkele seconden beschikbaar aan de productielijn.
+90%productie-efficiëntie
“De efficiëntie in de productie is met 90% gestegen.”
Abdul Rucyinga, hoofd IT
Laboratory & Allied · Farmaceutische productie
De productie-efficiëntie is met 90% gestegen. Een geoptimaliseerde planning voor drie maanden voor alle werkcentra is in minder dan 30 minuten klaar.
99,2%leverbetrouwbaarheid
“SkyPlanner heeft knelpunten zichtbaar gemaakt en meer overzicht gebracht in de aansturing van de productie.”
Toni Tuori, productiemanager
Piristeel · Dakveiligheids- en regenwatersystemen
De leverbetrouwbaarheid bereikte dit jaar 99,2% en het inplannen bespaart tot vier uur werktijd per dag.
Minderstilstand door materiaaltekorten
“De waarde van SkyPlanner is voor ons dat het een tool is die in het dagelijks gebruik werkt, vooral bij het vaststellen van leverdatums.”
Tommi Männistö, manager productieplanning
Eskomatic · Verspaning in opdracht
Het automatisch inplannen van de bezetting levert nauwkeurigere leverdatums op. Ook is de productiestilstand door materiaaltekorten sterk afgenomen.
Veelgestelde vragen
Welke Proalpha-interfaces gebruikt de integratie?
De REST API’s van Proalpha voor artikelen, voorraad en het terugschrijven van datums, productiemiddelen en terugmeldingen. INWB-berichtenstromen of het op n8n gebaseerde Integration Platform versturen productieorders met de bijbehorende bewerkingen. Voor de proefperiode en bulkimports worden bestandsexports gebruikt.
Waar komen de geplande datums in Proalpha terecht?
Bij de bewerking op de productieorder, via setWorkOrderOperationDates met begin- en eindtijdstippen. Als de engine de taak naar een andere machine heeft verplaatst, werkt changeWorkOrderOperationResource het productiemiddel bij.
Ondersteunt Proalpha webhooks?
Het Proalpha API Portal vermeldt geen API voor webhookabonnementen. Wijzigingen bereiken SkyPlanner via INWB-berichtenstromen, n8n-workflows of polling. De eigen webhooks van SkyPlanner zorgen ervoor dat het terugschrijven door gebeurtenissen wordt aangestuurd.
Kunnen terugmeldingen van operators naar Proalpha worden geboekt?
Ja. Tijdregistraties uit SkyPlanner Mobile Confirmations worden via operationDataEntry geboekt, met hoeveelheid, medewerkerstijd en tijd van het productiemiddel. Houd één terugmeldkanaal aan als er ook PDC-terminals in gebruik zijn.
Hebben we Proalpha APS nodig, en wat als we het al gebruiken?
U hebt het niet nodig. SkyPlanner stelt zelf een planning binnen de beschikbare capaciteit op aan de hand van uw productieorders, bewerkingen en productiemiddelen. Autopilot houdt deze actueel. Als Proalpha APS actief is, bepaalt u tijdens de scopebepaling welk systeem de bewerkingsdatums beheert. SkyPlanner schrijft dan alleen de datums waarvoor het verantwoordelijk is, zodat de twee planningen elkaar nooit overschrijven.
Kunnen we SkyPlanner testen voordat we de integratie bouwen?
Ja. Tijdens de gratis proefperiode van 30 dagen kunt u tot 20 werkcentra gebruiken met een CSV- of Excel-export van uw productieorders. Een creditcard is niet nodig. Start de proefperiode of neem contact op met sales om de scope van de integratie te bepalen.
