proALPHA 연동 가이드 SkyPlanner APS로 생산 스케줄링하기
이 Proalpha 연동 가이드는 파트너와 IT 팀을 위해 Proalpha ERP를 SkyPlanner APS에 연결하는 방법을 설명합니다. SkyPlanner는 Proalpha와 양방향으로 연동됩니다.
- 품목, 공정 정보가 포함된 작업지시, 자원, 캘린더, 재고, 구매주문을 가져옵니다.
- 공정별 계획 시작 및 종료 시점을 setWorkOrderOperationDates를 통해 Proalpha에 반영합니다.
- 자원 변경 사항을 changeWorkOrderOperationResource를 통해 Proalpha에 반영합니다.
- 작업자가 등록한 실적을 operationDataEntry를 통해 Proalpha에 반영합니다.
- SkyPlanner 웹훅은 일정이 변경될 때마다 변경 사항을 전송합니다.
SkyPlanner 팀은 온보딩 과정에서 고객의 Proalpha 환경에 맞게 연동을 구성하고, 가동 후에도 지원합니다. 이 가이드는 연동 작업에 참여하거나, 문서화된 SkyPlanner REST API(API 참조 문서)를 활용해 직접 개발하려는 파트너와 개발자를 위한 자료입니다.
Proalpha 인터페이스
Proalpha ERP는 Progress OpenEdge에서 실행되며, Release 9에서 플랫폼이 OpenEdge 12로 전환되었습니다. (Proalpha) 스케줄링에 중요한 인터페이스는 네 가지입니다.
- Proalpha ERP REST APIs. 공개된 Proalpha API Portal에는
api/web/v1하위의 OpenAPI 3.0 명세 108개가 나와 있습니다. 이 API는 결과를 Proalpha에 반영하고 품목과 재고를 조회하는 데 사용합니다. - Integration Workbench (INWB). Proalpha는 INWB를 “is a central platform which connects different IT systems, machines, sites”(서로 다른 IT 시스템, 기계, 사업장을 연결하는 중앙 플랫폼)라고 설명하며, “converts the data into the format of the target system.”(데이터를 대상 시스템의 형식으로 변환한다)이라고 명시합니다. (Proalpha) INWB는
POST /api/web/v1/inwb/message를 통해 pAX 메시지를 수신합니다. Proalpha와 작업지시를 주고받는 데 사용하세요. - Proalpha Integration Platform. 2026년 4월에 발표된 n8n 기반 플랫폼으로, “will be available to customers either on-premises or in the cloud.”(고객에게 온프레미스 또는 클라우드 방식으로 제공될 예정)입니다. Proalpha는 “will rely on an API-centric reference architecture and REST interfaces.”(API 중심의 참조 아키텍처와 REST 인터페이스를 기반으로 할 예정)라고 밝혔습니다. (Proalpha)
- EDI 및 파일 내보내기. INWB는 산업별 파일 형식을 처리하며, SkyPlanner 체험에 필요한 데이터는 파일로 내보내 사용할 수 있습니다.
생산 관련 엔드포인트
| Proalpha API | 엔드포인트 | 연동 시 용도 |
|---|---|---|
| Production Workorder Operation Dates API V1 | POST /api/web/v1/pps/prod/setWorkOrderOperationDates | 공정별 계획 시작 및 종료 시점(guid, startTimePoint, endTimePoint) |
| Production Workorder Operation Resource API V1 | POST /api/web/v1/pps/prod/changeWorkOrderOperationResource | 스케줄링에서 선택한 자원(guid, resourceGUID) |
| Production Workorder Operation API V1 | POST /api/web/v1/pps/prod/operationDataEntry/{combined, setup, process} | 실적 등록: postingQty, scrapQty, finishOperation, employeeID, resourceTime |
| Part API | GET/POST /api/web/v1/master/part | partNumber, partType, quantityUnitCode가 포함된 품목 |
| Material API V1 | GET /api/web/v1/mawi/MRPArea/{mrpAreaGuid}/part/{partGuid}/stock | MRP 영역별 재고 |
인증
공개된 Proalpha 명세는 HTTP Basic 인증을 사용합니다. 엔드포인트는 Proalpha 서버 또는 Proalpha Cloud에 있으며, 환경에 따라 {schema}://{host}:{port}/api/web/v1/... 형식으로 구성됩니다. 매핑 표에 있는 객체에만 접근 권한을 부여한 연동 전용 계정을 만드세요. IT 팀과 함께 SkyPlanner 클라우드에서 해당 엔드포인트로 접근할 수 있도록 네트워크 연결을 계획하세요.
SkyPlanner의 REST API는 API 토큰(SkyPlanner Settings > API)으로 인증하며, Swagger/OpenAPI 문서가 제공됩니다. API 토큰만 있으면 시작할 수 있습니다. 연동 튜토리얼에서 첫 API 호출 방법을 단계별로 안내합니다.
이벤트와 폴링
Proalpha API Portal에는 웹훅 구독 API가 나와 있지 않습니다. Proalpha의 변경 사항은 다음 경로로 가져옵니다.
- 신규 및 변경된 작업지시를 공정 정보와 함께 전송하는 INWB 메시지 흐름
- Proalpha Integration Platform의 n8n 워크플로
- 재고 조회를 위한 Material API의 주기적 폴링
SkyPlanner는 상태나 일정이 바뀌면 웹훅을 전송하므로, Proalpha로의 결과 반영은 이벤트 기반으로 이루어집니다.
데이터 매핑
| Proalpha 객체 또는 API | SkyPlanner 객체 | 방향 | 전송 주기 |
|---|---|---|---|
| Part (Part API) | 제품 및 자재 | Proalpha → SkyPlanner | 최초 적재 후 변경 시마다 |
| 제품 공정 모델: process, activities; 작업지시 BOM 항목 | 제품 구조, 하위 제품, 공정 단계 | Proalpha → SkyPlanner | 최초 적재 후 변경 시마다 |
| 수량과 납기가 포함된 작업지시(Fertigungsauftrag) | 납기와 우선순위가 포함된 주문 및 작업 | Proalpha → SkyPlanner | INWB 또는 n8n 푸시, 또는 몇 분 간격 |
| 작업지시 공정: targetSetupTime, targetProcessTime, resource | 셋업 시간과 소요 시간이 포함된 공정 단계 | Proalpha → SkyPlanner | 작업지시와 함께 |
| 자원, 자원 그룹, 대체 자원 그룹 | 작업장, 작업장 그룹, 대체 작업장 | Proalpha → SkyPlanner | 최초 적재 |
| intensity와 overloadIntensity가 포함된 자원 캘린더 블록 | 교대조 및 작업장 효율 | Proalpha → SkyPlanner | 최초 적재 후 매일 갱신하거나 SkyPlanner에서 관리 |
| MRP 영역별 재고 | 자재 재고 | Proalpha → SkyPlanner | 매시간 또는 스케줄링 실행 전마다 |
| 납품일이 포함된 구매주문 | 납품일에 입고되는 자재 | Proalpha → SkyPlanner | 매시간 또는 스케줄링 실행 전마다 |
| setWorkOrderOperationDates | 공정별 예정 시작 및 종료 시점 | SkyPlanner → Proalpha | 일정 변경 시 SkyPlanner 웹훅으로 전송 |
| changeWorkOrderOperationResource | 엔진이 선택한 작업장 | SkyPlanner → Proalpha | 일정 변경 시 |
| operationDataEntry (setup, process, combined) | Mobile Confirmations에서 등록한 시간 기록 및 수량 | SkyPlanner → Proalpha | 실적 등록 시마다 또는 교대조별 |
| SkyPlanner 스케줄링 규칙 | 준비·전환 시간 매트릭스, 공구 가용 수량 제약, 작업자 수 | SkyPlanner에서 관리 | 온보딩 중 설정 |
연동 패턴
1. 기준정보 최초 적재. Part API로 품목을 조회하고, INWB 또는 파일 내보내기를 통해 자원, 자원 그룹, 캘린더를 한 번 적재합니다. 각 Proalpha 자원을 어떤 SkyPlanner 작업장에 매핑할지 신중하게 정하세요. 대체 자원 그룹은 대체 작업장으로 매핑됩니다.
2. 주문 동기화. INWB 메시지 흐름 또는 n8n 워크플로가 미결 작업지시를 공정, 목표 시간, 자원 정보와 함께 전송합니다. 재고는 Material API에서 MRP 영역별로 가져오고, 미결 구매주문은 INWB를 통해 가져옵니다. SkyPlanner는 발주한 자재를 구매주문 납품일에 사용할 수 있는 것으로 처리하며, 구매주문이 Delivered로 표시되면 재고를 갱신합니다.
3. 일정 역전송. 엔진이 배치하거나 이동한 각 공정에 대해 연동 시스템이 공정 guid와 시작·종료 시점을 전달하여 setWorkOrderOperationDates를 호출합니다. 엔진이 다른 자원을 선택했다면 이어서 changeWorkOrderOperationResource를 호출합니다.
4. 현장 실적 등록. 작업자는 SkyPlanner Mobile Confirmations 또는 Production Timer로 작업을 기록합니다. 작업 시간 기록은 일정을 최신 상태로 유지하며, operationDataEntry를 통해 Proalpha에 등록됩니다. 공장에서 이미 PDC 단말기로 실적을 등록하고 있다면 중복 등록을 막기 위해 등록 경로를 하나로 유지하세요.
5. 데이터 관리 주체와 충돌 처리 규칙. 가동 전에 다음 내용을 문서로 정리하세요.
| 데이터 | 관리 주체 |
|---|---|
| 품목, 공정 모델, 수량, 작업지시 상태 | Proalpha |
| 공정 순서, 시작·종료 시각, 자원 배정 | SkyPlanner |
| 준비·전환 시간 매트릭스, 공구, 작업자 수 | SkyPlanner |
| 교대 근무 및 부재 | 범위 산정 단계에서 선정한 단일 시스템 |
| 실적 및 재고 수불 | Proalpha — SkyPlanner 작업 시간 기록 또는 PDC에서 데이터 수신 |
Proalpha APS 또는 Feinplanung을 사용 중이라면 공정 일정을 어느 시스템에서 관리할지 정하세요. 두 스케줄링 시스템이 같은 일정을 기록하면 서로 덮어쓰게 됩니다. Autopilot을 사용하면 생산 상황이 바뀔 때 SkyPlanner가 일정을 자동으로 재조정합니다.
일반적인 프로젝트 진행 단계
구축은 보통 온보딩을 시작한 후 몇 주 안에 완료됩니다. 그에 앞서 자사 데이터로 30일 무료 체험을 진행합니다. Proalpha에서 미완료 작업지시, 공정, 자원을 CSV 또는 Excel로 내보낸 뒤 SkyPlanner로 가져와 일정을 검증하세요.
- 매핑 워크숍. Proalpha 파트너와 함께 매핑 표, 데이터 관리 규칙, 동기화 주기, 실적 등록 경로를 확정합니다.
- 인터페이스 설정. REST API와 INWB 흐름을 활성화하고 연동용 사용자 계정을 생성한 뒤 네트워크 접근을 허용합니다. 테스트 시스템에 먼저 적용한 다음 운영 시스템에 적용합니다.
- 초기 데이터 적재. 품목, 자원, 자원 그룹, 캘린더를 적재합니다.
- 작업지시·재고·구매주문 동기화. 작업지시는 INWB 또는 n8n으로 푸시하고 재고는 폴링으로 가져오며, 재시도 기능을 적용합니다.
- SkyPlanner 제약 조건 설정. 준비·전환 시간 매트릭스, 공구, 작업자 수, 대체 작업장을 설정합니다.
- 일정 역전송. setWorkOrderOperationDates와 changeWorkOrderOperationResource를 사용하며, 이 단계에서 operationDataEntry도 추가합니다.
- 병행 운영. SkyPlanner의 일정을 현재 계획과 비교하고 기준정보를 수정합니다.
- 정식 가동. 데이터가 일치하면 역전송 기능을 켭니다.
Proalpha 연동 시 미리 고려할 사항
- 공정 순서 객체 없음. Proalpha는 제품 공정 모델을 기준으로 계획을 수립합니다. SAP 또는 Business Central 프로젝트에서 그대로 가져온 도구는 공정 순서 객체를 찾기 때문에 데이터를 누락합니다. 작업지시에서 공정과 BOM 항목을 읽어오세요.
- 캘린더 가동 강도. 캘린더 블록에는 intensity와 overloadIntensity가 포함됩니다. 시간 값만 그대로 복사하지 말고 SkyPlanner의 교대 근무와 효율에 매핑하세요.
- 측정 단위. quantityUnitCode를 확인하고 목표 셋업 시간이 주문당 기준인지 개당 기준인지 확인하세요. 단위가 잘못되면 모든 소요 시간이 왜곡됩니다.
- 고객 서버에서 호스팅하는 엔드포인트. REST 계층은 고객사의 Proalpha 서버에서 실행됩니다. 방화벽, 포트, 인증서 준비 여부가 프로젝트 시작일을 결정하므로 접근 허용과 인증서 설정을 미리 마치세요.
- 릴리스 버전. 매핑을 확정하기 전에 사용 중인 Proalpha 릴리스가 어떤 REST API를 제공하는지 파트너와 확인하세요.
- 로그인이 필요한 문서. Proalpha 온라인 도움말은 Documentation Portal에 로그인해야 볼 수 있습니다. 필드 이름을 추측하지 말고 파트너에게 확인하세요.
Proalpha 연동 설정 및 지원 담당
- SkyPlanner 팀이 온보딩 중에 연동을 설정하고 정식 가동 후에도 지원합니다. Proalpha는 구축 환경마다 모델링 방식이 다르므로 이 과정에서 SkyPlanner 팀의 노하우가 활용됩니다.
- Proalpha 파트너도 참여할 수 있습니다. 파트너는 고객사의 공정 모델, INWB 흐름, 릴리스 버전을 잘 알고 있으며 API 접근을 설정할 수 있습니다. SkyPlanner는 REST API, Swagger/OpenAPI 문서, 웹훅을 제공합니다.
- 사내 개발자도 연동 기능을 개발할 수 있습니다. API 토큰으로 동일한 REST API를 사용하면 됩니다. 필요할 때 SkyPlanner 팀이 지원합니다. 제품 문서는 SkyPlanner 문서에서 공개되어 있습니다.
SkyPlanner는 작업장 5개를 포함해 월 199 €부터 시작하며 매월 청구됩니다. 고객사의 공정과 요구사항에 맞춘 연동 견적을 요금제와 함께 사전에 제공하므로, 시작 전에 전체 비용을 확인할 수 있습니다. Proalpha의 생산능력 계획 방식은 proALPHA는 실제 생산능력을 반영한 생산 스케줄링을 지원하나요?에서, 전반적인 내용은 proALPHA 페이지에서 확인하세요. 다른 시스템은 ERP 연동 안내에서 살펴볼 수 있습니다.
제조업체의 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%에 도달했으며, 스케줄링 업무에서 하루 최대 네 시간을 절약합니다.
감소자재 부족으로 인한 생산 중단
“SkyPlanner의 가치는 일상 업무에서 실질적으로 쓸 수 있는 도구라는 점입니다. 특히 납기일을 정할 때 유용합니다.”
Tommi Männistö, 생산 계획 관리자
Eskomatic · 위탁 기계가공
부하를 자동으로 배분해 일정을 수립하므로 납기일이 더 정확해졌고, 자재 부족으로 인한 생산 중단도 크게 줄었습니다.
자주 묻는 질문
연동에 어떤 Proalpha 인터페이스를 사용하나요?
부품과 재고 조회, 일정·자원·실적 역전송에는 Proalpha REST API를 사용합니다. INWB 메시지 흐름 또는 n8n 기반 Integration Platform으로 작업지시와 해당 공정을 전송합니다. 체험 및 대량 데이터 적재에는 파일 내보내기를 사용합니다.
계획된 일정은 Proalpha의 어디에 저장되나요?
setWorkOrderOperationDates를 통해 작업지시 공정에 시작·종료 시점으로 저장됩니다. 엔진이 작업을 다른 설비로 옮겼다면 changeWorkOrderOperationResource로 자원을 갱신합니다.
Proalpha는 웹훅을 지원하나요?
Proalpha API Portal에는 웹훅 구독 API가 나와 있지 않습니다. 변경 사항은 INWB 메시지 흐름, n8n 워크플로 또는 폴링을 통해 SkyPlanner에 전달됩니다. SkyPlanner 자체 웹훅을 사용하면 역전송을 이벤트 기반으로 처리할 수 있습니다.
작업자가 등록한 실적을 Proalpha에 전송할 수 있나요?
네. SkyPlanner Mobile Confirmations의 작업 시간 기록은 수량, 작업자 시간, 자원 시간과 함께 operationDataEntry를 통해 등록됩니다. PDC 단말기도 사용 중이라면 실적 등록 경로를 하나로 유지하세요.
Proalpha APS가 필요한가요? 이미 사용 중이라면 어떻게 하나요?
필요하지 않습니다. SkyPlanner는 작업지시, 공정, 자원을 바탕으로 실제 생산능력을 반영한 일정을 자체적으로 수립하며, Autopilot이 이를 최신 상태로 유지합니다. Proalpha APS를 사용 중이라면 범위 산정 단계에서 공정 일정을 어느 시스템이 관리할지 정하세요. 그러면 SkyPlanner는 자신이 관리하는 일정만 기록하므로 두 계획이 서로 덮어쓰지 않습니다.
연동을 구축하기 전에 SkyPlanner를 테스트할 수 있나요?
네. 작업지시를 CSV 또는 Excel로 내보내면 30일 무료 체험에서 작업장 최대 20개까지 사용할 수 있으며, 신용카드는 필요하지 않습니다. 무료 체험을 시작하세요. 연동 범위를 산정하려면 영업팀에 문의하세요.
