연동 / ERP / Oracle Fusion Cloud
Oracle Fusion Cloud 연동 가이드 SkyPlanner APS로 생산 스케줄링하기
이 Oracle Fusion Cloud 연동 가이드는 파트너와 IT 팀을 대상으로 Oracle Fusion Cloud Manufacturing을 SkyPlanner APS에 연결하는 방법을 설명합니다. SkyPlanner는 Oracle에서 제공하는 REST 리소스를 통해 Oracle Fusion Cloud와 양방향으로 연동합니다.
- 작업지시와 해당 공정, 작업 정의, 작업 센터, 생산 자원, 캘린더, 품목, 품목 구조, 현재고 수량, 구매 주문을 가져옵니다.
- 계획 시작일과 완료일을 각 작업지시 공정에 다시 전송합니다.
- 작업자가 확정한 실적은 공정 트랜잭션과 자원 트랜잭션으로 다시 등록합니다.
- SkyPlanner 웹훅은 일정이 변경되는 즉시 변경 사항을 전송합니다.
SkyPlanner 팀은 온보딩 과정에서 고객의 Oracle Fusion Cloud 환경에 맞춰 연동을 구성하고, 가동 후에도 지원합니다. 이 가이드는 연동 작업에 참여하거나 SkyPlanner의 문서화된 REST API(API 참조 문서)를 활용해 직접 개발하려는 파트너와 개발자를 위한 문서입니다.
Oracle Fusion Cloud의 연동 인터페이스
Oracle Fusion Cloud는 외부 스케줄러에 세 가지 데이터 연동 경로를 제공합니다.
- Oracle Fusion Cloud SCM용 REST API. 기본 경로는
/fscmRestApi/resources/11.13.18.05/입니다. 스케줄러가 사용하는 리소스는workOrders(하위 리소스:WorkOrderOperation,WorkOrderOperationResource,WorkOrderOperationMaterial),processWorkOrders,workDefinitions,workCenters,productionResources,calendars,itemsV2,itemStructures,inventoryOnhandBalances입니다. 진행 실적은operationTransactions,resourceTransactions,materialTransactions에 등록합니다. 구매 주문은 Procurement REST API의purchaseOrders에서 가져옵니다. (REST 엔드포인트) - File-Based Data Import (FBDI). Import Work Orders 프로세스는 템플릿을 기반으로 작업지시와 해당 공정 및 공정 자원을 생성하거나 갱신합니다. Import Work Order Resource Transactions는 자원 실적을 불러옵니다. Oracle은 처리 시점에 대해 명확히 안내합니다. “This option isn’t suitable for importing manufacturing data on a real-time basis.”(이 옵션은 제조 데이터를 실시간으로 가져오는 데 적합하지 않습니다.) (출처)
- Oracle Integration (OIC). Oracle의 연동 플랫폼은 Fusion과 다른 시스템 사이의 데이터 흐름을 처리합니다. Oracle Integration 레시피는 Oracle Fusion Cloud Manufacturing의 Work Order Status Change 이벤트를 수신합니다(출처). 회사에서 이미 OIC를 운영하고 있다면 이 방식을 사용하세요.
실시간 스케줄링에는 REST를 주로 사용합니다. FBDI는 기준정보를 처음 적재할 때 적합합니다.
인증 및 접근 권한
- 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는 Multi Token Over SSL RESTful Service Policy라는 전역 Oracle Web Services Manager (OWSM) 보안 정책을 사용합니다.) SSL을 통한 Basic 인증과 SAML 2.0 bearer token 등의 토큰 기반 인증을 지원합니다. (빠른 시작)
- 연동 전용 사용자. Oracle에 연동 전용 사용자를 생성하세요. 필요한 작업지시, 작업 정의, 재고 및 트랜잭션 권한을 직무 역할로 부여하되, 접근 범위는 연동 대상 제조 조직으로 제한하세요.
- 페이지 처리. Oracle은 SCM REST 호출 한 번에 반환하는 레코드 수를 제한합니다. 따라서
limit과offset을 사용해 조회하고 조직과 상태로 필터링하세요(출처).
SkyPlanner의 REST API는 Authorization-Token 헤더에 API 토큰을 넣어 인증합니다(SkyPlanner Settings > API). API 문서는 Swagger/OpenAPI로 제공됩니다. 연동 튜토리얼에서 첫 API 호출 과정을 단계별로 안내합니다.
이벤트와 폴링
Oracle 측 데이터는 폴링으로 조회합니다. 필터를 적용한 REST 쿼리로 신규·변경 작업지시, 릴리스 상태 변경, 현재고 및 구매 주문을 가져옵니다. 조회 주기는 공장별로 설정하며, 작업지시는 수 분 간격, 재고는 시간 단위로 조회합니다. Oracle Integration을 운영하는 경우 Work Order Status Change 이벤트로 즉시 조회를 실행할 수 있습니다.
SkyPlanner는 상태나 일정이 바뀌면 웹훅을 보내므로, 데이터를 다시 반영하는 처리는 이벤트 기반으로 이루어집니다.
데이터 매핑
| Oracle Fusion Cloud 객체(REST 리소스) | SkyPlanner 객체 | 방향 | 주기 |
|---|---|---|---|
품목(itemsV2), 측정 단위 | 제품 및 자재 | Oracle → SkyPlanner | 초기 적재 후 폴링 |
품목 구조(itemStructures) | 제품 구조, 하위 제품, 제품별 자재 | Oracle → SkyPlanner | 최초 적재 후 변경 시 |
작업 정의(workDefinitions): 공정, 공정 자원, 사용량, Basis Type | 소요 시간, 준비 시간 및 정리 시간을 포함한 공정 단계 | Oracle → SkyPlanner | 초기 적재 후 변경 시 |
작업 센터(workCenters), 설비 및 인력에 해당하는 생산 자원(productionResources) | 작업장, 작업장 그룹, 인력, 효율 | Oracle → SkyPlanner | 초기 적재 후 드물게 갱신 |
캘린더 및 교대근무(calendars, 교대근무 예외) | 교대근무 및 비근무일 | Oracle → SkyPlanner | 매일, 또는 SkyPlanner에서 교대근무를 직접 관리 |
| 제조 조직 | 공장별 작업장 그룹 | Oracle → SkyPlanner | 초기 적재 |
WorkOrderOperation 및 WorkOrderOperationMaterial을 포함한 작업지시(workOrders, processWorkOrders) | 납기와 자재 소요량을 포함한 주문 및 작업 | Oracle → SkyPlanner | 수 분 간격으로 폴링 |
현재고 수량(inventoryOnhandBalances) | 재고 수량 | Oracle → SkyPlanner | 매시간 또는 스케줄링 실행 시 폴링 |
약정 납품일을 포함한 구매 주문(purchaseOrders) | 구매 주문, 납품일별 입고 예정 자재 | Oracle → SkyPlanner | 매시간 또는 스케줄링 실행 시 폴링 |
WorkOrderOperation PlannedStartDate, PlannedCompletionDate (PATCH) | 작업별 계획 시작 및 종료 시점 | SkyPlanner → Oracle | 일정 변경 시 SkyPlanner 웹훅으로 전송 |
WorkOrderOperationResource 날짜(PATCH) | 작업별 자원 할당 | SkyPlanner → Oracle | 선택한 경우 일정 변경 시 |
operationTransactions (POST) | 공정별 완료 수량 | SkyPlanner → Oracle | 실적 확정 시마다 |
resourceTransactions (POST) | 시간 기록: 인력 작업 시간 및 설비 가동 시간 | SkyPlanner → Oracle | 선택한 경우 실적 확정 시마다 또는 교대근무별 |
| Oracle Fusion Cloud에 없음 | 준비 시간 매트릭스, 가용 수량을 제약으로 반영하는 공구 자원, 대체 설비 및 인력 | SkyPlanner에서 관리 | 온보딩 중 설정 |
연동 방식
1. 기준정보 초기 적재. REST로 품목, 품목 구조, 작업 정의, 작업 센터, 생산 자원 및 캘린더를 조회하거나 FBDI 추출 파일에서 한 차례 적재합니다. 작업 센터의 매핑 방식은 신중하게 정하세요. 동일한 자원에 속하는 설비 네 대가 있는 작업 센터는 작업장 그룹 하나 또는 작업장 네 개로 구성할 수 있습니다. 제조 조직마다 작업장 그룹을 구성하므로 모든 공장을 하나의 계획에서 관리할 수 있습니다.
2. 작업지시 동기화. 릴리스된 작업지시와 미릴리스 작업지시를 해당 공정 및 자재와 함께 조회하고, 미결 구매 주문도 가져옵니다. SkyPlanner는 주문한 자재를 구매 주문의 납품일에 사용 가능한 것으로 처리하며, 구매 주문이 Delivered로 표시되면 재고를 갱신합니다.
스케줄링 대상은 Supply Planning의 계획 오더가 아니라 작업지시입니다. 계획 오더는 먼저 Oracle에서 작업지시로 전환해야 합니다.
3. 일정 재전송. 엔진이 작업을 배치하거나 이동하면 SkyPlanner 웹훅이 workOrders/{WorkOrderId}/child/WorkOrderOperation/{WorkOrderOperationId}에 PlannedStartDate와 PlannedCompletionDate를 포함한 PATCH 요청을 실행합니다. 이때 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.”(계획 시작일은 작업지시 시작일보다 빠르거나 작업지시 종료일보다 늦을 수 없습니다.) (출처) 따라서 새 일정이 기존 날짜 범위를 벗어나면 연동 과정에서 작업지시 헤더의 날짜를 먼저 PATCH로 갱신한 뒤 공정을 갱신합니다.
4. 생산 현장 실적 확정. 작업자는 SkyPlanner Mobile Confirmations 또는 Production Timer로 작업을 기록하며, 이 시간 기록을 통해 일정이 최신 상태로 유지됩니다. 완료 수량은 operationTransactions에, 인력 작업 시간과 설비 가동 시간은 resourceTransactions에 등록합니다. 공장에서 이미 Oracle에 실적을 보고하고 있다면 SkyPlanner는 해당 진행 실적을 읽어옵니다.
5. 데이터 관리 주체와 충돌 처리 규칙. 가동 전에 다음 사항을 문서로 정리하세요.
| 데이터 | 관리 주체 |
|---|---|
| 품목, 품목 구조, 작업 정의, 수량, 작업지시 상태 | Oracle Fusion Cloud |
| 공정 순서, 시작 및 완료 시점, 자원 할당 | SkyPlanner |
| 준비 시간 매트릭스, 공구 및 작업자 요건, 대체 자원 | SkyPlanner |
| 교대조 및 비근무일 | 범위 산정 시 선택한 단일 시스템 |
| 자원, 공정 및 자재 트랜잭션 | Oracle에서 관리하며, 직접 입력하거나 SkyPlanner 시간 기록에서 전송 |
공정 일자를 기록하는 시스템은 하나로 정하세요. SkyPlanner는 Oracle의 스케줄링 작업 영역이 필요하지 않으므로, Production Scheduling을 대신해 계획 일자를 기록합니다. Production Scheduling에서 계속 일정을 릴리스한다면 해당 조직과 SkyPlanner가 스케줄링하는 조직을 분리하세요.
일반적인 프로젝트 진행 단계
대기업도 일반적으로 온보딩 시작 후 수주 안에 구축을 완료합니다. 그 전에 Oracle에서 작업 센터, 작업 정의, 미결 작업지시를 CSV나 Excel로 내보내 30일 무료 체험에서 일정을 검증하세요.
- 매핑. 매핑 테이블, 데이터 관리 주체별 규칙, 대상 조직, 동기화 주기, 트랜잭션을 Oracle로 전송할지 여부를 확정하세요.
- Oracle 접근 권한. 연동용 사용자와 역할을 생성하세요. 먼저 Oracle 비운영 환경에서 테스트하세요.
- 초기 데이터 적재. 품목, 품목 구조, 작업 정의, 작업 센터, 생산 자원, 캘린더를 적재합니다.
- 작업지시 및 구매발주 동기화. 필터, 페이징, 재시도를 적용해 폴링합니다.
- SkyPlanner 제약 조건 설정. 준비 시간 매트릭스, 공구, 작업별 작업자 수, 대체 설비 또는 인력을 설정합니다.
- Oracle에 일정 반영. SkyPlanner 웹훅을 통해 PATCH 요청을 보내고, 선택한 경우 트랜잭션도 전송합니다.
- 병행 테스트. 기존 계획과 SkyPlanner를 병행 운영하면서 일자를 비교하고 기준정보를 수정하세요.
- 운영 전환. 데이터가 일치하면 공장별로 Oracle에 데이터를 다시 반영하는 기능을 활성화하세요.
Oracle Fusion Cloud 연동 시 고려할 사항
- 기본 스케줄러 동작. Oracle의 제약 조건을 고려하지 않는 엔진은 생성 시와 “certain update actions”(특정 업데이트 작업 시)에 실행됩니다. 사용 환경에서 어떤 업데이트가 일자를 다시 계산하는지 테스트하고, 공정 일자는 SkyPlanner가 마지막으로 기록하도록 유지하세요.
- 작업지시 기간. 공정 일자는 작업지시의 시작일과 완료일 범위 안에 있어야 합니다. 헤더를 먼저 PATCH로 업데이트하세요.
- Basis Type. Basis Type이 Variable일 때만 자원 사용량이 단위당 기준으로 적용됩니다. Fixed는 공정당 고정 시간을 뜻합니다. 가져올 때 변환하지 않으면 모든 소요 시간이 잘못됩니다.
- 개별 제조와 프로세스 제조. 개별 제조 공장은
workOrders를, 프로세스 제조 공장은processWorkOrders를 사용합니다. 두 방식을 모두 운영한다면 둘 다 매핑하세요. - 페이징. Oracle은 REST 호출당 레코드 수를 제한합니다. 모든 조회에 페이징을 적용하고 조직과 상태로 필터링하세요.
- 분기별 업데이트. Oracle은 분기마다 Fusion을 업데이트합니다. 경로에 REST 버전을 고정하고 업데이트할 때마다 다시 테스트하세요.
- 상태별 규칙. Pending Approval 또는 마감 상태의 작업지시에는 새 일자를 반영하지 않아야 합니다. 조회할 때 제외하세요.
Oracle Fusion Cloud 연동 구성 및 지원 담당
- SkyPlanner 팀이 온보딩 중에 연동을 구성하고 운영 전환 후에도 지원합니다. 지원 범위는 합의된 REST 리소스와 조직입니다. 공장마다 Oracle Fusion Cloud 운영 방식이 다르며, 이러한 차이를 다루는 데 팀의 노하우가 활용됩니다.
- 기존 Oracle 파트너도 참여할 수 있습니다. 파트너는 귀사의 조직, 역할, 확장 기능을 이해하고 있으므로 SkyPlanner 팀과 함께 연동용 사용자, 역할, 필요한 Oracle Integration 흐름을 설정할 수 있습니다.
- 사내 개발자도 연동을 확장할 수 있습니다. API 토큰으로 SkyPlanner의 REST API를 사용하면 됩니다. API 토큰만 있으면 시작할 수 있고, 필요할 때 SkyPlanner 팀이 지원합니다. 연동 관련 문서는 SkyPlanner 연동 문서에서 확인하세요.
SkyPlanner는 작업장 5개를 포함해 월 199 €부터 시작하며 매월 청구됩니다. 연동 비용은 귀사의 프로세스와 요구 사항에 맞춰 요금제와 함께 사전에 견적을 제공합니다. 요금, Oracle Fusion Cloud 생산 스케줄링, Oracle Fusion Cloud 페이지, ERP 연동 허브를 확인하세요. NetSuite를 사용하시나요? NetSuite 연동 가이드를 확인하세요.
제조업 고객의 SkyPlanner 후기
2시간매주 절약
“SkyPlanner 덕분에 Excel 스프레드시트로 생산 계획을 세우던 방식에서 벗어나 실시간으로 생산을 최적화하게 되었습니다.”
Kalle Kalliomäki, 공급망 전문가
UTU · 배전반 및 개폐장치
생산 계획 업무에서 매주 2시간을 절약하고, 새로운 작업 대기열이 수초 만에 생산 라인에 전달됩니다.
+90%생산 효율
“생산 효율이 90% 높아졌습니다.”
Abdul Rucyinga, IT 총괄
Laboratory & Allied · 의약품 제조
생산 효율이 90% 향상되었으며, 모든 작업장을 아우르는 석 달치 최적화 계획을 세우는 데 30분도 걸리지 않습니다.
99.2%납기 준수율
“SkyPlanner 덕분에 병목 구간이 눈에 보이고 생산 관리가 명확해졌습니다.”
Toni Tuori, 생산 관리자
Piristeel · 지붕 안전설비 및 빗물 배수 시스템
올해 납기 준수율이 99.2%에 도달했으며, 스케줄링 업무에서 하루 최대 네 시간을 절약합니다.
1,000s작업지시 일정 자동 편성
“생산을 관리하는 방식이 달라졌고, 생산능력을 파악하는 수준도 완전히 달라졌습니다.”
Hannu Ryynänen, 대표
Mamec · 산업용 믹서, 펌프 및 첨단 위탁 제조
수천 건의 작업지시 일정이 자동으로 편성되고, 조직 전체가 생산 현황을 실시간으로 파악합니다.
자주 묻는 질문
Oracle Fusion Cloud에 작업지시용 API가 있나요?
네. Oracle Fusion Cloud SCM의 REST API는 공정, 자원, 자재를 하위 리소스로 포함하는 workOrders와 프로세스 제조용 processWorkOrders를 제공합니다. GET, POST, PATCH를 지원합니다.
계획 일자는 Oracle Fusion Cloud에 어떻게 역반영되나요?
작업지시의 하위 리소스인 WorkOrderOperation에 PATCH 요청을 보내 PlannedStartDate와 PlannedCompletionDate를 설정합니다. 공정 일자는 작업지시 기간 안에 있어야 하므로, 필요한 경우 헤더를 먼저 PATCH로 업데이트합니다.
작업자의 실적 확정 내역은 Oracle에 어떻게 전달되나요?
완료 수량은 operationTransactions로, 작업자 투입 시간과 설비 가동 시간은 resourceTransactions로 전송합니다. 둘 다 Fusion Manufacturing에서 REST POST를 지원하는 리소스입니다.
Oracle Fusion Cloud는 웹훅을 지원하나요?
Fusion은 Work Order Status Change 같은 비즈니스 이벤트를 발행하며, Oracle Integration에서 이를 구독할 수 있습니다. Oracle Integration을 사용하지 않으면 연동 시스템이 공장별로 설정한 주기에 따라 REST API를 폴링합니다. SkyPlanner 자체 웹훅은 일정이 변경되는 즉시 변경 내용을 전송합니다.
Oracle 파트너는 Oracle Production Scheduling과 SkyPlanner 중 무엇을 제안해야 하나요?
고객이 여러 공장을 아우르면서 실제 생산능력을 반영하고 자동으로 최신 상태를 유지하는 단일 일정을 원한다면 SkyPlanner를 제안하세요. Production Scheduling은 Supply Chain Planning 오퍼링에서 활성화하며, 스케줄링 조직별로 일정을 계산하고 단일 유닛 설비에만 작업 전환 규칙을 적용합니다(Oracle 문서). SkyPlanner는 SCM REST API를 통해 연결되며, 자동으로 계획을 다시 수립하고 작업 전환, 공구, 작업조, 자재를 계획에 반영합니다. 사용자 수 제한 없이 월 199 €부터 이용할 수 있습니다.
