JobBOSS² 연동 가이드 SkyPlanner APS로 생산 스케줄링하기
이 JobBOSS² 연동 가이드는 파트너와 IT 팀을 대상으로 ECI의 JobBOSS²를 SkyPlanner APS에 연결하는 방법을 설명합니다. SkyPlanner는 ECI에서 제공하는 API를 사용해 JobBOSS²와 양방향으로 연동합니다.
- Orders와 Order Line Items, Order Routings, Estimates, Routings와 자재, Work Centers, Employees, Company Calendar, Job Requirements, 구매 주문 품목을 가져옵니다.
- 계획 시작일과 종료일을 각 Order Routing 단계에 다시 반영합니다.
- 선택에 따라 작업자의 작업 시간 기록을 Time Ticket Details로 다시 전송할 수 있습니다.
- SkyPlanner 웹훅은 일정이 변경되는 즉시 변경 사항을 전송합니다.
SkyPlanner 팀은 온보딩 과정에서 고객의 JobBOSS² 환경에 맞게 연동을 구성하고, 가동 후에도 지원합니다. 이 가이드는 연동에 참여하거나 SkyPlanner의 문서화된 REST API(API 참조 문서)를 활용해 직접 개발하려는 파트너와 개발자를 위한 문서입니다. 미국의 한 주문형 생산업체는 이미 이 방식으로 연동을 구현했습니다.
JobBOSS² 연동 인터페이스
ECI는 ECI 제조 API 문서 사이트에 제조 API와 OpenAPI 명세를 공개하고 있습니다. 스케줄링에 필요한 API는 두 가지입니다.
- JobBOSS² API (v1). REST와 JSON을 사용하는 JobBOSS² 전용 API입니다. 주문, Order Line Items, Order Routings, Estimates, Routings, 자재, Job Requirements, Work Centers, Company Calendar, Employees, 구매 주문, Time Tickets, Time Ticket Details를 읽고 씁니다. ECI는 “is currently only supported for JobBOSS² hosted (Cloud) customers.”(현재 JobBOSS² 호스팅(클라우드) 고객만 지원)라고 명시합니다.
- ECI ERP API (v2.1). Deacom, M1, JobBOSS²에 공통으로 사용할 수 있는 REST API입니다. JobBOSS²에서는 작업, 작업 공정, 작업 자재, 부품, 부품 공정, 작업 센터, 구매 주문 품목, 작업 시간 기록 항목을 처리합니다. ECI는 “the actual ERP database could be a cloud hosted ERP or on premises install,”(실제 ERP 데이터베이스는 클라우드 호스팅 또는 온프레미스 설치 환경일 수 있음)이라고 설명합니다. 따라서 온프레미스 JobBOSS²는 이 API로 연동합니다.
두 API는 같은 규칙을 따릅니다. lastModDate[gte]= 같은 필터 표현식, fields= 매개변수, sort=를 사용하며, take와 skip으로 페이지를 나눕니다. take의 기본값은 200입니다. “All dates submitted to the API are assumed to be in UTC.”(API에 제출하는 모든 날짜는 UTC로 간주됩니다.)
ECI는 두 API 모두에 다음 규칙을 적용합니다. “All APIs must be activated by ECI before use.”(모든 API는 사용 전에 ECI에서 활성화해야 합니다.) ECI 계정 담당자에게 미리 요청하세요.
인증 및 접근 권한
- API 사용자. 연동에는 ECI의 Integration Engine Management Console에서 발급한 API 사용자를 사용합니다. 호출이 어떤 제품, 고객, 데이터베이스에 접근하는지는 API 사용자에 따라 결정됩니다.
- OAuth 2.0 클라이언트 자격 증명. 클라이언트 ID와 시크릿으로 Authentication API의 토큰 엔드포인트에서 토큰을 발급받습니다. 이후 모든 호출에
Authorization: Bearer [token]을 보냅니다. - 권한 범위. API 사용자에게는 아래 매핑 표에 필요한 리소스만 허용하고, 그 외의 권한은 부여하지 마세요.
SkyPlanner의 REST API는 API 토큰(SkyPlanner Settings > API)으로 인증하며, Swagger/OpenAPI 문서를 제공합니다. 연동 튜토리얼에서 첫 API 호출 방법을 단계별로 안내합니다.
이벤트와 폴링
ECI의 두 API 문서에는 모두 웹훅이 명시되어 있지 않습니다. JobBOSS² 쪽 데이터는 폴링으로 가져옵니다. 마지막 실행 이후의 lastModDate를 기준으로 Order Line Items, Order Routings, 구매 주문 품목을 필터링하고, take와 skip으로 페이지를 나눕니다. 주기는 업체별로 설정하며, 작업은 몇 분마다, 재고는 한 시간마다 조회하는 식으로 운영합니다.
SkyPlanner는 상태나 일정이 바뀌면 웹훅을 보내므로, JobBOSS²에 다시 반영하는 처리는 이벤트 기반으로 이루어집니다.
데이터 매핑
| JobBOSS² 객체(JobBOSS² API 리소스) | SkyPlanner 객체 | 방향 | 주기 |
|---|---|---|---|
Estimates (/estimates), 자재 (/materials) | 제품, 자재, 제품 구조 | JobBOSS² → SkyPlanner | 최초 적재 후 변경 시 |
Routings (/routings): 작업 센터, 셋업 시간, 사이클 타임, 팀 인원수, 작업에 사용할 설비 | 소요 시간과 셋업 시간이 포함된 공정 단계 | JobBOSS² → SkyPlanner | 최초 적재 후 변경 시 |
Work Centers (/work-centers): 교대조별 근무 시간, 1~3교대 가동 여부, 근무일 | 작업장, 작업장 그룹, 효율 | JobBOSS² → SkyPlanner | 최초 적재 후에는 드물게 갱신 |
Company Calendar (/company-calendars), Employees (/employees) | 교대조, 비근무일, 인력 | JobBOSS² → SkyPlanner | 매일 동기화하거나 SkyPlanner에서 교대조 관리 |
Orders 및 Order Line Items (/order-line-items): 작업 번호, 납기일, 우선순위, 생산할 수량 | 납기일과 우선순위가 포함된 주문 | JobBOSS² → SkyPlanner | 몇 분 간격으로 폴링 |
Order Routings (/order-routings): 작업 단계, 상태, 남은 작업 시간 | 공정 단계별 작업 | JobBOSS² → SkyPlanner | 몇 분 간격으로 폴링 |
Job Requirements (/job-requirements), 구매 주문 품목 (/purchase-order-line-items) | 자재 소요량, 납품일별 구매 주문 | JobBOSS² → SkyPlanner | 매시간 또는 스케줄링 실행 시 폴링 |
Order Routing의 estimatedStartDate, estimatedEndDate, workCenter, employeeCode (PATCH) | 단계별 계획 시작·종료 시점, 설비 및 작업자 | SkyPlanner → JobBOSS² | 일정 변경 시 SkyPlanner 웹훅으로 전송 |
| Time Ticket Details (POST): 작업, 단계, 작업 센터, 직원, 셋업 시간, 사이클 타임, 완성 수량 및 폐기 수량, 시작 및 종료 시간 | 작업 시간 기록 및 작업자 실적 등록 | SkyPlanner → JobBOSS² | 전송을 선택한 경우 실적 등록 건별 또는 교대조별 |
| JobBOSS²에 없음 | 작업 전환 시간 매트릭스, 가용 수량이 제한된 자원으로 관리하는 공구, 대체 설비 및 인력 | SkyPlanner에서 관리 | 온보딩 중 설정 |
온프레미스 JobBOSS²에서는 ERP API 리소스인 /jobs, /job-operations, /job-materials, /parts, /part-operations, /work-centers, /purchase-order-lines를 통해 같은 객체를 읽고, 작업 시간 기록은 /timecard-lines로 전송합니다.
연동 구현 방식
1. 기준정보 최초 적재. Estimates, Routings, 자재, Work Centers, Company Calendar, Employees를 읽어옵니다. 작업 센터는 신중하게 매핑하세요. 예를 들어 선반 네 대가 있는 작업 센터를 하나의 작업장 그룹 또는 네 개의 작업장으로 구성하면 SkyPlanner가 설비별로 작업 순서를 정합니다.
2. 작업 동기화. 미완료 Order Line Items와 해당 Order Routings, Job Requirements, 미완료 구매 주문 품목을 읽어옵니다. SkyPlanner는 발주한 자재를 구매 주문의 납품일부터 사용 가능한 것으로 간주하며, 구매 주문이 Delivered로 표시되면 재고를 갱신합니다. 보류 중이거나 종료된 작업은 제외합니다.
3. 일정 재반영. 엔진이 공정 단계를 배치하거나 이동하면 SkyPlanner 웹훅이 /api/v1/orders/{orderNumber}/order-line-items/{itemNumber}/order-routings/{stepNumber}에 대한 PATCH 요청을 트리거합니다. 이 요청은 estimatedStartDate와 estimatedEndDate를 UTC로 설정합니다. SkyPlanner에서 해당 단계를 다른 설비나 작업자에게 옮겼다면 workCenter와 employeeCode도 설정합니다. 날짜는 Whiteboard, Planning Board, Scheduling Advisor에 이미 표시되는 작업 단계에 반영됩니다.
4. 현장 실적 등록. 작업자는 SkyPlanner Mobile Confirmations 또는 Production Timer로 작업을 기록하며, 이 시간 기록을 통해 일정이 최신 상태로 유지됩니다. 실제 작업 시간을 JobBOSS²에 다시 전송할지는 선택할 수 있습니다. 전송을 선택하면 등록된 실적마다 셋업 시간, 사이클 타임, 수량이 포함된 Time Ticket Detail이 생성됩니다. 전송하지 않으면 데이터 수집은 JobBOSS²에서 계속 수행하고, SkyPlanner는 Order Routings에서 진행 상황을 읽어옵니다.
5. 데이터 관리 주체와 충돌 처리 규칙. 가동 전에 다음 사항을 문서로 정리하세요.
| 데이터 | 관리 주체 |
|---|---|
| Estimates, Routings, 수량, 납기일, 작업 상태 | JobBOSS² |
| 단계 순서, 시작 및 종료 시간, 단계별 설비와 작업자 | SkyPlanner |
| 작업 전환 시간 매트릭스, 공구 및 작업자 요건, 대체 자원 | SkyPlanner |
| 교대조 및 비근무일 | 범위 산정 시 선택한 단일 시스템 |
| Time Tickets, 자재 출고, 입고, 원가 계산 | JobBOSS²에서 관리하며, 직접 입력하거나 SkyPlanner 작업 시간 기록을 전송 |
작업 단계의 날짜를 기록할 시스템은 하나만 정하세요. SkyPlanner로 스케줄링하는 작업은 Whiteboard 대신 SkyPlanner에서 일정을 조정합니다. 계획 담당자가 SkyPlanner에서 작업을 옮기면 해당 날짜가 JobBOSS²에 반영됩니다.
일반적인 프로젝트 진행 단계
구축은 일반적으로 온보딩 시작 후 몇 주 안에 완료됩니다. 그 전에 JobBOSS²에서 Work Centers, 공정 순서, 미완료 작업을 CSV나 Excel로 내보내고, 30일 무료 체험에서 일정을 검증하세요.
- 매핑. 매핑 표, 데이터 관리 주체 규칙, 동기화 주기, Time Tickets를 다시 전송할지 여부를 확정합니다.
- ECI 접근 권한. ECI에 JobBOSS² API 또는 ERP API 활성화와 API 사용자 생성을 요청합니다. 샌드박스 회사가 있으면 해당 환경에서 테스트합니다.
- 초기 데이터 적재. Estimates, Routings, Work Centers, 캘린더 및 직원 데이터를 가져옵니다.
- 작업 및 구매 발주 동기화.
lastModDate필터를 적용해 폴링하고, 페이지 단위 조회와 재시도를 처리합니다. - SkyPlanner 제약 조건 설정. 작업 전환 시간 매트릭스, 공구, 작업별 작업자 수, 대체 설비 또는 인력을 설정합니다.
- 일정 역전송. SkyPlanner 웹훅으로 Order Routing PATCH를 호출합니다. 선택한 경우 Time Ticket Details도 전송합니다.
- 병행 테스트. 기존 일정 보드와 SkyPlanner를 병행 운영하며 날짜를 비교하고 기준정보를 수정합니다.
- 정식 운영 전환. 데이터가 일치하면 역전송을 활성화합니다.
JobBOSS² 연동 시 고려할 사항
- 호스팅 또는 온프레미스. JobBOSS² API는 호스팅 고객용입니다. 온프레미스 환경에서는 ERP API를 사용하며, 제공되는 리소스 목록이 다릅니다. 1단계에서 연동 방식을 확정합니다.
- 모든 시간은 UTC 기준. API는 UTC로 시간을 읽고 씁니다. 공장 현지 시간으로 변환하지 않으면 7:00 시작 작업이 다른 시간에 배치됩니다.
- 작업 센터에 포함된 실제 설비. 작업 센터는 설비, 설비 그룹, 셀 또는 인력을 나타낼 수 있습니다. SkyPlanner는 각 공정 단계의 설비 수와 팀 인원수를 바탕으로 해당 단계에 필요한 자원 수를 파악합니다.
- 외주 공정. 작업 센터 대신 외주업체가 지정된 단계는 사내 생산능력을 사용하는 것이 아니라 리드타임으로 반영됩니다. 소요 시간만 있는 단계로 모델링합니다.
- 공정 중첩 및 무인 작업. 공정 단계에는 중첩 실행이나 무인 운전을 나타내는 플래그를 지정할 수 있습니다. 무인 작업이 올바르게 계획되도록 두 플래그를 모두 전달합니다.
- 시간 단위. 셋업 시간과 사이클 타임은 각각 별도의 단위를 사용합니다. 대기 시간은 설비 가동 시간이 아닙니다. 가져올 때 단위를 변환하지 않으면 모든 소요 시간이 잘못 계산됩니다.
- 페이지 단위 조회. 기본 페이지당 레코드 수는 200개입니다. 모든 조회에서 페이지를 나누어 읽어야 합니다.
JobBOSS² 연동 설정 및 지원 담당
- SkyPlanner 팀이 온보딩 중 연동을 설정하고 정식 운영 후에도 지원합니다. 지원 범위는 합의된 리소스와 폴링 규칙을 따릅니다. 업체마다 JobBOSS² 운영 방식이 다르므로, 각 업체의 운영 노하우를 이 과정에 반영합니다.
- JobBOSS² 파트너도 참여할 수 있습니다. 파트너는 고객사의 환경을 잘 알고 있으므로 SkyPlanner 팀과 함께 ECI에 API 활성화와 API 사용자 생성을 요청하고 조율할 수 있습니다.
- 사내 개발자가 추가 개발을 진행할 수도 있습니다. API 토큰으로 SkyPlanner의 REST API를 사용하면 됩니다. API 토큰만 있으면 시작할 수 있으며, 필요할 때 SkyPlanner 팀이 지원합니다. 연동 문서는 SkyPlanner 연동 문서에서 확인할 수 있습니다.
SkyPlanner는 작업장 5개를 포함해 월 199 €부터 시작하며, 매월 청구됩니다. 고객사의 공정과 요구사항에 맞춘 연동 견적은 요금제와 함께 사전에 제공합니다. 요금, 실제 설비·인력의 가용량을 반영하는 JobBOSS² 생산 스케줄링, JobBOSS² 페이지, SkyPlanner 기능, ERP 연동 안내를 확인해 보세요.
SkyPlanner를 사용하는 제조업체
2시간매주 절약
“SkyPlanner 덕분에 Excel 스프레드시트로 생산 계획을 세우던 방식에서 실시간으로 생산을 최적화하는 방식으로 전환했습니다.”
Kalle Kalliomäki, 공급망 전문가
UTU · 배전반 및 개폐장치
생산 계획 업무에서 매주 2시간을 절약하며, 새로운 작업 대기열은 수초 만에 생산 라인에 전달됩니다.
+90%생산 효율 향상
“생산 효율이 90% 향상되었습니다.”
Abdul Rucyinga, IT 책임자
Laboratory & Allied · 의약품 제조
생산 효율이 90% 향상되었으며, 모든 작업장에 걸쳐 석 달간의 최적화된 계획을 수립하는 데 30분도 걸리지 않습니다.
1,000건 단위작업 지시 일정 자동 배정
“생산을 관리하는 방식이 달라졌고, 생산능력에 대한 이해도 완전히 다른 수준으로 높아졌습니다.”
Hannu Ryynänen, 대표
Mamec · 산업용 믹서, 펌프 및 첨단 위탁 제조
수천 건의 작업 지시 일정이 자동으로 배정되며, 조직 전체가 생산 현황을 실시간으로 파악합니다.
98%납기 준수율, 약 50%에서 상승
“SkyPlanner는 납기 준수율을 유지하는 데 결정적인 역할을 합니다.”
Hannu Lahtinen, 대표이사
KJH-Comp · 판금 가공 및 위탁 제조
납기 준수율이 약 50%에서 최대 98%로 높아졌으며, 이전에는 관리자 두 명이 담당하던 스케줄링을 이제 한 명이 처리합니다.
자주 묻는 질문
JobBOSS²에 API가 있나요?
네. ECI는 JobBOSS² API와 특정 제품에 종속되지 않는 ERP API를 제공합니다. 둘 다 OpenAPI 명세를 갖춘 REST 방식입니다. JobBOSS² API는 호스팅 고객을 대상으로 주문, Order Routings, Estimates, Work Centers, 구매 발주 및 Time Tickets를 읽고 씁니다.
JobBOSS² 연동은 어떻게 인증하나요?
OAuth 2.0 클라이언트 자격 증명으로 인증합니다. ECI가 API를 활성화하면 Integration Engine Management Console에서 API 사용자를 발급하며, 각 호출에 Bearer 토큰을 포함합니다.
JobBOSS²는 웹훅을 지원하나요?
ECI API 문서에는 웹훅이 명시되어 있지 않습니다. 따라서 연동 시 업체별로 정한 주기에 따라 lastModDate 필터로 JobBOSS²를 폴링합니다. SkyPlanner 자체 웹훅은 일정이 변경되는 즉시 변경 내용을 전송합니다.
계획된 날짜는 JobBOSS²에 어떻게 다시 기록되나요?
작업 단계별로 기록됩니다. SkyPlanner는 각 Order Routing에 PATCH를 호출해 estimatedStartDate와 estimatedEndDate를 업데이트합니다. 해당 단계가 다른 설비나 작업자로 옮겨졌다면 workCenter와 employeeCode도 함께 업데이트합니다.
JobBOSS² 파트너는 ECI APS와 SkyPlanner 중 무엇을 제안해야 하나요?
고객이 여러 자원의 실제 생산능력을 반영하는 생산 스케줄링을 수주 내에 가동하려 한다면 SkyPlanner를 제안하세요. ECI APS는 LYNQ 기반의 별도 추가 기능입니다. SkyPlanner는 ECI 자체 JobBOSS² API로 연결되며, 작업 전환, 작업조, 지그 및 자재를 계획하고 자동으로 일정을 다시 수립합니다. 요금은 월 199 €부터 시작합니다.
