Integrationer / ERP / HELIOS
Guide til HELIOS-integration med SkyPlanner APS til produktionsplanlægning
Denne guide til HELIOS-integration viser partnere og IT-teams, hvordan HELIOS iNuvio og HELIOS Nephrite forbindes med SkyPlanner APS. SkyPlanner udveksler data med HELIOS i begge retninger via HELIOS’ egne grænseflader:
- Produktionsordrer (výrobní příkazy) med tilhørende operationer, fremstillede dele, styklister, ruter, arbejdspladser, maskiner, faggrupper, personaleressourcer, lagerbeholdninger og indkøbsordrer overføres til SkyPlanner.
- Planlagte start- og slutdatoer skrives tilbage til produktionsordrerne.
- Operatørernes tidsregistreringer kan skrives tilbage som operationsregistreringer (evidence výrobních operací), hvis I ønsker det.
- SkyPlanner-webhooks sender ændringer i planen, så snart de sker.
SkyPlanner-teamet tilpasser integrationen til jeres HELIOS-opsætning under opstarten og yder support efter idriftsættelsen. Denne guide er til HELIOS-partnere og udviklere, der vil deltage eller selv bygge videre på SkyPlanners dokumenterede REST API (API-reference).
HELIOS’ integrationsgrænseflader
Helios Inuvio Server (Inuvio REST API). Asseco beskriver den som en separat del af HELIOS iNuvio, der giver adgang til HELIOS iNuvios funktionsområder via REST API (Hjælp til Helios Inuvio Server). Den følger med iNuvio-distributionen, og OpenAPI-specifikationen er udgivet i Rapidoc- og Redoc-format. API’et arbejder med HELIOS-oversigter (browses), som hver har deres eget ID og egne rettigheder:
- GET /browses/list og GET /browses/meta viser de tilgængelige oversigter og deres kolonner.
- /browses/data læser rækker fra en oversigt og skriver rækker, hvor oversigten tillader oprettelse, opdatering og sletning.
- /api/v1/actions/meta og /api/v1/actions/execute/{dbName}/{browseIdent}/{actionIdent} udfører eksterne handlinger på en oversigt. I dag omfatter det eksterne handlinger af typen Procedure, Browse og Plugin.
De produktionsoversigter, en planlægger bruger, omfatter produktionsplanen (výrobní plán), produktionsordrer (výrobní příkazy), dele på produktionsordrer, materialer og halvfabrikata til produktion, faggrupper, personaleressourcer, forudindstillinger for ruteoperationer og operationsregistreringer. Lagerbeholdninger, tilgange, afgange og afgivne indkøbsordrer (vydané objednávky) er tilgængelige på samme måde.
HELIOS Nephrite REST API. Nephrites roadmap omfatter udvikling af REST API (Roadmap for HELIOS Nephrite). Under afklaringen bekræfter SkyPlanner-teamet sammen med jer og jeres HELIOS-partner, hvilke Nephrite-endpoints der gælder for jeres installation. Datastrømmene nedenfor er de samme.
Excel og CSV. Alle HELIOS-oversigter kan eksporteres til Microsoft Office, hvilket er tilstrækkeligt til at indlæse data i prøveperioden.
Autentificering og licenser
- To metoder til autentificering. iNuvio tilbyder et ældre, proprietært autentificerings-API (/api/token) og et nyere OAuth2 API baseret på RFC 6749 (/oauth/token, /oauth/revoke). Tokens fornyes via POST /oauth/token eller GET /api/token.
- Licenser. Selve Helios Inuvio Server er gratis, mens REST API kræver licens. Fra version 3.0.2026.0301 er system- og funktionsområde-API’erne samlet i ét Inuvio REST API, og API-adgangen er ikke længere begrænset af antallet af brugere.
- Rettigheder. Integrationsbrugeren skal have læserettigheder til produktions- og lageroversigterne samt ret til at udføre de aftalte eksterne handlinger.
I SkyPlanner sker autentificering til REST API med et API-token i Authorization-Token-headeren (SkyPlanner Settings > API), og API’et er dokumenteret i Swagger/OpenAPI. Integrationsvejledningen gennemgår de første kald.
Hændelser og polling
SkyPlanner læser data fra HELIOS med faste intervaller. Kald til /browses/data, filtreret efter åbne produktionsordrer og seneste ændringer, henter nyt arbejde. Intervallet fastsættes for hver fabrik, fra hvert par minutter for produktionsordrer til én gang i timen for lagerbeholdninger.
SkyPlanner sender webhooks, når status eller planen ændres, så tilbageskrivningen er hændelsesstyret.
Datamapping
| HELIOS-objekt (oversigt) | SkyPlanner-objekt | Retning | Hyppighed |
|---|---|---|---|
| Varekort og fremstillede dele (vyráběné dílce), enheder | Produkter og materialer | HELIOS → SkyPlanner | Førstegangsindlæsning, derefter polling |
| Styklister (kusovník, kusovníkové vazby) med gyldighedsdatoer | Produktstruktur, delprodukter, materialer pr. produkt | HELIOS → SkyPlanner | Første indlæsning, derefter ved ændringer |
| Ruter (technologický postup): operation, arbejdsplads, forberedelsestid for maskine og operatør, styktid, afslutningstid, tid mellem operationer | Procestrin med varigheder, opstillings- og nedtagningstider | HELIOS → SkyPlanner | Første indlæsning, derefter ved ændringer |
| Arbejdspladser (pracoviště), maskiner (stroje), alternative arbejdspladser | Arbejdsstationer, grupper af arbejdsstationer, alternative arbejdsstationer | HELIOS → SkyPlanner | Første indlæsning, derefter sjældent |
| Faggrupper (výrobní profese), personaleressourcer (výrobní personální zdroje) | Personale og antal operatører pr. opgave | HELIOS → SkyPlanner | Førstegangsindlæsning, derefter ved ændringer |
| Planlægningskalendere (plánovací kalendáře) | Skiftehold og arbejdsfri dage | HELIOS → SkyPlanner | Dagligt, eller egne skiftehold i SkyPlanner |
| Produktionsordrer (výrobní příkazy), dele og operationer på ordrerne, materialer til produktion | Ordrer og opgaver med frister og materialebehov | HELIOS → SkyPlanner | Polling hvert par minutter |
| Lagerbeholdning (stav skladu) | Lagerbeholdninger | HELIOS → SkyPlanner | Polling hver time eller ved planlægningskørsel |
| Afgivne indkøbsordrer (vydané objednávky) med leveringsdatoer | Indkøbsordrer, indgående materialer efter leveringsdato | HELIOS → SkyPlanner | Polling hver time eller ved planlægningskørsel |
| Planlagt start og afslutning pr. operation på produktionsordren (ekstern handling) | Planlagt start og afslutning pr. opgave | SkyPlanner → HELIOS | Ved ændringer i planen via SkyPlanner-webhook |
| Operationsregistreringer (evidence výrobních operací) | Tidsregistreringer og operatørtilbagemeldinger | SkyPlanner → HELIOS | Pr. tilbagemelding eller pr. skiftehold, hvis det vælges |
| Findes ikke i HELIOS | Matrix for omstillingstider, værktøjer som ressourcer med begrænset kapacitet, opgaver med flere operatører | Vedligeholdes i SkyPlanner | Sættes op under opstarten |
Integrationsmønstre
1. Førstegangsindlæsning af stamdata. Læs fremstillede dele, styklister, ruter, arbejdspladser, maskiner, faggrupper, personaleressourcer og kalendere fra TPV-oversigterne. Hver HELIOS-ressource har en markering, der angiver, om den skal indgå i kapacitetsplanlægningen. Beslut derfor for hver ressource, hvad SkyPlanner skal planlægge. En arbejdsplads med fire maskiner bliver til én gruppe af arbejdsstationer eller fire arbejdsstationer.
2. Ordresynkronisering. Læs produktionsordrer med tilhørende dele, operationer og materialer samt afgivne indkøbsordrer. SkyPlanner betragter bestilt materiale som tilgængeligt på indkøbsordrens leveringsdato og opdaterer lagerbeholdningen, når indkøbsordren markeres som Delivered. Planlæg frigivne produktionsordrer. Planlagte mængder i produktionsplanen bliver i HELIOS, indtil de bliver til produktionsordrer.
3. Tilbageskrivning af planen. Når planlægningsmotoren placerer eller flytter en opgave, udløser en SkyPlanner-webhook en ekstern handling på produktionsordreoversigten via /api/v1/actions/execute. Handlingen er en HELIOS-procedure, som aftales under afklaringen, og som fastsætter planlagt start og afslutning for ordreoperationen. HELIOS validerer ændringen med sin egen logik.
4. Tilbagemeldinger fra produktionen. Operatørerne registrerer arbejdet med SkyPlanner Mobile Confirmations eller Production Timer, og tidsregistreringerne holder planen opdateret. I vælger, om de faktiske tider skal skrives tilbage til HELIOS. Hvis ja, gemmer en ekstern handling dem som operationsregistreringer for hver ordreoperation. Hvis nej, fortsætter operatørerne med at rapportere på HELIOS-terminalerne, og SkyPlanner læser disse registreringer.
5. Regler for dataejerskab og konflikter. Skriv dem ned før idriftsættelsen:
| Data | Dataejer |
|---|---|
| Varer, styklister, ruter, mængder, ordrestatus | HELIOS |
| Operationsrækkefølge, start- og sluttidspunkter, maskintildeling | SkyPlanner |
| Omstillingsmatrix, krav til værktøjer og operatører, alternative ressourcer | SkyPlanner |
| Skiftehold og arbejdsfrie dage | Ét system, valgt under afklaringen |
| Operationsregistreringer, materialeafgange og -tilgange | HELIOS, indtastet dér eller overført fra SkyPlanners tidsregistreringer |
Vælg ét system til at skrive ordredatoer. Hvis HELIOS’ kapacitetsplanlægning eller Nephrite APS stadig skriver datoer, skal det slås fra for de ordrer, SkyPlanner planlægger. Alternativt skal HELIOS-planen kun bruges som testplan.
Typiske projekttrin
Implementeringen er normalt afsluttet inden for få uger efter opstart. Inden da kan I validere planen i den gratis prøveperiode på 30 dage med arbejdspladser, ruter og åbne produktionsordrer eksporteret fra HELIOS som CSV eller Excel.
- Datamapping. Fastlæg mappingtabellen, reglerne for dataejerskab, synkroniseringsintervallerne, og om operationsregistreringer skal skrives tilbage.
- Adgang til HELIOS. Opsæt Helios Inuvio Server, integrationsbrugeren, OAuth2-legitimationsoplysninger og licens til REST API. Test først på en kopi af databasen.
- Førstegangsindlæsning. Fremstillede dele, styklister, ruter, arbejdspladser, maskiner, faggrupper, kalendere.
- Synkronisering af produktions- og indkøbsordrer. Polling med filtre, sideinddeling og genforsøg.
- Opsætning af begrænsninger i SkyPlanner. Omstillingsmatrix, værktøjer, antal operatører pr. opgave og alternative maskiner eller medarbejdere.
- Tilbageskrivning af planen. Opret og test de eksterne handlinger til planlagte datoer og, hvis det vælges, operationsregistreringer.
- Paralleltest. Kør SkyPlanner sideløbende med den nuværende plan, sammenlign datoer, og ret stamdata.
- Idriftsættelse. Aktivér tilbageskrivning, når dataene stemmer overens.
Det skal I tage højde for ved en HELIOS-integration
- Planlægningsmarkeringer. Kun ressourcer, der er markeret til kapacitetsplanlægning, har pålidelige kapacitetsdata. Kontrollér markeringerne på arbejdspladser, maskiner, faggrupper og underleverandøropgaver før den første indlæsning.
- Tidsenheder. Forberedelses-, styk- og afslutningstider kan angives i timer, minutter eller sekunder. Omregn ved import, ellers bliver alle varigheder forkerte.
- Tid mellem operationer. Den konstante tid mellem operationer er ventetid, ikke maskintid. Modellér den som ventetid, ikke som kapacitet.
- Underleverandøroperationer (kooperace). Transporttiden gælder både ud og hjem. Modellér underleverandørarbejde som trin, der kun optager tid.
- Oversigter med skriveadgang. Alle oversigter understøtter læsning, men kun nogle understøtter oprettelse, opdatering og sletning. GET /browses/list med filteret browseCreateImplemented=1 viser hvilke. Oversigter over produktionsordrer er skrivebeskyttede, så planlagte datoer sendes tilbage via den aftalte eksterne handling.
Hvem opsætter og supporterer HELIOS-integrationen?
- SkyPlanner-teamet opsætter integrationen under onboarding og yder support efter idriftsættelsen. Det omfatter de aftalte oversigter og eksterne handlinger. Hver fabrik bruger HELIOS forskelligt, og den viden indgår i opsætningen.
- Jeres HELIOS-partner kan deltage. Partneren kender jeres installation, tilpassede procedurer og licensforhold og kan opsætte Helios Inuvio Server og de eksterne handlinger sammen med SkyPlanner-teamet.
- Jeres egne udviklere kan bygge videre på integrationen via SkyPlanners REST API med et API-token. Et API-token er nok til at komme i gang, og SkyPlanner-teamet hjælper efter behov. Dokumentationen findes i SkyPlanners integrationsdokumentation.
SkyPlanner fås fra 199 € om måneden med 5 arbejdsstationer inkluderet og månedlig fakturering. I får på forhånd et tilbud på integrationen sammen med abonnementet, tilpasset jeres proces og behov. Se priser, produktionsplanlægning med HELIOS under hensyntagen til den faktiske maskin- og personalekapacitet, HELIOS-siden og oversigten over ERP-integrationer. Læs om det grundlæggende i produktionsplanlægning.
Produktionsvirksomheders erfaringer med SkyPlanner
2 hsparet hver uge
“SkyPlanner har flyttet vores produktionsplanlægning fra Excel-regneark til optimering af produktionen i realtid.”
Kalle Kalliomäki, forsyningskædespecialist
UTU · Eltavler og koblingsanlæg
Produktionsplanlægningen sparer 2 timers arbejdstid hver uge, og en ny opgavekø når ud til produktionslinjen på få sekunder.
+90%produktionseffektivitet
“Effektiviteten i produktionen er steget med 90%.”
Abdul Rucyinga, IT-chef
Laboratory & Allied · Lægemiddelproduktion
Produktionseffektiviteten er steget med 90%, og det tager under 30 minutter at lave en optimeret plan for tre måneder på tværs af alle arbejdsstationer.
1.000-vis afproduktionsordrer planlægges automatisk
“Vi har styr på produktionen på en helt anden måde, og vores forståelse af kapaciteten er på et helt andet niveau.”
Hannu Ryynänen, administrerende direktør
Mamec · Industrielle blandere, pumper og højteknologisk kontraktproduktion
Tusindvis af produktionsordrer planlægges automatisk, og hele organisationen har overblik over produktionen i realtid.
100%leveringssikkerhed siden 2021
“SkyPlanner giver os overblik over kapaciteten og gør planlægningen forudsigelig.”
Dan Berglund, COO/CFO
Opes Corporation · Produktion af kemikalier og fødevarer
Leveringssikkerheden har været 100% i hele den periode, SkyPlanner har været i brug, siden 2021.
Ofte stillede spørgsmål
Har HELIOS et API til produktionsordrer?
Ja. Helios Inuvio Server giver REST-adgang til oversigter i HELIOS iNuvio, herunder produktionsplanen, produktionsordrer, ordredele, materialer til produktion og operationsregistreringer. For HELIOS Nephrite fastlægger SkyPlanner-teamet integrationsmetoden for jeres installation sammen med jer og jeres HELIOS-partner under afklaringen i forbindelse med onboarding.
Hvordan opfanger SkyPlanner ændringer i HELIOS?
SkyPlanner henter data fra HELIOS-oversigterne med et interval, der fastsættes for hver fabrik, og filtrerer på åbne produktionsordrer og seneste ændringer. SkyPlanners egne webhooks sender ændringer i planen, så snart de sker.
Hvordan skrives planlagte datoer tilbage til HELIOS?
Via en ekstern handling på produktionsordreoversigten, som køres med /api/v1/actions/execute. Handlingen er en HELIOS-procedure, der aftales under afklaringen, så HELIOS anvender sin egen logik på hver dato, systemet modtager.
Hvilken godkendelsesmetode bruger Inuvio REST API?
OAuth2 i henhold til RFC 6749 via /oauth/token eller det ældre, proprietære /api/token. SkyPlanners eget API bruger et API-token i headeren Authorization-Token.
Bør en HELIOS-partner foreslå HELIOS APS eller SkyPlanner?
SkyPlanner, når kundens plan ofte ændrer sig, og planlægningen skal holde sig inden for den faktiske kapacitet. I HELIOS foregår planlægningen som beregninger på én aktiv plan. Systemet kan skifte til ubegrænset kapacitet for at overholde datoer og overlader konflikter til planlæggeren (HELIOS-hjælp). SkyPlanner tilsluttes via REST API, omplanlægger automatisk og planlægger omstillinger, værktøjer, bemanding og materialer. Antallet af brugere er ubegrænset, og prisen starter fra 199 € om måneden.
Kan vi teste SkyPlanner, før vi bygger integrationen?
Ja. Den gratis prøveperiode på 30 dage understøtter op til 20 arbejdsstationer med CSV- eller Excel-import fra HELIOS, og der kræves intet kreditkort. Start prøveperioden, eller tal med salg for at få afklaret integrationens omfang.
