Průvodce integrací HELIOS pro plánování výroby se SkyPlanner APS
Tento průvodce integrací HELIOS ukazuje partnerům a IT týmům, jak propojit HELIOS iNuvio a HELIOS Nephrite se SkyPlanner APS. SkyPlanner se s HELIOS integruje obousměrně prostřednictvím jeho vlastních rozhraní:
- Do SkyPlanner se načítají výrobní příkazy včetně operací, vyráběné dílce, kusovníky, technologické postupy, pracoviště, stroje, profese, personální zdroje, stavy skladu a vydané objednávky.
- Plánované termíny zahájení a dokončení se zapisují zpět do výrobních příkazů.
- Pokud se tak rozhodnete, lze časové záznamy obsluhy zapisovat zpět do evidence výrobních operací.
- Webhooky SkyPlanner odesílají změny rozvrhu ihned, jakmile nastanou.
Tým SkyPlanner během zavádění nastaví integraci podle vaší konfigurace HELIOS a zajišťuje její podporu i po spuštění do ostrého provozu. Tento průvodce je určen partnerům a vývojářům HELIOS, kteří se chtějí zapojit nebo sami vytvořit napojení pomocí zdokumentovaného REST API SkyPlanner (dokumentace API).
Integrační rozhraní HELIOS
Helios Inuvio Server (Inuvio REST API). Asseco jej popisuje jako samostatnou součást HELIOS iNuvio, která zpřístupňuje agendy HELIOS iNuvio přes REST API (nápověda k Helios Inuvio Server). Je součástí distribuce iNuvio a specifikace OpenAPI je zveřejněna ve formátech Rapidoc a Redoc. API pracuje s přehledy HELIOS (browses), z nichž každý má vlastní ID a přístupová práva:
- GET /browses/list a GET /browses/meta vracejí seznam dostupných přehledů a jejich sloupců.
- /browses/data čte řádky přehledu a umožňuje jejich zápis tam, kde přehled podporuje vytváření, úpravy a mazání.
- /api/v1/actions/meta a /api/v1/actions/execute/{dbName}/{browseIdent}/{actionIdent} spouštějí externí akce nad přehledem. Aktuálně jde o externí akce typu Procedure, Browse a Plugin.
Mezi výrobní přehledy, se kterými plánovač pracuje, patří výrobní plán, výrobní příkazy, dílce výrobních příkazů, materiály a polotovary pro výrobu, profese, personální zdroje, přednastavení operací technologických postupů a evidence výrobních operací. Stejným způsobem jsou dostupné stavy skladu, příjemky, výdejky a vydané objednávky.
HELIOS Nephrite REST API. Plán rozvoje Nephrite zahrnuje vývoj REST API (plán rozvoje HELIOS Nephrite). Během vymezení rozsahu tým SkyPlanner společně s vámi a vaším partnerem HELIOS ověří endpointy Nephrite pro vaši instalaci. Níže popsané datové toky zůstávají stejné.
Excel a CSV. Každý přehled HELIOS umožňuje export do Microsoft Office, což pro zkušební načtení dat stačí.
Autentizace a licence
- Dvě možnosti autentizace. iNuvio nabízí starší proprietární autentizační API (/api/token) a novější API OAuth2 založené na RFC 6749 (/oauth/token, /oauth/revoke). Tokeny se obnovují pomocí POST /oauth/token nebo GET /api/token.
- Licence. Samotný Helios Inuvio Server je zdarma, REST API podléhá licenci. Od verze 3.0.2026.0301 jsou systémové a agendové API sloučena do jednoho Inuvio REST API a přístup k API již není omezen počtem uživatelů.
- Oprávnění. Integrační uživatel potřebuje právo číst výrobní a skladové přehledy a spouštět dohodnuté externí akce.
Na straně SkyPlanner používá REST API k autentizaci API token v hlavičce Authorization-Token (SkyPlanner Settings > API). Dokumentace je dostupná ve Swagger/OpenAPI. Integrační návod vás provede prvními voláními.
Události a pravidelné načítání
SkyPlanner načítá data z HELIOS v pravidelných intervalech. Nové výrobní úkoly získává voláním /browses/data s filtry na otevřené výrobní příkazy a poslední změny. Intervaly se nastavují pro každý závod zvlášť: od několika minut u výrobních příkazů po hodinu u stavů skladu.
Při změně stavu nebo plánu SkyPlanner odesílá webhooky, takže zpětný zápis je řízen událostmi.
Mapování dat
| Objekt HELIOS (přehled) | Objekt SkyPlanner | Směr | Četnost |
|---|---|---|---|
| Kmenové karty a vyráběné dílce, měrné jednotky | Výrobky a materiály | HELIOS → SkyPlanner | Úvodní načtení, poté pravidelné načítání |
| Kusovníky a kusovníkové vazby s časovou platností | Struktura výrobku, dílčí výrobky, materiály pro jednotlivé výrobky | HELIOS → SkyPlanner | Počáteční načtení, poté při změně |
| Technologické postupy: operace, pracoviště, čas přípravy stroje a obsluhy, jednotkový čas, dokončovací čas, mezioperační čas | Operace s dobou trvání, přípravnými a dokončovacími časy | HELIOS → SkyPlanner | Počáteční načtení, poté při změně |
| Pracoviště, stroje, alternativní pracoviště | Pracoviště, skupiny pracovišť, alternativní pracoviště | HELIOS → SkyPlanner | Počáteční načtení, poté jen zřídka |
| Výrobní profese, výrobní personální zdroje | Pracovníci a počty pracovníků obsluhy na operaci | HELIOS → SkyPlanner | Úvodní načtení, poté při změně |
| Plánovací kalendáře | Směny a nepracovní dny | HELIOS → SkyPlanner | Denně, nebo vlastní směny ve SkyPlanner |
| Výrobní příkazy, jejich dílce a operace, materiály pro výrobu | Zakázky a operace s termíny dokončení a požadavky na materiál | HELIOS → SkyPlanner | Načítání každých několik minut |
| Stav skladu | Skladové zůstatky | HELIOS → SkyPlanner | Dotazování každou hodinu nebo při spuštění rozvrhování |
| Vydané objednávky s termíny dodání | Nákupní objednávky, očekávaný materiál podle termínu dodání | HELIOS → SkyPlanner | Načítání každou hodinu nebo při spuštění plánování |
| Plánované zahájení a dokončení každé operace výrobního příkazu (externí akce) | Plánované zahájení a dokončení každé operace | SkyPlanner → HELIOS | Při změně plánu prostřednictvím webhooku SkyPlanner |
| Evidence výrobních operací | Časové záznamy a potvrzení obsluhy | SkyPlanner → HELIOS | Při každém potvrzení nebo za směnu, pokud tuto možnost zvolíte |
| Není v HELIOS | Matice časů seřízení, nástroje jako zdroje s omezenou kapacitou, operace s více pracovníky obsluhy | Spravováno ve SkyPlanner | Nastavení během zavádění |
Integrační postupy
1. Úvodní načtení kmenových dat. Z přehledů TPV načtěte vyráběné dílce, kusovníky, technologické postupy, pracoviště, stroje, profese, personální zdroje a kalendáře. Každý výrobní zdroj v HELIOS má příznak pro zahrnutí do kapacitního plánování. U každého proto rozhodněte, zda jej bude SkyPlanner plánovat. Z pracoviště se čtyřmi stroji vznikne jedna skupina pracovišť nebo čtyři pracoviště.
2. Synchronizace příkazů a objednávek. Načtěte výrobní příkazy včetně dílců, operací a materiálů a také vydané objednávky. SkyPlanner považuje objednaný materiál za dostupný k termínu dodání objednávky a aktualizuje stav skladu, jakmile je objednávka označena jako Delivered. Do plánu zařazujte uvolněné výrobní příkazy. Plánovaná množství ve výrobním plánu zůstávají v HELIOS, dokud se z nich nestanou výrobní příkazy.
3. Zpětný zápis plánu. Když plánovací algoritmus zařadí nebo přesune operaci, webhook SkyPlanner spustí externí akci nad přehledem výrobních příkazů prostřednictvím /api/v1/actions/execute. Jde o proceduru HELIOS dohodnutou při vymezení rozsahu, která nastaví plánované zahájení a dokončení operace výrobního příkazu. HELIOS změnu ověří podle vlastní logiky.
4. Odvádění výroby. Obsluha zaznamenává práci pomocí SkyPlanner Mobile Confirmations nebo Production Timer a časové záznamy udržují plán aktuální. Sami rozhodnete, zda se skutečné časy budou zapisovat zpět do HELIOS. Pokud ano, externí akce je zapíše do evidence výrobních operací ke konkrétní operaci příkazu. Pokud ne, obsluha nadále odvádí práci na terminálech HELIOS a SkyPlanner tyto záznamy načítá.
5. Pravidla správy dat a řešení konfliktů. Sepište je před spuštěním ostrého provozu:
| Data | Spravující systém |
|---|---|
| Položky, kusovníky, technologické postupy, množství, stav příkazu | HELIOS |
| Pořadí operací, časy zahájení a dokončení, přiřazení strojů | SkyPlanner |
| Matice přípravných časů, požadavky na nástroje a obsluhu, alternativní zdroje | SkyPlanner |
| Směny a nepracovní dny | Jeden systém zvolený při vymezení rozsahu |
| Evidence výrobních operací, výdejky a příjemky materiálu | HELIOS, s přímým zadáváním nebo přenosem časových záznamů ze SkyPlanner |
Určete jediný systém, který bude zapisovat termíny příkazů. Pokud termíny stále zapisuje kapacitní plánování HELIOS nebo Nephrite APS, vypněte tento zápis u příkazů plánovaných ve SkyPlanner, nebo ponechte plán v HELIOS pouze jako testovací.
Obvyklé kroky projektu
Implementace se obvykle dokončí během několika týdnů od zahájení zavádění. Ještě předtím ověřte plán v rámci 30denního bezplatného zkušebního období s pracovišti, technologickými postupy a otevřenými výrobními příkazy exportovanými z HELIOS do CSV nebo Excelu.
- Mapování. Dohodněte konečnou podobu mapovací tabulky, pravidla odpovědnosti za data, intervaly synchronizace a to, zda se bude evidence výrobních operací zapisovat zpět.
- Přístup k HELIOS. Nastavte Helios Inuvio Server, integračního uživatele, přihlašovací údaje OAuth2 a licenci REST API. Nejprve vše otestujte na kopii databáze.
- Úvodní načtení. Vyráběné dílce, kusovníky, technologické postupy, pracoviště, stroje, profese, kalendáře.
- Synchronizace výrobních příkazů a nákupních objednávek. Pravidelné načítání s filtrováním, stránkováním a opakováním neúspěšných požadavků.
- Nastavení omezení ve SkyPlanner. Matice přípravných časů, nástroje, počty pracovníků obsluhy pro jednotlivé operace a alternativní stroje nebo pracovníci.
- Zpětný zápis plánu. Vytvořte a otestujte externí akce pro plánované termíny a případně i pro evidenci výrobních operací.
- Paralelní testování. Provozujte SkyPlanner souběžně se stávajícím plánem, porovnejte termíny a opravte kmenová data.
- Spuštění ostrého provozu. Jakmile data souhlasí, zapněte zpětný zápis.
S čím počítat při integraci HELIOS
- Příznaky plánování. Spolehlivé údaje o kapacitě mají pouze výrobní zdroje označené pro kapacitní plánování. Před prvním načtením zkontrolujte příznaky u pracovišť, strojů, profesí a kooperací.
- Časové jednotky. Přípravné, jednotkové a dokončovací časy lze zadávat v hodinách, minutách nebo sekundách. Při importu jednotky převeďte, jinak budou všechny doby trvání chybné.
- Mezioperační čas. Konstantní mezioperační čas představuje čekání mezi operacemi, nikoli strojní čas. Modelujte jej jako čekání, ne jako čerpání kapacity.
- Kooperační operace. Dopravní čas se započítává při cestě tam i zpět. Kooperace modelujte jako kroky, které zabírají pouze čas.
- Přehledy umožňující zápis. Všechny přehledy podporují čtení, ale jen některé umožňují vytvářet, aktualizovat a mazat záznamy. Které to jsou, zjistíte voláním GET /browses/list s filtrem browseCreateImplemented=1. Přehledy výrobních příkazů jsou pouze pro čtení, takže plánované termíny se zapisují zpět prostřednictvím dohodnuté externí akce.
Kdo nastavuje integraci s HELIOS a zajišťuje její podporu
- Tým SkyPlanner integraci nastaví při zavádění a po spuštění zajišťuje její podporu v rozsahu dohodnutých přehledů a externích akcí. Každý závod používá HELIOS jinak a právě při nastavení se tyto znalosti uplatní.
- Zapojit se může i váš partner pro HELIOS. Zná vaši instalaci, vlastní procedury i licenční podmínky a může společně s týmem SkyPlanner nastavit Helios Inuvio Server a externí akce.
- Integraci mohou dále rozvíjet i vaši vlastní vývojáři pomocí REST API systému SkyPlanner a API tokenu. Pro začátek stačí API token a tým SkyPlanner v případě potřeby pomůže. Podrobnosti najdete v dokumentaci integrace SkyPlanner.
Cena SkyPlanner začíná na 199 € měsíčně a zahrnuje 5 pracovišť. Fakturace je měsíční. Cenu integrace stanovíme předem podle vašich procesů a potřeb společně s cenou tarifu. Podívejte se na ceník, kapacitní plánování pro HELIOS, stránku HELIOS a přehled integrací s ERP. Základy najdete na stránce plánování výroby.
Jak výrobní firmy hodnotí SkyPlanner
2 hušetřené každý týden
„Díky SkyPlanner jsme přešli od plánování výroby v tabulkách Excelu k optimalizaci výroby v reálném čase.“
Kalle Kalliomäki, specialista dodavatelského řetězce
UTU · Elektrické rozváděče a spínací zařízení
Plánování výroby šetří každý týden 2 hodiny práce a nová fronta operací se na linku dostane během několika sekund.
+90 %efektivita výroby
„Efektivita výroby vzrostla o 90 %.“
Abdul Rucyinga, vedoucí IT
Laboratory & Allied · Farmaceutická výroba
Efektivita výroby vzrostla o 90 % a vytvoření optimalizovaného plánu na tři měsíce pro všechna pracoviště trvá méně než 30 minut.
1 000 a víceautomaticky naplánovaných výrobních příkazů
„Výrobu máme pod kontrolou úplně jinak a náš přehled o kapacitách je na zcela jiné úrovni.“
Hannu Ryynänen, generální ředitel
Mamec · Průmyslová míchadla, čerpadla a technologicky náročná zakázková výroba
Tisíce výrobních příkazů se plánují automaticky a celá firma má přehled o výrobě v reálném čase.
100%včasnost dodávek od roku 2021
„SkyPlanner nám dává přehled o kapacitách a díky němu je plánování předvídatelné.“
Dan Berglund, COO/CFO
Opes Corporation · Chemická a potravinářská výroba
Po celou dobu používání SkyPlanner, tedy od roku 2021, dosahuje včasnost dodávek 100 %.
Časté dotazy
Má HELIOS API pro výrobní příkazy?
Ano. Helios Inuvio Server poskytuje přes REST přístup k přehledům HELIOS iNuvio, včetně výrobního plánu, výrobních příkazů, dílců příkazů, materiálů do výroby a záznamů operací. U HELIOS Nephrite tým SkyPlanner společně s vámi a vaším partnerem pro HELIOS určí způsob napojení vaší instalace při vymezení rozsahu v úvodní fázi zavádění.
Jak SkyPlanner získává změny z HELIOS?
SkyPlanner pravidelně načítá přehledy HELIOS v intervalech nastavených pro každý závod. Data filtruje na otevřené výrobní příkazy a poslední změny. Vlastní webhooky systému SkyPlanner odesílají změny plánu ihned, jakmile nastanou.
Jak se plánované termíny zapisují zpět do HELIOS?
Prostřednictvím externí akce nad přehledem výrobních příkazů, která se spouští přes /api/v1/actions/execute. Jde o proceduru HELIOS dohodnutou při vymezení rozsahu, takže HELIOS na každý přijatý termín uplatní vlastní logiku.
Jaké ověřování používá Inuvio REST API?
OAuth2 podle RFC 6749 na /oauth/token nebo starší proprietární /api/token. Vlastní API systému SkyPlanner používá API token v hlavičce Authorization-Token.
Má partner pro HELIOS doporučit HELIOS APS, nebo SkyPlanner?
SkyPlanner, pokud se zákazníkův plán často mění a musí stále respektovat omezenou kapacitu. Plánování v HELIOS probíhá formou výpočtů nad jedním aktivním plánem, může přepnout na neomezenou kapacitu kvůli dodržení termínů a řešení kolizí nechává na plánovači (nápověda HELIOS). SkyPlanner se připojuje přes REST API, automaticky přeplánovává a plánuje přestavby, nástroje, pracovní týmy i materiál. Počet uživatelů je neomezený a cena začíná na 199 € měsíčně.
Můžeme SkyPlanner vyzkoušet před vytvořením integrace?
Ano. Bezplatná 30denní zkušební verze podporuje až 20 pracovišť a import dat z HELIOS přes CSV nebo Excel. Platební kartu nepotřebujete. Vyzkoušejte SkyPlanner nebo se pro vymezení rozsahu integrace obraťte na obchodní tým.
