Epicor Kinetic 연동 가이드 SkyPlanner APS를 활용한 생산 스케줄링

Epicor는 다음과 같이 설명합니다. “All Kinetic services, including business objects, processes, reports, BAQs, and Epicor Functions, are accessible through REST endpoints.”(비즈니스 객체, 프로세스, 보고서, BAQs, Epicor Functions를 비롯한 모든 Kinetic 서비스에 REST 엔드포인트로 접근할 수 있습니다.) 스케줄링 연동은 Epicor의 네 가지 기술을 기반으로 구현합니다.

1. Kinetic REST API v2 (OData v4). 비즈니스 객체는 Erp.BO.<Name>Svc라는 이름의 서비스로 제공됩니다. 일반적인 경로는 /api/v2/odata/{Company}/Erp.BO.{Svc}/{EntitySet}입니다. REST v1도 여전히 존재하지만 레거시 버전이므로 v2를 기반으로 구축하세요. 사용 중인 릴리스의 엔터티 집합과 메서드는 /api/help/v2/의 REST Help에서 확인하세요.
2. REST를 통한 Business Activity Queries (BAQ) 조회. BAQ는 /api/v2/odata/{Company}/BaqSvc/{BAQ}/Data에서 제공됩니다. JobHead, JobOper, JobMtl, PartWhse, PORel을 조인하여 계획에 필요한 데이터를 한 번의 호출로 추출할 때 실용적인 조회 경로입니다(커뮤니티 예제).
3. Epicor Functions (EFx). /api/v2/efx/{Company}/{Library}/{Function}에서 호출할 수 있는 서버 측 함수입니다. Epicor의 설명에 따르면 이 함수는 “can be triggered from multiple entry points, including BPMs, REST services, schedules, and application events.”(BPM, REST 서비스, 스케줄, 애플리케이션 이벤트를 비롯한 여러 진입점에서 실행할 수 있습니다.)
4. BPM 지시문. 작업이나 공정이 변경되면 Method Directives와 Data Directives가 실행되며, 외부로 데이터를 전송하는 함수를 호출할 수 있습니다.

파일 연동에서는 DMT로 데이터를 가져오고 BAQ 내보내기로 데이터를 추출합니다. Epicor는 Epicor Automation Studio도 제공하며, 이를 “a low-code app for integration-led automations”(연동 기반 자동화를 위한 로우코드 앱)이라고 설명합니다. 데이터베이스에 직접 접근하지 마세요. REST, BAQs, 함수는 온프레미스와 Kinetic Cloud에서 동일하게 작동합니다.

Epicor 문서에는 범용 아웃바운드 웹훅 API가 명시되어 있지 않습니다. 따라서 Kinetic의 변경 사항은 다음 두 가지 방법 중 하나로 SkyPlanner에 전달합니다.

• 이벤트 기반. JobHead 또는 JobOper에 설정한 BPM Data Directive가 Epicor Function을 호출하면, 이 함수가 변경된 작업을 SkyPlanner REST API로 전송합니다.
• 주기적 폴링. 변경 일자를 기준으로 필터링하는 BAQ를 몇 분 간격 또는 매시간 실행합니다. 운영 관리와 장애 복구가 더 간단한 방식입니다.

반대 방향에서는 SkyPlanner가 웹훅을 통해 상태와 일정 변경 사항을 전송합니다. 미들웨어 또는 EFx 엔드포인트가 이를 받아 Kinetic에 기록합니다.

1. 기준정보 최초 적재. 품목, 자원 그룹, 자원, 작업 수행 능력, 캘린더, 직원 정보를 조회합니다. Kinetic의 자원으로 SkyPlanner 작업장을, 자원 그룹으로 작업장 그룹을 구성하세요. 대량 조회 시에는 $top과 $skip으로 페이지를 나누거나 BAQ를 통해 데이터를 일괄 추출하세요.

2. 오더 동기화. 릴리스되고 확정된 작업을 해당 공정 및 자재와 함께 전송하세요. 엔터티별로 따로 조회하지 말고 GetDatasetForTree 또는 BAQ로 작업 트리를 가져오세요. 미확정 MRP 작업은 확정될 때까지 Kinetic에 남겨 두세요. 재고를 조회할 때 미결 구매 오더의 납품 일정과 납기일도 함께 동기화하세요. SkyPlanner는 발주한 자재를 납품일부터 사용 가능한 것으로 처리하고 구매 오더가 Delivered로 표시되면 재고를 갱신합니다. 따라서 스케줄링 시 현재 재고와 입고 예정 구매 자재를 모두 확인합니다.

3. 일정 재반영. SkyPlanner의 웹훅은 공정별 계획 시작·종료 일시와 작업장을 EFx 엔드포인트(/api/v2/efx/{Company}/{Library}/{Function})로 전송합니다. 이 함수는 Kinetic의 스케줄 엔진을 통해 일정을 기록합니다. 이 엔진은 Job Entry의 스케줄링과 스케줄링 보드에서도 사용하는 동일한 비즈니스 객체입니다(커뮤니티 예제).

1. ScheduleEngine.GetNewParamsForJob은 해당 작업의 스케줄 엔진 데이터셋을 생성합니다.
2. 함수는 작업 번호, 조립 순번, 공정 순번, 계획 시작 일시를 설정한 다음 ScheduleEngine.MoveJobItem을 호출합니다.
3. SkyPlanner가 공정을 그룹 내 다른 자원에 배정했다면 ScheduleEngine.ChangeResource가 해당 자원으로 옮깁니다. MoveJobItem만 호출하면 그룹의 기본 자원이 유지됩니다.
4. 함수는 작업의 일정 잠금(JobHead.SchedLocked, Job Entry의 Lock 옵션)을 설정하여 Global Scheduling이 SkyPlanner에서 정한 일정을 유지하도록 합니다.

이 호출들을 하나의 Epicor Function으로 묶으면 작업별 쓰기 처리를 원자적으로 수행하고 자체 검증도 추가할 수 있습니다. 사용자 정의 함수를 사용하지 않으려는 사업장에서는 Erp.BO.ScheduleEngineSvc에 직접 REST 호출을 보내 같은 순서로 실행할 수 있습니다. ResourceTimeUsed나 JobOper의 날짜 필드에는 절대 직접 값을 쓰지 마세요. 엔진을 우회하게 되어 보드의 배정 정보와 일정이 어긋납니다.

4. 현장 실적 등록. 작업자는 SkyPlanner의 Mobile Confirmations, Production Timer 또는 Quick Log Mode로 작업을 기록합니다. 종료된 각 작업 시간 기록은 Erp.BO.LaborSvc를 통해 Kinetic의 노무 실적으로 반영됩니다. 실시간 작업에는 StartActivity와 EndActivityByEmp를, 사후 입력에는 Labors와 Update를 사용합니다. 사업장에서 승인이 필요하다면 처리 흐름과 접근 범위에 submitForApproval을 포함하세요.

5. 데이터 관리 주체와 충돌 처리 규칙. 운영을 시작하기 전에 다음 내용을 문서화하세요.

SkyPlanner가 일정을 수립한 작업에는 일정 잠금이 적용되므로 Global Scheduling이 해당 일정을 변경하지 않습니다. SkyPlanner가 계획하지 않는 자원에는 Kinetic 스케줄링을 계속 사용하세요.

구축은 일반적으로 온보딩 시작 후 수주 내에 완료됩니다. Kinetic 연동 프로젝트에는 다음 작업이 포함됩니다.

1. 개발에 착수하기 전, 작업·공정·자원을 내보낸 CSV 또는 Excel 파일로 30일 체험 진행.
2. API 키, 접근 범위, 연동 전용 사용자 계정, 연동에서 조회할 BAQs 설정.
3. 기준정보 매핑: 작업 수행 능력, 자원 그룹, 자원, 캘린더, 직원을 SkyPlanner의 워크스테이션, 그룹, 교대조, 인력에 매핑.
4. 품목, 제조 방법(BOM과 공정), 자원의 초기 데이터 적재.
5. 작업 및 구매 오더 동기화(PORel 납기일), PartWhse 재고 동기화.
6. Epicor Function 내에서 ScheduleEngineSvc (MoveJobItem, ChangeResource)를 통해 공정의 계획 일정을 재반영하고 작업 잠금 설정.
7. LaborSvc를 통해 현장 실적을 노무 실적으로 등록.
8. 기존 Kinetic 일정과 병행 테스트한 뒤 운영 시작.

공장마다 Kinetic을 운영하는 방식은 다릅니다. 작업 수행 능력에 따른 공정 순서, 자원 그룹 캘린더, BAQ 설계, BPM 지시문, 버전별 데이터 반환 메서드가 모두 현장마다 다릅니다. 이를 정확히 설정해야 계획 담당자가 믿고 쓸 수 있는 일정이 됩니다. 그렇지 않으면 일정을 다시 손봐야 합니다.

1. SkyPlanner 팀이 온보딩 중에 설정하고 운영 시작 후에도 지원합니다. 팀은 자원, 작업, 구매 발주별 납품 일정을 매핑하고 BAQ 조회, BPM 트리거, 데이터 반환 함수를 설정합니다. SkyPlanner의 REST API와 웹훅을 Kinetic REST v2에 연결합니다. BAQs, BPMs 또는 Kinetic 버전이 바뀌어도 지원은 계속됩니다.
2. Epicor 파트너. BAQs, BPMs, Epicor Functions를 이미 개발하고 있는 파트너라면 문서화된 동일한 SkyPlanner REST API를 활용할 수 있습니다. 이 API로 주문, 제품, 자재, 공정 단계, 시간 기록을 읽고 쓸 수 있습니다.
3. 사내 개발팀. Kinetic REST 경험이 있는 사내 팀은 직접 개발할 수 있으며, Automation Studio를 사용 중이라면 해당 환경에서도 개발할 수 있습니다. SkyPlanner API 키만 있으면 시작할 수 있고(연동 튜토리얼), 필요하면 SkyPlanner 팀이 지원합니다. 제품 문서는 SkyPlanner 문서에서 누구나 확인할 수 있습니다.

동일한 API·웹훅 연동 방식은 UTU 등 다른 ERP를 사용하는 기업의 실제 운영 환경에서도 쓰이고 있습니다. Laboratory & Allied에서는 사내 IT 팀이 SkyPlanner의 도움을 받아 SAP Business One 연동의 대부분을 자체 구축했습니다.

어느 방식을 선택하든 출발점은 같습니다. 먼저 CSV 데이터를 가져와 30일 무료 체험으로 일정을 검증한 뒤 연동을 구축하세요. 워크스테이션 5개를 포함한 요금은 월 199 €부터이며, 매월 결제하고 언제든 해지할 수 있습니다. 연동 비용은 고객의 공정과 요구사항에 맞춰 요금제와 함께 사전에 견적을 드리므로, 시작 전에 전체 비용을 확인할 수 있습니다.