Verbindt met ERP & MES-systemen zoals

Koppelingen / ERP / HELIOS

Handleiding voor de HELIOS-koppeling voor productieplanning met SkyPlanner APS

Deze handleiding laat partners en IT-teams zien hoe ze HELIOS iNuvio en HELIOS Nephrite aan SkyPlanner APS koppelen. SkyPlanner wisselt in beide richtingen gegevens uit met HELIOS via de eigen interfaces van HELIOS:

  • SkyPlanner leest productieorders (výrobní příkazy) in, met de bijbehorende bewerkingen, geproduceerde onderdelen, stuklijsten, bewerkingsvolgordes, werkplekken, machines, beroepsgroepen, personele capaciteit, voorraad en inkooporders.
  • Geplande start- en einddatums worden teruggeschreven naar de productieorders.
  • Als u daarvoor kiest, kunnen tijdregistraties van operators worden teruggeschreven als bewerkingsregistraties (evidence výrobních operací).
  • SkyPlanner-webhooks geven wijzigingen in het productieschema direct door.
Gantt-tijdlijn in SkyPlanner APS met taken ingepland op verschillende werkcentra en daaronder een orderlijst.

Het SkyPlanner-team stemt de koppeling tijdens de onboarding af op uw HELIOS-inrichting en biedt ook na de ingebruikname ondersteuning. Deze handleiding is bedoeld voor HELIOS-partners en ontwikkelaars die daaraan willen meewerken of zelf op de gedocumenteerde REST API van SkyPlanner willen voortbouwen (API-documentatie).

Interfaces voor koppelingen met HELIOS

Helios Inuvio Server (Inuvio REST API). Asseco beschrijft dit als een afzonderlijk onderdeel van HELIOS iNuvio dat via een REST API toegang geeft tot de gegevensregisters in HELIOS iNuvio (Help voor Helios Inuvio Server). Het wordt meegeleverd met iNuvio. De OpenAPI-specificatie is beschikbaar in Rapidoc- en Redoc-formaat. De API werkt met HELIOS-overzichten (browses), elk met een eigen ID en eigen rechten:

  • GET /browses/list en GET /browses/meta tonen de beschikbare overzichten en de bijbehorende kolommen.
  • /browses/data leest rijen uit een overzicht en schrijft rijen waar het overzicht aanmaken, wijzigen en verwijderen toestaat.
  • /api/v1/actions/meta en /api/v1/actions/execute/{dbName}/{browseIdent}/{actionIdent} voeren externe acties uit op een overzicht. Momenteel zijn dat externe acties van het type Procedure, Browse en Plugin.

Een productieplanner gebruikt onder meer overzichten van het productieplan (výrobní plán), productieorders (výrobní příkazy), onderdelen per productieorder, materialen en halffabricaten voor productie, beroepsgroepen, personele capaciteit, voorinstellingen voor bewerkingen in de bewerkingsvolgorde en bewerkingsregistraties. Voorraad, ontvangsten, uitgiften en geplaatste inkooporders (vydané objednávky) zijn op dezelfde manier beschikbaar.

HELIOS Nephrite REST API. De roadmap van Nephrite vermeldt de ontwikkeling van een REST API (roadmap van HELIOS Nephrite). Tijdens de scopebepaling stelt het SkyPlanner-team samen met u en uw HELIOS-partner vast welke Nephrite-endpoints voor uw installatie beschikbaar zijn. De hieronder beschreven gegevensstromen blijven hetzelfde.

Excel en CSV. Elk HELIOS-overzicht kan naar Microsoft Office worden geëxporteerd. Dat volstaat om de gegevens voor de proefperiode in te laden.

Authenticatie en licenties

  • Twee manieren van authenticatie. iNuvio biedt een oudere, eigen authenticatie-API (/api/token) en een nieuwere OAuth2 API op basis van RFC 6749 (/oauth/token, /oauth/revoke). Tokens worden vernieuwd via POST /oauth/token of GET /api/token.
  • Licenties. Helios Inuvio Server zelf is gratis; voor de REST API is een licentie nodig. Vanaf versie 3.0.2026.0301 zijn de systeem-API en de API’s voor gegevensregisters samengevoegd tot één Inuvio REST API. De API-toegang wordt dan niet langer beperkt door het aantal gebruikers.
  • Rechten. Het gebruikersaccount voor de koppeling heeft leesrechten nodig op de productie- en voorraadoverzichten en rechten om de afgesproken externe acties uit te voeren.

Aan de kant van SkyPlanner verloopt de authenticatie voor de REST API via een API-token in de Authorization-Token-header (SkyPlanner Settings > API). De API is gedocumenteerd in Swagger/OpenAPI. De integratiehandleiding leidt u door de eerste API-aanroepen.

Events en polling

SkyPlanner leest HELIOS op vaste tijdstippen uit. Aanroepen naar /browses/data halen nieuw werk op, met filters op openstaande productieorders en recente wijzigingen. De frequentie wordt per fabriek ingesteld: van elke paar minuten voor productieorders tot elk uur voor voorraad.

SkyPlanner verstuurt webhooks wanneer de status of het productieschema verandert. Het terugschrijven wordt dus door events aangestuurd.

Gegevensmapping

HELIOS-object (overzicht)Object in SkyPlannerRichtingFrequentie
Artikelkaarten en geproduceerde onderdelen (vyráběné dílce), eenhedenProducten en materialenHELIOS → SkyPlannerInitiële import, daarna polling
Stuklijsten (kusovník, kusovníkové vazby) met geldigheidsdatumsProductstructuur, subproducten, materialen per productHELIOS → SkyPlannerInitiële import, daarna bij wijzigingen
Bewerkingsvolgordes (technologický postup): bewerking, werkplek, voorbereidingstijd voor machine en operator, tijd per eenheid, afwerktijd, tijd tussen bewerkingenProcesstappen met duur, instel- en afbouwtijdenHELIOS → SkyPlannerInitiële import, daarna bij wijzigingen
Werkplekken (pracoviště), machines (stroje), alternatieve werkplekkenWerkcentra, werkcentrumgroepen, alternatieve werkcentraHELIOS → SkyPlannerInitiële import, daarna zelden
Beroepsgroepen (výrobní profese), personele capaciteit (výrobní personální zdroje)Personeel en aantal operators per taakHELIOS → SkyPlannerInitiële import, daarna bij wijzigingen
Planningskalenders (plánovací kalendáře)Diensten en vrije dagenHELIOS → SkyPlannerDagelijks, of eigen diensten in SkyPlanner
Productieorders (výrobní příkazy), onderdelen en bewerkingen per order, materialen voor productieOrders en taken met uiterste datums en materiaalbehoeftenHELIOS → SkyPlannerPolling om de paar minuten
Voorraad (stav skladu)VoorraadsaldiHELIOS → SkyPlannerPolling, elk uur of bij het berekenen van het productieschema
Geplaatste inkooporders (vydané objednávky) met leverdatumsInkooporders, binnenkomende materialen per leverdatumHELIOS → SkyPlannerPolling, elk uur of bij het berekenen van het productieschema
Geplande start- en eindtijd per bewerking van een productieorder (externe actie)Geplande start- en eindtijd per taakSkyPlanner → HELIOSBij wijziging van het productieschema, via een SkyPlanner-webhook
Bewerkingsregistraties (evidence výrobních operací)Tijdregistraties en bevestigingen van operatorsSkyPlanner → HELIOSPer bevestiging of per dienst, als u daarvoor kiest
Niet in HELIOSOmsteltijdenmatrix, gereedschappen met beperkte capaciteit, taken met meerdere operatorsBeheerd in SkyPlannerIngericht tijdens de onboarding

Integratiepatronen

1. Eerste import van stamgegevens. Lees geproduceerde onderdelen, stuklijsten, bewerkingsvolgordes, werkplekken, machines, beroepsgroepen, personele capaciteit en kalenders in vanuit de TPV-overzichten. Elk productiemiddel in HELIOS heeft een vinkje om het in de capaciteitsplanning op te nemen. Bepaal daarom per productiemiddel wat SkyPlanner inplant. Een werkplek met vier machines wordt één werkcentrumgroep of vier werkcentra.

2. Ordersynchronisatie. Lees productieorders met hun onderdelen, bewerkingen en materialen in, plus geplaatste inkooporders. SkyPlanner beschouwt besteld materiaal als beschikbaar op de leverdatum van de inkooporder en werkt de voorraad bij zodra de inkooporder de status Delivered krijgt. Plan vrijgegeven productieorders in. Geplande aantallen in het productieplan blijven in HELIOS totdat ze productieorders worden.

3. Het productieschema terugschrijven. Wanneer de planningsengine een taak inplant of verplaatst, activeert een SkyPlanner-webhook via /api/v1/actions/execute een externe actie op het productieorderoverzicht. Die actie is een HELIOS-procedure die tijdens de scopebepaling is afgesproken en de geplande start en het geplande einde van de orderbewerking vastlegt. HELIOS valideert de wijziging met zijn eigen logica.

4. Terugmeldingen vanaf de werkvloer. Operators registreren hun werk met SkyPlanner Mobile Confirmations of de Production Timer. Die tijdregistraties houden het productieschema actueel. U bepaalt of de werkelijke tijden naar HELIOS worden teruggeschreven. Zo ja, dan legt een externe actie ze per orderbewerking vast als bewerkingsregistraties. Zo nee, dan blijven operators hun werk op HELIOS-terminals terugmelden en leest SkyPlanner die registraties in.

5. Gegevenseigenaarschap en conflictregels. Leg deze vóór de ingebruikname vast:

GegevensEigenaar
Artikelen, stuklijsten, bewerkingsvolgordes, aantallen, orderstatusHELIOS
Bewerkingsvolgorde, start- en eindtijden, machinetoewijzingSkyPlanner
Omsteltijdenmatrix, vereisten voor gereedschappen en operators, alternatieve productiemiddelenSkyPlanner
Ploegendiensten en niet-werkdagenEén systeem, gekozen tijdens de scopebepaling
Bewerkingsregistraties, materiaaluitgiften en -ontvangstenHELIOS, daar ingevoerd of overgenomen uit tijdregistraties van SkyPlanner

Laat de orderdatums door één systeem vastleggen. Als de capaciteitsplanning van HELIOS of Nephrite APS nog datums schrijft, schakel dat dan uit voor orders die SkyPlanner inplant. Of gebruik het HELIOS-plan uitsluitend als testplan.

Gebruikelijke projectstappen

De implementatie is normaal gesproken binnen enkele weken na de start van de onboarding afgerond. Valideer het productieschema daarvoor al tijdens de gratis proefperiode van 30 dagen, met werkplekken, bewerkingsvolgordes en openstaande productieorders die u vanuit HELIOS als CSV of Excel exporteert.

  1. Mapping. Leg de mappingtabel, de afspraken over gegevensbeheer, de synchronisatiefrequenties en het al dan niet terugschrijven van bewerkingsregistraties vast.
  2. Toegang tot HELIOS. Richt Helios Inuvio Server, het gebruikersaccount voor de koppeling, de OAuth2-inloggegevens en de REST API-licentie in. Test eerst op een kopie van de database.
  3. Eerste import. Geproduceerde onderdelen, stuklijsten, bewerkingsvolgordes, werkplekken, machines, beroepsgroepen, kalenders.
  4. Synchronisatie van productie- en inkooporders. Polling met filters, paginering en herhaalpogingen.
  5. Randvoorwaarden instellen in SkyPlanner. Omsteltijdenmatrix, gereedschappen, aantal operators per taak en alternatieve machines of medewerkers.
  6. Het productieschema terugschrijven. Maak en test de externe acties voor geplande datums en, als u daarvoor kiest, bewerkingsregistraties.
  7. Parallel testen. Laat SkyPlanner naast het huidige plan draaien, vergelijk datums en corrigeer stamgegevens.
  8. Ingebruikname. Schakel het terugschrijven in zodra de gegevens overeenkomen.

Aandachtspunten voor een HELIOS-koppeling

  • Vinkjes voor planning. Alleen productiemiddelen die voor capaciteitsplanning zijn aangevinkt, hebben betrouwbare capaciteitsgegevens. Controleer vóór de eerste import de vinkjes bij werkplekken, machines, beroepsgroepen en uitbestedingen.
  • Tijdseenheden. Voorbereidings-, stuk- en afwerktijden kunnen in uren, minuten of seconden worden ingevoerd. Reken ze bij het importeren om, anders klopt geen enkele tijdsduur.
  • Tijd tussen bewerkingen. De vaste tijd tussen bewerkingen is wachttijd, geen machinetijd. Modelleer deze als wachttijd, niet als capaciteit.
  • Uitbestede bewerkingen (kooperace). Houd rekening met transporttijd voor zowel de heen- als de terugweg. Modelleer uitbestede bewerkingen als stappen die alleen tijd kosten.
  • Overzichten met schrijftoegang. Alle overzichten kunnen worden uitgelezen, maar slechts een deel ondersteunt aanmaken, wijzigen en verwijderen. GET /browses/list met het filter browseCreateImplemented=1 laat zien welke dat zijn. Overzichten van productieorders zijn alleen-lezen. Geplande datums worden daarom via de afgesproken externe actie teruggeschreven.

Wie richt de HELIOS koppeling in en ondersteunt deze?

  1. Het SkyPlanner-team richt de koppeling tijdens de onboarding in en ondersteunt deze na de ingebruikname. Dit omvat de afgesproken overzichten en externe acties. Elke fabriek gebruikt HELIOS op een eigen manier; die praktijkkennis wordt in de inrichting verwerkt.
  2. Uw HELIOS-partner kan meewerken. De partner kent uw installatie, maatwerkprocedures en licenties en kan samen met het SkyPlanner-team Helios Inuvio Server en de externe acties inrichten.
  3. Uw eigen ontwikkelaars kunnen de koppeling verder uitbouwen via de REST API van SkyPlanner met een API-token. Een API-token volstaat om te beginnen. Het SkyPlanner-team helpt waar nodig. De documentatie vindt u in de integratiedocumentatie van SkyPlanner.

SkyPlanner is beschikbaar vanaf 199 € per maand, inclusief 5 werkcentra, met maandelijkse facturatie. U ontvangt vooraf, samen met uw abonnement, een offerte voor de koppeling op basis van uw processen en behoeften. Bekijk de prijzen, capaciteitsplanning met HELIOS, de HELIOS-pagina en het overzicht van ERP-koppelingen. Meer over de basisprincipes van planning vindt u op de pagina over productieplanning.

Ervaringen van productiebedrijven met SkyPlanner

Kalle Kalliomäki, supplychainspecialist bij UTU, op de productievloer voor verdeelborden in Ulvila

2 hbesparing per week

“Met SkyPlanner zijn we voor onze productieplanning overgestapt van Excel-spreadsheets naar realtime productieoptimalisatie.”

Kalle Kalliomäki, supplychainspecialist
UTU · Elektrische verdeelborden en schakelinstallaties

De productieplanning bespaart elke week 2 uur werktijd en een nieuwe werklijst bereikt de productielijn binnen enkele seconden.

Lees de ervaring van UTU

Operators in cleanroomkleding bij een flessenvullijn in de farmaceutische fabriek van Laboratory & Allied in Nairobi

+90%productie-efficiëntie

“De efficiëntie in de productie is met 90% gestegen.”

Abdul Rucyinga, hoofd IT
Laboratory & Allied · Farmaceutische productie

De productie-efficiëntie is met 90% gestegen. Een geoptimaliseerde planning voor drie maanden voor alle werkcentra is in minder dan 30 minuten klaar.

Lees de ervaring van Laboratory & Allied

Hannu Ryynänen, CEO van Mamec, in de productiehal van het bedrijf in Lohja

1.000’enwerkorders automatisch ingepland

“We hebben de productie op een andere manier onder controle en ons inzicht in de capaciteit ligt op een heel ander niveau.”

Hannu Ryynänen, CEO
Mamec · Industriële mengers, pompen en hightechproductie in opdracht

Duizenden werkorders worden automatisch ingepland, met realtime inzicht in de productie voor de hele organisatie.

Lees de ervaring van Mamec

100%leverbetrouwbaarheid sinds 2021

“SkyPlanner geeft ons inzicht in de capaciteit en maakt de planning voorspelbaar.”

Dan Berglund, COO/CFO
Opes Corporation · Chemische en voedingsmiddelenproductie

De leverbetrouwbaarheid is 100% sinds SkyPlanner in 2021 in gebruik werd genomen.

Lees de ervaring van Opes Corporation

Veelgestelde vragen

Heeft HELIOS een API voor productieorders?

Ja. Helios Inuvio Server biedt via REST toegang tot de overzichten in HELIOS iNuvio, waaronder het productieplan, productieorders, orderonderdelen, productiematerialen en bewerkingsregistraties. Voor HELIOS Nephrite bepaalt het SkyPlanner-team samen met u en uw HELIOS-partner de aanpak voor uw installatie tijdens de scopebepaling bij de onboarding.

Hoe haalt SkyPlanner wijzigingen uit HELIOS op?

SkyPlanner vraagt de HELIOS-overzichten periodiek op, met een interval dat per fabriek wordt ingesteld. Daarbij wordt gefilterd op openstaande productieorders en recente wijzigingen. De eigen webhooks van SkyPlanner sturen wijzigingen in de planning direct door zodra ze plaatsvinden.

Hoe worden geplande datums teruggeschreven naar HELIOS?

Via een externe actie op het productieorderoverzicht, uitgevoerd met /api/v1/actions/execute. Deze actie is een HELIOS-procedure die tijdens de scopebepaling wordt afgesproken. Zo past HELIOS zijn eigen logica toe op elke ontvangen datum.

Welke authenticatie gebruikt de Inuvio REST API?

OAuth2 volgens RFC 6749 via /oauth/token, of de oudere, leveranciersspecifieke methode via /api/token. De eigen API van SkyPlanner gebruikt een API-token in de Authorization-Token-header.

Moet een HELIOS-partner HELIOS APS of SkyPlanner voorstellen?

SkyPlanner, wanneer de planning van de klant vaak verandert en de werkelijke capaciteit een harde grens moet blijven. HELIOS voert planningsberekeningen uit op één actief plan, kan overschakelen naar onbeperkte capaciteit om datums te halen en laat het oplossen van planningsconflicten aan de planner over (HELIOS-help). SkyPlanner maakt verbinding via de REST API, plant automatisch opnieuw en neemt omstellingen, gereedschappen, ploegen en materiaal mee in de planning. Het aantal gebruikers is onbeperkt, vanaf 199 € per maand.

Kunnen we SkyPlanner testen voordat we de integratie bouwen?

Ja. Tijdens de gratis proefperiode van 30 dagen kunt u tot 20 werkcentra gebruiken en gegevens uit HELIOS importeren via CSV of Excel. Een creditcard is niet nodig. Start de proefperiode of neem contact op met sales voor de scopebepaling van de koppeling.