Integrácie / ERP / HELIOS
Sprievodca integráciou HELIOS so SkyPlanner APS na rozvrhovanie výroby
Tento sprievodca integráciou HELIOS ukazuje partnerom a IT tímom, ako prepojiť HELIOS iNuvio a HELIOS Nephrite so SkyPlanner APS. SkyPlanner sa prepája s HELIOS obojsmerne cez vlastné rozhrania systému HELIOS:
- Do SkyPlanner sa načítavajú výrobné príkazy (výrobní příkazy) s operáciami, vyrábané dielce, kusovníky, technologické postupy, pracoviská, stroje, profesie, personálne zdroje, stav zásob a nákupné objednávky.
- Plánované termíny začatia a ukončenia sa zapisujú späť do výrobných príkazov.
- Ak si to zvolíte, časové záznamy operátorov sa môžu zapisovať späť ako záznamy operácií (evidence výrobních operací).
- Webhooky SkyPlanner odosielajú zmeny rozvrhu hneď, ako nastanú.
Tím SkyPlanner počas zavádzania nastaví integráciu podľa vašej konfigurácie HELIOS a zabezpečuje jej podporu aj po spustení ostrej prevádzky. Tento sprievodca je určený partnerom a vývojárom HELIOS, ktorí sa chcú zapojiť alebo sami vytvárať riešenia pomocou zdokumentovaného REST API SkyPlanner (referenčná dokumentácia API).
Integračné rozhrania HELIOS
Helios Inuvio Server (Inuvio REST API). Asseco ho opisuje ako samostatnú súčasť HELIOS iNuvio, ktorá sprístupňuje agendy HELIOS iNuvio cez REST API (pomocník pre Helios Inuvio Server). Dodáva sa ako súčasť distribúcie iNuvio a špecifikácia OpenAPI je zverejnená vo formátoch Rapidoc a Redoc. API pracuje s prehľadmi HELIOS (browses), pričom každý má vlastné ID a prístupové práva:
- GET /browses/list a GET /browses/meta vracajú zoznam dostupných prehľadov a ich stĺpcov.
- /browses/data číta riadky prehľadu a zapisuje ich tam, kde prehľad povoľuje vytváranie, aktualizáciu a mazanie.
- /api/v1/actions/meta a /api/v1/actions/execute/{dbName}/{browseIdent}/{actionIdent} spúšťajú externé akcie nad prehľadom. V súčasnosti ide o externé akcie typu Procedure, Browse a Plugin.
Medzi výrobné prehľady, ktoré plánovač používa, patria výrobný plán (výrobní plán), výrobné príkazy (výrobní příkazy), dielce výrobných príkazov, materiály a polotovary pre výrobu, profesie, personálne zdroje, prednastavenia operácií technologického postupu a záznamy operácií. Rovnakým spôsobom sú dostupné aj stav zásob, príjemky, výdajky a vydané nákupné objednávky (vydané objednávky).
HELIOS Nephrite REST API. Plán rozvoja Nephrite zahŕňa vývoj REST API (plán rozvoja HELIOS Nephrite). Počas definovania rozsahu tím SkyPlanner spolu s vami a vaším partnerom HELIOS overí koncové body Nephrite pre vašu inštaláciu. Dátové toky uvedené nižšie zostávajú rovnaké.
Excel a CSV. Každý prehľad HELIOS umožňuje export do Microsoft Office, čo na skúšobné načítanie dát postačuje.
Autentifikácia a licencovanie
- Dva spôsoby autentifikácie. iNuvio ponúka staršie proprietárne autentifikačné API (/api/token) a novšie OAuth2 API založené na RFC 6749 (/oauth/token, /oauth/revoke). Tokeny sa obnovujú cez POST /oauth/token alebo GET /api/token.
- Licencovanie. Samotný Helios Inuvio Server je bezplatný, REST API však vyžaduje licenciu. Od verzie 3.0.2026.0301 sú systémové API a API agend zlúčené do jedného Inuvio REST API a prístup k API už nie je obmedzený počtom používateľov.
- Prístupové práva. Integračný používateľ potrebuje práva na čítanie výrobných a skladových prehľadov a právo spúšťať dohodnuté externé akcie.
Na strane SkyPlanner sa REST API autentifikuje pomocou API tokenu v hlavičke Authorization-Token (SkyPlanner Settings > API). Dokumentácia je dostupná v Swagger/OpenAPI. Návod na integráciu vás prevedie prvými volaniami.
Udalosti a pravidelné načítavanie
SkyPlanner načítava dáta z HELIOS v nastavených intervaloch. Novú prácu získava volaním /browses/data s filtrami na otvorené výrobné príkazy a posledné zmeny. Frekvencia sa nastavuje pre každý závod samostatne: od niekoľkých minút pri výrobných príkazoch až po hodinové intervaly pri stave zásob.
Pri zmene stavu alebo rozvrhu SkyPlanner odosiela webhooky, takže spätný zápis je riadený udalosťami.
Mapovanie dát
| Objekt HELIOS (prehľad) | Objekt SkyPlanner | Smer | Frekvencia |
|---|---|---|---|
| Karty položiek a vyrábané dielce (vyráběné dílce), jednotky | Výrobky a materiály | HELIOS → SkyPlanner | Úvodné načítanie, potom pravidelné načítavanie |
| Kusovníky (kusovník, kusovníkové vazby) s dátumovou platnosťou | Štruktúra výrobku, podvýrobky, materiály pre jednotlivé výrobky | HELIOS → SkyPlanner | Úvodné načítanie, potom pri zmene |
| Technologické postupy (technologický postup): operácia, pracovisko, čas prípravy stroja a operátora, jednotkový čas, zakončovací čas, medzioperačný čas | Kroky procesu s časmi trvania, prípravy a ukončenia | HELIOS → SkyPlanner | Úvodné načítanie, potom pri zmene |
| Pracoviská (pracoviště), stroje (stroje), alternatívne pracoviská | Pracoviská, skupiny pracovísk, alternatívne pracoviská | HELIOS → SkyPlanner | Úvodné načítanie, potom zriedkavo |
| Profesie (výrobní profese), personálne zdroje (výrobní personální zdroje) | Personál a počty operátorov na operáciu | HELIOS → SkyPlanner | Úvodné načítanie, potom pri zmene |
| Plánovacie kalendáre (plánovací kalendáře) | Zmeny a dni pracovného pokoja | HELIOS → SkyPlanner | Denne alebo vlastné pracovné zmeny v SkyPlanner |
| Výrobné príkazy (výrobní příkazy), ich dielce a operácie, materiály pre výrobu | Zákazky a operácie s termínmi dokončenia a materiálovými požiadavkami | HELIOS → SkyPlanner | Načítavanie každých niekoľko minút |
| Stav zásob (stav skladu) | Skladové zostatky | HELIOS → SkyPlanner | Dopytovanie každú hodinu alebo pri spustení rozvrhovania |
| Vydané nákupné objednávky (vydané objednávky) s termínmi dodania | Nákupné objednávky, očakávaný materiál podľa termínu dodania | HELIOS → SkyPlanner | Načítavanie každú hodinu alebo pri spustení rozvrhovania |
| Plánované začatie a ukončenie každej operácie výrobného príkazu (externá akcia) | Plánované začatie a ukončenie každej operácie | SkyPlanner → HELIOS | Pri zmene rozvrhu cez webhook SkyPlanner |
| Záznamy operácií (evidence výrobních operací) | Časové záznamy a potvrdenia operátorov | SkyPlanner → HELIOS | Pri každom potvrdení alebo za pracovnú zmenu, ak si to zvolíte |
| Nie je v HELIOS | Matica časov prestavenia, nástroje ako kapacitne obmedzené zdroje, operácie s viacerými operátormi | Spravuje sa v SkyPlanner | Nastavuje sa počas zavádzania |
Postupy integrácie
1. Úvodné načítanie kmeňových dát. Z prehľadov TPV načítajte vyrábané dielce, kusovníky, technologické postupy, pracoviská, stroje, profesie, personálne zdroje a kalendáre. Každý zdroj v HELIOS má príznak zaradenia do kapacitného plánovania. Pri každom zdroji preto rozhodnite, čo bude SkyPlanner rozvrhovať. Z pracoviska so štyrmi strojmi vznikne jedna skupina pracovísk alebo štyri pracoviská.
2. Synchronizácia zákaziek. Načítajte výrobné príkazy s ich dielcami, operáciami a materiálmi aj vydané nákupné objednávky. SkyPlanner považuje objednaný materiál za dostupný k termínu dodania nákupnej objednávky a aktualizuje stav zásob, keď je objednávka označená stavom Delivered. Rozvrhujte uvoľnené výrobné príkazy. Plánované množstvá vo výrobnom pláne zostávajú v HELIOS, kým sa z nich nestanú výrobné príkazy.
3. Spätný zápis rozvrhu. Keď plánovací algoritmus zaradí alebo presunie operáciu, webhook SkyPlanner spustí externú akciu nad prehľadom výrobných príkazov cez /api/v1/actions/execute. Ide o procedúru HELIOS dohodnutú pri definovaní rozsahu, ktorá nastaví plánované začatie a ukončenie operácie výrobného príkazu. HELIOS overí zmenu podľa vlastnej logiky.
4. Potvrdenia z výroby. Operátori zaznamenávajú prácu pomocou SkyPlanner Mobile Confirmations alebo Production Timer. Časové záznamy udržiavajú rozvrh aktuálny. Vy rozhodnete, či sa skutočné časy budú zapisovať späť do HELIOS. Ak áno, externá akcia ich uloží ako záznamy operácií pre jednotlivé operácie výrobného príkazu. Ak nie, operátori budú naďalej vykazovať prácu na termináloch HELIOS a SkyPlanner bude tieto záznamy načítavať.
5. Pravidlá zodpovednosti za dáta a riešenia konfliktov. Spíšte ich pred spustením ostrej prevádzky:
| Dáta | Zodpovedný systém |
|---|---|
| Položky, kusovníky, technologické postupy, množstvá, stav zákazky | HELIOS |
| Poradie operácií, časy začatia a dokončenia, priradenie stroja | SkyPlanner |
| Matica časov prestavenia, požiadavky na nástroje a obsluhu, alternatívne zdroje | SkyPlanner |
| Zmeny a nepracovné dni | Jeden systém vybraný pri definovaní rozsahu |
| Záznamy operácií, výdajky a príjemky materiálu | HELIOS, so zadaním priamo v ňom alebo zápisom z časových záznamov SkyPlanner |
Určite jediný systém, ktorý bude zapisovať termíny zákaziek. Ak termíny stále zapisuje kapacitné plánovanie HELIOS alebo Nephrite APS, vypnite tento zápis pre zákazky rozvrhované v SkyPlanner, prípadne ponechajte plán HELIOS len ako testovací plán.
Typické kroky projektu
Implementácia sa zvyčajne dokončí v priebehu niekoľkých týždňov od začiatku zavádzania. Ešte predtým si overte rozvrh počas 30-dňového bezplatného skúšobného obdobia s pracoviskami, technologickými postupmi a otvorenými výrobnými príkazmi exportovanými z HELIOS vo formáte CSV alebo Excel.
- Mapovanie. Dohodnite konečnú podobu mapovacej tabuľky, pravidlá zodpovednosti za dáta, frekvencie synchronizácie a to, či sa záznamy operácií budú zapisovať späť.
- Prístup k HELIOS. Nastavte Helios Inuvio Server, integračného používateľa, prihlasovacie údaje OAuth2 a licenciu REST API. Najprv testujte na kópii databázy.
- Úvodné načítanie. Vyrábané dielce, kusovníky, technologické postupy, pracoviská, stroje, profesie, kalendáre.
- Synchronizácia zákaziek a nákupných objednávok. Pravidelné načítavanie s filtrami, stránkovaním a opakovaním neúspešných požiadaviek.
- Nastavenie obmedzení v SkyPlanner. Matica časov prestavenia, nástroje, počty pracovníkov obsluhy pre každú operáciu a alternatívne stroje alebo pracovníci.
- Spätný zápis rozvrhu. Vytvorte a otestujte externé akcie pre plánované termíny a prípadne aj pre záznamy operácií, ak ste si ich zápis zvolili.
- Paralelné testovanie. Spustite SkyPlanner súbežne s aktuálnym plánom, porovnajte dátumy a opravte kmeňové dáta.
- Spustenie ostrej prevádzky. Keď sa dáta zhodujú, zapnite spätný zápis.
Na čo myslieť pri integrácii HELIOS
- Príznaky plánovania. Spoľahlivé údaje o kapacite majú len zdroje označené na zaradenie do kapacitného plánovania. Pred prvým načítaním skontrolujte príznaky pri pracoviskách, strojoch, profesiách a kooperáciách.
- Časové jednotky. Časy prípravy, jednotkové časy a zakončovacie časy môžu byť zadané v hodinách, minútach alebo sekundách. Pri importe ich prepočítajte, inak budú všetky časy trvania nesprávne.
- Medzioperačný čas. Konštantný medzioperačný čas predstavuje čakanie medzi operáciami, nie strojový čas. Modelujte ho ako čakanie, nie ako kapacitu.
- Kooperačné operácie (kooperace). Čas prepravy sa započítava pri ceste tam aj späť. Kooperácie modelujte ako kroky, ktoré zohľadňujú len čas.
- Prehľady s možnosťou zápisu. Všetky prehľady umožňujú čítanie, no len niektoré podporujú vytváranie, úpravy a odstraňovanie záznamov. Ktoré to sú, zistíte volaním GET /browses/list s filtrom browseCreateImplemented=1. Prehľady výrobných príkazov sú len na čítanie, preto sa plánované termíny zapisujú späť prostredníctvom dohodnutej externej akcie.
Kto nastavuje integráciu s HELIOS a zabezpečuje jej podporu
- Tím SkyPlanner nastaví integráciu počas zavádzania a zabezpečuje jej podporu aj po spustení do ostrej prevádzky, a to v rozsahu dohodnutých prehľadov a externých akcií. Každý závod používa HELIOS inak a práve tu sa tieto znalosti uplatnia.
- Zapojiť sa môže aj váš partner pre HELIOS. Pozná vašu inštaláciu, vlastné procedúry aj licencie a môže spolu s tímom SkyPlanner nastaviť Helios Inuvio Server a externé akcie.
- Vaši vývojári môžu integráciu ďalej rozvíjať cez REST API systému SkyPlanner s tokenom API. Na začiatok stačí token API a tím SkyPlanner v prípade potreby pomôže. Dokumentáciu nájdete na stránke Dokumentácia integrácie SkyPlanner.
Cena SkyPlanner začína na 199 € mesačne vrátane 5 pracovísk, s mesačnou fakturáciou. Cenovú ponuku na integráciu dostanete vopred spolu s ponukou na predplatné, podľa vašich procesov a potrieb. Pozrite si cenník, plánovanie výroby s HELIOS s ohľadom na reálne kapacity, stránku HELIOS a prehľad integrácií s ERP. Základné informácie o rozvrhovaní nájdete na stránke Rozvrhovanie výroby.
Ako výrobcovia hodnotia SkyPlanner
2 hušetrené každý týždeň
„Vďaka SkyPlanner sme prešli od plánovania výroby v excelových tabuľkách k optimalizácii výroby v reálnom čase.“
Kalle Kalliomäki, špecialista dodávateľského reťazca
UTU · Elektrické rozvádzače a spínacie zariadenia
Plánovanie výroby ušetrí každý týždeň 2 hodiny pracovného času a nový zoznam operácií sa dostane na linku za pár sekúnd.
+90%efektívnosť výroby
„Efektívnosť výroby sa zvýšila o 90 %.“
Abdul Rucyinga, vedúci IT
Laboratory & Allied · Farmaceutická výroba
Efektívnosť výroby sa zvýšila o 90 % a vytvorenie optimalizovaného plánu na tri mesiace pre všetky pracoviská trvá menej než 30 minút.
Niekoľko 1 000automaticky rozvrhnutých výrobných príkazov
„Výrobu máme pod kontrolou úplne inak a náš prehľad o kapacitách je na celkom inej úrovni.“
Hannu Ryynänen, generálny riaditeľ
Mamec · Priemyselné miešadlá, čerpadlá a technologicky vyspelá zákazková výroba
Tisíce výrobných príkazov sa rozvrhujú automaticky a celá organizácia má prehľad o výrobe v reálnom čase.
100%spoľahlivosť dodávok od roku 2021
„SkyPlanner nám dáva prehľad o kapacitách a vnáša do plánovania predvídateľnosť.“
Dan Berglund, COO/CFO
Opes Corporation · Chemická a potravinárska výroba
Spoľahlivosť dodávok dosahuje 100% počas celého obdobia používania SkyPlanner, teda od roku 2021.
Často kladené otázky
Má HELIOS API pre výrobné príkazy?
Áno. Helios Inuvio Server poskytuje cez REST prístup k prehľadom HELIOS iNuvio vrátane výrobného plánu, výrobných príkazov, dielcov príkazov, materiálov pre výrobu a záznamov operácií. Pri HELIOS Nephrite tím SkyPlanner spolu s vami a vaším partnerom pre HELIOS určí spôsob prepojenia vašej inštalácie pri definovaní rozsahu počas zavádzania.
Ako SkyPlanner zisťuje zmeny v HELIOS?
SkyPlanner pravidelne načítava prehľady HELIOS v intervaloch nastavených pre každý závod, s filtrom na otvorené výrobné príkazy a nedávne zmeny. Vlastné webhooky SkyPlanner odosielajú zmeny rozvrhu hneď, ako nastanú.
Ako sa plánované termíny zapisujú späť do HELIOS?
Prostredníctvom externej akcie v prehľade výrobných príkazov, ktorá sa spúšťa cez /api/v1/actions/execute. Ide o procedúru HELIOS dohodnutú pri definovaní rozsahu, takže HELIOS pri každom prijatom termíne uplatní vlastnú logiku.
Aké overovanie používa Inuvio REST API?
OAuth2 podľa RFC 6749 na /oauth/token alebo staršie proprietárne rozhranie /api/token. Vlastné API systému SkyPlanner používa token API v hlavičke Authorization-Token.
Má partner pre HELIOS odporučiť HELIOS APS alebo SkyPlanner?
SkyPlanner, ak sa plán zákazníka často mení a musí rešpektovať reálne kapacitné obmedzenia. Plánovanie v HELIOS prebieha formou výpočtov nad jedným aktívnym plánom, môže prepnúť na neobmedzenú kapacitu, aby dodržalo termíny, a riešenie kolízií necháva na plánovačovi (pomocník HELIOS). SkyPlanner sa pripája cez REST API, automaticky preplánováva výrobu, plánuje prestavby, nástroje, pracovné tímy aj materiál a umožňuje neobmedzený počet používateľov, od 199 € mesačne.
Môžeme SkyPlanner otestovať ešte pred vytvorením integrácie?
Áno. Bezplatná 30-dňová skúšobná verzia podporuje až 20 pracovísk s importom údajov z HELIOS cez CSV alebo Excel, bez potreby platobnej karty. Vyskúšajte ju alebo kontaktujte obchodný tím a dohodnite si rozsah integrácie.
