Integrationer / ERP / HELIOS
Guide till HELIOS-integration för produktionsplanering med SkyPlanner APS
Den här guiden till HELIOS-integration visar hur partner och IT-team kan koppla HELIOS iNuvio och HELIOS Nephrite till SkyPlanner APS. SkyPlanner integreras med HELIOS i båda riktningarna via HELIOS egna gränssnitt:
- Tillverkningsorder (výrobní příkazy) läses in med sina operationer, tillsammans med tillverkade detaljer, stycklistor, operationsföljder, arbetsplatser, maskiner, yrkeskategorier, personalresurser, lagersaldon och inköpsorder.
- Planerade start- och slutdatum förs tillbaka till tillverkningsorderna.
- Om du vill kan operatörernas tidrapporter föras tillbaka som operationsrapportering (evidence výrobních operací).
- SkyPlanners webhooks skickar planändringar direkt när de sker.
Under införandet konfigurerar SkyPlanner-teamet integrationen efter er HELIOS-miljö och ger support även efter driftstarten. Den här guiden är till för HELIOS-partner och utvecklare som vill delta i arbetet eller själva bygga vidare på SkyPlanners dokumenterade REST API (API-referens).
HELIOS gränssnitt för integration
Helios Inuvio Server (Inuvio REST API). Asseco beskriver detta som en separat del av HELIOS iNuvio som ger åtkomst till HELIOS iNuvios verksamhetsmoduler via REST API (Hjälp för Helios Inuvio Server). Den ingår i iNuvio-distributionen, och OpenAPI-specifikationen publiceras i Rapidoc- och Redoc-format. API:et arbetar med HELIOS vyer (browses), som var och en har ett eget ID och egna behörigheter:
- GET /browses/list och GET /browses/meta listar tillgängliga vyer och deras kolumner.
- /browses/data läser rader i en vy och skriver rader där vyn tillåter att data skapas, uppdateras och tas bort.
- /api/v1/actions/meta och /api/v1/actions/execute/{dbName}/{browseIdent}/{actionIdent} kör externa åtgärder i en vy. I dag stöds externa åtgärder av typerna Procedure, Browse och Plugin.
De produktionsvyer som en planerare använder omfattar produktionsplanen (výrobní plán), tillverkningsorder (výrobní příkazy), detaljer på tillverkningsorder, material och halvfabrikat för produktion, yrkeskategorier, personalresurser, förinställningar för operationer i operationsföljder samt operationsrapportering. Lagersaldon, inleveranser, uttag och utfärdade inköpsorder (vydané objednávky) är tillgängliga på samma sätt.
HELIOS Nephrite REST API. Nephrites utvecklingsplan tar upp utveckling av REST API (Utvecklingsplan för HELIOS Nephrite). Under kartläggningen bekräftar SkyPlanner-teamet vilka Nephrite-endpoints som gäller för er installation tillsammans med er och er HELIOS-partner. Dataflödena nedan är desamma.
Excel och CSV. Alla HELIOS-vyer kan exporteras till Microsoft Office, vilket räcker för att läsa in data under provperioden.
Autentisering och licensiering
- Två sätt att autentisera. iNuvio erbjuder ett äldre, proprietärt API för autentisering (/api/token) och ett nyare OAuth2 API som bygger på RFC 6749 (/oauth/token, /oauth/revoke). Token förnyas via POST /oauth/token eller GET /api/token.
- Licensiering. Själva Helios Inuvio Server är kostnadsfri, medan REST API kräver licens. Från version 3.0.2026.0301 slås API:erna för systemet och verksamhetsmodulerna ihop till ett gemensamt Inuvio REST API, och API-åtkomsten begränsas inte längre av antalet användare.
- Behörigheter. Integrationsanvändaren behöver läsbehörighet till produktions- och lagervyerna samt behörighet att köra de överenskomna externa åtgärderna.
På SkyPlanner-sidan sker autentiseringen till REST API med en API-token i headern Authorization-Token (SkyPlanner Settings > API). API:et är dokumenterat i Swagger/OpenAPI. Integrationshandledningen går igenom de första anropen.
Händelser och pollning
SkyPlanner läser data från HELIOS med bestämda intervall. Anrop till /browses/data filtreras på öppna tillverkningsorder och senaste ändringar för att hämta nytt arbete. Intervallet ställs in per fabrik, från några minuters mellanrum för tillverkningsorder till en gång i timmen för lagersaldon.
SkyPlanner skickar webhooks när status eller planeringen ändras, så återföringen är händelsestyrd.
Datamappning
| HELIOS-objekt (vy) | Objekt i SkyPlanner | Riktning | Frekvens |
|---|---|---|---|
| Artikelkort och tillverkade detaljer (vyráběné dílce), enheter | Produkter och material | HELIOS → SkyPlanner | Första inläsning, därefter pollning |
| Stycklistor (kusovník, kusovníkové vazby) med giltighetsdatum | Produktstruktur, delprodukter, material per produkt | HELIOS → SkyPlanner | Första inläsningen, därefter vid ändring |
| Operationsföljder (technologický postup): operation, arbetsplats, förberedelsetid för maskin och operatör, stycktid, avslutningstid, tid mellan operationer | Processteg med varaktighet, ställtid och avrustningstid | HELIOS → SkyPlanner | Första inläsningen, därefter vid ändring |
| Arbetsplatser (pracoviště), maskiner (stroje), alternativa arbetsplatser | Produktionsgrupper, grupper av produktionsgrupper, alternativa produktionsgrupper | HELIOS → SkyPlanner | Första inläsningen, sällan därefter |
| Yrkeskategorier (výrobní profese), personalresurser (výrobní personální zdroje) | Personal och antal operatörer per operation | HELIOS → SkyPlanner | Första inläsning, därefter vid ändringar |
| Planeringskalendrar (plánovací kalendáře) | Skift och arbetsfria dagar | HELIOS → SkyPlanner | Dagligen, eller egna skift i SkyPlanner |
| Tillverkningsorder (výrobní příkazy), detaljer på ordern och operationer, material för produktion | Order och operationer med färdigdatum och materialbehov | HELIOS → SkyPlanner | Pollning med några minuters mellanrum |
| Lager (stav skladu) | Lagersaldon | HELIOS → SkyPlanner | Pollning, varje timme eller vid planeringskörning |
| Utfärdade inköpsorder (vydané objednávky) med leveransdatum | Inköpsorder, inkommande material per leveransdatum | HELIOS → SkyPlanner | Pollning varje timme eller vid planeringskörning |
| Planerad start och sluttid per operation på tillverkningsordern (extern åtgärd) | Planerad start och sluttid per operation | SkyPlanner → HELIOS | När planeringen ändras, via en webhook från SkyPlanner |
| Operationsrapportering (evidence výrobních operací) | Tidrapporter och operatörskvitteringar | SkyPlanner → HELIOS | Per kvittering eller per skift, om det väljs |
| Finns inte i HELIOS | Ställtidsmatris, verktyg som resurser med begränsad kapacitet, operationer med flera operatörer | Underhålls i SkyPlanner | Konfigureras under införandet |
Integrationsmönster
1. Första inläsning av grunddata. Läs in tillverkade detaljer, stycklistor, operationsföljder, arbetsplatser, maskiner, yrkeskategorier, personalresurser och kalendrar från TPV-vyerna. Varje resurs i HELIOS har en flagga som anger om den ska ingå i kapacitetsplaneringen. Bestäm därför för varje resurs vad SkyPlanner ska planera. En arbetsplats med fyra maskiner blir en grupp av produktionsgrupper eller fyra produktionsgrupper.
2. Ordersynkronisering. Läs in tillverkningsorder med deras detaljer, operationer och material samt utfärdade inköpsorder. SkyPlanner räknar beställt material som tillgängligt på inköpsorderns leveransdatum och uppdaterar lagersaldot när inköpsordern markeras som Delivered. Planera frisläppta tillverkningsorder. Planerade kvantiteter i produktionsplanen ligger kvar i HELIOS tills de blir tillverkningsorder.
3. Återföring av planeringen. När planeringsmotorn lägger in eller flyttar en operation utlöser en webhook från SkyPlanner en extern åtgärd i vyn för tillverkningsorder via /api/v1/actions/execute. Åtgärden är en HELIOS-procedur som ni kommer överens om under kartläggningen och som sätter planerad start och sluttid för orderoperationen. HELIOS validerar ändringen med sin egen logik.
4. Kvitteringar från produktionen. Operatörerna registrerar sitt arbete med SkyPlanner Mobile Confirmations eller Production Timer, och tidrapporterna håller planeringen aktuell. Ni väljer om faktisk tid ska föras tillbaka till HELIOS. Om ni väljer det registrerar en extern åtgärd tiderna som operationsrapportering per orderoperation. Annars fortsätter operatörerna att rapportera på HELIOS-terminaler, och SkyPlanner läser in rapporteringen därifrån.
5. Dataägarskap och konfliktregler. Dokumentera dem före driftsättningen:
| Data | Ägare |
|---|---|
| Artiklar, stycklistor, operationsföljder, kvantiteter, orderstatus | HELIOS |
| Operationsföljd, start- och sluttider, maskintilldelning | SkyPlanner |
| Ställtidsmatris, krav på verktyg och operatörer, alternativa resurser | SkyPlanner |
| Skift och arbetsfria dagar | Ett system, valt under kartläggningen |
| Operationsrapportering, materialuttag och inleveranser | HELIOS, med registrering där eller överföring från SkyPlanners tidrapporter |
Välj ett enda system som skriver orderdatum. Om HELIOS kapacitetsplanering eller Nephrite APS fortfarande skriver datum ska ni stänga av det för de order som SkyPlanner planerar, eller använda HELIOS-planen enbart som testplan.
Typiska projektsteg
Implementeringen är normalt klar inom några veckor efter att införandet har startat. Innan dess ska ni validera planeringen under den kostnadsfria provperioden på 30 dagar med arbetsplatser, operationsföljder och öppna tillverkningsorder som exporterats från HELIOS som CSV eller Excel.
- Mappning. Fastställ mappningstabellen, regler för dataägarskap, synkroniseringsintervall och om operationsrapportering ska föras tillbaka.
- Åtkomst till HELIOS. Konfigurera Helios Inuvio Server, integrationsanvändaren, OAuth2-uppgifter och licensiering för REST API. Testa först mot en kopia av databasen.
- Första inläsning. Tillverkade detaljer, stycklistor, operationsföljder, arbetsplatser, maskiner, yrkeskategorier, kalendrar.
- Synkronisering av tillverkningsorder och inköpsorder. Pollning med filter, sidindelning och återförsök.
- Konfigurera begränsningar i SkyPlanner. Ställtidsmatris, verktyg, antal operatörer per operation och alternativa maskiner eller personal.
- Återföring av planeringen. Skapa och testa de externa åtgärderna för planerade datum och, om det har valts, operationsrapportering.
- Parallelltestning. Kör SkyPlanner parallellt med den befintliga planen, jämför datum och rätta grunddata.
- Driftsättning. Aktivera återskrivningen när uppgifterna stämmer överens.
Att tänka på inför en HELIOS-integration
- Planeringsflaggor. Bara resurser som är flaggade för kapacitetsplanering har tillförlitliga kapacitetsdata. Kontrollera flaggorna för arbetsplatser, maskiner, yrkeskategorier och legotillverkning före den första inläsningen.
- Tidsenheter. Förberedelsetid, stycktid och avslutningstid kan anges i timmar, minuter eller sekunder. Omvandla enheterna vid import, annars blir alla tidslängder fel.
- Tid mellan operationer. Den fasta tiden mellan operationer är väntetid, inte maskintid. Modellera den som väntetid, inte som kapacitet.
- Legobearbetning (kooperace). Transporttid gäller både dit och tillbaka. Modellera legobearbetning som steg som enbart tar tid.
- Skrivbara översikter. Alla översikter stöder läsning, men bara vissa tillåter att poster skapas, uppdateras och tas bort. GET /browses/list med filtret browseCreateImplemented=1 visar vilka. Översikterna för tillverkningsorder är skrivskyddade, så planerade datum förs tillbaka via den överenskomna externa åtgärden.
Vem konfigurerar och ger support för HELIOS-integrationen?
- SkyPlanner-teamet konfigurerar integrationen under införandet och ger support efter driftsättningen. Det gäller de överenskomna översikterna och externa åtgärderna. Varje fabrik använder HELIOS på sitt sätt, och här kommer den kunskapen till nytta.
- Din HELIOS-partner kan delta. Partnern känner till din installation, dina anpassade procedurer och dina licenser och kan konfigurera Helios Inuvio Server och de externa åtgärderna tillsammans med SkyPlanner-teamet.
- Dina egna utvecklare kan bygga vidare på integrationen via SkyPlanners REST API med en API-token. Det räcker med en API-token för att komma igång, och SkyPlanner-teamet hjälper till vid behov. Dokumentationen finns i SkyPlanners integrationsdokumentation.
SkyPlanner kostar från 199 € per månad med 5 produktionsgrupper inkluderade och faktureras månadsvis. Du får en offert på integrationen i förväg, anpassad till din process och dina behov, tillsammans med ditt abonnemang. Se priser, finplanering med HELIOS, HELIOS-sidan och översikten över ERP-integrationer. Grunderna i produktionsplanering finns under produktionsplanering.
Tillverkare berättar om SkyPlanner
2 hsparade varje vecka
”SkyPlanner har tagit vår produktionsplanering från Excel-ark till produktionsoptimering i realtid.”
Kalle Kalliomäki, specialist inom försörjningskedjan
UTU · Elcentraler och ställverk
Produktionsplaneringen sparar 2 timmars arbetstid varje vecka, och en ny arbetskö når produktionslinjen på några sekunder.
+90%produktionseffektivitet
”Effektiviteten i produktionen har ökat med 90%.”
Abdul Rucyinga, IT-chef
Laboratory & Allied · Läkemedelstillverkning
Produktionseffektiviteten har ökat med 90%, och det tar under 30 minuter att skapa en optimerad tremånadersplan för alla produktionsgrupper.
1 000-talstillverkningsorder planeras automatiskt
”Vi har kontroll över produktionen på ett helt annat sätt, och vår förståelse för kapaciteten ligger på en helt annan nivå.”
Hannu Ryynänen, vd
Mamec · Industriella blandare, pumpar och högteknologisk legotillverkning
Tusentals tillverkningsorder planeras automatiskt, och hela organisationen får en bild av produktionen i realtid.
100%leveransprecision sedan 2021
”SkyPlanner ger oss insyn i kapaciteten och gör planeringen förutsägbar.”
Dan Berglund, COO/CFO
Opes Corporation · Kemi- och livsmedelstillverkning
Leveransprecisionen har varit 100% under hela den tid SkyPlanner har använts, sedan 2021.
Vanliga frågor
Har HELIOS ett API för tillverkningsorder?
Ja. Helios Inuvio Server ger REST-åtkomst till översikterna i HELIOS iNuvio, bland annat produktionsplanen, tillverkningsorder, orderdelar, produktionsmaterial och operationsposter. För HELIOS Nephrite fastställer SkyPlanner-teamet integrationsvägen för din installation tillsammans med dig och din HELIOS-partner under kartläggningen inför införandet.
Hur fångar SkyPlanner upp ändringar i HELIOS?
SkyPlanner läser av HELIOS-översikterna med intervall som ställs in för varje fabrik, filtrerat på öppna tillverkningsorder och de senaste ändringarna. SkyPlanners egna webhooks skickar ändringar i planen så snart de sker.
Hur skrivs planerade datum tillbaka till HELIOS?
Via en extern åtgärd i översikten för tillverkningsorder, som körs med /api/v1/actions/execute. Åtgärden är en HELIOS-procedur som ni kommer överens om under kartläggningen, så HELIOS tillämpar sin egen logik på varje datum som tas emot.
Vilken autentisering använder Inuvio REST API?
OAuth2 enligt RFC 6749 via /oauth/token, eller den äldre proprietära lösningen /api/token. SkyPlanners eget API använder en API-token i headern Authorization-Token.
Bör en HELIOS-partner föreslå HELIOS APS eller SkyPlanner?
SkyPlanner, när kundens plan ändras ofta och planeringen måste hålla sig inom tillgänglig kapacitet. HELIOS planering bygger på beräkningar i en aktiv plan, kan växla till obegränsad kapacitet för att hålla datum och lämnar åt planeraren att lösa krockar (HELIOS hjälp). SkyPlanner ansluter via REST API, planerar om automatiskt och planerar omställningar, verktyg, arbetslag och material. Obegränsat antal användare ingår, från 199 € per månad.
Kan vi testa SkyPlanner innan vi bygger integrationen?
Ja. Under den kostnadsfria provperioden på 30 dagar kan du använda upp till 20 produktionsgrupper och importera data från HELIOS via CSV eller Excel. Inget kreditkort behövs. Starta provperioden eller kontakta säljteamet för en kartläggning av integrationen.