PSIpenta 연동 가이드 SkyPlanner APS로 생산 스케줄링 구현하기
이 가이드는 PSI 파트너와 IT 팀을 대상으로 PSIpenta/ERP를 SkyPlanner APS와 연결하는 방법을 설명합니다. SkyPlanner는 PSI가 제공하는 인터페이스를 통해 PSIpenta와 양방향으로 연동합니다.
- 생산 오더(Fertigungsaufträge)와 해당 공정(Arbeitsgänge), 공정 경로(Arbeitspläne), BOM(Stücklisten), 작업 센터, 기계, 공구(Betriebsmittel), 재고 및 구매 오더를 가져옵니다.
- 공정별 계획 시작·종료 시점과 작업 센터를 생산 오더에 다시 반영합니다.
- 원하는 경우 작업자의 시간 기록을 BDE 실적(Rückmeldungen)으로 다시 전송할 수 있습니다.
- SkyPlanner 웹훅은 일정이 변경되는 즉시 변경 사항을 전송합니다.
SkyPlanner 팀은 온보딩 과정에서 고객의 PSIpenta 환경에 맞춰 연동을 구성하고, 가동 후에도 지원합니다. 이 가이드는 연동 작업에 참여하거나 문서화된 SkyPlanner REST API(API 참조 문서)를 활용해 직접 개발하려는 파트너와 개발자를 위한 문서입니다.
PSIpenta 연동 인터페이스
PSI는 외부 스케줄러와 연동하는 세 가지 경로를 제공합니다(PSI 브로슈어).
- PSIpenta/ERP REST API. PSI는 PSIpenta/ERP용 REST 및 SOAP API를 명시하고, RESTful 웹 서비스를 통해 모든 PSIpenta 구성 요소를 기존 아키텍처에 통합할 수 있다고 설명합니다. 생산 데이터를 읽고 계획 일정을 기록하는 주된 경로입니다.
- PSIpenta/BDE REST 및 SOAP API. 생산 현장 데이터 수집 모듈에는 자체 API가 있습니다. 작업자 실적을 전송할 때 이 경로를 사용합니다.
- PSIintegration. PSIpenta 모듈 간 연동을 위한 PSI의 표준 통합 계층입니다. 허브 앤드 스포크 방식으로 작동하며, 어댑터에서 그래픽 방식으로 메시지를 매핑하고 모든 메시지를 데이터베이스에 보관합니다. 현재 환경에서 이미 이 계층을 통해 외부 시스템과 연결하고 있다면 이를 사용하세요.
PSIpenta/ERP 10에는 외부 시스템 연동을 위한 BPMN 2.0 워크플로가 추가되었습니다. 웹 기반 Workflow Developer에서 워크플로를 구성합니다(PSI). 워크플로는 PSIpenta의 변경에 반응해 SkyPlanner를 호출할 수 있습니다.
인증 및 접근 권한
- PSIpenta 측. 연동은 전용 기술 계정으로 실행하며, 권한은 읽고 쓰는 객체로 제한합니다. PSI 파트너가 고객 환경에서 계정과 API 접근을 설정합니다.
- 네트워크. PSIpenta는 일반적으로 온프레미스에서 실행됩니다. 연동 시스템은 IT 팀이 허용한 경로로 PSIpenta에 접근합니다. 예를 들어 외부에 공개한 API 엔드포인트나 내부 네트워크의 소규모 커넥터를 사용할 수 있습니다.
- SkyPlanner 측. REST API는 Settings > API에서 생성한 API 토큰을
Authorization-Token헤더에 넣어 인증합니다. API는 Swagger/OpenAPI로 문서화되어 있으며, 연동 튜토리얼에서 첫 API 호출 과정을 안내합니다.
이벤트와 폴링
PSIpenta 측에서는 연동 시스템이 REST API를 폴링해 미결 생산 오더와 최근 변경 사항을 가져오거나, BPMN 워크플로 또는 PSIintegration 메시지가 변경 사항을 SkyPlanner로 푸시합니다. 주기는 공장별로 설정하며, 오더는 수분마다, 재고는 매시간 갱신하는 식으로 정합니다.
SkyPlanner는 상태나 일정이 변경되면 웹훅을 전송하므로, 변경 사항을 다시 반영하는 작업은 이벤트 기반으로 처리됩니다.
데이터 매핑
| PSIpenta 객체 | SkyPlanner 객체 | 전송 방향 | 주기 |
|---|---|---|---|
| 품목(Artikel), 단위 | 제품 및 자재 | PSIpenta → SkyPlanner | 최초 적재 후 폴링 |
| 다단계 BOM(Stücklisten) | 제품 구조, 하위 제품, 제품별 자재 | PSIpenta → SkyPlanner | 최초 적재 후 변경 시 |
| 공정, 준비 시간 및 가동 시간이 포함된 공정 경로(Arbeitspläne) | 소요 시간, 준비 시간 및 정리 시간이 포함된 공정 단계 | PSIpenta → SkyPlanner | 최초 적재 후 변경 시 |
| 작업 센터(Arbeitsplätze) 및 기계 | 작업장, 작업장 그룹, 효율 | PSIpenta → SkyPlanner | 최초 적재 후 드물게 갱신 |
| 공구 및 치공구(Betriebsmittel) | 가용 수량이 제한된 공유 자원으로 관리하는 공구 | PSIpenta → SkyPlanner | 최초 적재 후 변경 시 갱신 |
| 교대근무 캘린더 | 교대근무 및 비가동일 | PSIpenta → SkyPlanner | 매일 갱신하거나 SkyPlanner에서 교대근무를 별도 관리 |
| 공정 및 자재가 포함된 생산 오더(Fertigungsaufträge) | 납기 및 자재 소요량이 포함된 오더와 작업 | PSIpenta → SkyPlanner | 수분 간격으로 폴링 |
| 현재고 | 재고 잔량 | PSIpenta → SkyPlanner | 매시간 또는 스케줄링 실행 시 폴링 |
| 납품일이 포함된 구매 오더(Bestellungen) | 구매 오더, 납품일별 입고 예정 자재 | PSIpenta → SkyPlanner | 매시간 또는 스케줄링 실행 시 폴링 |
| 생산 오더의 공정별 계획 시작·종료 시점 및 작업 센터 | 작업별 예정 시작·종료 시점 | SkyPlanner → PSIpenta | 일정 변경 시 SkyPlanner 웹훅으로 전송 |
| BDE 실적(Rückmeldungen): 공정별 시간·수량 및 작업자 | 작업 시간 기록 및 작업자 실적 보고 | SkyPlanner → PSIpenta | 선택 시 실적 보고마다 또는 교대마다 |
| SkyPlanner 스케줄링 규칙 | 준비 시간 매트릭스, 작업별 작업자 수, 대체 설비 및 인력 | SkyPlanner에서 관리 | 온보딩 중 설정 |
연동 패턴
1. 기준정보 최초 적재. PSIpenta/ERP REST API로 부품, BOM, 공정 경로, 작업 센터, 기계, Betriebsmittel 및 캘린더를 읽어옵니다. 작업 센터의 매핑 방식은 신중히 정하세요. 기계 네 대가 있는 작업 센터는 하나의 작업장 그룹 또는 네 개의 작업장으로 구성합니다.
2. 오더 동기화. 릴리스된 생산 오더와 해당 공정·자재, 미결 구매 오더를 읽어옵니다. SkyPlanner는 발주한 자재를 구매 오더의 납품일에 사용 가능한 것으로 간주하고, 구매 오더가 Delivered로 표시되면 재고를 갱신합니다. 구매 제안은 오더로 전환될 때까지 PSIpenta에 남습니다.
3. 스케줄 역반영. 엔진이 공정을 배치하거나 이동하면 SkyPlanner 웹훅이 PSIpenta/ERP REST API 호출을 트리거합니다. 이 호출은 생산 오더에서 해당 공정의 계획 시작·종료 시점과 작업 센터를 갱신합니다. 오더 일정은 해당 공정 일정에 따라 정해집니다. 고객 환경에서 사용할 리소스와 필드는 온보딩 범위 산정 과정에서 정합니다.
4. 현장 실적 등록. 작업자는 SkyPlanner Mobile Confirmations 또는 Production Timer로 작업을 기록하며, 이 시간 기록을 통해 스케줄이 최신 상태로 유지됩니다. 실제 작업 시간을 다시 전송할지는 고객이 선택합니다. 전송을 선택하면 PSIpenta/BDE API를 통해 공정별 시간과 수량이 BDE 실적으로 전송됩니다. BDE 단말기를 계속 사용하는 경우에는 SkyPlanner가 PSIpenta에서 실적을 읽어옵니다.
5. 데이터 관리 주체 및 충돌 처리 규칙. 가동 전에 다음 사항을 문서화하세요.
| 데이터 | 관리 주체 |
|---|---|
| 부품, BOM, 공정 경로, 수량, 오더 상태 | PSIpenta |
| 공정 순서, 시작·종료 시각, 기계 배정 | SkyPlanner |
| 준비 시간 매트릭스, 작업자 수, 대체 자원 | SkyPlanner |
| Betriebsmittel 기준정보 | PSIpenta에서 관리하며, 시간대별 가용성은 SkyPlanner에서 계획 |
| 교대근무 및 비가동일 | 범위 산정 시 선택한 하나의 시스템 |
| 실적, 자재 출고 및 입고 | PSIpenta에서 관리하며, 직접 입력하거나 SkyPlanner 시간 기록에서 전송 |
공정 일정을 기록하는 시스템은 하나로 정하세요. Leitstand, Adaptive Planung 또는 MES Scheduling도 계획 일정을 설정한다면, SkyPlanner가 스케줄링하는 오더에 대해서는 해당 기능을 끄세요.
일반적인 프로젝트 진행 단계
구축은 일반적으로 온보딩 시작 후 수 주 내에 완료됩니다. 그전에 PSIpenta에서 작업 센터, 공정 경로 및 미결 생산 오더를 CSV 또는 Excel로 내보내 30일 무료 체험에서 스케줄을 검증하세요.
- 매핑. 매핑 표, 데이터 관리 주체별 규칙, 동기화 주기 및 실적 역전송 여부를 확정합니다.
- PSIpenta 접근 설정. 기술 계정을 만들고 PSI 파트너와 함께 API 경로를 활성화한 뒤, 테스트 환경에서 먼저 검증합니다.
- 최초 적재. 부품, BOM, 공정 경로, 작업 센터, 기계, Betriebsmittel 및 캘린더를 적재합니다.
- 생산·구매 오더 동기화. 필터, 페이징 및 재시도를 적용한 폴링이나 워크플로가 트리거하는 메시지를 사용합니다.
- SkyPlanner 제약 조건 설정. 준비 시간 매트릭스, 공구, 작업별 작업자 수 및 대체 기계나 인력을 설정합니다.
- 스케줄 역반영. SkyPlanner 웹훅으로 공정 일정을 반영하고, 선택한 경우 BDE 실적도 전송합니다.
- 병행 테스트. 기존 계획과 SkyPlanner를 병행 운영하며 일정을 비교하고 기준정보를 수정합니다.
- 가동 시작. 데이터가 일치하면 역반영을 활성화합니다.
PSIpenta 연동 시 미리 검토할 사항
- 모듈 구성. 라이선스를 보유하고 실제 사용 중인 PSI 계획 모듈을 확인하세요. 일정을 기록하는 모듈마다 명확한 규칙이 필요합니다.
- 작업 센터 또는 기계 단위. SkyPlanner가 작업 센터 단위로 스케줄링할지, 기계 단위로 스케줄링할지 정하고 양방향 연동에 동일하게 적용하세요.
- Betriebsmittel. Betriebsmittel 목록의 치공구와 공구는 SkyPlanner에서 가용 수량이 제한된 공구로 관리되므로, 공정을 배치할 때 해당 공구도 함께 예약됩니다.
- 준비·가공 시간 단위. 데이터를 가져올 때 올바른 단위와 산정 기준으로 준비 시간과 가공 시간을 변환하세요. 그렇지 않으면 모든 소요 시간이 잘못됩니다.
- 외주 공정. 외주 공정은 사내 생산능력을 사용하는 것이 아니라 경과 시간으로 반영해야 합니다. 시간만 소요되는 단계로 모델링하세요.
- 시작된 공정. 스케줄링을 실행하기 전에 매번 실적에서 진행 상황을 읽어와 이미 완료된 작업을 기준으로 스케줄을 수립하세요. 이후 Running Time Lock이 앞으로 몇 시간 동안 예정된 작업을 고정합니다.
PSIpenta 연동 구성 및 지원 담당
- SkyPlanner 팀이 온보딩 중에 연동을 구성하고 가동 후에도 지원합니다. 지원 범위는 합의된 API 호출과 메시지입니다. 공장마다 PSIpenta 운영 방식이 다르며, 구성 과정에 이러한 현장 노하우를 반영합니다.
- PSI 파트너도 참여할 수 있습니다. 파트너는 고객의 모듈, 사용자 정의 필드 및 PSIintegration 구성을 알고 있으므로, SkyPlanner 팀과 함께 API 접근을 설정할 수 있습니다.
- 사내 개발자가 직접 개발할 수도 있습니다. API 토큰으로 SkyPlanner REST API를 사용하면 됩니다. API 토큰만 있으면 시작할 수 있으며, 필요할 때 SkyPlanner 팀이 지원합니다. 연동 문서는 SkyPlanner 연동 문서에서 확인하세요.
SkyPlanner는 작업장 5개를 포함해 월 199 €부터 시작하며 매월 청구됩니다. 연동 비용은 고객의 프로세스와 요구 사항에 맞춰 요금제와 함께 사전에 견적을 제공합니다. 요금, PSIpenta 생산 스케줄링, PSIpenta 페이지 및 ERP 연동 허브를 확인하세요.
제조업체의 SkyPlanner 사용 후기
2시간매주 절약
“SkyPlanner 덕분에 Excel 스프레드시트로 생산 계획을 세우던 방식에서 벗어나 실시간으로 생산을 최적화하고 있습니다.”
Kalle Kalliomäki, 공급망 전문가
UTU · 배전반 및 개폐장치
생산 계획 업무에 드는 시간을 매주 2시간 절약하고, 새로운 작업 대기열을 몇 초 만에 생산 라인에 전달합니다.
+90%생산 효율 향상
“생산 효율이 90% 높아졌습니다.”
Abdul Rucyinga, IT 책임자
Laboratory & Allied · 의약품 제조
생산 효율이 90% 높아졌으며, 모든 작업장에 걸쳐 석 달치 최적화 계획을 세우는 데 30분도 걸리지 않습니다.
100%2021년부터 유지한 납기 준수율
“SkyPlanner 덕분에 생산능력을 한눈에 파악하고 예측 가능한 계획을 세울 수 있습니다.”
Dan Berglund, COO/CFO
Opes Corporation · 화학 및 식품 제조
SkyPlanner를 도입한 2021년부터 지금까지 납기 준수율 100%를 유지하고 있습니다.
감소자재 부족으로 인한 생산 중단
“SkyPlanner의 가치는 일상 업무에서 실질적으로 쓸 수 있는 도구라는 점입니다. 특히 납기를 정할 때 유용합니다.”
Tommi Männistö, 생산 계획 관리자
Eskomatic · 위탁 기계가공
부하를 자동으로 배분해 일정을 세우면서 납기를 더 정확하게 산정할 수 있게 되었고, 자재 부족으로 인한 생산 중단도 크게 줄었습니다.
자주 묻는 질문
PSIpenta에 생산 오더용 API가 있나요?
네. PSI는 PSIpenta/ERP와 PSIpenta/BDE용 REST 및 SOAP API를 명시하고 있으며, 모든 PSIpenta 구성요소를 RESTful 웹 서비스로 연동할 수 있다고 안내합니다. PSIintegration은 모듈 간에 메시지 기반 연동 계층을 제공합니다.
계획 일정은 PSIpenta에 어떻게 반영되나요?
PSIpenta/ERP REST API를 통해 반영됩니다. 일정이 변경될 때마다 SkyPlanner 웹훅이 업데이트를 트리거해 생산 오더의 각 공정에 대한 계획 시작일시, 계획 종료일시, 작업 센터를 갱신합니다.
SkyPlanner에서 PSIpenta BDE로 실적을 전송할 수 있나요?
네. 원하는 경우 그렇게 구성할 수 있습니다. SkyPlanner에 기록된 작업자 시간 기록은 PSIpenta/BDE API를 통해 공정별 시간과 수량을 포함한 BDE 실적으로 전송됩니다. BDE 단말기를 계속 사용하는 공장에서는 반대로 SkyPlanner가 해당 실적을 읽어오도록 합니다.
PSI 파트너는 PSIpenta Leitstand와 SkyPlanner 중 무엇을 제안해야 하나요?
고객이 몇 주 안에 실제 생산능력을 반영한 생산 스케줄링을 현업에 적용하고자 한다면 SkyPlanner를 제안하면 됩니다. Leitstand, Adaptive Planung, MES Scheduling은 PSI의 모듈형 제품을 구성하는 별도 모듈입니다(PSI). SkyPlanner는 PSIpenta/ERP 및 BDE API로 연동하며, 생산 상황이 바뀌면 자동으로 일정을 다시 수립합니다. 작업 전환, 공구, 작업조, 자재까지 계획하며, 월 199 €부터 사용자 수 제한 없이 이용할 수 있습니다.
연동하려면 PSIpenta/MES가 필요한가요?
아니요. SkyPlanner는 PSIpenta/ERP와 연동하며, 실적 처리를 위해 PSIpenta/BDE와도 연동합니다. 작업자는 휴대폰이나 태블릿으로 SkyPlanner에 작업을 기록할 수 있습니다.
