Integraties / ERP / IFS Cloud
Handleiding voor IFS Cloud-integratie voor productieschema’s met SkyPlanner APS
Deze integratiehandleiding laat partners en IT-teams zien hoe ze IFS Cloud aan SkyPlanner APS koppelen. SkyPlanner wisselt in beide richtingen gegevens uit met IFS Cloud via de eigen API’s van IFS:
- SkyPlanner ontvangt productieorders met bewerkingen en materialen, bewerkingsvolgordes, productstructuren, werkcentra, personeelscategorieën, gereedschappen, de beschikbaarheid van voorraadartikelen en inkooporders.
- De geplande start- en eindtijden en het gekozen productiemiddel binnen het werkcentrum worden teruggeschreven naar de bewerkingen van de productieorder.
- SkyPlanner-webhooks geven wijzigingen in het productieschema direct door.
Tijdens de onboarding stemt het SkyPlanner-team de integratie af op uw IFS Cloud-inrichting. Ook na de ingebruikname blijft het team ondersteuning bieden. Deze handleiding is bedoeld voor partners en ontwikkelaars die willen meewerken of zelf willen bouwen op de gedocumenteerde REST API van SkyPlanner (API-documentatie).
Integratiemogelijkheden voor IFS Cloud
OData-projections (RESTful API’s).
IFS Cloud stelt zijn bedrijfslogica beschikbaar via OData-projections. “Projections are exposed in the /ifsapplications/projection/ endpoint,” (projections worden beschikbaar gesteld via het endpoint /ifsapplications/projection/), binnen het endpoint main, int of b2b, afhankelijk van het type projection. Een typisch pad loopt vanaf /main/ifsapplications/ via de versie van de projection naar de bijbehorende .svc-service en entity set. Elke projection publiceert OData-metadata: “a machine-readable description of the data model of the APIs.” (een machineleesbare beschrijving van het datamodel van de API’s). (bron)
API Explorer.
De webclient van IFS Cloud toont alle projections, met API-documentatie en een OpenAPI-specificatie voor uw omgeving. Gebruik voor de integratie Premium APIs en Entity Service APIs, niet de UI-projections achter de pagina’s van de client. Premium APIs werken met versies: “The old version of the projection will still be retained along with the new version till the next release.” (De oude versie van de projection blijft naast de nieuwe versie beschikbaar tot de volgende release.) (bron)
IFS Connect.
De integratiebroker routeert berichten naar HTTP/REST-, bestands- en andere adressen. IFS schrijft: “Modern integration use web services together with IFS Connect and/or 3rd party integration tools.” (Moderne integraties gebruiken webservices in combinatie met IFS Connect en/of integratietools van derden.) (bron) IFS documenteert ook integratieroutes via middleware zoals Boomi.
Bestanden.
Met Data Migration Manager en taken in File Migration en Excel Migration kunt u gegevens in bulk laden. Tijdens de proefperiode volstaat een eenvoudige Excel-export.
Authenticatie
Externe integraties authenticeren zich via IFS Identity and Access Manager (IAM) met OAuth 2.0 en OpenID Connect:
- Registreer een IAM Client voor SkyPlanner en gebruik de Client Credentials-flow. Deze “allows for a non-interactive authentication of a service account” (maakt niet-interactieve authenticatie van een serviceaccount mogelijk) en “yields an access token associated with a service user.” (levert een toegangstoken op dat aan een servicegebruiker is gekoppeld).
- Vraag tokens aan via
POST https://<SYSTEM_URL>/auth/realms/<NAMESPACE>/protocol/openid-connect/token. - Geef de servicegebruiker uitsluitend machtigingensets voor de projections waaruit de integratie gegevens leest en waarnaar zij gegevens schrijft.
(bron)
Aan de kant van SkyPlanner gebruikt de REST API een API-token voor authenticatie (SkyPlanner Settings > API). De API is gedocumenteerd in Swagger/OpenAPI. De integratiehandleiding leidt u door de eerste API-aanroepen.
Events en wijzigingsdetectie
IFS Cloud heeft een eventframework: “Events can be used to automate actions within IFS Cloud.” (Met events kunt u acties binnen IFS Cloud automatiseren.) Aangepaste events worden geactiveerd wanneer een entiteit wordt aangemaakt, bijgewerkt of verwijderd. De bijbehorende acties worden via IFS Connect uitgevoerd. (bron)
Voor uitgaande berichten is er de REST Sender: “Outbound messages can be sent either synchronously or asynchronously,” (uitgaande berichten kunnen synchroon of asynchroon worden verzonden). U configureert de routering in IFS Connect. (bron) Ook Workflow Manager kan REST-endpoints aanroepen.
Er zijn twee werkbare aanpakken:
- Eventgestuurd. Een aangepast event bij wijzigingen in productieorders en de bijbehorende bewerkingen activeert een REST Sender-bericht naar de REST API van SkyPlanner.
- Polling. SkyPlanner leest om de paar minuten openstaande productieorders uit de projections en filtert daarbij op gewijzigde records.
Begin met polling en voeg events toe voor de objecten die het vaakst veranderen. SkyPlanner verstuurt webhooks wanneer de status of het productieschema verandert. Het terugschrijven verloopt dus eventgestuurd.
Gegevensmapping
De namen van projections verschillen per release. Neem de exacte namen over uit uw API Explorer.
| Object in IFS Cloud | Object in SkyPlanner | Richting | Frequentie |
|---|---|---|---|
| Inventory Part (op vestigingsniveau) | Producten en materialen | IFS → SkyPlanner | Eerste gegevensimport, daarna bij wijzigingen |
| Product Structure (kop, alternatief, regels) | Productstructuur, subproducten, materialen per product | IFS → SkyPlanner | Eerste gegevensimport, daarna bij wijzigingen |
| Routing, Routing Operations: insteltijd, bewerkingstijd, verplaatsingstijd, efficiëntie | Processtappen met bewerkingsduur, instel- en afbouwtijden | IFS → SkyPlanner | Eerste gegevensimport, daarna bij wijzigingen |
| Work Center, Work Center Resource: kalender, bezettingsgraad, efficiëntie | Werkcentra, werkcentrumgroepen, efficiënties | IFS → SkyPlanner | Eerste gegevensimport, daarna zelden |
| Personen per Labor Class; aantal medewerkers voor de bewerking | Personeel met diensten; operators per taak | IFS → SkyPlanner | Eerste gegevensimport; diensten worden in één systeem beheerd |
| Manufacturing Tool, gereedschapsgroepen | Gereedschappen als gedeelde productiemiddelen met beperkte capaciteit | IFS → SkyPlanner | Eerste gegevensimport |
| Shop Order (Released, Reserved, Started) met Shop Order Operations en materialen: Need Date, Earliest Start Date, prioriteit | Orders en taken met einddatums en materiaalbehoeften | IFS → SkyPlanner | Via events of polling om de paar minuten |
| Beschikbaarheid van voorraadartikelen | Voorraadsaldi | IFS → SkyPlanner | Polling, elk uur of bij het berekenen van het productieschema |
| Inkooporderregels met geplande ontvangst | Inkooporders met verwachte leverdatum; voorraad wordt bijgewerkt bij de status Delivered | IFS → SkyPlanner | Polling, elk uur of bij het berekenen van het productieschema |
| Shop Order Operation: start, einde, productiemiddel binnen het werkcentrum | Geplande start- en eindtijd en werkcentrum per bewerking | SkyPlanner → IFS | Bij wijzigingen in het productieschema, via een SkyPlanner-webhook |
| Terugmelding van bewerkingen (machinetijd, arbeidstijd, hoeveelheid) | Tijdregistraties en terugmeldingen van operators | SkyPlanner → IFS | Per terugmelding of per dienst, indien gekozen bij de scopebepaling |
| Inrichten in SkyPlanner | Omsteltijdenmatrix, alternatieve machines en personeel | Beheerd in SkyPlanner | Inrichten tijdens de onboarding |
Integratiepatronen
1. Eerste import van stamgegevens. Haal voorraadartikelen, maakbare productstructuren, bewerkingsvolgordes met bewerkingen, werkcentra en hun productiemiddelen, personeelscategorieën en gereedschappen op. Bepaal zorgvuldig hoe elk productiemiddel binnen een werkcentrum aan een SkyPlanner-werkcentrum wordt gekoppeld. Beslis of een werkcentrum met drie productiemiddelen wordt ingericht als één werkcentrumgroep of als drie werkcentra.
2. Productieorders synchroniseren. Lees productieorders met de status Released, Reserved en Started in, inclusief hun bewerkingen en materialen. Laat productieorders met de status Planned aan MRP over; die veranderen bij elke planningsrun. Voeg de beschikbaarheid van voorraadartikelen en openstaande inkooporderregels toe, zodat bij het opstellen van het productieschema zowel de voorraad als de verwachte inkopen worden gecontroleerd. SkyPlanner beschouwt besteld materiaal als beschikbaar op de leverdatum van de inkooporder.
3. Het productieschema terugschrijven. Voor elke bewerking die de planningsengine heeft ingepland of verplaatst, schrijft SkyPlanner de geplande start- en eindtijd en het productiemiddel binnen het werkcentrum terug naar de bewerking van de productieorder. Dit verloopt via de projection voor productieorderbewerkingen die in uw API Explorer staat, zodat IFS zijn eigen validatie uitvoert. Hoeveelheden, status en kosten blijven onder beheer van IFS.
4. Terugmeldingen van de productievloer. Kies één kanaal per vestiging. Operators kunnen blijven terugmelden in Shop Floor Workbench, waarna SkyPlanner de voortgang inleest. Of operators registreren hun werk met SkyPlanner Mobile Confirmations en de Production Timer. De tijdregistraties worden dan naar IFS verstuurd via de projection voor bewerkingsterugmeldingen die bij de scopebepaling is afgesproken.
5. Afspraken over gegevensbeheer en conflicten. Leg deze vóór de livegang vast:
| Gegevens | Beheerder |
|---|---|
| Voorraadartikelen, productstructuren, bewerkingsvolgordes, hoeveelheden, status van productieorders | IFS Cloud |
| Volgorde van bewerkingen, start- en eindtijden, toewijzing van productiemiddelen | SkyPlanner |
| Omsteltijdenmatrix, vereisten voor gereedschappen en operators, alternatieve productiemiddelen | SkyPlanner |
| Diensten en afwezigheden | Eén systeem, gekozen tijdens de scopebepaling |
| Terugmeldingen van bewerkingen en ontvangsten | IFS Cloud, via Shop Floor Workbench of tijdregistraties in SkyPlanner |
Conflicten ontstaan vooral door herplanning binnen IFS. Als een planner een productieorder opnieuw plant met de Infinite Scheduler, behandel deze dan als een nieuwe versie, synchroniseer de order opnieuw en laat SkyPlanner herplannen. Met Autopilot plant SkyPlanner automatisch opnieuw wanneer de productie verandert. Vestigingen die ook MSO gebruiken, bepalen welke werkcentra onder welke planningstool vallen.
Gebruikelijke projectstappen
De implementatie is normaal gesproken binnen enkele weken na de start van de onboarding afgerond, ook bij grote bedrijven. Daarvóór kunt u tijdens de gratis proefperiode van 30 dagen met uw eigen gegevens werken: exporteer werkcentra, bewerkingsvolgordes en openstaande productieorders vanuit IFS Cloud naar Excel en importeer ze.
- Mapping. Leg de mappingtabel, de regels voor gegevenseigenaarschap, de synchronisatiefrequenties en het kanaal voor terugmeldingen vast.
- IAM en rechten. Registreer de IAM-client, maak de servicegebruiker aan en ken de rechtensets voor de projections toe. Eerst in de sandbox, daarna in de productieomgeving.
- Eerste gegevensimport. Voorraadartikelen, productstructuren, bewerkingsvolgordes, werkcentra, personeelscategorieën en gereedschappen.
- Productieorders en inkooporders synchroniseren. Begin met polling en gebruik aangepaste events waar veel wijzigingen plaatsvinden.
- Randvoorwaarden instellen in SkyPlanner. Omsteltijdenmatrix, gereedschappen, aantallen operators en alternatieve machines of medewerkers.
- Planning terugschrijven. Schrijf de bewerkingsdatums en productiemiddelen terug naar de bewerkingen van de productieorder.
- Parallel testen. Laat SkyPlanner naast de huidige planning draaien, vergelijk de datums en corrigeer de stamgegevens.
- Ingebruikname. Schakel het terugschrijven in zodra de gegevens overeenkomen.
Aandachtspunten bij een IFS Cloud-integratie
- Machinetijd versus arbeidstijd. Productieorderbewerkingen hebben afzonderlijke instel- en bewerkingstijden voor machines en personeel, plus een ploegbezetting. Bepaal per werkcentrum welke tijd de duur bepaalt, anders klopt geen enkele bewerking.
- Bezetting en efficiëntie dubbel meegerekend. De bezettingsgraad van het werkcentrum, de bewerkingsefficiëntie en de efficiëntie van productiemiddelen verkorten allemaal de beschikbare tijd in IFS. Verwerk deze factoren slechts eenmaal in de efficiëntie van het werkcentrum in SkyPlanner.
- Verouderde capaciteitsgegevens. De capaciteit van productiemiddelen is pas beschikbaar nadat Calculate Work Center Resource Capacity is uitgevoerd. Controleer de kalenders en geldigheidsperioden vóór de eerste gegevensimport.
- Preferred Resource is een voorkeur. Leg daadwerkelijke alternatieven expliciet vast als alternatieve werkcentra in SkyPlanner.
- UI-projections veranderen. Gebruik Premium of Entity Service APIs als basis; deze behouden de vorige versie tot de volgende release. Test opnieuw bij elke halfjaarlijkse release.
- Shop Floor Workbench-projections volgen UI-processen. Projections die voor de Shop Floor Workbench-assistent zijn gebouwd, zijn niet bedoeld voor directe transactionele integratie. Kies de projection voor terugmeldingen tijdens de scopebepaling.
Wie configureert de integratie?
Het werk omvat de mapping naar uw bewerkingsvolgordes, werkcentra en IFS-inrichting. Daarnaast worden de randvoorwaarden ingesteld waarmee SkyPlanner bij de capaciteitsplanning rekening houdt: de omsteltijdenmatrix, gereedschappen, aantallen operators en alternatieve productiemiddelen.
- Het SkyPlanner-team configureert de integratie tijdens de onboarding en biedt ondersteuning na de ingebruikname. Dit omvat de SkyPlanner-kant en de afgesproken IFS-projections. Elke fabriek gebruikt IFS Cloud anders; die praktijkkennis komt hierbij van pas.
- Uw IFS-partner kan meewerken. De partner kent uw configuratie en kan samen met het team de IAM-client, rechtensets en events instellen. SkyPlanner levert de REST API, Swagger/OpenAPI-documentatie en webhooks.
- Uw eigen ontwikkelaars kunnen hierop voortbouwen via dezelfde gedocumenteerde REST API met een API-token. Een API-token is voldoende om te beginnen en het SkyPlanner-team helpt waar nodig. De openbare documentatie vindt u in de integratiedocumentatie van SkyPlanner.
SkyPlanner is beschikbaar vanaf 199 € per maand, inclusief 5 werkcentra, met maandelijkse facturatie. U ontvangt vooraf een offerte voor de integratie, afgestemd op uw proces en behoeften, samen met uw abonnement. Zo kent u de totale kosten voordat u begint. Bekijk hoe de eigen planning van IFS zich verhoudt tot SkyPlanner in capaciteitsplanning in IFS Cloud. Het overzicht vindt u op de IFS Cloud-pagina; andere ERP-systemen staan in het overzicht van ERP-integraties.
Ervaringen van maakbedrijven met SkyPlanner
2 hbespaard per week
“Dankzij SkyPlanner zijn we voor onze productieplanning overgestapt van Excel-spreadsheets naar realtime productieoptimalisatie.”
Kalle Kalliomäki, supplychainspecialist
UTU · Elektrische verdeelkasten en schakelapparatuur
De productieplanning bespaart elke week 2 uur werktijd en een nieuwe werklijst bereikt de productielijn binnen enkele seconden.
+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.
99,2%leverbetrouwbaarheid
“SkyPlanner heeft knelpunten zichtbaar gemaakt en het productiemanagement overzichtelijker gemaakt.”
Toni Tuori, productiemanager
Piristeel · Dakveiligheid en regenwatersystemen
De leverbetrouwbaarheid bereikte dit jaar 99,2% en de planning bespaart tot vier uur werktijd per dag.
Minderstilstand door materiaaltekorten
“De waarde van SkyPlanner voor ons is dat het een hulpmiddel is dat in de dagelijkse praktijk werkt, vooral bij het vaststellen van leverdatums.”
Tommi Männistö, manager productieplanning
Eskomatic · Verspaning in opdracht
Automatische capaciteitsplanning levert nauwkeurigere leverdatums op en de productiestilstand door materiaaltekorten is sterk afgenomen.
Veelgestelde vragen
Welke IFS Cloud-API moet een integratie voor productieplanning gebruiken?
De OData-projections onder /ifsapplications/projection/, bij voorkeur de Premium of Entity Service APIs die in uw API Explorer staan. Deze bieden OpenAPI-specificaties per omgeving en behouden de vorige versie tot de volgende release.
Wie bouwt de IFS Cloud-integratie?
Het SkyPlanner-team configureert de tweerichtingsintegratie tijdens de onboarding voor uw IFS-inrichting en biedt ondersteuning na de ingebruikname. Uw IFS-partner of uw eigen ontwikkelaars kunnen ook voortbouwen op de gedocumenteerde REST API van SkyPlanner. Een API-token is voldoende om te beginnen.
Welke authenticatie gebruikt de integratie?
Een IFS IAM-client met de OAuth 2.0 Client Credentials-flow, gekoppeld aan een servicegebruiker met rechtensets voor de benodigde projections. De eigen API van SkyPlanner gebruikt een API-token.
Kan IFS Cloud wijzigingen in productieorders realtime doorsturen?
Ja, met aangepaste events bij entiteitswijzigingen en de REST Sender, beide geconfigureerd in IFS Connect. Begin met polling om de paar minuten en voeg events toe waar veel wijzigingen plaatsvinden. De webhooks van SkyPlanner sturen planningswijzigingen direct door zodra ze plaatsvinden.
Hebben we MSO of PSO nodig voor deze integratie?
Nee. SkyPlanner leest productieorders, bewerkingen en werkcentra rechtstreeks uit IFS-projections en maakt zelf een planning die rekening houdt met de beschikbare capaciteit. U hebt geen MSO-toegang, PSO Cloud Service of IFS.ai Activation Pass nodig en hoeft geen tokenbudget te beheren. Autopilot plant bij elke wijziging automatisch opnieuw.
Kunnen we SkyPlanner testen voordat we de integratie bouwen?
Ja. Tijdens de gratis proefperiode van 30 dagen kunt u met maximaal 20 werkcentra werken en Excel- of CSV-bestanden uit IFS Cloud importeren. Een creditcard is niet nodig. Start de proefperiode of neem contact op met sales om de scope van de integratie te bepalen.
