Integrasjoner / ERP / HELIOS
Veiledning for HELIOS-integrasjon for produksjonsplanlegging med SkyPlanner APS
Denne veiledningen viser partnere og IT-team hvordan de kobler HELIOS iNuvio og HELIOS Nephrite til SkyPlanner APS. SkyPlanner utveksler data med HELIOS i begge retninger gjennom HELIOS sine egne grensesnitt:
- Produksjonsordrer (výrobní příkazy) med tilhørende operasjoner, produserte deler, stykklister, produksjonsruter, arbeidsplasser, maskiner, faggrupper, personellressurser, lagerbeholdning og innkjøpsordrer overføres til SkyPlanner.
- Planlagte start- og sluttdatoer skrives tilbake til produksjonsordrene.
- Hvis dere ønsker det, kan operatørenes tidsregistreringer skrives tilbake som operasjonsregistreringer (evidence výrobních operací).
- SkyPlanners webhooks sender planendringer fortløpende.
SkyPlanner-teamet tilpasser integrasjonen til HELIOS-oppsettet deres under oppstarten og gir støtte etter at løsningen er satt i drift. Denne veiledningen er for HELIOS-partnere og utviklere som vil delta i arbeidet eller selv bygge videre på det dokumenterte REST API-et til SkyPlanner (API-referanse).
Integrasjonsgrensesnitt i HELIOS
Helios Inuvio Server (Inuvio REST API). Asseco beskriver dette som en separat del av HELIOS iNuvio som gir tilgang til modulene i HELIOS iNuvio via REST API (hjelp for Helios Inuvio Server). Den følger med iNuvio-distribusjonen, og OpenAPI-spesifikasjonen er publisert i Rapidoc- og Redoc-format. API-et arbeider mot HELIOS-oversikter (browses), hver med egen ID og egne rettigheter:
- GET /browses/list og GET /browses/meta viser tilgjengelige oversikter og kolonnene deres.
- /browses/data leser rader fra en oversikt og skriver rader der oversikten tillater oppretting, oppdatering og sletting.
- /api/v1/actions/meta og /api/v1/actions/execute/{dbName}/{browseIdent}/{actionIdent} kjører eksterne handlinger på en oversikt. I dag støttes eksterne handlinger av typene Procedure, Browse og Plugin.
Produksjonsoversiktene en planlegger bruker, omfatter produksjonsplanen (výrobní plán), produksjonsordrer (výrobní příkazy), deler på produksjonsordrer, materialer og halvfabrikata til produksjon, faggrupper, personellressurser, forhåndsinnstillinger for operasjoner i produksjonsruter og operasjonsregistreringer. Lagerbeholdning, varemottak, lageruttak og utstedte innkjøpsordrer (vydané objednávky) er tilgjengelige på samme måte.
HELIOS Nephrite REST API. Utvikling av REST API står på veikartet for Nephrite (veikart for HELIOS Nephrite). Under avklaringen bekrefter SkyPlanner-teamet endepunktene for Nephrite-installasjonen deres sammen med dere og HELIOS-partneren deres. Dataflytene nedenfor er de samme.
Excel og CSV. Alle HELIOS-oversikter kan eksporteres til Microsoft Office. Det er tilstrekkelig for å laste inn data til utprøving.
Autentisering og lisensiering
- To måter å autentisere på. iNuvio tilbyr et eldre, proprietært autentiserings-API (/api/token) og et nyere OAuth2 API basert på RFC 6749 (/oauth/token, /oauth/revoke). Tokener fornyes via POST /oauth/token eller GET /api/token.
- Lisensiering. Selve Helios Inuvio Server er gratis, mens REST API-et krever lisens. Fra versjon 3.0.2026.0301 er system- og modul-API-ene samlet i ett Inuvio REST API, og API-tilgangen er ikke lenger begrenset av antall brukere.
- Rettigheter. Integrasjonsbrukeren trenger leserettigheter til produksjons- og lageroversiktene og rettighet til å kjøre de avtalte eksterne handlingene.
Hos SkyPlanner autentiseres REST API-et med et API-token i Authorization-Token-headeren (SkyPlanner Settings > API). API-et er dokumentert i Swagger/OpenAPI. Integrasjonsveiledningen viser hvordan dere gjør de første kallene.
Hendelser og polling
SkyPlanner henter data fra HELIOS med faste intervaller. Kall til /browses/data filtreres på åpne produksjonsordrer og nylige endringer for å hente inn nytt arbeid. Hyppigheten fastsettes per fabrikk: produksjonsordrer hentes med noen minutters mellomrom, mens lagerbeholdningen hentes hver time.
SkyPlanner sender webhooks når status eller produksjonsplanen endres. Tilbakeskrivingen er dermed hendelsesstyrt.
Datakobling
| HELIOS-objekt (oversikt) | Objekt i SkyPlanner | Retning | Hyppighet |
|---|---|---|---|
| Varekort og produserte deler (vyráběné dílce), enheter | Produkter og materialer | HELIOS → SkyPlanner | Første innlasting, deretter polling |
| Stykklister (kusovník, kusovníkové vazby) med gyldighetsdatoer | Produktstruktur, delprodukter, materialer per produkt | HELIOS → SkyPlanner | Førstegangsinnlasting, deretter ved endringer |
| Produksjonsruter (technologický postup): operasjon, arbeidsplass, klargjøringstid for maskin og operatør, enhetstid, avslutningstid, tid mellom operasjoner | Prosesstrinn med varighet, rigg- og nedriggingstider | HELIOS → SkyPlanner | Førstegangsinnlasting, deretter ved endringer |
| Arbeidsplasser (pracoviště), maskiner (stroje), alternative arbeidsplasser | Arbeidsstasjoner, grupper av arbeidsstasjoner, alternative arbeidsstasjoner | HELIOS → SkyPlanner | Førstegangsinnlasting, sjelden deretter |
| Faggrupper (výrobní profese), personellressurser (výrobní personální zdroje) | Personell og antall operatører per jobb | HELIOS → SkyPlanner | Første innlasting, deretter ved endringer |
| Planleggingskalendere (plánovací kalendáře) | Skift og arbeidsfrie dager | HELIOS → SkyPlanner | Daglig, eller egne skift i SkyPlanner |
| Produksjonsordrer (výrobní příkazy), ordredeler og operasjoner, materialer til produksjon | Ordrer og jobber med leveringsfrister og materialbehov | HELIOS → SkyPlanner | Polling med noen minutters mellomrom |
| Lagerbeholdning (stav skladu) | Lagerbeholdninger | HELIOS → SkyPlanner | Polling hver time eller ved planleggingskjøring |
| Utstedte innkjøpsordrer (vydané objednávky) med leveringsdatoer | Innkjøpsordrer, innkommende materialer etter leveringsdato | HELIOS → SkyPlanner | Polling hver time eller ved kjøring av produksjonsplanleggingen |
| Planlagt start og slutt per operasjon på produksjonsordren (ekstern handling) | Planlagt start og slutt per jobb | SkyPlanner → HELIOS | Ved endring i produksjonsplanen, via webhook fra SkyPlanner |
| Operasjonsregistreringer (evidence výrobních operací) | Tidsregistreringer og operatørbekreftelser | SkyPlanner → HELIOS | Per bekreftelse eller per skift, hvis dette velges |
| Finnes ikke i HELIOS | Omstillingsmatrise, verktøy som ressurser med begrenset kapasitet, jobber med flere operatører | Vedlikeholdes i SkyPlanner | Settes opp under oppstarten |
Integrasjonsmønstre
1. Første innlasting av grunndata. Hent produserte deler, stykklister, produksjonsruter, arbeidsplasser, maskiner, faggrupper, personellressurser og kalendere fra TPV-oversiktene. Hver HELIOS-ressurs har en markering som angir om den skal inngå i kapasitetsplanleggingen. Avgjør derfor for hver ressurs hva SkyPlanner skal planlegge. En arbeidsplass med fire maskiner blir til én gruppe av arbeidsstasjoner eller fire arbeidsstasjoner.
2. Ordresynkronisering. Hent produksjonsordrer med tilhørende deler, operasjoner og materialer, samt utstedte innkjøpsordrer. SkyPlanner regner bestilte materialer som tilgjengelige på innkjøpsordrens leveringsdato og oppdaterer lagerbeholdningen når innkjøpsordren merkes som Delivered. Planlegg frigitte produksjonsordrer. Planlagte mengder i produksjonsplanen blir i HELIOS til de blir til produksjonsordrer.
3. Tilbakeskriving av produksjonsplanen. Når planleggingsmotoren plasserer eller flytter en jobb, utløser en webhook fra SkyPlanner en ekstern handling på produksjonsordreoversikten via /api/v1/actions/execute. Handlingen er en HELIOS-prosedyre som avtales under avklaringen, og som setter planlagt start og slutt for ordreoperasjonen. HELIOS validerer endringen med sin egen logikk.
4. Bekreftelser fra produksjonsgulvet. Operatørene registrerer arbeid med SkyPlanner Mobile Confirmations eller Production Timer, og tidsregistreringene holder produksjonsplanen oppdatert. Dere velger om faktiske tider skal skrives tilbake til HELIOS. Hvis ja, fører en ekstern handling dem som operasjonsregistreringer per ordreoperasjon. Hvis nei, fortsetter operatørene å rapportere på HELIOS-terminalene, og SkyPlanner leser disse registreringene.
5. Regler for dataeierskap og konflikter. Dokumenter dem før produksjonssetting:
| Data | Eier |
|---|---|
| Varer, stykklister, produksjonsruter, mengder, ordrestatus | HELIOS |
| Operasjonsrekkefølge, start- og sluttidspunkter, tildeling av maskiner | SkyPlanner |
| Omstillingsmatrise, krav til verktøy og operatører, alternative ressurser | SkyPlanner |
| Skift og fridager | Ett system, valgt under avklaringen |
| Operasjonsregistreringer, materialuttak og varemottak | HELIOS, registrert der eller overført fra tidsregistreringer i SkyPlanner |
Velg ett system som skriver ordredatoer. Hvis kapasitetsplanleggingen i HELIOS eller Nephrite APS fortsatt skriver datoer, må dere slå av dette for ordrer som SkyPlanner planlegger, eller bare bruke HELIOS-planen som testplan.
Typiske prosjekttrinn
Implementeringen er normalt ferdig i løpet av noen uker etter at oppstartsarbeidet begynner. Før det bør dere validere produksjonsplanen i den gratis prøveperioden på 30 dager, med arbeidsplasser, produksjonsruter og åpne produksjonsordrer eksportert fra HELIOS som CSV eller Excel.
- Datakobling. Fastsett koblingstabellen, eierskapsreglene, synkroniseringsintervallene og om operasjonsregistreringer skal skrives tilbake.
- HELIOS-tilgang. Sett opp Helios Inuvio Server, integrasjonsbrukeren, OAuth2-påloggingsinformasjon og lisens for REST API. Test først på en kopi av databasen.
- Første innlasting. Produserte deler, stykklister, produksjonsruter, arbeidsplasser, maskiner, faggrupper og kalendere.
- Synkronisering av produksjons- og innkjøpsordrer. Polling med filtre, sideinndeling og nye forsøk ved feil.
- Oppsett av begrensninger i SkyPlanner. Omstillingsmatrise, verktøy, antall operatører per jobb og alternative maskiner eller medarbeidere.
- Tilbakeskriving av produksjonsplanen. Opprett og test de eksterne handlingene for planlagte datoer og, hvis dere har valgt det, operasjonsregistreringer.
- Parallelltesting. Kjør SkyPlanner parallelt med den gjeldende planen, sammenlign datoer og rett opp grunndata.
- Produksjonssetting. Aktiver tilbakeskriving når dataene stemmer overens.
Hva dere må ta høyde for i en HELIOS-integrasjon
- Markeringer for planlegging. Bare ressurser som er merket for kapasitetsplanlegging, har pålitelige kapasitetsdata. Kontroller markeringene for arbeidsplasser, maskiner, faggrupper og underleverandøroppdrag før første innlasting.
- Tidsenheter. Klargjøringstid, stykktid og avslutningstid kan angis i timer, minutter eller sekunder. Konverter enhetene ved import, ellers blir alle varigheter feil.
- Tid mellom operasjoner. Den faste tiden mellom operasjoner er ventetid, ikke maskintid. Modeller den som ventetid, ikke som kapasitet.
- Underleverandøroperasjoner (kooperace). Transporttid gjelder både ut og tilbake. Modeller underleverandørarbeid som trinn som bare tar tid.
- Oversikter med skrivetilgang. Alle oversikter støtter lesing, men bare noen støtter oppretting, oppdatering og sletting. GET /browses/list med filteret browseCreateImplemented=1 viser hvilke. Oversikter over produksjonsordrer er skrivebeskyttet, så planlagte datoer sendes tilbake via den avtalte eksterne handlingen.
Hvem setter opp og støtter HELIOS-integrasjonen?
- SkyPlanner-teamet setter opp integrasjonen under innføringen og gir støtte etter produksjonsstart. Dette omfatter de avtalte oversiktene og eksterne handlingene. Hver fabrikk bruker HELIOS på sin måte, og denne kunnskapen ligger til grunn for oppsettet.
- HELIOS-partneren din kan delta. Partneren kjenner installasjonen, de tilpassede prosedyrene og lisensvilkårene deres, og kan sette opp Helios Inuvio Server og de eksterne handlingene sammen med SkyPlanner-teamet.
- Egne utviklere kan bygge videre på integrasjonen mot SkyPlanners REST API med et API-token. Et API-token er nok for å komme i gang, og SkyPlanner-teamet hjelper til ved behov. Integrasjonsdokumentasjonen finner du i SkyPlanners integrasjonsdokumentasjon.
SkyPlanner koster fra 199 € per måned med 5 arbeidsstasjoner inkludert og månedlig fakturering. Du får et pristilbud på integrasjonen på forhånd, tilpasset prosessene og behovene dine, sammen med abonnementet. Se priser, produksjonsplanlegging med HELIOS innenfor faktisk maskin- og personellkapasitet, HELIOS-siden og oversikten over ERP-integrasjoner. Du finner grunnleggende informasjon om planlegging under produksjonsplanlegging.
Produsentenes erfaringer med SkyPlanner
2 hspart hver uke
«SkyPlanner har tatt produksjonsplanleggingen vår fra Excel-ark til produksjonsoptimalisering i sanntid.»
Kalle Kalliomäki, spesialist på forsyningskjeder
UTU · Elektriske tavler og koblingsanlegg
Produksjonsplanleggingen sparer 2 timers arbeidstid hver uke, og en ny jobbkø når produksjonslinjen på sekunder.
+90%produksjonseffektivitet
«Effektiviteten i produksjonen har økt med 90%.»
Abdul Rucyinga, IT-sjef
Laboratory & Allied · Legemiddelproduksjon
Produksjonseffektiviteten har økt med 90%, og det tar under 30 minutter å lage en optimalisert plan for tre måneder for alle arbeidsstasjoner.
1 000-tallsarbeidsordrer planlegges automatisk
«Vi har kontroll på produksjonen på en helt annen måte, og forståelsen vår av kapasiteten er på et helt annet nivå.»
Hannu Ryynänen, daglig leder
Mamec · Industrielle blandere, pumper og høyteknologisk kontraktsproduksjon
Tusenvis av arbeidsordrer planlegges automatisk, og hele organisasjonen har oversikt over produksjonen i sanntid.
100%leveringspålitelighet siden 2021
«SkyPlanner gir oss oversikt over kapasiteten og gjør planleggingen forutsigbar.»
Dan Berglund, COO/CFO
Opes Corporation · Kjemisk industri og næringsmiddelproduksjon
Leveringspåliteligheten har vært 100% hele tiden SkyPlanner har vært i bruk, siden 2021.
Vanlige spørsmål
Har HELIOS et API for produksjonsordrer?
Ja. Helios Inuvio Server gir REST-tilgang til oversikter i HELIOS iNuvio, blant annet produksjonsplanen, produksjonsordrer, ordredeler, produksjonsmaterialer og operasjonsregistreringer. For HELIOS Nephrite fastsetter SkyPlanner-teamet integrasjonsmåten for installasjonen deres sammen med dere og HELIOS-partneren under avklaringen ved innføring.
Hvordan fanger SkyPlanner opp endringer i HELIOS?
SkyPlanner henter data fra HELIOS-oversiktene med intervaller som fastsettes for hver fabrikk, filtrert til åpne produksjonsordrer og nylige endringer. SkyPlanners egne webhooks sender endringer i produksjonsplanen fortløpende.
Hvordan skrives planlagte datoer tilbake til HELIOS?
Via en ekstern handling i oversikten over produksjonsordrer, som kjøres med /api/v1/actions/execute. Handlingen er en HELIOS-prosedyre som avtales under avklaringen, slik at HELIOS bruker sin egen logikk på hver dato systemet mottar.
Hvilken autentisering bruker Inuvio REST API?
OAuth2 i henhold til RFC 6749 via /oauth/token, eller den eldre, proprietære løsningen /api/token. SkyPlanners eget API bruker et API-token i Authorization-Token-headeren.
Bør en HELIOS-partner foreslå HELIOS APS eller SkyPlanner?
SkyPlanner når kundens plan endres ofte og planleggingen må holde seg innenfor tilgjengelig kapasitet. HELIOS utfører planberegninger på én aktiv plan, kan bytte til ubegrenset kapasitet for å overholde datoer og overlater kollisjoner til planleggeren (HELIOS-hjelp). SkyPlanner kobles til via REST API, planlegger om automatisk og tar med omstillinger, verktøy, arbeidslag og materialer i planen. Antall brukere er ubegrenset, og prisen er fra 199 € per måned.
Kan vi teste SkyPlanner før vi bygger integrasjonen?
Ja. Den gratis prøveperioden på 30 dager støtter opptil 20 arbeidsstasjoner med CSV- eller Excel-import fra HELIOS. Du trenger ikke kredittkort. Start prøveperioden, eller snakk med salg for å avklare integrasjonen.
