Integrationer / ERP / proALPHA ERP
Guide till proALPHA-integration för produktionsplanering med SkyPlanner APS
Den här integrationsguiden visar partner och IT-team hur de kopplar Proalpha ERP till SkyPlanner APS. SkyPlanner integreras med Proalpha i båda riktningarna:
- Artiklar, tillverkningsorder med operationer, resurser, kalendrar, lagersaldon och inköpsorder läses in.
- Planerad start- och sluttid för varje operation återförs via setWorkOrderOperationDates.
- Resursändringar återförs via changeWorkOrderOperationResource.
- Operatörernas återrapporteringar skickas tillbaka via operationDataEntry.
- SkyPlanners webhooks skickar ändringar i planen så snart de sker.
SkyPlanner-teamet konfigurerar integrationen för er Proalpha-miljö under införandet och ger support efter driftsättningen. Guiden riktar sig till partner och utvecklare som vill delta eller själva bygga vidare på SkyPlanners dokumenterade REST API (API-referens).
Gränssnitten i Proalpha
Proalpha ERP körs på Progress OpenEdge, och med Release 9 flyttades plattformen till OpenEdge 12. (Proalpha) Fyra gränssnitt är relevanta för produktionsplaneringen.
- Proalpha ERP REST APIs. Den offentliga Proalpha API Portal listar 108 OpenAPI 3.0-specifikationer under
api/web/v1. Dessa API:er används för återföring av data samt för inläsning av artiklar och lagersaldon. - Integration Workbench (INWB). Proalpha beskriver INWB så här: ”is a central platform which connects different IT systems, machines, sites” (är en central plattform som kopplar samman olika IT-system, maskiner och anläggningar) och ”converts the data into the format of the target system.” (konverterar data till målsystemets format). (Proalpha) INWB tar emot pAX-meddelanden via
POST /api/web/v1/inwb/message. Använd det för flöden av tillverkningsorder till och från Proalpha. - Proalpha Integration Platform. Plattformen presenterades i april 2026 och bygger på n8n. Den ”will be available to customers either on-premises or in the cloud.” (kommer att vara tillgänglig för kunder antingen lokalt eller i molnet). Proalpha ”will rely on an API-centric reference architecture and REST interfaces.” (kommer att använda en API-centrerad referensarkitektur och REST-gränssnitt). (Proalpha)
- EDI och filexport. INWB hanterar branschspecifika filformat, och filexport räcker för att prova SkyPlanner.
API-endpoints för produktion
| Proalpha API | API-endpoint | Användning i integrationen |
|---|---|---|
| Production Workorder Operation Dates API V1 | POST /api/web/v1/pps/prod/setWorkOrderOperationDates | Planerad start- och sluttid per operation (guid, startTimePoint, endTimePoint) |
| Production Workorder Operation Resource API V1 | POST /api/web/v1/pps/prod/changeWorkOrderOperationResource | Resurs som valts vid planeringen (guid, resourceGUID) |
| Production Workorder Operation API V1 | POST /api/web/v1/pps/prod/operationDataEntry/{combined, setup, process} | Återrapporteringar: postingQty, scrapQty, finishOperation, employeeID, resourceTime |
| Part API | GET/POST /api/web/v1/master/part | Artiklar med partNumber, partType, quantityUnitCode |
| Material API V1 | GET /api/web/v1/mawi/MRPArea/{mrpAreaGuid}/part/{partGuid}/stock | Lagersaldo per MRP-område |
Autentisering
De publicerade Proalpha-specifikationerna använder HTTP Basic-autentisering. API-endpoints är miljöspecifika, {schema}://{host}:{port}/api/web/v1/..., på er Proalpha-server eller i Proalpha Cloud. Skapa ett separat tekniskt användarkonto med behörigheter begränsade till objekten i mappningstabellen. Planera nätverksåtkomsten från SkyPlanners moln till denna endpoint tillsammans med ert IT-team.
SkyPlanners REST API använder en API-token för autentisering (SkyPlanner Settings > API) och är dokumenterat i Swagger/OpenAPI. En API-token räcker för att komma igång. Integrationshandledningen går igenom de första anropen.
Händelser och pollning
Proalpha API Portal listar inget API för webhook-prenumerationer. Ändringar skickas från Proalpha via:
- ett meddelandeflöde i INWB som skickar nya och ändrade tillverkningsorder med tillhörande operationer
- ett n8n-arbetsflöde på Proalpha Integration Platform
- schemalagd pollning av Material API för lagersaldon
SkyPlanner skickar webhooks när status eller planen ändras. Återföringen till Proalpha är därför händelsestyrd.
Datamappning
| Objekt eller API i Proalpha | Objekt i SkyPlanner | Riktning | Frekvens |
|---|---|---|---|
| Part (Part API) | Produkter och material | Proalpha → SkyPlanner | Första inläsningen, därefter vid ändringar |
| Produktens processmodell: process, aktiviteter; BOM-rader i tillverkningsordern | Produktstruktur, delprodukter, processteg | Proalpha → SkyPlanner | Första inläsningen, därefter vid ändringar |
| Tillverkningsorder (Fertigungsauftrag) med kvantitet och färdigdatum | Order och operationer med färdigdatum och prioritet | Proalpha → SkyPlanner | Push via INWB eller n8n, alternativt med några minuters mellanrum |
| Tillverkningsorderns operationer: targetSetupTime, targetProcessTime, resource | Processteg med ställtider och varaktigheter | Proalpha → SkyPlanner | Tillsammans med tillverkningsordern |
| Resurser, resursgrupper, alternativa resursgrupper | Produktionsgrupper, grupper av produktionsgrupper, alternativa produktionsgrupper | Proalpha → SkyPlanner | Första inläsningen |
| Block i resurskalendern med intensity och overloadIntensity | Skift och produktionsgruppernas effektivitet | Proalpha → SkyPlanner | Första inläsningen; därefter dagligen eller underhåll i SkyPlanner |
| Lagersaldo per MRP-område | Materialsaldo | Proalpha → SkyPlanner | Varje timme eller före varje planeringskörning |
| Inköpsorder med leveransdatum | Inkommande material på leveransdatumet | Proalpha → SkyPlanner | Varje timme eller före varje planeringskörning |
| setWorkOrderOperationDates | Planerad start- och sluttid per operation | SkyPlanner → Proalpha | När planen ändras, via en webhook från SkyPlanner |
| changeWorkOrderOperationResource | Produktionsgrupp som planeringsmotorn valt | SkyPlanner → Proalpha | När planen ändras |
| operationDataEntry (setup, process, combined) | Tidsregistreringar och kvantiteter från Mobile Confirmations | SkyPlanner → Proalpha | Vid varje återrapportering eller per skift |
| Planeringsregler i SkyPlanner | Ställtidsmatris, verktyg som resurser med begränsad kapacitet, antal operatörer | Underhålls i SkyPlanner | Konfigureras under införandet |
Integrationsmönster
1. Första inläsningen av grunddata. Läs in artiklar via Part API och gör en engångsinläsning av resurser, resursgrupper och kalendrar via INWB eller filexport. Mappa varje Proalpha-resurs noggrant till en produktionsgrupp i SkyPlanner. Alternativa resursgrupper blir alternativa produktionsgrupper.
2. Ordersynkronisering. Ett INWB-meddelandeflöde eller n8n-arbetsflöde skickar öppna tillverkningsorder med operationer, normtider och resurser. Lagersaldon hämtas via Material API per MRP-område och öppna inköpsorder via INWB. SkyPlanner räknar beställt material som tillgängligt på inköpsorderns leveransdatum och uppdaterar lagersaldot när inköpsordern markeras som Delivered.
3. Återskrivning av planen. För varje operation som planeringsmotorn har lagt in eller flyttat anropar integrationen setWorkOrderOperationDates med operationens guid samt start- och sluttid. Om motorn har valt en annan resurs anropas därefter changeWorkOrderOperationResource.
4. Återrapportering från produktionen. Operatörerna registrerar arbetet med SkyPlanner Mobile Confirmations eller Production Timer. Tidsregistreringarna håller planen aktuell och förs över till Proalpha via operationDataEntry. Om fabriken redan återrapporterar via PDC-terminaler ska ni använda en enda kanal för att undvika dubbla registreringar.
5. Regler för dataägarskap och konflikter. Dokumentera dem före driftstart:
| Data | Ägare |
|---|---|
| Artiklar, processmodeller, kvantiteter, tillverkningsorderns status | Proalpha |
| Operationsföljd, start- och sluttider, resurstilldelning | SkyPlanner |
| Ställtidsmatris, verktyg, antal operatörer | SkyPlanner |
| Skift och frånvaro | Ett system, valt under kartläggningen |
| Återrapportering och lagertransaktioner | Proalpha, med underlag från SkyPlanners tidsregistreringar eller PDC |
Om Proalpha APS eller Feinplanung är aktivt behöver ni bestämma vilket system som äger operationernas datum. Om två planeringssystem uppdaterar samma datum skriver de över varandras uppgifter. Med Autopilot planerar SkyPlanner om automatiskt när produktionen förändras.
Vanliga projektsteg
Implementeringen är normalt klar inom några veckor efter att införandet har påbörjats. Innan dess kan ni använda era egna data under den kostnadsfria provperioden på 30 dagar. Exportera öppna tillverkningsorder, operationer och resurser från Proalpha till CSV eller Excel, importera dem och validera planen.
- Workshop om datamappning. Fastställ mappningstabellen, reglerna för dataägarskap, synkroniseringsintervallen och kanalen för återrapportering tillsammans med er Proalpha-partner.
- Konfigurera gränssnitten. Aktivera REST API:erna och INWB-flödena, skapa den tekniska användaren och öppna nätverksåtkomsten. Börja i testsystemet och gå sedan vidare till produktionssystemet.
- Första inläsningen. Artiklar, resurser, resursgrupper och kalendrar.
- Synkronisera order, lagersaldon och inköpsorder. Tillverkningsorder skickas via INWB eller n8n och lagersaldon hämtas genom polling, med återförsök.
- Konfigurera begränsningar i SkyPlanner. Ställtidsmatris, verktyg, antal operatörer och alternativa produktionsgrupper.
- Återskrivning av planen. setWorkOrderOperationDates och changeWorkOrderOperationResource; här läggs även operationDataEntry till.
- Parallellkörning. Jämför SkyPlanners datum med den befintliga planen och rätta grunddata.
- Driftstart. Aktivera återskrivningen när uppgifterna stämmer överens.
Att tänka på inför en integration med Proalpha
- Inget objekt för operationsföljder. Proalpha planerar utifrån produkternas processmodeller. Verktyg som kopierats från SAP- eller Business Central-projekt söker efter operationsföljder och missar data. Läs i stället operationer och BOM-rader från tillverkningsordern.
- Kalenderns belastningsgrad. Kalenderblock innehåller intensity och overloadIntensity. Mappa dem till skift och effektivitetsnivåer i SkyPlanner i stället för att bara kopiera antalet timmar.
- Måttenheter. Kontrollera quantityUnitCode och om den planerade ställtiden gäller per order eller per styck. Fel enheter ger fel i samtliga tidsberäkningar.
- Endpoints i kundens miljö. REST-lagret körs på er Proalpha-server. Brandväggar, portar och certifikat avgör när projektet kan starta, så ordna åtkomsten i god tid.
- Version. Kontrollera med er partner vilka REST API:er er Proalpha-version tillhandahåller innan ni fastställer mappningen.
- Dokumentation som kräver inloggning. Proalphas onlinehjälp finns bakom inloggning i Documentation Portal. Bekräfta fältnamnen med er partner i stället för att gissa.
Integrationen med Proalpha: vem konfigurerar den och ger support?
- SkyPlanner-teamet konfigurerar integrationen under införandet och ger support efter driftstart. Varje Proalpha-installation är modellerad på sitt sätt, och här kommer den kunskapen till användning.
- Er Proalpha-partner kan delta. Partnern känner till era processmodeller, INWB-flöden och er version och kan ordna API-åtkomsten. SkyPlanner tillhandahåller REST API, Swagger/OpenAPI-dokumentation och webhooks.
- Era egna utvecklare kan bygga vidare på integrationen via samma REST API med en API-token. SkyPlanner-teamet hjälper till vid behov. Produktdokumentationen är öppet tillgänglig i SkyPlanners dokumentation.
SkyPlanner kostar från 199 € per månad med 5 produktionsgrupper inkluderade och faktureras månadsvis. Ni får en offert på integrationen utifrån era processer och behov, tillsammans med abonnemanget, så att ni ser hela kostnaden innan ni börjar. Läs om hur Proalpha planerar kapacitet i Har proALPHA finplanering?, få en överblick på sidan om proALPHA och se andra system i översikten över ERP-integrationer.
Tillverkningsföretagens omdömen om SkyPlanner
2 hsparade varje vecka
”SkyPlanner har tagit vår produktionsplanering från Excel-kalkylblad till produktionsoptimering i realtid.”
Kalle Kalliomäki, specialist inom försörjningskedjan
UTU · Elcentraler och ställverk
Produktionsplaneringen sparar 2 timmars arbetstid varje vecka, och en ny arbetskö når produktionslinjen på några sekunder.
+90%produktionseffektivitet
”Effektiviteten i produktionen har ökat med 90%.”
Abdul Rucyinga, IT-chef
Laboratory & Allied · Läkemedelstillverkning
Produktionseffektiviteten har ökat med 90%, och det tar under 30 minuter att skapa en optimerad plan för tre månader för samtliga produktionsgrupper.
99,2%leveransprecision
”SkyPlanner har gjort det lättare att identifiera flaskhalsar och skapat tydlighet i produktionsstyrningen.”
Toni Tuori, produktionschef
Piristeel · Taksäkerhet och takavvattningssystem
Leveransprecisionen nådde 99,2% i år, och produktionsplaneringen sparar upp till fyra timmars arbetstid per dag.
Färrestopp på grund av materialbrist
”Värdet med SkyPlanner för oss är att det är ett verktyg som fungerar i vardagen, särskilt när vi ska fastställa leveransdatum.”
Tommi Männistö, produktionsplaneringschef
Eskomatic · Legobearbetning
Automatisk beläggningsplanering ger mer exakta leveransdatum, och produktionsstoppen på grund av materialbrist har minskat kraftigt.
Vanliga frågor
Vilka gränssnitt i Proalpha använder integrationen?
Proalphas REST API:er används för artiklar, lagersaldon och återskrivning av datum, resurser och återrapportering. INWB-meddelandeflöden eller den n8n-baserade Integration Platform överför tillverkningsorder med tillhörande operationer. Filexporter används under provperioden och för massinläsningar.
Var hamnar de planerade datumen i Proalpha?
På tillverkningsorderns operation, via setWorkOrderOperationDates med start- och sluttidpunkter. Om planeringsmotorn har flyttat operationen till en annan maskin uppdateras resursen via changeWorkOrderOperationResource.
Har Proalpha stöd för webhooks?
Proalpha API Portal listar inget API för webhook-prenumerationer. Ändringar når SkyPlanner via INWB-meddelandeflöden, n8n-arbetsflöden eller polling. SkyPlanners egna webhooks gör återskrivningen händelsestyrd.
Kan operatörernas återrapportering föras över till Proalpha?
Ja. Tidsregistreringar från SkyPlanner Mobile Confirmations förs över via operationDataEntry med kvantitet, medarbetartid och resurstid. Använd en enda kanal för återrapportering om PDC-terminaler också används.
Behöver vi Proalpha APS, och vad gäller om vi redan använder det?
Nej, det behövs inte. SkyPlanner skapar själv en kapacitetsanpassad produktionsplan utifrån era tillverkningsorder, operationer och resurser, och Autopilot håller den aktuell. Om Proalpha APS är aktivt bestämmer ni under kartläggningen vilket system som äger operationernas datum. SkyPlanner skriver sedan bara de datum som det äger, så att de två planerna aldrig skriver över varandra.
Kan vi testa SkyPlanner innan vi bygger integrationen?
Ja. Under den kostnadsfria provperioden på 30 dagar kan ni använda upp till 20 produktionsgrupper med en CSV- eller Excel-export av era tillverkningsorder. Inget kreditkort behövs. Starta provperioden eller kontakta säljteamet för att kartlägga integrationen.
