Integraatiot / ERP / HELIOS
HELIOS-integraatio-opas tuotannonsuunnitteluun SkyPlanner APS:llä
Tämä HELIOS-integraatio-opas kertoo kumppaneille ja IT-tiimeille, miten HELIOS iNuvio ja HELIOS Nephrite yhdistetään SkyPlanner APS:ään. SkyPlanner integroituu HELIOS-järjestelmään kaksisuuntaisesti HELIOSin omien rajapintojen kautta:
- SkyPlanneriin tuodaan tuotantotilaukset (výrobní příkazy) työvaiheineen, valmistettavat osat, osaluettelot, reititykset, työpisteet, koneet, ammattiryhmät, henkilöstöresurssit, varastotiedot ja ostotilaukset.
- Suunnitellut aloitus- ja valmistumispäivät palautetaan tuotantotilauksille.
- Työntekijöiden aikakirjaukset voidaan halutessasi palauttaa työvaihekirjauksina (evidence výrobních operací).
- SkyPlannerin webhookit lähettävät aikataulumuutokset heti niiden tapahtuessa.
SkyPlanner-tiimi määrittää integraation HELIOS-ympäristöösi sopivaksi käyttöönoton aikana ja tukee sitä tuotantokäytön alettua. Tämä opas on tarkoitettu HELIOS-kumppaneille ja kehittäjille, jotka haluavat osallistua toteutukseen tai rakentaa sen itse SkyPlannerin dokumentoidun REST API -rajapinnan varaan (API-dokumentaatio).
HELIOSin integraatiorajapinnat
Helios Inuvio Server (Inuvio REST API). Asseco kuvaa sitä HELIOS iNuvion erilliseksi osaksi, joka tarjoaa REST API -yhteyden HELIOS iNuvion toimintoihin (Helios Inuvio Serverin ohje). Se toimitetaan iNuvion mukana, ja OpenAPI-määritys julkaistaan Rapidoc- ja Redoc-muodossa. Rajapinta käyttää HELIOSin luettelonäkymiä (browses), joista jokaisella on oma tunniste ja omat käyttöoikeudet:
- GET /browses/list ja GET /browses/meta listaavat käytettävissä olevat näkymät ja niiden sarakkeet.
- /browses/data lukee näkymän rivejä ja kirjoittaa niitä, jos näkymä sallii rivien luonnin, päivityksen ja poiston.
- /api/v1/actions/meta ja /api/v1/actions/execute/{dbName}/{browseIdent}/{actionIdent} suorittavat näkymässä ulkoisia toimintoja. Tällä hetkellä tuettuja ulkoisten toimintojen tyyppejä ovat Procedure, Browse ja Plugin.
Tuotannonsuunnittelijan käyttämiä tuotantonäkymiä ovat tuotantosuunnitelma (výrobní plán), tuotantotilaukset (výrobní příkazy), tuotantotilausten osat, tuotannon materiaalit ja puolivalmisteet, ammattiryhmät, henkilöstöresurssit, reitityksen työvaiheiden esiasetukset ja työvaihekirjaukset. Varastotiedot, saapumiset, otot ja lähetetyt ostotilaukset (vydané objednávky) ovat käytettävissä samalla tavalla.
HELIOS Nephrite REST API. Nephriten kehityssuunnitelmaan sisältyy REST API -rajapinnan kehittäminen (HELIOS Nephriten kehityssuunnitelma). SkyPlanner-tiimi varmistaa määrittelyvaiheessa ympäristösi Nephrite-päätepisteet yhdessä sinun ja HELIOS-kumppanisi kanssa. Alla kuvatut tietovirrat pysyvät samoina.
Excel ja CSV. Jokaisen HELIOS-näkymän tiedot voi viedä Microsoft Officeen. Tämä riittää kokeilun tiedonsiirtoon.
Tunnistautuminen ja lisensointi
- Kaksi tunnistautumistapaa. iNuvio tarjoaa vanhemman oman tunnistautumisrajapinnan (/api/token) ja uudemman, RFC 6749 -standardiin perustuvan OAuth2-rajapinnan (/oauth/token, /oauth/revoke). Tunnisteet uusitaan kutsulla POST /oauth/token tai GET /api/token.
- Lisensointi. Helios Inuvio Server itsessään on maksuton, mutta REST API -rajapinnan käyttö vaatii lisenssin. Versiosta 3.0.2026.0301 alkaen järjestelmä- ja toimintorajapinnat on yhdistetty yhdeksi Inuvio REST API -rajapinnaksi, eikä käyttäjämäärä enää rajoita rajapinnan käyttöä.
- Käyttöoikeudet. Integraatiokäyttäjä tarvitsee lukuoikeudet tuotanto- ja varastonäkymiin sekä oikeuden suorittaa sovitut ulkoiset toiminnot.
SkyPlannerin REST API -rajapintaan tunnistaudutaan API-tunnisteella, joka välitetään Authorization-Token-otsakkeessa (SkyPlanner Settings > API). Rajapinta on dokumentoitu Swagger/OpenAPI-muodossa. Integraation aloitusohje opastaa ensimmäisten kutsujen tekemisessä.
Tapahtumat ja säännöllinen tietojen haku
SkyPlanner lukee HELIOSin tietoja säännöllisin väliajoin. Uudet työt haetaan /browses/data-kutsuilla, jotka rajataan avoimiin tuotantotilauksiin ja viimeaikaisiin muutoksiin. Hakuväli määritetään tehdaskohtaisesti: tuotantotilauksia voidaan hakea muutaman minuutin välein ja varastotietoja tunnin välein.
SkyPlanner lähettää webhook-ilmoituksia, kun tila tai aikataulu muuttuu. Tietojen palautus toimii siis tapahtumapohjaisesti.
Tietojen vastaavuudet
| HELIOS-objekti (näkymä) | SkyPlannerin objekti | Suunta | Päivitystiheys |
|---|---|---|---|
| Nimikekortit ja valmistettavat osat (vyráběné dílce), yksiköt | Tuotteet ja materiaalit | HELIOS → SkyPlanner | Alkusiirto, sen jälkeen säännöllinen haku |
| Osaluettelot (kusovník, kusovníkové vazby) voimassaoloaikoineen | Tuoterakenne, alituotteet ja tuotekohtaiset materiaalit | HELIOS → SkyPlanner | Alkulataus, sen jälkeen muutosten yhteydessä |
| Reititykset (technologický postup): työvaihe, työpiste, koneen ja työntekijän valmisteluaika, yksikköaika, viimeistelyaika ja työvaiheiden välinen aika | Työvaiheet kestoineen, asetusaikoineen ja purkuaikoineen | HELIOS → SkyPlanner | Alkulataus, sen jälkeen muutosten yhteydessä |
| Työpisteet (pracoviště), koneet (stroje), vaihtoehtoiset työpisteet | Työpisteet, työpisteryhmät, vaihtoehtoiset työpisteet | HELIOS → SkyPlanner | Alkulataus, sen jälkeen harvoin |
| Ammattiryhmät (výrobní profese), henkilöstöresurssit (výrobní personální zdroje) | Henkilöstö ja työkohtaiset työntekijämäärät | HELIOS → SkyPlanner | Alkusiirto, sen jälkeen muutosten yhteydessä |
| Suunnittelukalenterit (plánovací kalendáře) | Työvuorot ja vapaapäivät | HELIOS → SkyPlanner | Päivittäin tai omat työvuorot SkyPlannerissa |
| Tuotantotilaukset (výrobní příkazy), tilausten osat ja työvaiheet, tuotannon materiaalit | Tilaukset ja työt määräpäivineen ja materiaalitarpeineen | HELIOS → SkyPlanner | Haku muutaman minuutin välein |
| Varastotilanne (stav skladu) | Varastosaldot | HELIOS → SkyPlanner | Pollaus tunnin välein tai suunnitteluajon yhteydessä |
| Lähetetyt ostotilaukset (vydané objednávky) toimituspäivineen | Ostotilaukset, saapuvat materiaalit toimituspäivän mukaan | HELIOS → SkyPlanner | Haku tunnin välein tai suunnitteluajon yhteydessä |
| Tuotantotilauksen työvaiheen suunniteltu aloitus ja valmistuminen (ulkoinen toiminto) | Työn suunniteltu aloitus ja lopetus | SkyPlanner → HELIOS | Aikataulun muuttuessa SkyPlannerin webhook-ilmoituksen kautta |
| Työvaihekirjaukset (evidence výrobních operací) | Aikakirjaukset ja työntekijöiden kuittaukset | SkyPlanner → HELIOS | Kuittauksen tai työvuoron yhteydessä, jos näin valitaan |
| Ei HELIOSissa | Asetusaikamatriisi, työkalut rajallisina resursseina, usean työntekijän työt | Ylläpidetään SkyPlannerissa | Määritetään käyttöönoton aikana |
Integraation toimintamallit
1. Perustietojen alkusiirto. Lue valmistettavat osat, osaluettelot, reititykset, työpisteet, koneet, ammattiryhmät, henkilöstöresurssit ja kalenterit TPV-näkymistä. Jokaisella HELIOS-resurssilla on asetus, jolla se otetaan mukaan kapasiteetin suunnitteluun. Päätä siis resurssikohtaisesti, mitä SkyPlanner suunnittelee. Työpiste, jossa on neljä konetta, mallinnetaan yhdeksi työpisteryhmäksi tai neljäksi työpisteeksi.
2. Tilausten synkronointi. Lue tuotantotilaukset osineen, työvaiheineen ja materiaaleineen sekä lähetetyt ostotilaukset. SkyPlanner käsittelee tilatun materiaalin saatavana ostotilauksen toimituspäivänä ja päivittää varastosaldon, kun ostotilauksen tilaksi merkitään Delivered. Ota suunnitteluun vapautetut tuotantotilaukset. Tuotantosuunnitelman suunnitellut määrät pysyvät HELIOSissa, kunnes niistä muodostetaan tuotantotilaukset.
3. Aikataulutietojen palautus. Kun suunnittelumoottori sijoittaa tai siirtää työn, SkyPlannerin webhook-ilmoitus käynnistää tuotantotilausnäkymässä ulkoisen toiminnon /api/v1/actions/execute-rajapinnan kautta. Toiminto on määrittelyvaiheessa sovittu HELIOS-proseduuri, joka asettaa tilauksen työvaiheen suunnitellun aloituksen ja valmistumisen. HELIOS tarkistaa muutoksen oman logiikkansa mukaisesti.
4. Tuotannon kuittaukset. Työntekijät kirjaavat työnsä SkyPlanner Mobile Confirmations- tai Production Timer -toiminnolla, ja aikakirjaukset pitävät aikataulun ajan tasalla. Päätät itse, palautetaanko toteutuneet ajat HELIOSiin. Jos palautetaan, ulkoinen toiminto tallentaa ne työvaihekirjauksina tilauksen kullekin työvaiheelle. Muussa tapauksessa työntekijät jatkavat raportointia HELIOS-päätteillä ja SkyPlanner lukee nämä kirjaukset.
5. Tietojen omistajuus ja ristiriitojen käsittely. Kirjaa säännöt ennen tuotantokäyttöön siirtymistä:
| Tiedot | Omistaja |
|---|---|
| Nimikkeet, osaluettelot, reititykset, määrät, tilauksen tila | HELIOS |
| Työvaiheiden järjestys, aloitus- ja lopetusajat, koneen valinta | SkyPlanner |
| Asetusaikamatriisi, työkalu- ja työntekijävaatimukset, vaihtoehtoiset resurssit | SkyPlanner |
| Työvuorot ja vapaapäivät | Yksi järjestelmä, joka valitaan määrittelyssä |
| Työvaihekirjaukset, materiaalien otot ja saapumiset | HELIOS: kirjataan siellä tai siirretään SkyPlannerin aikakirjauksista |
Valitse yksi järjestelmä kirjoittamaan tilausten päivämäärät. Jos HELIOSin kapasiteetin suunnittelu tai Nephrite APS kirjoittaa niitä edelleen, poista tämä käytöstä SkyPlannerin suunnittelemilta tilauksilta tai säilytä HELIOS-suunnitelma vain testikäytössä.
Projektin tyypilliset vaiheet
Toteutus valmistuu tavallisesti viikoissa käyttöönoton alkamisesta. Varmista sitä ennen aikataulun toimivuus 30 päivän maksuttomassa kokeilussa. Käytä HELIOSista CSV- tai Excel-muodossa vietyjä työpisteitä, reitityksiä ja avoimia tuotantotilauksia.
- Tietovastaavuudet. Vahvista vastaavuustaulukko, tietojen omistajuussäännöt, synkronointivälit ja se, palautetaanko työvaihekirjaukset.
- Yhteys HELIOSiin. Ota käyttöön Helios Inuvio Server, integraatiokäyttäjä, OAuth2-tunnukset ja REST API -lisenssi. Testaa ensin tietokannan kopiolla.
- Alkusiirto. Valmistettavat osat, osaluettelot, reititykset, työpisteet, koneet, ammattiryhmät ja kalenterit.
- Tuotanto- ja ostotilausten synkronointi. Säännöllinen haku suodatuksineen, sivutuksineen ja uudelleenyrityksineen.
- Rajoitteiden määritys SkyPlannerissa. Asetusaikamatriisi, työkalut, työkohtaiset työntekijämäärät sekä vaihtoehtoiset koneet tai henkilöt.
- Aikataulutietojen palautus. Luo ja testaa ulkoiset toiminnot suunniteltuja päivämääriä ja haluttaessa työvaihekirjauksia varten.
- Rinnakkaistestaus. Aja SkyPlanneria nykyisen suunnitelman rinnalla, vertaa päivämääriä ja korjaa perustiedot.
- Tuotantokäyttöön siirtyminen. Ota tietojen takaisinkirjoitus käyttöön, kun tiedot täsmäävät.
Mitä HELIOS-integraatiossa on huomioitava
- Suunnitteluasetukset. Vain kapasiteetin suunnitteluun merkityillä resursseilla on luotettavat kapasiteettitiedot. Tarkista työpisteiden, koneiden, ammattiryhmien ja alihankintojen asetukset ennen alkusiirtoa.
- Aikayksiköt. Valmistelu-, kappale- ja viimeistelyajat voidaan syöttää tunteina, minuutteina tai sekunteina. Muunna yksiköt tuonnin yhteydessä, muuten kaikki kestot ovat väärin.
- Työvaiheiden välinen aika. Työvaiheiden välinen vakioaika on odotusta, ei koneaikaa. Mallinna se odotuksena, älä kapasiteettina.
- Alihankintavaiheet (kooperace). Kuljetusaika koskee sekä meno- että paluumatkaa. Mallinna alihankintavaiheet pelkän keston perusteella.
- Näkymät, joihin voi kirjoittaa. Kaikki näkymät tukevat lukemista, mutta vain osa tukee tietojen luontia, päivitystä ja poistoa. Kutsu GET /browses/list suodattimella browseCreateImplemented=1 näyttää, mitkä näkymät tukevat näitä toimintoja. Tuotantotilausten näkymät ovat vain luettavia, joten suunnitellut päivämäärät palautetaan sovitun ulkoisen toiminnon kautta.
Kuka vastaa HELIOS-integraation asetuksista ja tuesta
- SkyPlanner-tiimi määrittää integraation asetukset käyttöönoton aikana ja tarjoaa tukea tuotantokäytön alettua. Työ kattaa sovitut näkymät ja ulkoiset toiminnot. Jokainen tehdas käyttää HELIOS-järjestelmää eri tavalla, ja tämä käyttökokemus otetaan huomioon määrityksissä.
- HELIOS-kumppanisi voi osallistua. Kumppani tuntee asennuksenne, räätälöidyt proseduurinne ja lisensointinne. Hän voi määrittää Helios Inuvio Serverin ja ulkoiset toiminnot yhdessä SkyPlanner-tiimin kanssa.
- Omat kehittäjänne voivat laajentaa integraatiota SkyPlannerin REST API -rajapinnan kautta API-tunnisteella. Alkuun pääsee pelkällä API-tunnisteella, ja SkyPlanner-tiimi auttaa tarvittaessa. Ohjeet löytyvät SkyPlannerin integraatiodokumentaatiosta.
SkyPlannerin hinta on alkaen 199 € kuukaudessa. Hintaan sisältyy 5 työpistettä, ja laskutus tapahtuu kuukausittain. Integraatiosta annetaan etukäteen prosessiinne ja tarpeisiinne perustuva tarjous valitsemanne tilauksen yhteydessä. Tutustu hinnastoon, HELIOS-hienokuormitukseen, HELIOS-sivuun ja ERP-integraatioihin. Suunnittelun perusteet löydät tuotannonsuunnittelun oppaasta.
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
Tuotannonsuunnittelu säästää 2 tuntia työaikaa joka viikko, ja uusi työjono saadaan linjalle sekunneissa.
+90%tuotannon tehokkuutta
”Tuotannon tehokkuus on kasvanut 90 %.”
Abdul Rucyinga, IT-johtaja
Laboratory & Allied · Lääkevalmistus
Tuotannon tehokkuus on kasvanut 90 %, ja kaikki työpisteet kattava optimoitu suunnitelma kolmeksi kuukaudeksi valmistuu alle 30 minuutissa.
1 000:iaautomaattisesti suunniteltuja työmääräimiä
”Tuotanto on aivan eri tavalla hallinnassa, ja ymmärryksemme kapasiteetista on aivan eri tasolla.”
Hannu Ryynänen, toimitusjohtaja
Mamec · Teollisuussekoittimet, pumput ja korkean teknologian sopimusvalmistus
Tuhansien työmääräinten aikataulut suunnitellaan automaattisesti, ja koko organisaatiolla on reaaliaikainen näkymä tuotantoon.
100%toimitusvarmuus vuodesta 2021
”SkyPlanner antaa meille näkyvyyden kapasiteettiin ja tekee suunnittelusta ennakoitavaa.”
Dan Berglund, COO/CFO
Opes Corporation · Kemian- ja elintarviketeollisuus
Toimitusvarmuus on ollut 100 % koko SkyPlannerin käytön ajan, vuodesta 2021 lähtien.
Usein kysytyt kysymykset
Onko HELIOS-järjestelmässä API-rajapinta tuotantotilauksille?
Kyllä. Helios Inuvio Server tarjoaa REST-yhteyden HELIOS iNuvion näkymiin, kuten tuotantosuunnitelmaan, tuotantotilauksiin, tilausten osiin, tuotannon materiaaleihin ja työvaihetietoihin. HELIOS Nephriten osalta SkyPlanner-tiimi sopii asennukseenne sopivan toteutustavan yhdessä teidän ja HELIOS-kumppaninne kanssa käyttöönoton määrittelyvaiheessa.
Miten SkyPlanner hakee HELIOS-järjestelmässä tehdyt muutokset?
SkyPlanner kyselee HELIOS-näkymiä tehdaskohtaisesti sovituin väliajoin. Kyselyt rajataan avoimiin tuotantotilauksiin ja viimeaikaisiin muutoksiin. SkyPlannerin omat webhookit välittävät aikataulumuutokset heti niiden tapahtuessa.
Miten suunnitellut päivämäärät kirjoitetaan takaisin HELIOS-järjestelmään?
Tuotantotilausnäkymän ulkoisella toiminnolla, joka suoritetaan kutsulla /api/v1/actions/execute. Toiminto on määrittelyvaiheessa sovittu HELIOS-proseduuri, joten HELIOS käsittelee jokaisen vastaanottamansa päivämäärän oman logiikkansa mukaisesti.
Mitä tunnistautumistapaa Inuvio REST API käyttää?
Se käyttää RFC 6749:n mukaista OAuth2-tunnistautumista osoitteessa /oauth/token tai vanhempaa valmistajakohtaista /api/token-toteutusta. SkyPlannerin oma API käyttää API-tunnistetta Authorization-Token-otsakkeessa.
Kannattaako HELIOS-kumppanin ehdottaa HELIOS APS:ää vai SkyPlanneria?
SkyPlanneria, kun asiakkaan suunnitelma muuttuu usein ja suunnittelun on pysyttävä käytettävissä olevan kapasiteetin rajoissa. HELIOS tekee suunnittelulaskennat yhdelle aktiiviselle suunnitelmalle. Se voi siirtyä rajattomaan kapasiteettiin määräpäivien saavuttamiseksi ja jättää päällekkäisyydet suunnittelijan ratkaistaviksi (HELIOS-ohje). SkyPlanner yhdistyy REST API -rajapinnan kautta, suunnittelee tuotannon uudelleen automaattisesti ja huomioi suunnittelussa tuotevaihdot, työkalut, työryhmät ja materiaalit. Käyttäjämäärää ei ole rajoitettu, ja hinta on alkaen 199 € kuukaudessa.
Voimmeko testata SkyPlanneria ennen integraation rakentamista?
Kyllä. Ilmaisessa 30 päivän kokeilussa voi käyttää enintään 20 työpistettä ja tuoda HELIOS-tietoja CSV- tai Excel-tiedostoista. Luottokorttia ei tarvita. Aloita kokeilu tai ota yhteyttä myyntiin integraation määrittelyä varten.
