Integracijos / ERP / HELIOS
HELIOS integravimo vadovas: gamybos tvarkaraščių sudarymas su SkyPlanner APS
Šiame HELIOS integravimo vadove partneriams ir IT komandoms paaiškinama, kaip sujungti HELIOS iNuvio ir HELIOS Nephrite su SkyPlanner APS. SkyPlanner su HELIOS keičiasi duomenimis abiem kryptimis per pačios HELIOS sąsajas:
- Į SkyPlanner perduodami gamybos užsakymai (výrobní příkazy) su jų operacijomis, gaminamos detalės, komplektavimo specifikacijos, technologiniai maršrutai, darbo vietos, įrenginiai, profesijos, personalo ištekliai, atsargos ir pirkimo užsakymai.
- Suplanuotos pradžios ir pabaigos datos įrašomos atgal į gamybos užsakymus.
- Jei pasirinksite, operatorių darbo laiko įrašai gali būti perduodami atgal kaip operacijų įrašai (evidence výrobních operací).
- SkyPlanner siunčia pranešimus per webhook sąsajas vos pasikeitus tvarkaraščiui.
Diegimo metu SkyPlanner komanda pritaiko integraciją prie jūsų HELIOS konfigūracijos ir ją palaiko pradėjus naudoti sistemą. Šis vadovas skirtas HELIOS partneriams ir programuotojams, kurie nori prisidėti prie integravimo arba patys kurti sprendimus naudodami dokumentuotą SkyPlanner REST API (API žinynas).
HELIOS integravimo sąsajos
Helios Inuvio Server (Inuvio REST API). Asseco jį apibūdina kaip atskirą HELIOS iNuvio dalį, suteikiančią REST API prieigą prie HELIOS iNuvio duomenų sričių (Helios Inuvio Server žinynas). Jis tiekiamas su iNuvio diegimo paketu, o OpenAPI specifikacija skelbiama Rapidoc ir Redoc formatais. API veikia su HELIOS duomenų sąrašais (browses), kurių kiekvienas turi savo ID ir prieigos teises:
- GET /browses/list ir GET /browses/meta pateikia prieinamus duomenų sąrašus ir jų stulpelius.
- /browses/data nuskaito duomenų sąrašo eilutes ir jas įrašo, jei sąraše leidžiama kurti, atnaujinti bei šalinti įrašus.
- /api/v1/actions/meta ir /api/v1/actions/execute/{dbName}/{browseIdent}/{actionIdent} vykdo išorinius veiksmus duomenų sąraše. Šiuo metu palaikomi Procedure, Browse ir Plugin tipų išoriniai veiksmai.
Planuotojo naudojami gamybos duomenų sąrašai apima gamybos planą (výrobní plán), gamybos užsakymus (výrobní příkazy), gamybos užsakymų detales, gamybai skirtas medžiagas ir pusgaminius, profesijas, personalo išteklius, išankstines technologinio maršruto operacijų nuostatas ir operacijų įrašus. Tokiu pat būdu pasiekiami atsargų, pajamavimo, išdavimo ir pateiktų pirkimo užsakymų (vydané objednávky) duomenys.
HELIOS Nephrite REST API. Nephrite plėtros plane numatytas REST API kūrimas (HELIOS Nephrite plėtros planas). Apibrėždama apimtį, SkyPlanner komanda kartu su jumis ir jūsų HELIOS partneriu patvirtina jūsų įdiegtoje sistemoje naudojamus Nephrite galinius taškus. Toliau aprašyti duomenų srautai išlieka tokie patys.
Excel ir CSV. Kiekvieną HELIOS duomenų sąrašą galima eksportuoti į Microsoft Office – to pakanka bandomajam duomenų įkėlimui.
Autentifikavimas ir licencijavimas
- Du autentifikavimo būdai. iNuvio siūlo senesnę nuosavą autentifikavimo API (/api/token) ir naujesnę OAuth2 API, pagrįstą RFC 6749 (/oauth/token, /oauth/revoke). Prieigos raktai atnaujinami per POST /oauth/token arba GET /api/token.
- Licencijavimas. Pats Helios Inuvio Server yra nemokamas, o REST API reikia licencijos. Nuo 3.0.2026.0301 versijos sistemos ir duomenų sričių API sujungtos į vieną Inuvio REST API, o API prieiga nebėra ribojama pagal naudotojų skaičių.
- Teisės. Integracijai naudojamai paskyrai reikia suteikti gamybos ir atsargų duomenų sąrašų skaitymo teises bei teisę vykdyti sutartus išorinius veiksmus.
SkyPlanner REST API autentifikavimui naudoja API prieigos raktą antraštėje Authorization-Token (SkyPlanner Settings > API). API aprašyta Swagger/OpenAPI dokumentacijoje. Integravimo pamokoje paaiškinta, kaip atlikti pirmąsias užklausas.
Įvykiai ir periodinės užklausos
SkyPlanner periodiškai nuskaito HELIOS duomenis. Naujos užduotys gaunamos per /browses/data užklausas, filtruojamas pagal neužbaigtus gamybos užsakymus ir naujausius pakeitimus. Dažnis nustatomas kiekvienai gamyklai atskirai: gamybos užsakymams – kas kelias minutes, atsargoms – kas valandą.
Pasikeitus būsenai ar tvarkaraščiui, SkyPlanner siunčia webhook pranešimus, todėl duomenų įrašymą atgal inicijuoja įvykiai.
Duomenų susiejimas
| HELIOS objektas (duomenų sąrašas) | SkyPlanner objektas | Kryptis | Dažnis |
|---|---|---|---|
| Prekių kortelės ir gaminamos detalės (vyráběné dílce), matavimo vienetai | Gaminiai ir medžiagos | HELIOS → SkyPlanner | Pradinis įkėlimas, vėliau – periodinės užklausos |
| Komplektavimo specifikacijos (kusovník, kusovníkové vazby) su galiojimo datomis | Gaminio struktūra, tarpiniai gaminiai, kiekvienam gaminiui reikalingos medžiagos | HELIOS → SkyPlanner | Pradinis įkėlimas, vėliau – pasikeitus duomenims |
| Technologiniai maršrutai (technologický postup): operacija, darbo vieta, įrenginio ir operatoriaus paruošimo laikas, vieneto gamybos laikas, baigiamasis laikas, tarpoperacinis laikas | Proceso etapai su trukmėmis, paruošimo ir sutvarkymo laikais | HELIOS → SkyPlanner | Pradinis įkėlimas, vėliau – pasikeitus duomenims |
| Darbo vietos (pracoviště), įrenginiai (stroje), alternatyvios darbo vietos | Darbo centrai, darbo centrų grupės, alternatyvūs darbo centrai | HELIOS → SkyPlanner | Pradinis įkėlimas, vėliau – retai |
| Profesijos (výrobní profese), personalo ištekliai (výrobní personální zdroje) | Personalas ir operatorių skaičius kiekvienai užduočiai | HELIOS → SkyPlanner | Pradinis įkėlimas, vėliau – pasikeitus duomenims |
| Planavimo kalendoriai (plánovací kalendáře) | Pamainos ir nedarbo dienos | HELIOS → SkyPlanner | Kasdien arba atskirai nustatomos pamainos SkyPlanner sistemoje |
| Gamybos užsakymai (výrobní příkazy), jų detalės ir operacijos, gamybai skirtos medžiagos | Užsakymai ir užduotys su terminais ir medžiagų poreikiais | HELIOS → SkyPlanner | Užklausos kas kelias minutes |
| Atsargos (stav skladu) | Atsargų likučiai | HELIOS → SkyPlanner | Periodinės užklausos kas valandą arba sudarant tvarkaraštį |
| Pateikti pirkimo užsakymai (vydané objednávky) su pristatymo datomis | Pirkimo užsakymai, gaunamos medžiagos pagal pristatymo datą | HELIOS → SkyPlanner | Užklausos kas valandą arba paleidžiant tvarkaraščio sudarymą |
| Suplanuota kiekvienos gamybos užsakymo operacijos pradžia ir pabaiga (išorinis veiksmas) | Suplanuota kiekvienos užduoties pradžia ir pabaiga | SkyPlanner → HELIOS | Pasikeitus tvarkaraščiui, per SkyPlanner webhook pranešimą |
| Operacijų įrašai (evidence výrobních operací) | Darbo laiko įrašai ir operatorių patvirtinimai | SkyPlanner → HELIOS | Po kiekvieno patvirtinimo arba kiekvieną pamainą, jei pasirinkta |
| HELIOS sistemoje nėra | Paruošimo laikų matrica, įrankiai kaip riboti ištekliai, kelių operatorių atliekamos užduotys | Tvarkoma SkyPlanner sistemoje | Nustatoma diegimo metu |
Integravimo modeliai
1. Pradinis pagrindinių duomenų įkėlimas. Iš TPV duomenų sąrašų nuskaitykite gaminamas detales, komplektavimo specifikacijas, technologinius maršrutus, darbo vietas, įrenginius, profesijas, personalo išteklius ir kalendorius. Kiekvienas HELIOS išteklius turi požymį, nurodantį, ar jis įtraukiamas į gamybos pajėgumų planavimą, todėl kiekvienam ištekliui nuspręskite, ką planuos SkyPlanner. Darbo vieta su keturiais įrenginiais tampa viena darbo centrų grupe arba keturiais darbo centrais.
2. Užsakymų sinchronizavimas. Nuskaitykite gamybos užsakymus su jų detalėmis, operacijomis ir medžiagomis, taip pat pateiktus pirkimo užsakymus. SkyPlanner laiko užsakytas medžiagas prieinamomis pirkimo užsakyme nurodytą pristatymo dieną ir atnaujina atsargas, kai pirkimo užsakymui suteikiama būsena Delivered. Sudarykite vykdyti išleistų gamybos užsakymų tvarkaraščius. Gamybos plane numatyti kiekiai lieka HELIOS sistemoje, kol tampa gamybos užsakymais.
3. Tvarkaraščio įrašymas atgal. Kai planavimo variklis įtraukia arba perkelia užduotį, SkyPlanner webhook pranešimas per /api/v1/actions/execute inicijuoja išorinį veiksmą gamybos užsakymų duomenų sąraše. Šis veiksmas – apibrėžiant apimtį sutarta HELIOS procedūra, kuri nustato suplanuotą užsakymo operacijos pradžią ir pabaigą. HELIOS patikrina pakeitimą pagal savo vidinę logiką.
4. Darbo atlikimo patvirtinimai gamyboje. Operatoriai registruoja darbą naudodami SkyPlanner Mobile Confirmations arba Production Timer, o pagal darbo laiko įrašus atnaujinamas tvarkaraštis. Jūs pasirenkate, ar faktinį darbo laiką perduoti atgal į HELIOS. Jei taip, išorinis veiksmas jį užregistruoja kiekvienos užsakymo operacijos įrašuose. Jei ne, operatoriai toliau teikia duomenis HELIOS terminaluose, o SkyPlanner nuskaito šiuos įrašus.
5. Atsakomybės už duomenis ir konfliktų sprendimo taisyklės. Užrašykite jas prieš pradėdami naudoti integraciją:
| Duomenys | Atsakinga sistema |
|---|---|
| Prekės, komplektavimo specifikacijos, technologiniai maršrutai, kiekiai, užsakymo būsena | HELIOS |
| Operacijų seka, pradžios ir pabaigos laikas, įrenginių priskyrimas | SkyPlanner |
| Paruošimo trukmių matrica, reikalavimai įrankiams ir operatoriams, alternatyvūs ištekliai | SkyPlanner |
| Pamainos ir nedarbo dienos | Viena sistema, pasirinkta apimties apibrėžimo metu |
| Operacijų įrašai, medžiagų išdavimas ir pajamavimas | HELIOS: duomenys įvedami tiesiogiai arba perduodami iš SkyPlanner darbo laiko įrašų |
Pasirinkite vieną sistemą, kuri įrašo užsakymų datas. Jei HELIOS gamybos pajėgumų planavimas arba Nephrite APS vis dar įrašo datas, išjunkite šią funkciją užsakymams, kurių tvarkaraščius sudaro SkyPlanner, arba naudokite HELIOS planą tik bandymams.
Įprasti projekto etapai
Diegimas paprastai užbaigiamas per kelias savaites nuo jo pradžios. Prieš tai patikrinkite tvarkaraštį per 30 dienų nemokamą bandomąjį laikotarpį, naudodami iš HELIOS CSV arba Excel formatu eksportuotas darbo vietas, technologinius maršrutus ir neužbaigtus gamybos užsakymus.
- Duomenų susiejimas. Galutinai suderinkite susiejimo lentelę, atsakomybės už duomenis taisykles, sinchronizavimo dažnį ir tai, ar operacijų įrašai bus perduodami atgal.
- Prieiga prie HELIOS. Sukonfigūruokite Helios Inuvio Server, integracijai skirtą naudotojo paskyrą, OAuth2 prisijungimo duomenis ir REST API licencijavimą. Pirmiausia išbandykite naudodami duomenų bazės kopiją.
- Pradinis įkėlimas. Gaminamos detalės, komplektavimo specifikacijos, technologiniai maršrutai, darbo vietos, įrenginiai, profesijos, kalendoriai.
- Gamybos ir pirkimo užsakymų sinchronizavimas. Periodinės užklausos su filtrais, duomenų skaidymu į puslapius ir pakartotiniais bandymais.
- Apribojimų konfigūravimas SkyPlanner sistemoje. Paruošimo trukmių matrica, įrankiai, kiekvienai užduočiai reikalingų operatorių skaičius ir alternatyvūs įrenginiai ar darbuotojai.
- Tvarkaraščio įrašymas atgal. Sukurkite ir išbandykite išorinius veiksmus suplanuotoms datoms ir, jei pasirinkta, operacijų įrašams perduoti.
- Lygiagretus testavimas. Naudokite SkyPlanner lygiagrečiai su dabartiniu planu, palyginkite datas ir pataisykite pagrindinius duomenis.
- Naudojimo pradžia. Kai duomenys sutaps, įjunkite įrašymą atgal.
Į ką atsižvelgti integruojant HELIOS
- Planavimo požymiai. Patikimus pajėgumų duomenis turi tik tie ištekliai, kurie pažymėti kaip įtraukiami į gamybos pajėgumų planavimą. Prieš pirmąjį įkėlimą patikrinkite darbo vietų, įrenginių, profesijų ir subrangos požymius.
- Laiko vienetai. Paruošimo, vieneto gamybos ir baigiamasis laikas gali būti įvestas valandomis, minutėmis arba sekundėmis. Importuodami konvertuokite vienetus, antraip visos trukmės bus neteisingos.
- Laikas tarp operacijų. Pastovus laikas tarp operacijų yra laukimo, o ne įrenginio darbo laikas. Modeliuokite jį kaip laukimą, o ne kaip pajėgumų naudojimą.
- Subrangos operacijos (kooperace). Transportavimo laikas taikomas vežant tiek pas subrangovą, tiek atgal. Subrangos operacijas modeliuokite kaip etapus, kuriems skiriamas tik laikas.
- Duomenų sąrašai, kuriuose galima keisti duomenis. Skaityti duomenis galima visuose duomenų sąrašuose, tačiau kurti, atnaujinti ir šalinti įrašus – tik kai kuriuose. Kuriuose tai galima, parodo GET /browses/list su filtru browseCreateImplemented=1. Gamybos užsakymų duomenų sąrašai skirti tik skaityti, todėl suplanuotos datos grąžinamos per sutartą išorinį veiksmą.
Kas konfigūruoja ir prižiūri HELIOS integraciją
- SkyPlanner komanda sukonfigūruoja integraciją diegimo metu ir prižiūri ją pradėjus naudoti. Priežiūra apima sutartas apžvalgas ir išorinius veiksmus. Kiekviena gamykla HELIOS naudoja savaip, todėl čia pritaikomos žinios apie konkrečią sistemą.
- Gali dalyvauti ir jūsų HELIOS partneris. Partneris išmano jūsų įdiegtą sistemą, individualias procedūras ir licencijavimo sąlygas, todėl kartu su SkyPlanner komanda gali sukonfigūruoti Helios Inuvio Server ir išorinius veiksmus.
- Jūsų programuotojai gali toliau plėtoti integraciją, naudodami SkyPlanner REST API ir API prieigos raktą. Pradžiai pakanka API prieigos rakto, o prireikus padeda SkyPlanner komanda. Žr. SkyPlanner integracijos dokumentaciją.
SkyPlanner kainuoja nuo 199 € per mėnesį, į kainą įtraukti 5 darbo centrai. Mokama kas mėnesį. Integracijos kaina pateikiama iš anksto kartu su jūsų plano pasiūlymu, atsižvelgiant į jūsų procesą ir poreikius. Žr. kainodarą, gamybos planavimą su HELIOS atsižvelgiant į realius įrenginių ir darbuotojų pajėgumus, HELIOS puslapį ir ERP integracijų skiltį. Tvarkaraščių sudarymo pagrindai pateikiami skiltyje gamybos tvarkaraščių sudarymas.
Gamintojų atsiliepimai apie SkyPlanner
2 hsutaupoma kas savaitę
„Su SkyPlanner nuo gamybos planavimo Excel lentelėse perėjome prie gamybos optimizavimo realiuoju laiku.“
Kalle Kalliomäki, tiekimo grandinės specialistas
UTU · Elektros skirstomieji skydai ir skirstymo įranga
Planuojant gamybą kas savaitę sutaupomos 2 darbo valandos, o nauja darbų eilė gamybos liniją pasiekia per kelias sekundes.
+90%gamybos efektyvumas
„Gamybos efektyvumas padidėjo 90%.“
Abdul Rucyinga, IT vadovas
Laboratory & Allied · Vaistų gamyba
Gamybos efektyvumas padidėjo 90%, o optimizuotas trijų mėnesių planas visiems darbo centrams sudaromas per mažiau nei 30 minučių.
1 000 ir daugiauautomatiškai suplanuotų gamybos užsakymų
„Gamybą valdome visai kitaip, o mūsų supratimas apie pajėgumus pakilo į visiškai kitą lygį.“
Hannu Ryynänen, generalinis direktorius
Mamec · Pramoniniai maišytuvai, siurbliai ir aukštųjų technologijų sutartinė gamyba
Tūkstančiai gamybos užsakymų suplanuojami automatiškai, o visa organizacija realiuoju laiku mato gamybos būklę.
100%pristatymo patikimumas nuo 2021 m.
„SkyPlanner leidžia aiškiai matyti pajėgumus, o planavimo rezultatai tampa nuspėjami.“
Dan Berglund, COO/CFO
Opes Corporation · Chemijos ir maisto produktų gamyba
Pristatymo patikimumas siekia 100% visą SkyPlanner naudojimo laikotarpį – nuo 2021 m.
Dažniausiai užduodami klausimai
Ar HELIOS turi API gamybos užsakymams?
Taip. Helios Inuvio Server suteikia REST prieigą prie HELIOS iNuvio apžvalgų, įskaitant gamybos planą, gamybos užsakymus, užsakymų dalis, gamybai skirtas medžiagas ir operacijų įrašus. Jei naudojate HELIOS Nephrite, SkyPlanner komanda kartu su jumis ir jūsų HELIOS partneriu parenka jūsų sistemai tinkamą integravimo būdą, kai diegimo pradžioje apibrėžiama apimtis.
Kaip SkyPlanner gauna HELIOS pakeitimus?
SkyPlanner periodiškai teikia užklausas HELIOS apžvalgoms pagal kiekvienai gamyklai nustatytą grafiką. Taikomi filtrai, kad būtų gaunami tik neužbaigti gamybos užsakymai ir naujausi pakeitimai. Pačios SkyPlanner žiniatinklio pranešimai (webhooks) perduoda tvarkaraščio pakeitimus vos jiems įvykus.
Kaip suplanuotos datos įrašomos atgal į HELIOS?
Per gamybos užsakymų apžvalgos išorinį veiksmą, vykdomą naudojant /api/v1/actions/execute. Šis veiksmas yra HELIOS procedūra, dėl kurios susitariama apibrėžiant apimtį, todėl kiekvienai gautai datai HELIOS taiko savo logiką.
Kokį autentifikavimo būdą naudoja Inuvio REST API?
OAuth2 pagal RFC 6749 per /oauth/token arba senesnį nuosavą būdą per /api/token. Pačios SkyPlanner API naudoja API prieigos raktą Authorization-Token antraštėje.
Ką HELIOS partneriui siūlyti – HELIOS APS ar SkyPlanner?
SkyPlanner, kai kliento planas dažnai keičiasi ir būtina laikytis realių pajėgumų ribų. HELIOS planavimas pagrįstas vieno aktyvaus plano skaičiavimais. Kad būtų laikomasi terminų, galima pereiti prie neribotų pajėgumų, o konfliktus paliekama spręsti planuotojui (HELIOS žinynas). SkyPlanner jungiasi per REST API, automatiškai perplanuoja, planuoja perderinimus, įrankius, brigadas ir medžiagas, o naudotojų skaičius neribojamas. Kaina – nuo 199 € per mėnesį.
Ar galime išbandyti SkyPlanner prieš kurdami integraciją?
Taip. Per 30 dienų nemokamą bandomąjį laikotarpį galite naudoti iki 20 darbo centrų ir importuoti HELIOS duomenis CSV arba Excel formatu. Kredito kortelės nereikia. Pradėkite bandomąjį laikotarpį arba susisiekite su pardavimų komanda, kad apibrėžtumėte integracijos apimtį.
