Koppelingen / ERP / Oracle Fusion Cloud
Handleiding voor de Oracle Fusion Cloud koppeling voor productieplanning met SkyPlanner APS
Deze handleiding laat partners en IT-teams zien hoe ze Oracle Fusion Cloud Manufacturing aan SkyPlanner APS koppelen. SkyPlanner wisselt in beide richtingen gegevens uit met Oracle Fusion Cloud via de eigen REST-resources van Oracle:
- SkyPlanner leest productieorders met hun bewerkingen, werkdefinities, werkcentra, productiemiddelen, kalenders, artikelen, artikelstructuren, actuele voorraden en inkooporders in.
- De geplande start- en einddatums worden teruggeschreven naar elke bewerking van de productieorder.
- Terugmeldingen van operators worden teruggeboekt als bewerkingstransacties en resourcetransacties.
- SkyPlanner-webhooks sturen wijzigingen in het productieschema direct door.
Het SkyPlanner-team stemt de koppeling tijdens de implementatie af op uw Oracle Fusion Cloud-inrichting en biedt ook na de ingebruikname ondersteuning. Deze handleiding is bedoeld voor partners en ontwikkelaars die willen meewerken of zelf een koppeling willen bouwen met de gedocumenteerde REST API van SkyPlanner (API-documentatie).
Integratie-interfaces van Oracle Fusion Cloud
Oracle Fusion Cloud biedt externe planningssoftware drie routes voor gegevensuitwisseling:
- REST API voor Oracle Fusion Cloud SCM. Het basispad is
/fscmRestApi/resources/11.13.18.05/. Planningssoftware gebruikt de resourcesworkOrders(met de onderliggende resourcesWorkOrderOperation,WorkOrderOperationResourceenWorkOrderOperationMaterial),processWorkOrders,workDefinitions,workCenters,productionResources,calendars,itemsV2,itemStructureseninventoryOnhandBalances. De voortgang wordt geboekt viaoperationTransactions,resourceTransactionsenmaterialTransactions. Inkooporders worden opgehaald uitpurchaseOrdersin de Procurement REST API. (REST-eindpunten) - File-Based Data Import (FBDI). Het proces Import Work Orders maakt productieorders met hun bewerkingen en bijbehorende productiemiddelen aan of werkt ze bij op basis van een sjabloon. Import Work Order Resource Transactions laadt resourceboekingen. Oracle is duidelijk over de timing: “This option isn’t suitable for importing manufacturing data on a real-time basis.” (Deze optie is niet geschikt om productiegegevens in realtime te importeren.) (bron)
- Oracle Integration (OIC). Het integratieplatform van Oracle verzorgt de gegevensstromen tussen Fusion en andere systemen. Een recept in Oracle Integration luistert naar de gebeurtenis Work Order Status Change in Oracle Fusion Cloud Manufacturing (bron). Gebruik dit als uw bedrijf al met OIC werkt.
Voor realtime planning is REST de belangrijkste route. FBDI is geschikt voor het voor het eerst inladen van de stamgegevens.
Authenticatie en toegang
- Beveiliging van Oracle REST. “Fusion Applications REST APIs use a global Oracle Web Services Manager (OWSM) security policy called Multi Token Over SSL RESTful Service Policy.” (De REST API’s van Fusion Applications gebruiken een algemeen beveiligingsbeleid van Oracle Web Services Manager (OWSM), genaamd Multi Token Over SSL RESTful Service Policy.) Dit beleid accepteert Basic-authenticatie via SSL en authenticatie op basis van tokens, zoals een SAML 2.0-bearertoken. (Snelstartgids)
- Integratiegebruiker. Maak een aparte Oracle-gebruiker aan voor de koppeling. Ken functierollen toe met de benodigde rechten voor productieorders, werkdefinities, voorraad en transacties. Beperk die rechten tot de productieorganisaties die binnen de scope vallen.
- Paginering. Oracle beperkt het aantal records dat één SCM REST-aanroep retourneert. Lees daarom met
limitenoffseten filter op organisatie en status (bron)
De REST API van SkyPlanner gebruikt voor authenticatie een API-token in de header Authorization-Token (SkyPlanner Settings > API) en is gedocumenteerd in Swagger/OpenAPI. De integratiehandleiding leidt u door de eerste aanroepen.
Gebeurtenissen en polling
Gegevens uit Oracle worden via polling opgehaald. Gefilterde REST-query’s halen nieuwe en gewijzigde productieorders, statuswijzigingen naar vrijgegeven, actuele voorraden en inkooporders op. De frequentie wordt per fabriek ingesteld: van elke paar minuten voor productieorders tot elk uur voor de voorraad. Als u Oracle Integration gebruikt, kan de gebeurtenis Work Order Status Change direct een leesactie activeren.
SkyPlanner verstuurt webhooks zodra de status of het productieschema verandert. Het terugschrijven is dus gebeurtenisgestuurd.
Gegevensmapping
| Oracle Fusion Cloud-object (REST-resource) | SkyPlanner-object | Richting | Frequentie |
|---|---|---|---|
Artikelen (itemsV2), maateenheden | Producten en materialen | Oracle → SkyPlanner | Eerste import, daarna via polling |
Artikelstructuren (itemStructures) | Productstructuur, deelproducten, materialen per product | Oracle → SkyPlanner | Eerste import, daarna bij wijzigingen |
Werkdefinities (workDefinitions): bewerkingen, productiemiddelen per bewerking, verbruik, Basis Type | Processtappen met bewerkings-, instel- en afbouwtijden | Oracle → SkyPlanner | Eerste import, daarna bij wijzigingen |
Werkcentra (workCenters), productiemiddelen (productionResources) voor machines en personeel | Werkcentra, werkcentrumgroepen, personeel, efficiënties | Oracle → SkyPlanner | Eerste import, daarna zelden |
Kalenders en diensten (calendars, uitzonderingen op diensten) | Diensten en vrije dagen | Oracle → SkyPlanner | Dagelijks, of diensten beheren in SkyPlanner |
| Productieorganisaties | Werkcentrumgroepen per fabriek | Oracle → SkyPlanner | Eerste import |
Productieorders (workOrders, processWorkOrders) met WorkOrderOperation en WorkOrderOperationMaterial | Orders en taken met uiterste gereeddatums en materiaalbehoeften | Oracle → SkyPlanner | Polling om de paar minuten |
Actuele voorraden (inventoryOnhandBalances) | Voorraadstanden | Oracle → SkyPlanner | Polling, elk uur of bij een planningsrun |
Inkooporders (purchaseOrders) met toegezegde leverdatums | Inkooporders, inkomend materiaal per leverdatum | Oracle → SkyPlanner | Polling, elk uur of bij een planningsrun |
WorkOrderOperation PlannedStartDate, PlannedCompletionDate (PATCH) | Geplande start- en eindtijd per taak | SkyPlanner → Oracle | Bij wijziging van het productieschema, via een SkyPlanner-webhook |
Datums van WorkOrderOperationResource (PATCH) | Toewijzing van productiemiddelen per taak | SkyPlanner → Oracle | Bij wijziging van het productieschema, indien hiervoor gekozen is |
operationTransactions (POST) | Gereedgemelde aantallen per bewerking | SkyPlanner → Oracle | Per terugmelding |
resourceTransactions (POST) | Tijdregistraties: arbeids- en machinetijd | SkyPlanner → Oracle | Per terugmelding of per dienst, indien hiervoor gekozen is |
| Niet in Oracle Fusion Cloud | Insteltijdenmatrix, gereedschappen met beperkte beschikbaarheid, alternatieve machines en personeel | Beheerd in SkyPlanner | Ingericht tijdens de implementatie |
Integratiepatronen
1. Eerste import van stamgegevens. Lees artikelen, artikelstructuren, werkdefinities, werkcentra, productiemiddelen en kalenders via REST in, of laad ze eenmalig vanuit FBDI-extracten. Maak bewuste keuzes bij het mappen van werkcentra: een werkcentrum met vier machines die aan hetzelfde productiemiddel zijn gekoppeld, wordt één werkcentrumgroep of vier werkcentra. Elke productieorganisatie wordt een werkcentrumgroep, zodat alle fabrieken in één planning staan.
2. Productieorders synchroniseren. Lees vrijgegeven en niet-vrijgegeven productieorders in, inclusief bewerkingen en materialen, plus openstaande 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 productieorders in, geen geplande orders uit Supply Planning. Geplande orders worden eerst in Oracle omgezet in productieorders.
3. Planning terugschrijven. Wanneer de planningsengine een taak inplant of verplaatst, activeert een SkyPlanner-webhook een PATCH op workOrders/{WorkOrderId}/child/WorkOrderOperation/{WorkOrderOperationId} met PlannedStartDate en PlannedCompletionDate. Daarbij geldt de regel van Oracle: “The planned start date must not occur before the start date of the work order or after the finish date of the work order.” (De geplande startdatum mag niet vóór de startdatum of na de einddatum van de productieorder liggen.) (bron) Valt de nieuwe planning buiten die datums, dan past de koppeling dus eerst de datums in de productieorderkop aan via PATCH en daarna de bewerkingen.
4. Terugmeldingen vanaf de werkvloer. Operators registreren hun werk met SkyPlanner Mobile Confirmations of de Production Timer. De tijdregistraties houden de planning actueel. Gereedgemelde aantallen worden geboekt via operationTransactions, arbeids- en machine-uren via resourceTransactions. Rapporteert uw fabriek al in Oracle, dan leest SkyPlanner de voortgang daaruit.
5. Afspraken over gegevenseigenaarschap en conflicten. Leg deze vast vóór de ingebruikname:
| Gegevens | Eigenaar |
|---|---|
| Artikelen, artikelstructuren, werkdefinities, aantallen, status van productieorders | Oracle Fusion Cloud |
| Bewerkingsvolgorde, start- en eindtijden, toewijzing van productiemiddelen | SkyPlanner |
| Matrix met insteltijden, eisen aan gereedschap en operators, alternatieve productiemiddelen | SkyPlanner |
| Ploegendiensten en niet-werkdagen | Eén systeem, gekozen tijdens de scopebepaling |
| Transacties voor productiemiddelen, bewerkingen en materialen | Oracle, met rechtstreekse invoer of boekingen vanuit SkyPlanner-tijdregistraties |
Wijs één systeem aan dat de bewerkingsdatums schrijft. SkyPlanner heeft geen planningswerkgebied in Oracle nodig en neemt daarom het schrijven van geplande datums over van Production Scheduling. Geeft Production Scheduling nog planningen vrij, houd de bijbehorende organisaties dan gescheiden van de organisaties die SkyPlanner plant.
Gebruikelijke projectstappen
De implementatie is doorgaans binnen enkele weken na de start van de onboarding afgerond, ook bij grote bedrijven. Valideer de planning vooraf tijdens de gratis proefperiode van 30 dagen, met werkcentra, werkdefinities en openstaande productieorders die u vanuit Oracle als CSV of Excel exporteert.
- Mapping. Leg de mappingtabel, het gegevenseigenaarschap, de organisaties binnen de scope en de synchronisatiefrequenties vast. Bepaal ook of transacties worden teruggeboekt.
- Toegang tot Oracle. Maak de integratiegebruiker en rollen aan. Test eerst in een Oracle-omgeving die niet voor productie wordt gebruikt.
- Eerste gegevensimport. Artikelen, artikelstructuren, werkdefinities, werkcentra, productiemiddelen en kalenders.
- Productieorders en inkooporders synchroniseren. Polling met filters, paginering en herhaalpogingen.
- Randvoorwaarden instellen in SkyPlanner. Matrix met insteltijden, gereedschappen, aantal operators per taak en alternatieve machines of medewerkers.
- Planning terugschrijven. PATCH via SkyPlanner-webhooks, aangevuld met transacties als daarvoor is gekozen.
- Parallel testen. Laat SkyPlanner naast de huidige planning draaien, vergelijk de datums en corrigeer de stamgegevens.
- Ingebruikname. Schakel het terugschrijven per fabriek in zodra de gegevens overeenkomen.
Aandachtspunten bij een Oracle Fusion Cloud koppeling
- Standaardgedrag van de planner. De Oracle-engine die zonder capaciteitsbeperkingen plant, wordt uitgevoerd bij het aanmaken en bij “certain update actions” (bepaalde bijwerkacties). Test in uw omgeving welke updates de datums opnieuw berekenen en zorg dat SkyPlanner de bewerkingsdatums als laatste schrijft.
- Tijdvensters van productieorders. Bewerkingsdatums moeten binnen de start- en einddatum van de productieorder vallen. Pas eerst de orderkop aan via PATCH.
- Basis Type. Het gebruik van productiemiddelen geldt alleen per eenheid als Basis Type op Variable staat. Bij Fixed geldt een vaste tijd per bewerking. Reken dit bij het importeren om, anders klopt geen enkele tijdsduur.
- Discrete productie en procesproductie. Fabrieken met discrete productie gebruiken
workOrders, procesfabrieken gebruikenprocessWorkOrders. Richt de mapping voor beide in als u beide productievormen gebruikt. - Paginering. Oracle beperkt het aantal records per REST-aanroep. Gebruik paginering voor elke query en filter op organisatie en status.
- Kwartaalupdates. Oracle werkt Fusion elk kwartaal bij. Leg de REST-versie vast in het pad en test na elke update opnieuw.
- Statusregels. Productieorders met de status Pending Approval of een afgesloten status mogen geen nieuwe datums krijgen. Filter ze uit bij het inlezen.
Wie richt de Oracle Fusion Cloud koppeling in en ondersteunt deze?
- Het SkyPlanner-team richt de koppeling tijdens de onboarding in en ondersteunt deze na ingebruikname, voor de afgesproken REST-resources en organisaties. Elke fabriek gebruikt Oracle Fusion Cloud anders. Die praktijkkennis wordt hier toegepast.
- Uw Oracle-partner kan meewerken. De partner kent uw organisaties, rollen en uitbreidingen en kan samen met het SkyPlanner-team de integratiegebruiker, rollen en eventuele Oracle Integration-flows inrichten.
- Uw eigen ontwikkelaars kunnen hierop voortbouwen via de REST API van SkyPlanner met een API-token. Een API-token is voldoende om te beginnen. Het SkyPlanner-team helpt waar nodig. De documentatie vindt u in de SkyPlanner-integratiedocumentatie.
SkyPlanner is beschikbaar vanaf 199 € per maand, inclusief 5 werkcentra, met maandelijkse facturering. U ontvangt vooraf een offerte voor de koppeling, afgestemd op uw proces en behoeften, samen met uw abonnement. Bekijk de prijzen, capaciteitsplanning voor Oracle Fusion Cloud, de Oracle Fusion Cloud-pagina en het overzicht van ERP-koppelingen. Gebruikt u NetSuite? Bekijk dan de handleiding voor de NetSuite-koppeling.
Ervaringen van fabrikanten met SkyPlanner
2 hbespaard per week
“Met SkyPlanner zijn we voor onze productieplanning overgestapt van Excel-spreadsheets naar realtime productieoptimalisatie.”
Kalle Kalliomäki, supplychainspecialist
UTU · Elektrische schakelborden en schakelapparatuur
De productieplanning bespaart elke week 2 uur werktijd, en een nieuwe werklijst is binnen enkele seconden beschikbaar aan de productielijn.
+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 meer overzicht gebracht in de productieaansturing.”
Toni Tuori, productiemanager
Piristeel · Dakveiligheid en hemelwaterafvoersystemen
De leverbetrouwbaarheid bereikte dit jaar 99,2%, en het inplannen bespaart tot vier uur werktijd per dag.
1.000-tallenproductieorders automatisch ingepland
“We hebben de productie op een andere manier onder controle en ons inzicht in de capaciteit is van een heel ander niveau.”
Hannu Ryynänen, algemeen directeur
Mamec · Industriële mengers, pompen en hightechproductie in opdracht
Duizenden productieorders worden automatisch ingepland, met realtime inzicht in de productie voor de hele organisatie.
Veelgestelde vragen
Heeft Oracle Fusion Cloud een API voor productieorders?
Ja. De REST API voor Oracle Fusion Cloud SCM biedt workOrders met onderliggende objecten voor bewerkingen, productiemiddelen en materialen, plus processWorkOrders voor procesproductie. De API ondersteunt GET, POST en PATCH.
Hoe worden geplande datums teruggeschreven naar Oracle Fusion Cloud?
Via een PATCH op het onderliggende WorkOrderOperation-object van de productieorder, waarmee PlannedStartDate en PlannedCompletionDate worden ingesteld. Bewerkingsdatums moeten binnen de datums van de productieorder blijven. Daarom wordt zo nodig eerst de orderkop via PATCH aangepast.
Hoe komen terugmeldingen van operators in Oracle terecht?
Gereedgemelde aantallen worden geboekt via operationTransactions, arbeids- en machine-uren via resourceTransactions. Beide zijn REST-resources in Fusion Manufacturing die POST ondersteunen.
Ondersteunt Oracle Fusion Cloud webhooks?
Fusion publiceert business events zoals Work Order Status Change, waarop Oracle Integration zich kan abonneren. Zonder Oracle Integration vraagt de koppeling de REST API periodiek uit, volgens een interval dat per fabriek wordt ingesteld. De eigen webhooks van SkyPlanner sturen planningswijzigingen direct door zodra ze plaatsvinden.
Moet een Oracle-partner Oracle Production Scheduling of SkyPlanner voorstellen?
SkyPlanner, als de klant één planning voor meerdere fabrieken wil die rekening houdt met de beschikbare capaciteit en zichzelf actueel houdt. Production Scheduling wordt ingeschakeld binnen het aanbod van Supply Chain Planning, berekent de planning per scheduling organization en past omstelregels alleen toe op single-unit equipment (Oracle-documentatie). SkyPlanner maakt verbinding via de SCM REST API, herplant automatisch en plant omstellingen, gereedschappen, ploegen en materiaal. Het aantal gebruikers is onbeperkt, vanaf 199 € per maand.
Kunnen we SkyPlanner testen voordat we de koppeling bouwen?
Ja. Tijdens de gratis proefperiode van 30 dagen kunt u tot 20 werkcentra gebruiken en gegevens uit Oracle importeren via CSV of Excel. Een creditcard is niet nodig. Start de proefperiode of neem contact op met sales om de scope van de koppeling te bepalen.