Integraatiot / ERP / proALPHA ERP
proALPHA-integraatio-opas tuotannonsuunnitteluun SkyPlanner APS:llä
Tämä Proalpha-integraatio-opas kertoo kumppaneille ja IT-tiimeille, miten Proalpha ERP yhdistetään SkyPlanner APS:ään. SkyPlannerin ja Proalphan integraatio toimii molempiin suuntiin:
- SkyPlanneriin tuodaan nimikkeet, työmääräimet työvaiheineen, resurssit, kalenterit, varastosaldot ja ostotilaukset.
- Kunkin työvaiheen suunniteltu alku- ja loppuaika palautetaan setWorkOrderOperationDates-kutsulla.
- Resurssimuutokset palautetaan changeWorkOrderOperationResource-kutsulla.
- Työntekijöiden kuittaukset palautetaan operationDataEntry-kutsulla.
- SkyPlannerin webhookit välittävät aikataulumuutokset heti niiden tapahtuessa.
SkyPlannerin tiimi määrittää integraation Proalpha-ympäristöösi sopivaksi käyttöönoton aikana ja tukee sitä myös tuotantokäytön alettua. Tämä opas on kumppaneille ja kehittäjille, jotka haluavat osallistua toteutukseen tai rakentaa integraation itse SkyPlannerin dokumentoidun REST API:n avulla (API-dokumentaatio).
Proalphan rajapinnat
Proalpha ERP toimii Progress OpenEdge -alustalla. Release 9:n myötä alusta päivitettiin OpenEdge 12:een. (Proalpha) Tuotannonsuunnittelun kannalta olennaisia rajapintoja on neljä.
- Proalpha ERP REST APIs. Julkinen Proalpha API Portal listaa 108 OpenAPI 3.0 -määritystä polun
api/web/v1alla. Näiden rajapintojen kautta tiedot kirjoitetaan takaisin sekä luetaan nimikkeet ja varastosaldot. - Integration Workbench (INWB). Proalpha kuvaa INWB:tä sanoin “is a central platform which connects different IT systems, machines, sites” (on keskitetty alusta, joka yhdistää eri IT-järjestelmät, koneet ja toimipaikat) ja “converts the data into the format of the target system.” (muuntaa tiedot kohdejärjestelmän muotoon). (Proalpha) Se vastaanottaa pAX-viestejä päätepisteen
POST /api/web/v1/inwb/messagekautta. Käytä sitä työmääräinten siirtämiseen Proalphasta ja Proalphaan. - Proalpha Integration Platform. Huhtikuussa 2026 julkistettu alusta perustuu n8n:ään. Proalphan mukaan se “will be available to customers either on-premises or in the cloud.” (tulee asiakkaiden saataville joko paikallisesti asennettuna tai pilvipalveluna). Proalpha “will rely on an API-centric reference architecture and REST interfaces.” (tulee tukeutumaan API-keskeiseen viitearkkitehtuuriin ja REST-rajapintoihin). (Proalpha)
- EDI ja tiedostoviennit. INWB käsittelee toimialakohtaisia tiedostomuotoja, ja tiedostoviennit riittävät SkyPlannerin kokeiluun.
Tuotannon päätepisteet
| Proalpha API | Päätepiste | Käyttö integraatiossa |
|---|---|---|
| Production Workorder Operation Dates API V1 | POST /api/web/v1/pps/prod/setWorkOrderOperationDates | Työvaihekohtaiset suunnitellut alku- ja loppuajat (guid, startTimePoint, endTimePoint) |
| Production Workorder Operation Resource API V1 | POST /api/web/v1/pps/prod/changeWorkOrderOperationResource | Suunnittelussa valittu resurssi (guid, resourceGUID) |
| Production Workorder Operation API V1 | POST /api/web/v1/pps/prod/operationDataEntry/{combined, setup, process} | Kuittaukset: postingQty, scrapQty, finishOperation, employeeID, resourceTime |
| Part API | GET/POST /api/web/v1/master/part | Nimikkeet ja niiden kentät partNumber, partType, quantityUnitCode |
| Material API V1 | GET /api/web/v1/mawi/MRPArea/{mrpAreaGuid}/part/{partGuid}/stock | Varastosaldot MRP-alueittain |
Tunnistautuminen
Julkaistuissa Proalpha-määrityksissä käytetään HTTP Basic -tunnistautumista. Päätepisteet ovat ympäristökohtaisia, {schema}://{host}:{port}/api/web/v1/..., ja sijaitsevat Proalpha-palvelimellasi tai Proalpha Cloudissa. Luo integraatiolle oma tekninen käyttäjätunnus ja rajaa sen oikeudet vastaavuustaulukon objekteihin. Suunnittele IT-tiimisi kanssa verkkoyhteys SkyPlannerin pilvestä kyseiseen päätepisteeseen.
SkyPlannerin REST API käyttää tunnistautumiseen API-tokenia (SkyPlanner Settings > API), ja sen dokumentaatio on Swagger/OpenAPI-muodossa. Alkuun pääsee pelkällä API-tokenilla. Integraation aloitusohje käy läpi ensimmäiset kutsut.
Tapahtumat ja määräajoin tehtävät kyselyt
Proalpha API Portal ei listaa rajapintaa webhook-tilausten tekemiseen. Proalphasta lähtevät muutokset välitetään seuraavilla tavoilla:
- INWB-viestivirralla, joka lähettää uudet ja muuttuneet työmääräimet työvaiheineen
- Proalpha Integration Platformin n8n-työnkululla
- hakemalla varastosaldot Material API:sta määräajoin tehtävillä kyselyillä
SkyPlanner lähettää webhook-ilmoituksia tilan tai aikataulun muuttuessa, joten tietojen kirjoittaminen takaisin Proalphaan perustuu tapahtumiin.
Tietojen vastaavuudet
| Proalphan objekti tai API | SkyPlannerin objekti | Suunta | Siirtotiheys |
|---|---|---|---|
| Part (Part API) | Tuotteet ja materiaalit | Proalpha → SkyPlanner | Alkulataus, sen jälkeen muutosten yhteydessä |
| Tuotteen prosessimalli: prosessi ja toiminnot; työmääräimen BOM-rivit | Tuoterakenne, alituotteet, työvaiheet | Proalpha → SkyPlanner | Alkulataus, sen jälkeen muutosten yhteydessä |
| Työmääräin (Fertigungsauftrag), määrä ja määräpäivä | Tilaus ja työt, määräpäivä ja prioriteetti | Proalpha → SkyPlanner | INWB:n tai n8n:n lähettämänä tai muutaman minuutin välein |
| Työmääräimen työvaiheet: targetSetupTime, targetProcessTime, resource | Työvaiheet asetusaikoineen ja kestoineen | Proalpha → SkyPlanner | Työmääräimen mukana |
| Resurssit, resurssiryhmät, vaihtoehtoiset resurssiryhmät | Työpisteet, työpisteryhmät, vaihtoehtoiset työpisteet | Proalpha → SkyPlanner | Alkulataus |
| Resurssikalenterin jaksot ja niiden kentät intensity ja overloadIntensity | Työvuorot ja työpisteiden tehokkuudet | Proalpha → SkyPlanner | Alkulataus; sen jälkeen päivittäin tai ylläpito SkyPlannerissa |
| Varastosaldot MRP-alueittain | Materiaalien varastosaldot | Proalpha → SkyPlanner | Tunneittain tai ennen jokaista suunnitteluajoa |
| Ostotilaukset toimituspäivineen | Saapuva materiaali toimituspäivänään | Proalpha → SkyPlanner | Tunneittain tai ennen jokaista suunnitteluajoa |
| setWorkOrderOperationDates | Työvaihekohtaiset suunnitellut alku- ja loppuajat | SkyPlanner → Proalpha | Aikataulun muuttuessa SkyPlannerin webhookin kautta |
| changeWorkOrderOperationResource | Laskentamoottorin valitsema työpiste | SkyPlanner → Proalpha | Aikataulun muuttuessa |
| operationDataEntry (setup, process, combined) | Aikakirjaukset ja määrät Mobile Confirmations -toiminnosta | SkyPlanner → Proalpha | Kuittaus- tai työvuorokohtaisesti |
| SkyPlannerin suunnittelusäännöt | Asetusaikamatriisi, työkalut rajallisen kapasiteetin resursseina, työntekijämäärät | Ylläpidetään SkyPlannerissa | Määritetään käyttöönoton aikana |
Integraation toteutusmallit
1. Perustietojen alkulataus. Lue nimikkeet Part API:n kautta ja lataa resurssit, resurssiryhmät ja kalenterit kertaalleen INWB:n tai tiedostoviennin avulla. Määritä huolellisesti, mitä SkyPlannerin työpistettä kukin Proalphan resurssi vastaa. Vaihtoehtoisista resurssiryhmistä muodostetaan vaihtoehtoiset työpisteet.
2. Tilausten synkronointi. INWB-sanomavirta tai n8n-työnkulku lähettää avoimet työmääräimet työvaiheineen, tavoiteaikoineen ja resursseineen. Varastosaldot haetaan Material API -rajapinnasta MRP-alueittain ja avoimet ostotilaukset INWB:n kautta. SkyPlanner käsittelee tilatun materiaalin saatavilla olevana ostotilauksen toimituspäivänä ja päivittää varastosaldon, kun ostotilauksen tilaksi merkitään Delivered.
3. Aikataulun takaisinkirjoitus. Integraatio kutsuu setWorkOrderOperationDates-toimintoa jokaiselle työvaiheelle, jonka laskentamoottori on sijoittanut aikatauluun tai siirtänyt. Kutsussa välitetään työvaiheen guid sekä alku- ja loppuaika. Jos laskentamoottori valitsi toisen resurssin, sen jälkeen kutsutaan changeWorkOrderOperationResource-toimintoa.
4. Tuotannon kuittaukset. Työntekijät kirjaavat työnsä SkyPlanner Mobile Confirmations – tai Production Timer -toiminnolla. Aikakirjaukset pitävät aikataulun ajan tasalla ja siirtyvät Proalphaan operationDataEntry-toiminnon kautta. Jos tehtaalla tehdään jo kuittauksia PDC-päätteillä, käytä vain yhtä kuittauskanavaa päällekkäisten kirjausten välttämiseksi.
5. Tietojen omistajuus ja ristiriitojen käsittely. Kirjaa säännöt ennen tuotantokäyttöön siirtymistä:
| Tiedot | Omistaja |
|---|---|
| Nimikkeet, prosessimallit, määrät, työmääräimen tila | Proalpha |
| Työvaiheiden järjestys, alku- ja loppuajat, resurssien valinta | SkyPlanner |
| Asetusaikamatriisi, työkalut, työntekijämäärät | SkyPlanner |
| Työvuorot ja poissaolot | Yksi määrittelyssä valittu järjestelmä |
| Kuittaukset ja varastokirjaukset | Proalpha, johon tiedot tulevat SkyPlannerin aikakirjauksista tai PDC:stä |
Jos Proalpha APS tai Feinplanung on käytössä, päätä, kumpi järjestelmä hallitsee työvaiheiden aikoja. Jos kaksi suunnittelujärjestelmää kirjoittaa samoja aikoja, ne ylikirjoittavat toistensa tiedot. Autopilot-toiminnon avulla SkyPlanner päivittää aikataulun automaattisesti tuotannon muuttuessa.
Projektin tyypilliset vaiheet
Käyttöönotto valmistuu tavallisesti viikkojen kuluessa sen aloittamisesta. Sitä ennen voit kokeilla ohjelmistoa maksutta 30 päivän ajan omilla tiedoillasi. Vie avoimet työmääräimet, työvaiheet ja resurssit Proalphasta CSV- tai Excel-tiedostoon, tuo ne SkyPlanneriin ja tarkista aikataulu.
- Tietovastaavuuksien työpaja. Sovi Proalpha-kumppanisi kanssa vastaavuustaulukon sisällöstä, omistajuussäännöistä, synkronointiväleistä ja kuittauskanavasta.
- Rajapintojen käyttöönotto. Ota REST API -rajapinnat ja INWB-sanomavirrat käyttöön, luo tekninen käyttäjä ja avaa verkkoyhteydet. Tee tämä ensin testijärjestelmässä ja sitten tuotannossa.
- Alkulataus. Nimikkeet, resurssit, resurssiryhmät ja kalenterit.
- Työmääräinten, varastosaldojen ja ostotilausten synkronointi. Työmääräimet lähetetään INWB:n tai n8n:n kautta ja varastosaldot haetaan kyselyillä. Siirtoihin määritetään uudelleenyritykset.
- Rajoitteiden määritys SkyPlannerissa. Asetusaikamatriisi, työkalut, työntekijämäärät ja vaihtoehtoiset työpisteet.
- Aikataulun takaisinkirjoitus. setWorkOrderOperationDates ja changeWorkOrderOperationResource; tässä vaiheessa lisätään myös operationDataEntry.
- Rinnakkaisajo. Vertaa SkyPlannerin aikoja nykyiseen suunnitelmaan ja korjaa perustiedot.
- Tuotantokäyttöön siirtyminen. Ota takaisinkirjoitus käyttöön, kun tiedot täsmäävät.
Mitä Proalpha-integraatiossa on huomioitava
- Ei reititysobjektia. Proalpha käyttää suunnittelussa tuotteiden prosessimalleja. SAP- tai Business Central -projekteista kopioidut työkalut etsivät reitityksiä, jolloin osa tiedoista jää löytymättä. Lue työmääräimeltä työvaiheet ja BOM-rivit.
- Kalenterin tehokkuustiedot. Kalenterijaksoissa on kentät intensity ja overloadIntensity. Muunna ne SkyPlannerin työvuoroiksi ja tehokkuuksiksi sen sijaan, että kopioisit pelkät tuntimäärät.
- Mittayksiköt. Tarkista quantityUnitCode ja se, onko tavoiteasetusaika tilaus- vai kappalekohtainen. Väärät yksiköt vääristävät kaikkia kestoja.
- Rajapintapäätepisteet asiakkaan palvelimella. REST-kerros toimii omalla Proalpha-palvelimellasi. Palomuurit, portit ja varmenteet ratkaisevat projektin aloitusajankohdan, joten hoida tarvittavat avaukset ja varmenteet ajoissa.
- Ohjelmistoversio. Varmista kumppaniltasi, mitkä REST API -rajapinnat Proalpha-versiosi tarjoaa, ennen kuin lyöt tietovastaavuudet lukkoon.
- Kirjautumista vaativa dokumentaatio. Proalphan verkko-ohjeet ovat Documentation Portal -portaalissa kirjautumisen takana. Varmista kenttien nimet kumppaniltasi arvaamisen sijaan.
Kuka määrittää Proalpha-integraation ja vastaa sen tuesta?
- SkyPlanner-tiimi määrittää integraation käyttöönoton aikana ja tukee sitä tuotantokäytössä. Jokainen Proalpha-ympäristö on mallinnettu eri tavoin, ja juuri tässä tiimin osaamista tarvitaan.
- Proalpha-kumppanisi voi osallistua. Kumppani tuntee prosessimallisi, INWB-sanomavirtasi ja ohjelmistoversiosi ja voi järjestää API-yhteydet. SkyPlanner tarjoaa REST API -rajapinnan, Swagger/OpenAPI-dokumentaation ja webhookit.
- Omat kehittäjäsi voivat jatkaa integraation kehittämistä saman REST API -rajapinnan kautta API-tunnisteella. SkyPlanner-tiimi auttaa tarvittaessa. Tuotedokumentaatio on julkisesti saatavilla SkyPlannerin dokumentaatiosivustolla.
SkyPlannerin hinta on alkaen 199 € kuukaudessa, ja se sisältää 5 työpistettä. Laskutus on kuukausittainen. Saat etukäteen tarjouksen palvelupaketista ja prosessisi ja tarpeidesi mukaisesta integraatiosta, joten tiedät kokonaiskustannukset ennen aloittamista. Lue Proalphan kapasiteettisuunnittelusta artikkelista Onko proALPHAssa hienokuormitus?, tutustu yleiskatsaukseen proALPHA-sivulla ja muihin järjestelmiin ERP-integraatioiden sivulla.
Valmistavan teollisuuden kokemuksia SkyPlannerista
2 hsäästöä joka viikko
”SkyPlanner on vienyt tuotannonsuunnittelumme Excel-taulukoista reaaliaikaiseen tuotannon optimointiin.”
Kalle Kalliomäki, toimitusketjuasiantuntija
UTU · Sähkökeskukset ja kojeistot
Tuotannonsuunnittelussa säästyy 2 tuntia työaikaa joka viikko, ja uusi työjono saadaan linjalle sekunneissa.
+90%tuotantotehokkuutta
”Tuotannon tehokkuus on kasvanut 90 %.”
Abdul Rucyinga, IT-johtaja
Laboratory & Allied · Lääkkeiden valmistus
Tuotannon tehokkuus on kasvanut 90 %, ja kaikki työpisteet kattava optimoitu kolmen kuukauden suunnitelma valmistuu alle 30 minuutissa.
99,2 %toimitusvarmuus
”SkyPlanner on auttanut tunnistamaan pullonkaulat ja selkeyttänyt tuotannonohjausta.”
Toni Tuori, tuotantopäällikkö
Piristeel · Kattoturva- ja sadevesijärjestelmät
Toimitusvarmuus nousi tänä vuonna 99,2 %:iin, ja tuotannonsuunnittelussa säästyy jopa neljä tuntia työaikaa päivässä.
Vähemmänmateriaalipuutteista johtuvia seisokkeja
”SkyPlannerin arvo meille on siinä, että se on arjessa toimiva työkalu erityisesti toimituspäivien määrittämiseen.”
Tommi Männistö, tuotannonsuunnittelupäällikkö
Eskomatic · Sopimuskoneistus
Automaattinen kuormitussuunnittelu tarkentaa toimituspäiviä, ja materiaalipuutteista johtuvat tuotantoseisokit ovat vähentyneet huomattavasti.
Usein kysytyt kysymykset
Mitä Proalphan rajapintoja integraatio käyttää?
Proalphan REST API -rajapintoja käytetään nimikkeiden ja varastosaldojen lukemiseen sekä aikojen, resurssien ja kuittausten takaisinkirjoitukseen. INWB-sanomavirrat tai n8n-pohjainen Integration Platform välittävät työmääräimet työvaiheineen. Kokeilussa ja massalatauksissa käytetään tiedostovientejä.
Mihin suunnitellut ajat tallentuvat Proalphassa?
Työmääräimen työvaiheelle setWorkOrderOperationDates-toiminnolla, jolle välitetään alku- ja loppuajankohdat. Jos laskentamoottori siirsi työn toiselle koneelle, changeWorkOrderOperationResource päivittää resurssin.
Tukeeko Proalpha webhookeja?
Proalpha API Portal ei luettele webhook-tilausten API-rajapintaa. Muutokset välittyvät SkyPlanneriin INWB-sanomavirtojen, n8n-työnkulkujen tai toistuvien kyselyjen kautta. SkyPlannerin omat webhookit tekevät takaisinkirjoituksesta tapahtumapohjaisen.
Voiko työntekijöiden kuittaukset siirtää Proalphaan?
Kyllä. SkyPlanner Mobile Confirmations -toiminnon aikakirjaukset siirtyvät operationDataEntry-toiminnon kautta määrineen sekä työntekijä- ja resurssiaikoineen. Käytä vain yhtä kuittauskanavaa, jos käytössä on myös PDC-päätteitä.
Tarvitsemmeko Proalpha APS:n, ja entä jos se on jo käytössä?
Ette tarvitse sitä. SkyPlanner muodostaa itse todellisen kapasiteetin huomioivan aikataulun työmääräimistä, työvaiheista ja resursseista, ja Autopilot pitää sen ajan tasalla. Jos Proalpha APS on käytössä, päättäkää määrittelyssä, kumpi järjestelmä hallitsee työvaiheiden aikoja. SkyPlanner kirjoittaa tällöin vain sen vastuulle kuuluvat ajat, joten suunnitelmat eivät koskaan ylikirjoita toisiaan.
Voimmeko kokeilla SkyPlanneria ennen integraation rakentamista?
Kyllä. Ilmaisessa 30 päivän kokeilussa voit käyttää enintään 20 työpistettä ja tuoda työmääräimesi CSV- tai Excel-tiedostona. Luottokorttia ei tarvita. Aloita kokeilu tai ota yhteyttä myyntiin integraation määrittelyä varten.
