Integrationer / ERP / proALPHA ERP
Guide til proALPHA-integration til produktionsplanlægning med SkyPlanner APS
Denne guide til Proalpha-integration viser partnere og IT-teams, hvordan de forbinder Proalpha ERP med SkyPlanner APS. SkyPlanner udveksler data med Proalpha i begge retninger:
- Varer, produktionsordrer med operationer, ressourcer, kalendere, lagerbeholdninger og indkøbsordrer overføres til SkyPlanner.
- Planlagte start- og sluttidspunkter for hver operation sendes tilbage via setWorkOrderOperationDates.
- Ressourceændringer sendes tilbage via changeWorkOrderOperationResource.
- Operatørernes tilbagemeldinger sendes tilbage via operationDataEntry.
- SkyPlanner sender planændringer via webhooks, så snart de sker.
SkyPlanner-teamet tilpasser integrationen til jeres Proalpha-opsætning under opstarten og yder support efter idriftsættelsen. Denne guide er til partnere og udviklere, der vil deltage eller selv bygge en løsning med SkyPlanners dokumenterede REST API (API-reference).
Grænseflader i Proalpha
Proalpha ERP kører på Progress OpenEdge, og med Release 9 blev platformen flyttet til OpenEdge 12. (Proalpha) Fire grænseflader er relevante for detailplanlægningen.
- Proalpha ERP REST APIs. Den offentlige Proalpha API Portal indeholder 108 OpenAPI 3.0-specifikationer under
api/web/v1. Disse API’er bruges til tilbageskrivning og til at læse varer og lagerbeholdninger. - Integration Workbench (INWB). Proalpha skriver, at INWB “is a central platform which connects different IT systems, machines, sites” (er en central platform, som forbinder forskellige IT-systemer, maskiner og lokationer) og “converts the data into the format of the target system.” (konverterer data til målsystemets format). (Proalpha) Den modtager pAX-meddelelser via
POST /api/web/v1/inwb/message. Brug den til at overføre produktionsordrer til og fra Proalpha. - Proalpha Integration Platform. Platformen blev annonceret i april 2026 og er baseret på n8n. Den “will be available to customers either on-premises or in the cloud.” (vil være tilgængelig for kunder enten lokalt eller i skyen). Proalpha “will rely on an API-centric reference architecture and REST interfaces.” (vil basere sig på en API-centreret referencearkitektur og REST-grænseflader). (Proalpha)
- EDI og fileksport. INWB håndterer branchespecifikke filformater, og fileksport dækker behovet i SkyPlanners prøveperiode.
Endpoints til produktion
| Proalpha API | Endpoint | Anvendelse i integrationen |
|---|---|---|
| Production Workorder Operation Dates API V1 | POST /api/web/v1/pps/prod/setWorkOrderOperationDates | Planlagt start og slut for hver operation (guid, startTimePoint, endTimePoint) |
| Production Workorder Operation Resource API V1 | POST /api/web/v1/pps/prod/changeWorkOrderOperationResource | Ressource valgt under planlægningen (guid, resourceGUID) |
| Production Workorder Operation API V1 | POST /api/web/v1/pps/prod/operationDataEntry/{combined, setup, process} | Tilbagemeldinger: postingQty, scrapQty, finishOperation, employeeID, resourceTime |
| Part API | GET/POST /api/web/v1/master/part | Varer med partNumber, partType, quantityUnitCode |
| Material API V1 | GET /api/web/v1/mawi/MRPArea/{mrpAreaGuid}/part/{partGuid}/stock | Lagerbeholdning pr. MRP-område |
Autentificering
De offentliggjorte Proalpha-specifikationer bruger HTTP Basic-autentificering. Endpoints er miljøspecifikke, {schema}://{host}:{port}/api/web/v1/..., på jeres Proalpha-server eller i Proalpha Cloud. Opret en særskilt teknisk bruger med rettigheder begrænset til objekterne i mappingtabellen. Planlæg netværksadgangen fra SkyPlanners cloud til dette endpoint sammen med jeres IT-team.
Hos SkyPlanner bruger REST API’et et API-token til autentificering (SkyPlanner Settings > API) og er dokumenteret i Swagger/OpenAPI. Et API-token er nok til at komme i gang. Integrationsvejledningen gennemgår de første kald.
Hændelser og polling
Proalpha API Portal indeholder ikke noget API til webhook-abonnementer. Ændringer fra Proalpha overføres via:
- et INWB-meddelelsesflow, der sender nye og ændrede produktionsordrer med tilhørende operationer
- et n8n-workflow på Proalpha Integration Platform
- polling med faste intervaller af Material API for at hente lagerbeholdninger
SkyPlanner sender webhooks, når status eller planen ændres, så tilbageskrivningen til Proalpha er hændelsesstyret.
Datamapping
| Proalpha-objekt eller API | SkyPlanner-objekt | Retning | Hyppighed |
|---|---|---|---|
| Part (Part API) | Produkter og materialer | Proalpha → SkyPlanner | Første indlæsning, derefter ved ændringer |
| Produktets procesmodel: process, activities; BOM-linjer på produktionsordren | Produktstruktur, delprodukter, procestrin | Proalpha → SkyPlanner | Første indlæsning, derefter ved ændringer |
| Produktionsordre (Fertigungsauftrag) med antal og leveringsfrist | Ordre og opgaver med leveringsfrist og prioritet | Proalpha → SkyPlanner | Push via INWB eller n8n, eller med få minutters mellemrum |
| Operationer på produktionsordren: targetSetupTime, targetProcessTime, resource | Procestrin med omstillingstider og varigheder | Proalpha → SkyPlanner | Sammen med produktionsordren |
| Ressourcer, ressourcegrupper, alternative ressourcegrupper | Arbejdsstationer, arbejdsstationsgrupper, alternative arbejdsstationer | Proalpha → SkyPlanner | Første indlæsning |
| Blokke i ressourcekalenderen med intensity og overloadIntensity | Skift og arbejdsstationernes effektivitet | Proalpha → SkyPlanner | Første indlæsning; derefter dagligt eller vedligeholdt i SkyPlanner |
| Lagerbeholdning pr. MRP-område | Materialebeholdning | Proalpha → SkyPlanner | Hver time eller før hver planlægningskørsel |
| Indkøbsordrer med leveringsdato | Indgående materiale på leveringsdatoen | Proalpha → SkyPlanner | Hver time eller før hver planlægningskørsel |
| setWorkOrderOperationDates | Planlagt start og slut for hver operation | SkyPlanner → Proalpha | Ved planændringer via en SkyPlanner-webhook |
| changeWorkOrderOperationResource | Arbejdsstation valgt af planlægningsmotoren | SkyPlanner → Proalpha | Ved planændringer |
| operationDataEntry (setup, process, combined) | Tidsregistreringer og mængder fra Mobile Confirmations | SkyPlanner → Proalpha | Pr. tilbagemelding eller pr. skift |
| Planlægningsregler i SkyPlanner | Omstillingstidsmatrix, værktøjer som ressourcer med begrænset kapacitet, antal operatører | Vedligeholdes i SkyPlanner | Opsættes under opstarten |
Integrationsmønstre
1. Første indlæsning af stamdata. Læs varer via Part API, og indlæs ressourcer, ressourcegrupper og kalendere én gang via INWB eller en fileksport. Tag bevidst stilling til, hvilken arbejdsstation i SkyPlanner hver Proalpha-ressource skal knyttes til. Alternative ressourcegrupper bliver til alternative arbejdsstationer.
2. Ordresynkronisering. Et INWB-meddelelsesflow eller et n8n-workflow sender åbne produktionsordrer med deres operationer, normtider og ressourcer. Lagerbeholdningen hentes via Material API pr. MRP-område, og åbne indkøbsordrer hentes via INWB. SkyPlanner betragter bestilte materialer som tilgængelige på indkøbsordrens leveringsdato og opdaterer lagerbeholdningen, når indkøbsordren markeres som Delivered.
3. Tilbageskrivning af planen. For hver operation, som planlægningsmotoren har placeret eller flyttet, kalder integrationen setWorkOrderOperationDates med operationens guid samt start- og sluttidspunkt. Hvis motoren har valgt en anden ressource, kaldes derefter changeWorkOrderOperationResource.
4. Tilbagemeldinger fra produktionen. Operatørerne registrerer arbejdet med SkyPlanner Mobile Confirmations eller Production Timer. Tidsregistreringerne holder planen ajour og bogføres i Proalpha via operationDataEntry. Hvis I allerede bruger PDC-terminaler til tilbagemeldinger i produktionen, skal I holde jer til én kanal for at undgå dobbeltposteringer.
5. Regler for dataansvar og konflikter. Skriv dem ned før idriftsættelsen:
| Data | Ansvarligt system |
|---|---|
| Varer, procesmodeller, mængder, produktionsordrers status | Proalpha |
| Operationsrækkefølge, start- og sluttidspunkter, ressourcetildeling | SkyPlanner |
| Matrix for omstillingstider, værktøjer, antal operatører | SkyPlanner |
| Skift og fravær | Ét system, valgt under afklaringen |
| Tilbagemeldinger og lagerposteringer | Proalpha, med data fra SkyPlanner-tidsregistreringer eller PDC |
Hvis Proalpha APS eller Feinplanung er aktivt, skal I beslutte, hvilket system der har ansvaret for operationernes datoer. Hvis to planlægningssystemer skriver til de samme datoer, overskriver de hinanden. Med Autopilot omplanlægger SkyPlanner automatisk, når produktionen ændrer sig.
Typiske trin i projektet
Implementeringen er normalt afsluttet inden for få uger efter opstarten af onboarding. Inden da kan I bruge jeres egne data i den gratis prøveperiode på 30 dage. Eksportér åbne produktionsordrer, operationer og ressourcer fra Proalpha til CSV eller Excel, importér dem, og kontrollér planen.
- Workshop om mapping. Fastlæg mappingtabellen, reglerne for dataansvar, synkroniseringsintervallerne og kanalen til tilbagemeldinger sammen med jeres Proalpha-partner.
- Opsætning af grænseflader. Aktivér REST API’er og INWB-flows, opret den tekniske bruger, og åbn for netværksadgang. Først i testsystemet, derefter i produktionssystemet.
- Første dataindlæsning. Varer, ressourcer, ressourcegrupper og kalendere.
- Synkronisering af ordrer, lager og indkøbsordrer. Produktionsordrer sendes via INWB eller n8n, og lagerbeholdningen hentes med polling. Begge dele sættes op med genforsøg.
- Opsætning af begrænsninger i SkyPlanner. Matrix for omstillingstider, værktøjer, antal operatører og alternative arbejdsstationer.
- Tilbageskrivning af planen. setWorkOrderOperationDates og changeWorkOrderOperationResource; operationDataEntry tilføjes på dette trin.
- Paralleldrift. Sammenlign datoerne i SkyPlanner med den nuværende plan, og ret stamdata.
- Idriftsættelse. Aktivér tilbageskrivning, når data stemmer overens.
Det skal I tage højde for i en Proalpha-integration
- Intet ruteobjekt. Proalpha planlægger ud fra produkternes procesmodeller. Værktøjer, der er kopieret fra SAP- eller Business Central-projekter, leder efter ruter og overser derfor data. Læs operationer og BOM-linjer på produktionsordren.
- Intensitet i kalenderen. Kalenderblokke indeholder intensity og overloadIntensity. Map dem til skift og effektivitetsgrader i SkyPlanner i stedet for blot at kopiere timetallene.
- Måleenheder. Kontrollér quantityUnitCode, og om den normerede omstillingstid gælder pr. ordre eller pr. styk. Forkerte enheder giver forkerte varigheder overalt.
- Endpoints hos kunden. REST-laget kører på jeres Proalpha-server. Firewalls, porte og certifikater er afgørende for, hvornår projektet kan starte, så få adgangsforholdene på plads tidligt.
- Version. Få bekræftet hos jeres partner, hvilke REST API’er jeres Proalpha-version stiller til rådighed, før I fastlægger mappingen.
- Dokumentation kræver login. Proalphas onlinehjælp ligger bag login i Documentation Portal. Få feltnavnene bekræftet hos jeres partner i stedet for at gætte.
Hvem opsætter og supporterer Proalpha-integrationen?
- SkyPlanner-teamet opsætter integrationen under onboarding og yder support efter idriftsættelsen. Hver Proalpha-installation er modelleret forskelligt, og her kommer den erfaring i spil.
- Jeres Proalpha-partner kan deltage. Partneren kender jeres procesmodeller, INWB-flows og version og kan opsætte API-adgang. SkyPlanner stiller REST API, Swagger/OpenAPI-dokumentation og webhooks til rådighed.
- Jeres egne udviklere kan bygge videre på integrationen via samme REST API med et API-token. SkyPlanner-teamet hjælper efter behov. Produktdokumentationen er offentligt tilgængelig i SkyPlanners dokumentation.
SkyPlanner koster fra 199 € pr. måned med 5 arbejdsstationer inkluderet og månedlig fakturering. I får på forhånd et tilbud på integrationen ud fra jeres processer og behov sammen med abonnementet, så I kender den samlede pris, før I starter. Læs om Proalphas kapacitetsplanlægning i Har proALPHA produktionsplanlægning, der tager højde for den faktiske kapacitet?, få overblikket på proALPHA-siden, og se andre systemer i oversigten over ERP-integrationer.
Produktionsvirksomheders erfaringer med SkyPlanner
2 hsparet hver uge
“SkyPlanner har flyttet vores produktionsplanlægning fra Excel-ark til optimering af produktionen i realtid.”
Kalle Kalliomäki, forsyningskædespecialist
UTU · Eltavler og koblingsanlæg
Produktionsplanlægningen sparer 2 timers arbejdstid hver uge, og en ny opgavekø når frem til produktionslinjen på få sekunder.
+90%produktionseffektivitet
“Effektiviteten i produktionen er steget med 90%.”
Abdul Rucyinga, IT-chef
Laboratory & Allied · Lægemiddelproduktion
Produktionseffektiviteten er steget med 90%, og det tager under 30 minutter at lave en optimeret plan for tre måneder på tværs af alle arbejdsstationer.
99,2%leveringssikkerhed
“SkyPlanner har gjort det lettere at få øje på flaskehalse og skabt større overblik i produktionsstyringen.”
Toni Tuori, produktionschef
Piristeel · Tagsikkerhed og regnvandssystemer
Leveringssikkerheden nåede op på 99,2% i år, og planlægningen sparer op til fire timers arbejdstid om dagen.
Færrestop på grund af materialemangel
“Værdien af SkyPlanner for os er, at det er et værktøj, der fungerer i hverdagen, især når vi skal fastsætte leveringsdatoer.”
Tommi Männistö, chef for produktionsplanlægning
Eskomatic · Spåntagende bearbejdning som underleverandør
Automatisk belastningsplanlægning giver mere præcise leveringsdatoer, og antallet af produktionsstop på grund af materialemangel er faldet markant.
Ofte stillede spørgsmål
Hvilke Proalpha-grænseflader bruger integrationen?
Proalphas REST API’er bruges til varer, lagerbeholdning og tilbageskrivning af datoer, ressourcer og tilbagemeldinger. INWB-meddelelsesflows eller den n8n-baserede Integration Platform overfører produktionsordrer med deres operationer. Fileksporter bruges i prøveperioden og til masseindlæsning.
Hvor gemmes de planlagte datoer i Proalpha?
På produktionsordrens operation via setWorkOrderOperationDates med start- og sluttidspunkt. Hvis planlægningsmotoren har flyttet opgaven til en anden maskine, opdaterer changeWorkOrderOperationResource ressourcen.
Understøtter Proalpha webhooks?
Proalpha API Portal viser ingen API til webhook-abonnementer. Ændringer overføres til SkyPlanner via INWB-meddelelsesflows, n8n-workflows eller polling. SkyPlanners egne webhooks gør tilbageskrivningen hændelsesstyret.
Kan operatørernes tilbagemeldinger bogføres i Proalpha?
Ja. Tidsregistreringer fra SkyPlanner Mobile Confirmations bogføres via operationDataEntry med mængde, medarbejdertid og ressourcetid. Hold jer til én kanal til tilbagemeldinger, hvis I også bruger PDC-terminaler.
Har vi brug for Proalpha APS, og hvad hvis vi allerede bruger det?
I har ikke brug for det. SkyPlanner opbygger selv produktionsplanen ud fra jeres produktionsordrer, operationer og ressourcer under hensyntagen til den faktiske kapacitet, og Autopilot holder den ajour. Hvis Proalpha APS er aktivt, skal I under afklaringen beslutte, hvilket system der har ansvaret for operationernes datoer. SkyPlanner skriver derefter kun de datoer, det har ansvaret for, så de to planer aldrig overskriver hinanden.
Kan vi teste SkyPlanner, før vi bygger integrationen?
Ja. Den gratis prøveperiode på 30 dage understøtter op til 20 arbejdsstationer med en CSV- eller Excel-eksport af jeres produktionsordrer. Der kræves intet kreditkort. Start prøveperioden, eller kontakt salg for at afklare integrationens omfang.
