Integrationer / ERP / Oracle Fusion Cloud
Guide till integration med Oracle Fusion Cloud för produktionsplanering med SkyPlanner APS
Den här guiden visar partner och IT-team hur Oracle Fusion Cloud Manufacturing ansluts till SkyPlanner APS. SkyPlanner integreras med Oracle Fusion Cloud i båda riktningarna via Oracles egna REST-resurser:
- Tillverkningsorder med operationer, tillverkningsdefinitioner, produktionsgrupper, produktionsresurser, kalendrar, artiklar, artikelstrukturer, lagersaldon och inköpsorder läses in.
- Planerade start- och slutdatum skickas tillbaka till varje operation på tillverkningsordern.
- Operatörernas återrapportering skickas tillbaka som operations- och resurstransaktioner.
- SkyPlanner skickar planändringar via webhooks så snart de sker.
SkyPlanner-teamet konfigurerar integrationen efter er Oracle Fusion Cloud-miljö under införandet och ger support efter driftsättningen. Guiden vänder sig till partner och utvecklare som vill delta i arbetet eller själva bygga vidare på SkyPlanners dokumenterade REST API (API-referens).
Integrationsgränssnitt i Oracle Fusion Cloud
Oracle Fusion Cloud erbjuder tre vägar för datautbyte med ett externt planeringssystem:
- REST API för Oracle Fusion Cloud SCM. Bassökvägen är
/fscmRestApi/resources/11.13.18.05/. Ett planeringssystem använder resursernaworkOrders(med underresursernaWorkOrderOperation,WorkOrderOperationResourceochWorkOrderOperationMaterial),processWorkOrders,workDefinitions,workCenters,productionResources,calendars,itemsV2,itemStructuresochinventoryOnhandBalances. Återrapportering skickas tilloperationTransactions,resourceTransactionsochmaterialTransactions. Inköpsorder hämtas frånpurchaseOrdersi Procurement REST API. (REST-endpoints) - File-Based Data Import (FBDI). Processen Import Work Orders skapar eller uppdaterar tillverkningsorder med tillhörande operationer och operationsresurser utifrån en mall. Import Work Order Resource Transactions läser in resursrapportering. Oracle är tydliga om tidsaspekten: ”This option isn’t suitable for importing manufacturing data on a real-time basis.” (Det här alternativet är inte lämpligt för import av tillverkningsdata i realtid.) (källa)
- Oracle Integration (OIC). Oracles integrationsplattform hanterar flöden mellan Fusion och andra system. En färdig integrationsmall i Oracle Integration lyssnar på händelsen Work Order Status Change i Oracle Fusion Cloud Manufacturing (källa). Använd den om företaget redan kör OIC.
REST är huvudvägen för planering i realtid. FBDI passar för den första inläsningen av grunddata.
Autentisering och åtkomst
- Säkerhet i Oracle REST. ”Fusion Applications REST APIs use a global Oracle Web Services Manager (OWSM) security policy called Multi Token Over SSL RESTful Service Policy.” (Fusion Applications REST API:er använder en global säkerhetspolicy i Oracle Web Services Manager (OWSM) som heter Multi Token Over SSL RESTful Service Policy.) Policyn tillåter Basic-autentisering över SSL och tokenbaserad autentisering, till exempel med en SAML 2.0 bearer-token. (Snabbstart)
- Integrationsanvändare. Skapa en särskild Oracle-användare för integrationen. Tilldela roller som ger nödvändiga behörigheter för tillverkningsorder, tillverkningsdefinitioner, lager och transaktioner, begränsade till de tillverkningsorganisationer som ingår.
- Paginering. Oracle begränsar antalet poster som ett enskilt SCM REST-anrop returnerar. Läs därför med
limitochoffsetoch filtrera på organisation och status (källa)
SkyPlanners REST API använder en API-token i headern Authorization-Token för autentisering (SkyPlanner Settings > API) och är dokumenterat i Swagger/OpenAPI. Integrationshandledningen går igenom de första anropen.
Händelser och pollning
Data från Oracle hämtas genom pollning. Filtrerade REST-frågor hämtar nya och ändrade tillverkningsorder, statusändringar till frisläppt, lagersaldon och inköpsorder. Intervallet bestäms per fabrik: med några minuters mellanrum för tillverkningsorder och upp till en gång i timmen för lagersaldon. Om ni använder Oracle Integration kan händelsen Work Order Status Change utlösa en omedelbar läsning.
SkyPlanner skickar webhooks när status eller planen ändras. Återskrivningen är därmed händelsestyrd.
Datamappning
| Objekt i Oracle Fusion Cloud (REST-resurs) | Objekt i SkyPlanner | Riktning | Frekvens |
|---|---|---|---|
Artiklar (itemsV2), måttenheter | Produkter och material | Oracle → SkyPlanner | Första inläsning, därefter pollning |
Artikelstrukturer (itemStructures) | Produktstruktur, delprodukter, material per produkt | Oracle → SkyPlanner | Första inläsning, därefter vid ändring |
Tillverkningsdefinitioner (workDefinitions): operationer, operationsresurser, förbrukning, Basis Type | Processteg med varaktighet, ställ- och efterarbetstider | Oracle → SkyPlanner | Första inläsning, därefter vid ändring |
Produktionsgrupper (workCenters), produktionsresurser (productionResources) för utrustning och personal | Produktionsgrupper, grupperingar av produktionsgrupper, personal, effektivitetsgrader | Oracle → SkyPlanner | Första inläsning, därefter sällan |
Kalendrar och skift (calendars, skiftundantag) | Skift och arbetsfria dagar | Oracle → SkyPlanner | Dagligen, eller egna skift i SkyPlanner |
| Tillverkningsorganisationer | Grupperingar av produktionsgrupper per fabrik | Oracle → SkyPlanner | Första inläsning |
Tillverkningsorder (workOrders, processWorkOrders) med WorkOrderOperation och WorkOrderOperationMaterial | Order och operationer med färdigdatum och materialbehov | Oracle → SkyPlanner | Pollning med några minuters mellanrum |
Lagersaldon (inventoryOnhandBalances) | Lagersaldon | Oracle → SkyPlanner | Pollning varje timme eller vid planeringskörning |
Inköpsorder (purchaseOrders) med utlovade leveransdatum | Inköpsorder, inkommande material per leveransdatum | Oracle → SkyPlanner | Pollning varje timme eller vid planeringskörning |
WorkOrderOperation PlannedStartDate, PlannedCompletionDate (PATCH) | Planerad start och sluttid per operation | SkyPlanner → Oracle | Vid planändring, via webhook från SkyPlanner |
Datum för WorkOrderOperationResource (PATCH) | Resurstilldelning per operation | SkyPlanner → Oracle | Vid planändring, om detta valts |
operationTransactions (POST) | Färdigställda kvantiteter per operation | SkyPlanner → Oracle | Vid varje återrapportering |
resourceTransactions (POST) | Tidsregistreringar: arbets- och maskintid | SkyPlanner → Oracle | Vid varje återrapportering eller per skift, om detta valts |
| Finns inte i Oracle Fusion Cloud | Ställtidsmatris, verktyg som resurser med begränsad kapacitet, alternativa maskiner och personal | Underhålls i SkyPlanner | Konfigureras under införandet |
Integrationsmönster
1. Första inläsning av grunddata. Läs in artiklar, artikelstrukturer, tillverkningsdefinitioner, produktionsgrupper, produktionsresurser och kalendrar via REST, eller gör en engångsinläsning från FBDI-utdrag. Mappa produktionsgrupperna med omsorg: om en produktionsgrupp innehåller fyra maskiner som motsvarar samma resurs blir den en gruppering av produktionsgrupper eller fyra produktionsgrupper. Varje tillverkningsorganisation blir en gruppering av produktionsgrupper, så att alla fabriker ingår i en och samma plan.
2. Synkronisering av tillverkningsorder. Läs in frisläppta och ej frisläppta tillverkningsorder med tillhörande operationer och material samt öppna 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 tillverkningsorder, inte planerade order från Supply Planning. Planerade order omvandlas först till tillverkningsorder i Oracle.
3. Återskrivning av planen. När planeringsmotorn placerar eller flyttar en operation utlöser en webhook från SkyPlanner ett PATCH-anrop till workOrders/{WorkOrderId}/child/WorkOrderOperation/{WorkOrderOperationId} med PlannedStartDate och PlannedCompletionDate. Oracles regel gäller: ”The planned start date must not occur before the start date of the work order or after the finish date of the work order.” (Det planerade startdatumet får inte ligga före tillverkningsorderns startdatum eller efter dess slutdatum.) (källa) Om den nya planen hamnar utanför dessa datum uppdaterar integrationen därför först datumen i tillverkningsorderns huvud med PATCH och därefter operationerna.
4. Återrapportering från produktionen. Operatörerna registrerar arbetet med SkyPlanner Mobile Confirmations eller Production Timer, och tidsregistreringarna håller planen aktuell. Färdiga kvantiteter skickas till operationTransactions och arbets- och maskintid till resourceTransactions. Om fabriken redan rapporterar i Oracle läser SkyPlanner i stället in produktionsutfallet därifrån.
5. Regler för dataägarskap och konflikter. Dokumentera dem före driftstart:
| Data | Ägare |
|---|---|
| Artiklar, artikelstrukturer, tillverkningsdefinitioner, kvantiteter, tillverkningsorderns status | Oracle Fusion Cloud |
| Operationsföljd, start- och sluttider, resurstilldelning | SkyPlanner |
| Ställtidsmatris, krav på verktyg och operatörer, alternativa resurser | SkyPlanner |
| Skift och arbetsfria dagar | Ett system som väljs under kartläggningen |
| Resurs-, operations- och materialtransaktioner | Oracle, med registrering direkt där eller överföring från tidsregistreringarna i SkyPlanner |
Låt bara ett system skriva operationernas datum. SkyPlanner behöver inget arbetsområde för planering i Oracle och tar därför över från Production Scheduling som det system som skriver planerade datum. Om Production Scheduling fortfarande frisläpper planer måste dess organisationer hållas åtskilda från dem som SkyPlanner planerar.
Vanliga projektsteg
Implementeringen är normalt klar inom några veckor efter att introduktionen har startat, även för stora företag. Innan dess kan du validera planen under den kostnadsfria provperioden på 30 dagar med produktionsgrupper, tillverkningsdefinitioner och öppna tillverkningsorder som exporterats från Oracle i CSV- eller Excel-format.
- Mappning. Fastställ mappningstabellen, reglerna för dataägarskap, vilka organisationer som ingår, synkroniseringsfrekvenserna och om transaktioner ska skrivas tillbaka.
- Åtkomst till Oracle. Skapa integrationsanvändaren och rollerna. Testa först i en Oracle-miljö som inte används för produktion.
- Första inläsning. Artiklar, artikelstrukturer, arbetsdefinitioner, produktionsgrupper, produktionsresurser och kalendrar.
- Synkronisering av tillverknings- och inköpsorder. Periodisk hämtning med filter, paginering och återförsök.
- Inställning av begränsningar i SkyPlanner. Ställtidsmatris, verktyg, antal operatörer per operation samt alternativa maskiner eller personalresurser.
- Återskrivning av planen. PATCH-anrop som utlöses av webhooks från SkyPlanner samt transaktioner om det har valts.
- Parallelltestning. Kör SkyPlanner parallellt med den nuvarande planen, jämför datum och rätta grunddata.
- Driftstart. Aktivera återskrivning fabrik för fabrik när uppgifterna stämmer överens.
Att tänka på vid en integration med Oracle Fusion Cloud
- Standardbeteende för planeringsmotorn. Oracles planeringsmotor utan kapacitetsbegränsningar körs när en order skapas och vid ”certain update actions” (vissa uppdateringsåtgärder). Testa i er miljö vilka uppdateringar som räknar om datumen och se till att SkyPlanner är det sista systemet som skriver operationernas datum.
- Tillverkningsorderns tidsram. Operationernas datum måste ligga mellan tillverkningsorderns start- och slutdatum. Uppdatera först orderhuvudet med PATCH.
- Basis Type. Resursåtgången anges per enhet endast när Basis Type är Variable. Fixed innebär en fast tid per operation. Räkna om vid importen, annars blir samtliga varaktigheter fel.
- Diskret tillverkning och processtillverkning. Fabriker med diskret tillverkning använder
workOrders, medan processfabriker använderprocessWorkOrders. Mappa båda om ni har båda tillverkningsformerna. - Paginering. Oracle begränsar antalet poster per REST-anrop. Använd paginering för varje fråga och filtrera på organisation och status.
- Kvartalsvisa uppdateringar. Oracle uppdaterar Fusion varje kvartal. Lås REST-versionen i sökvägen och testa på nytt efter varje uppdatering.
- Statusregler. Tillverkningsorder med status Pending Approval eller stängd status bör inte få nya datum. Filtrera bort dem vid inläsning.
Vem konfigurerar och ger support för integrationen med Oracle Fusion Cloud?
- SkyPlanner-teamet konfigurerar integrationen under introduktionen och ger support efter driftstart, för de REST-resurser och organisationer som ni har kommit överens om. Varje fabrik använder Oracle Fusion Cloud på sitt sätt, och den kunskapen kommer till användning här.
- Er Oracle-partner kan delta. Partnern känner till era organisationer, roller och anpassningar och kan konfigurera integrationsanvändaren, rollerna och eventuella flöden i Oracle Integration tillsammans med SkyPlanner-teamet.
- Era 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. Ni får en offert på integrationen i förväg, utifrån era processer och behov, tillsammans med ert abonnemang. Se priser, finplanering för Oracle Fusion Cloud, sidan om Oracle Fusion Cloud och översikten över ERP-integrationer. Använder ni NetSuite? Se integrationsguiden för NetSuite.
Tillverkares omdömen 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 körplan 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.
99,2%leveransprecision
”SkyPlanner har gjort det lättare att upptäcka flaskhalsar och gett oss en tydligare produktionsstyrning.”
Toni Tuori, produktionschef
Piristeel · Taksäkerhet och takavvattningssystem
Leveransprecisionen nådde 99,2% i år, och planeringen sparar upp till fyra timmars arbetstid per dag.
1 000-talstillverkningsorder planeras automatiskt
”Vi har kontroll över produktionen på ett annat sätt, och vår förståelse för kapaciteten ligger på en helt annan nivå.”
Hannu Ryynänen, vd
Mamec · Industriblandare, pumpar och högteknologisk kontraktstillverkning
Tusentals tillverkningsorder planeras automatiskt, och hela organisationen får en realtidsbild av produktionen.
Vanliga frågor
Har Oracle Fusion Cloud ett API för tillverkningsorder?
Ja. REST API för Oracle Fusion Cloud SCM har workOrders med underresurser för operationer, resurser och material samt processWorkOrders för processtillverkning. Det stöder GET, POST och PATCH.
Hur skrivs planerade datum tillbaka till Oracle Fusion Cloud?
Med ett PATCH-anrop till tillverkningsorderns underresurs WorkOrderOperation, där PlannedStartDate och PlannedCompletionDate anges. Operationernas datum måste ligga inom tillverkningsorderns datum, så orderhuvudet uppdateras först med PATCH vid behov.
Hur når operatörernas återrapportering Oracle?
Färdiga kvantiteter skickas till operationTransactions och arbets- och maskintid till resourceTransactions. Båda är REST-resurser som stöder POST i Fusion Manufacturing.
Har Oracle Fusion Cloud stöd för webhooks?
Fusion publicerar affärshändelser som Work Order Status Change, som Oracle Integration kan prenumerera på. Utan Oracle Integration hämtar integrationen data från REST API med ett intervall som ställs in per fabrik. SkyPlanners egna webhooks skickar ut ändringar i produktionsplanen så snart de sker.
Bör en Oracle-partner föreslå Oracle Production Scheduling eller SkyPlanner?
SkyPlanner, när kunden vill ha en gemensam produktionsplan för flera fabriker som tar hänsyn till tillgänglig kapacitet och håller sig uppdaterad automatiskt. Production Scheduling aktiveras inom Supply Chain Planning, beräknar planer per planeringsorganisation och tillämpar omställningsregler endast på utrustning med en enda enhet (Oracles dokumentation). SkyPlanner ansluter via SCM REST API, planerar om automatiskt och planerar omställningar, verktyg, arbetslag och material. Antalet användare är obegränsat och priset börjar på 199 € per månad.
Kan vi testa SkyPlanner innan vi bygger integrationen?
Ja. Under den kostnadsfria provperioden på 30 dagar kan ni använda upp till 20 produktionsgrupper och importera data från Oracle via CSV eller Excel. Inget kreditkort behövs. Starta provperioden eller prata med oss på försäljning för att kartlägga integrationen.