Integracije / ERP / HELIOS
Vodnik za integracijo sistema HELIOS s SkyPlanner APS za terminiranje proizvodnje
Ta vodnik partnerjem in ekipam IT pojasnjuje, kako povezati HELIOS iNuvio in HELIOS Nephrite s SkyPlanner APS. SkyPlanner se s sistemom HELIOS povezuje dvosmerno prek njegovih lastnih vmesnikov:
- V SkyPlanner se prenašajo proizvodni nalogi (výrobní příkazy) z operacijami, izdelovani deli, kosovnice, tehnološki postopki, delovna mesta, stroji, poklici, kadrovski viri, zaloge in nabavna naročila.
- Planirani datumi začetka in zaključka se zapisujejo nazaj v proizvodne naloge.
- Če se tako odločite, se lahko evidence časa operaterjev zapisujejo nazaj kot evidence operacij (evidence výrobních operací).
- SkyPlanner pošilja obvestila webhook o spremembah terminskega plana takoj, ko se zgodijo.
Ekipa SkyPlanner med uvajanjem prilagodi integracijo vaši namestitvi sistema HELIOS in zanjo zagotavlja podporo tudi po prehodu v redno uporabo. Vodnik je namenjen partnerjem in razvijalcem za HELIOS, ki želijo sodelovati pri integraciji ali sami razvijati rešitve na podlagi dokumentiranega vmesnika REST API sistema SkyPlanner (referenčna dokumentacija API).
Integracijski vmesniki sistema HELIOS
Helios Inuvio Server (Inuvio REST API). Asseco ga opisuje kot ločen del sistema HELIOS iNuvio, ki prek vmesnika REST API omogoča dostop do njegovih evidenc (pomoč za Helios Inuvio Server). Vključen je v distribucijo iNuvio, specifikacija OpenAPI pa je objavljena v oblikah Rapidoc in Redoc. API deluje s pregledi sistema HELIOS (browses), od katerih ima vsak svoj ID in pravice dostopa:
- GET /browses/list in GET /browses/meta vrneta seznam razpoložljivih pregledov in njihovih stolpcev.
- /browses/data bere vrstice pregleda in jih zapisuje, če pregled omogoča ustvarjanje, posodabljanje in brisanje.
- /api/v1/actions/meta in /api/v1/actions/execute/{dbName}/{browseIdent}/{actionIdent} izvajata zunanja dejanja v pregledu. Trenutno so to zunanja dejanja tipov Procedure, Browse in Plugin.
Med proizvodne preglede, ki jih uporablja planer, spadajo proizvodni plan (výrobní plán), proizvodni nalogi (výrobní příkazy), deli na proizvodnih nalogih, materiali in polizdelki za proizvodnjo, poklici, kadrovski viri, prednastavitve operacij tehnoloških postopkov in evidence operacij. Na enak način so na voljo tudi zaloge, prejemi, izdaje in izdana nabavna naročila (vydané objednávky).
HELIOS Nephrite REST API. Razvojni načrt za Nephrite vključuje razvoj vmesnika REST API (razvojni načrt za HELIOS Nephrite). Ekipa SkyPlanner med opredelitvijo obsega skupaj z vami in vašim partnerjem za HELIOS potrdi končne točke Nephrite za vašo namestitev. Spodaj opisani podatkovni tokovi ostanejo enaki.
Excel in CSV. Vsak pregled v sistemu HELIOS omogoča izvoz v Microsoft Office, kar zadostuje za poskusni uvoz podatkov.
Avtentikacija in licenciranje
- Dva načina avtentikacije. iNuvio ponuja starejši lastniški API za avtentikacijo (/api/token) in novejši API OAuth2, ki temelji na RFC 6749 (/oauth/token, /oauth/revoke). Žetoni se osvežujejo prek POST /oauth/token ali GET /api/token.
- Licenciranje. Helios Inuvio Server je brezplačen, za REST API pa je potrebna licenca. Od različice 3.0.2026.0301 sta sistemski API in API za evidence združena v enoten Inuvio REST API, dostop do API pa ni več omejen s številom uporabnikov.
- Pravice. Uporabnik za integracijo potrebuje pravice za branje proizvodnih in skladiščnih pregledov ter pravico za izvajanje dogovorjenih zunanjih dejanj.
Na strani sistema SkyPlanner avtentikacija za REST API poteka z žetonom API v glavi Authorization-Token (SkyPlanner Settings > API). Vmesnik je dokumentiran v Swagger/OpenAPI. Vodič za integracijo vas vodi skozi prve klice.
Dogodki in periodično poizvedovanje
SkyPlanner bere podatke iz sistema HELIOS v določenih časovnih intervalih. Nove naloge pridobi s klici /browses/data, filtriranimi na odprte proizvodne naloge in nedavne spremembe. Pogostost se določi za vsak obrat posebej: od vsakih nekaj minut za proizvodne naloge do enkrat na uro za zaloge.
SkyPlanner ob spremembi stanja ali terminskega plana pošlje obvestila webhook, zato povratni zapis temelji na dogodkih.
Preslikava podatkov
| Objekt v sistemu HELIOS (pregled) | Objekt SkyPlanner | Smer | Pogostost |
|---|---|---|---|
| Kartice artiklov in izdelovani deli (vyráběné dílce), merske enote | Izdelki in materiali | HELIOS → SkyPlanner | Začetni uvoz, nato periodično poizvedovanje |
| Kosovnice (kusovník, kusovníkové vazby) z datumsko veljavnostjo | Struktura izdelka, podizdelki, materiali za posamezni izdelek | HELIOS → SkyPlanner | Začetni prenos, nato ob spremembi |
| Tehnološki postopki (technologický postup): operacija, delovno mesto, pripravljalni čas stroja in operaterja, čas na enoto, zaključni čas, medoperacijski čas | Koraki postopka s trajanjem ter časi priprave in pospravljanja | HELIOS → SkyPlanner | Začetni prenos, nato ob spremembi |
| Delovna mesta (pracoviště), stroji (stroje), nadomestna delovna mesta | Delovni centri, skupine delovnih centrov, nadomestni delovni centri | HELIOS → SkyPlanner | Začetni prenos, pozneje redko |
| Poklici (výrobní profese), kadrovski viri (výrobní personální zdroje) | Osebje in število operaterjev za posamezno operacijo | HELIOS → SkyPlanner | Začetni uvoz, nato ob spremembah |
| Planski koledarji (plánovací kalendáře) | Izmene in dela prosti dnevi | HELIOS → SkyPlanner | Dnevno ali samostojno upravljanje izmen v sistemu SkyPlanner |
| Proizvodni nalogi (výrobní příkazy), deli in operacije na nalogih, materiali za proizvodnjo | Nalogi in operacije z roki dokončanja in potrebami po materialu | HELIOS → SkyPlanner | Poizvedovanje vsakih nekaj minut |
| Zaloge (stav skladu) | Stanje zalog | HELIOS → SkyPlanner | Periodično preverjanje, vsako uro ali ob zagonu terminiranja |
| Izdana nabavna naročila (vydané objednávky) z datumi dobave | Nabavna naročila, prihajajoči material po datumih dobave | HELIOS → SkyPlanner | Poizvedovanje vsako uro ali ob zagonu terminiranja |
| Planirani začetek in zaključek posamezne operacije proizvodnega naloga (zunanje dejanje) | Planirani začetek in zaključek posamezne operacije | SkyPlanner → HELIOS | Ob spremembi terminskega plana prek obvestila webhook sistema SkyPlanner |
| Evidence operacij (evidence výrobních operací) | Evidence časa in potrditve operaterjev | SkyPlanner → HELIOS | Ob vsaki potrditvi ali za vsako izmeno, če se tako odločite |
| Ni v sistemu HELIOS | Matrika pripravljalnih časov, orodja kot viri z omejeno razpoložljivostjo, operacije z več operaterji | Upravljanje v sistemu SkyPlanner | Nastavitev med uvajanjem |
Načini integracije
1. Začetni uvoz matičnih podatkov. Iz pregledov TPV preberite izdelovane dele, kosovnice, tehnološke postopke, delovna mesta, stroje, poklice, kadrovske vire in koledarje. Vsak vir v sistemu HELIOS ima oznako za vključitev v planiranje proizvodnih kapacitet, zato za vsak vir določite, kaj bo SkyPlanner terminiral. Delovno mesto s štirimi stroji postane ena skupina delovnih centrov ali štirje delovni centri.
2. Sinhronizacija nalogov. Preberite proizvodne naloge z njihovimi deli, operacijami in materiali ter izdana nabavna naročila. SkyPlanner obravnava naročeni material kot razpoložljiv na datum dobave nabavnega naročila in posodobi zalogo, ko je naročilo označeno s statusom Delivered. Terminirajte sproščene proizvodne naloge. Planirane količine v proizvodnem planu ostanejo v sistemu HELIOS, dokler ne postanejo proizvodni nalogi.
3. Povratni zapis terminskega plana. Ko mehanizem za terminiranje razporedi ali premakne operacijo, obvestilo webhook sistema SkyPlanner prek /api/v1/actions/execute sproži zunanje dejanje v pregledu proizvodnih nalogov. To dejanje je procedura v sistemu HELIOS, dogovorjena med opredelitvijo obsega, ki nastavi planirani začetek in zaključek operacije na nalogu. HELIOS spremembo preveri s svojo poslovno logiko.
4. Potrjevanje v proizvodnji. Operaterji beležijo delo s SkyPlanner Mobile Confirmations ali Production Timer, evidence časa pa zagotavljajo ažurnost terminskega plana. Sami izberete, ali se dejanski časi zapisujejo nazaj v HELIOS. Če se za to odločite, jih zunanje dejanje zabeleži kot evidence operacij za vsako operacijo na nalogu. Sicer operaterji še naprej poročajo prek terminalov HELIOS, SkyPlanner pa bere te evidence.
5. Pravila o skrbništvu podatkov in reševanju navzkrižij. Zapišite jih pred prehodom v produkcijo:
| Podatki | Skrbnik |
|---|---|
| Artikli, kosovnice, tehnološki postopki, količine, status naloga | HELIOS |
| Zaporedje operacij, časi začetka in konca, dodelitev strojev | SkyPlanner |
| Matrika pripravljalnih časov, zahteve glede orodij in operaterjev, nadomestni viri | SkyPlanner |
| Izmene in dela prosti dnevi | En sistem, izbran pri opredelitvi obsega |
| Evidence operacij, izdaje in prejemi materiala | HELIOS; podatki se vnesejo v njem ali prenesejo iz evidenc časa sistema SkyPlanner |
Za zapisovanje datumov nalogov določite en sam sistem. Če datume še vedno zapisuje planiranje proizvodnih kapacitet v sistemu HELIOS ali Nephrite APS, to izklopite za naloge, ki jih terminira SkyPlanner, ali pa plan v sistemu HELIOS uporabljajte le kot testni plan.
Običajni koraki projekta
Implementacija je običajno končana v nekaj tednih po začetku uvajanja. Pred tem preverite terminski plan v 30-dnevnem brezplačnem preizkusu z delovnimi mesti, tehnološkimi postopki in odprtimi proizvodnimi nalogi, izvoženimi iz sistema HELIOS v obliki CSV ali Excel.
- Preslikava. Dokončno določite tabelo preslikav, pravila o pristojnosti za podatke, pogostost sinhronizacije in to, ali se evidence operacij zapisujejo nazaj.
- Dostop do sistema HELIOS. Nastavite Helios Inuvio Server, uporabnika za integracijo in poverilnice OAuth2 ter uredite licenco za REST API. Najprej preizkusite delovanje na kopiji podatkovne zbirke.
- Začetni uvoz. Izdelovani deli, kosovnice, tehnološki postopki, delovna mesta, stroji, poklici in koledarji.
- Sinhronizacija proizvodnih nalogov in nabavnih naročil. Periodično poizvedovanje s filtri, ostranjevanjem in ponovnimi poskusi.
- Nastavitev omejitev v sistemu SkyPlanner. Matrika pripravljalnih časov, orodja, število operaterjev na operacijo ter nadomestni stroji ali osebje.
- Povratni zapis terminskega plana. Ustvarite in preizkusite zunanja dejanja za planirane datume in, če se za to odločite, za evidence operacij.
- Vzporedno testiranje. Uporabljajte SkyPlanner vzporedno z obstoječim planom, primerjajte datume in popravite matične podatke.
- Prehod v produkcijo. Ko se podatki ujemajo, vklopite povratni zapis.
Kaj upoštevati pri integraciji s sistemom HELIOS
- Oznake za planiranje. Zanesljive podatke o kapacitetah imajo le viri, označeni za planiranje proizvodnih kapacitet. Pred prvim uvozom preverite oznake pri delovnih mestih, strojih, poklicih in kooperacijah.
- Časovne enote. Pripravljalni časi, časi na enoto in zaključni časi so lahko vneseni v urah, minutah ali sekundah. Ob uvozu jih pretvorite, sicer bodo vsa trajanja napačna.
- Medoperacijski čas. Stalni medoperacijski čas pomeni čakanje med operacijami, ne strojnega časa. Modelirajte ga kot čakanje, ne kot zasedenost kapacitet.
- Kooperantske operacije (kooperace). Čas prevoza se upošteva v obe smeri. Kooperantske operacije modelirajte kot korake, ki imajo le časovno trajanje.
- Pregledi z možnostjo zapisovanja. Vsi pregledi omogočajo branje, le nekateri pa tudi ustvarjanje, posodabljanje in brisanje. Kateri so to, pokaže GET /browses/list s filtrom browseCreateImplemented=1. Pregledi proizvodnih nalogov omogočajo samo branje, zato se planirani datumi vračajo prek dogovorjenega zunanjega dejanja.
Kdo nastavi integracijo s HELIOS in zagotavlja podporo
- Ekipa SkyPlanner integracijo nastavi med uvajanjem in zagotavlja podporo po zagonu, in sicer za dogovorjene preglede in zunanja dejanja. Vsak obrat uporablja HELIOS drugače, zato je pri tem ključno poznavanje njegove uporabe.
- Sodeluje lahko tudi vaš partner za HELIOS. Partner pozna vašo namestitev, prilagojene postopke in licenciranje ter lahko skupaj z ekipo SkyPlanner nastavi Helios Inuvio Server in zunanja dejanja.
- Integracijo lahko nadgradijo tudi vaši razvijalci, ki se na SkyPlanner REST API povežejo z žetonom API. Za začetek zadostuje žeton API, ekipa SkyPlanner pa po potrebi pomaga. Dokumentacija je na voljo na strani Dokumentacija za integracijo SkyPlanner.
SkyPlanner je na voljo od 199 € na mesec z vključenimi 5 delovnimi centri in mesečnim obračunavanjem. Ponudbo za integracijo pripravimo vnaprej glede na vaš proces in potrebe, skupaj s ponudbo za izbrani paket. Oglejte si cenik, terminiranje proizvodnje s HELIOS ob upoštevanju dejanskih kapacitet, stran o HELIOS in pregled integracij s sistemi ERP. Osnove terminiranja so predstavljene na strani Terminiranje proizvodnje.
Mnenja proizvodnih podjetij o SkyPlanner
2 hprihranka vsak teden
»S SkyPlanner smo pri planiranju proizvodnje prešli z Excelovih preglednic na optimizacijo proizvodnje v realnem času.«
Kalle Kalliomäki, strokovnjak za oskrbovalno verigo
UTU · Električni razdelilniki in stikalne naprave
Pri planiranju proizvodnje vsak teden prihranijo 2 uri dela, nova čakalna vrsta operacij pa pride do proizvodne linije v nekaj sekundah.
+90%učinkovitost proizvodnje
»Učinkovitost v proizvodnji se je povečala za 90%.«
Abdul Rucyinga, vodja IT
Laboratory & Allied · Farmacevtska proizvodnja
Učinkovitost proizvodnje se je povečala za 90%, priprava optimiziranega trimesečnega plana za vse delovne centre pa traja manj kot 30 minut.
1.000+samodejno terminiranih delovnih nalogov
»Proizvodnjo obvladujemo drugače, kapacitete pa razumemo na povsem drugi ravni.«
Hannu Ryynänen, generalni direktor
Mamec · Industrijska mešala, črpalke in visokotehnološka pogodbena proizvodnja
Na tisoče delovnih nalogov se terminira samodejno, celotna organizacija pa ima sproten vpogled v proizvodnjo.
100%zanesljivost dobav od leta 2021
»SkyPlanner nam omogoča vpogled v kapacitete in zagotavlja predvidljivost pri planiranju.«
Dan Berglund, COO/CFO
Opes Corporation · Kemična in živilska proizvodnja
Zanesljivost dobav je 100% ves čas uporabe sistema SkyPlanner, od leta 2021.
Pogosta vprašanja
Ali ima HELIOS API za proizvodne naloge?
Da. Helios Inuvio Server omogoča dostop prek REST do pregledov v HELIOS iNuvio, vključno s proizvodnim planom, proizvodnimi nalogi, deli nalogov, materiali za proizvodnjo in zapisi operacij. Za HELIOS Nephrite ekipa SkyPlanner med opredelitvijo obsega uvajanja skupaj z vami in vašim partnerjem za HELIOS določi način povezave za vašo namestitev.
Kako SkyPlanner prevzema spremembe iz HELIOS?
SkyPlanner v pregledih HELIOS preverja podatke v intervalih, določenih za posamezni obrat, pri čemer jih filtrira na odprte proizvodne naloge in nedavne spremembe. Lastni spletni kavlji sistema SkyPlanner pošiljajo spremembe terminskega plana takoj, ko nastanejo.
Kako se planirani datumi zapisujejo nazaj v HELIOS?
Prek zunanjega dejanja v pregledu proizvodnih nalogov, ki se izvede z /api/v1/actions/execute. Dejanje je postopek HELIOS, dogovorjen med opredelitvijo obsega, zato HELIOS za vsak prejeti datum uporabi svojo logiko.
Kakšno avtentikacijo uporablja Inuvio REST API?
OAuth2 po RFC 6749 na /oauth/token ali starejšo lastniško rešitev na /api/token. Lastni API sistema SkyPlanner uporablja žeton API v glavi Authorization-Token.
Naj partner za HELIOS predlaga HELIOS APS ali SkyPlanner?
SkyPlanner, kadar se plan stranke pogosto spreminja in mora upoštevati dejanske omejitve kapacitet. HELIOS pri planiranju izvaja izračune na enem aktivnem planu, lahko za doseganje rokov preklopi na neomejene kapacitete, reševanje prekrivanj pa prepusti planerju (pomoč za HELIOS). SkyPlanner se poveže prek REST API, samodejno posodablja terminski plan, planira prehode med operacijami, orodja, ekipe in material ter omogoča neomejeno število uporabnikov, od 199 € na mesec.
Ali lahko SkyPlanner preizkusimo pred izdelavo integracije?
Da. 30-dnevni brezplačni preizkus podpira do 20 delovnih centrov z uvozom podatkov iz HELIOS prek datotek CSV ali Excel, brez kreditne kartice. Začnite preizkus ali stopite v stik s prodajo, da opredelite obseg integracije.
