Lemonsoft 연동 가이드 SkyPlanner APS를 활용한 생산 스케줄링
이 가이드는 파트너와 IT 팀을 대상으로 Lemonsoft ERP를 SkyPlanner APS에 연결하는 방법을 설명합니다. SkyPlanner는 Lemonsoft의 REST API를 통해 Lemonsoft와 양방향으로 연동됩니다.
- 작업 번호(työnumero), 공정(työvaihe), 설비, 제품 구조, 자재, 계획된 근무조를 가져옵니다.
- 계획된 시작·종료 시간과 선택한 설비를 공정에 다시 반영합니다.
- 작업자의 실적 확인 내용을 완료 기록으로 전송합니다.
- SkyPlanner 웹훅은 일정이 변경되는 즉시 변경 사항을 전송합니다.
Kaskea Group은 Lemonsoft와 양방향으로 연동해 SkyPlanner를 사용하고 있습니다. SkyPlanner 팀이 온보딩 과정에서 고객의 Lemonsoft 환경에 맞게 연동을 설정하고, 운영을 시작한 뒤에도 지원합니다. 파트너와 개발자는 문서화된 SkyPlanner REST API를 활용해 직접 개발할 수도 있습니다(API 참조 문서).
Lemonsoft의 REST API
Lemonsoft의 연동 API는 LemonRest이며, 버전은 v1이고 Swagger 2.0 형식으로 문서화되어 있습니다. “LemonRest 2026.10 release-2026.10.2” 빌드에는 422개의 경로가 나열되어 있습니다. (Swagger)
- 기본 URL은 환경마다 다릅니다. 사용자 관리의 환경 관리 및 서비스 주소에서 Rest API 필드를 확인하세요. Lemonsoft의 Azure 플랫폼에서 기본 URL은
https://rest.lemon.fi입니다. - 사용 조건. Lemonsoft 플랫폼 서비스(Alustapalvelu) 고객은 REST API가 사전 설치되어 있으므로 사용자 권한만 부여하면 됩니다. (출처)
- 테스트 환경. 최종 고객이 Lemonsoft Service Desk에 신청합니다.
별도로 제공되는 Kellokortti 근태 관리 API는 스케줄링에 필요하지 않습니다.
인증
LemonRest는 세션을 사용합니다.
- UserName, Password, Database, ApiKey를 포함해
POST /api/auth/login을 호출하면session_id가 반환됩니다. - 모든 호출의
Session-Id헤더에 이 값을 넣어 전송하세요. POST /api/auth/renew로 세션을 갱신합니다.GET /api/auth/alive로 정상 작동 여부를 확인합니다.
POST /api/auth/login/token은 사용자 이름과 비밀번호 대신 Token을 받습니다. 연동 전용 사용자를 생성하고 API 키와 연동에 필요한 권한만 부여하세요. (출처)
SkyPlanner 측 REST API는 API 토큰(SkyPlanner Settings > API)으로 인증하며, Swagger/OpenAPI 문서가 제공됩니다. 연동 튜토리얼에서 초기 API 호출 과정을 안내합니다.
변경 감지: 델타 쿼리
LemonRest에는 웹훅이나 구독 엔드포인트가 없습니다. 변경 사항은 델타 쿼리로 조회합니다.
GET /api/production/main_ws/changed?updated_after=...는 마지막 실행 이후 변경된 작업을 반환합니다.optimization=true를 추가하세요. 로그 의존성을 없애고 쿼리 속도를 높이기 위해 2026.6.3 릴리스에 추가된 옵션입니다. (릴리스 노트)GET /api/log/deletion_events로 삭제된 작업을 감지해 취소된 작업을 일정에서 제거합니다.
몇 분 간격으로 폴링하세요. SkyPlanner는 상태나 일정이 변경되면 웹훅을 전송하므로, Lemonsoft에 결과를 반영하는 쪽은 이벤트 기반으로 동작합니다.
데이터 매핑
| Lemonsoft 객체(엔드포인트) | SkyPlanner 객체 | 방향 | 주기 |
|---|---|---|---|
Tuote, product_code (/api/products) | 제품 및 자재 | Lemonsoft → SkyPlanner | 초기 적재 후 변경 시 |
Työvaiheet 행을 포함한 Tuoterakenne (/api/products/structure, all_levels) | 제품 구조, 하위 제품, 준비 시간이 포함된 공정 단계 | Lemonsoft → SkyPlanner | 초기 적재 후 변경 시 |
Kone, Koneryhmä (/api/production/machines, /api/settings/machine_groups) | 작업장, 작업장 그룹 | Lemonsoft → SkyPlanner | 초기 적재 후 드물게 갱신 |
ProductMainWorkStage로 표현되는 Työnumero (/api/production/workstage, main_ws/changed) | 납기와 우선순위가 포함된 주문 | Lemonsoft → SkyPlanner | 몇 분 간격으로 델타 폴링 |
ProductSubWorkStage로 표현되는 Työvaihe (main_ws/sub_ws): machine, setting_time, duration, work_amount_left | 작업장별 작업(공정 단계) | Lemonsoft → SkyPlanner | 몇 분 간격으로 델타 폴링 |
구성품 소요량 (main_ws/{worknumber}/materials) | 작업별 자재 소요량 | Lemonsoft → SkyPlanner | 각 작업과 함께 |
계획된 근무조 (/api/persons/plannedshifts) | 근무조, 인원 | Lemonsoft → SkyPlanner | 매일 동기화하거나 SkyPlanner에서 근무조 관리 |
작업 번호에 연결된 판매 주문 (/api/orders/work/{work_number}) | 고객 및 우선순위 관련 정보 | Lemonsoft → SkyPlanner | 각 작업과 함께 |
Työvaihe의 start_time, end_time, machine_id (PUT /api/production/workstage) | 계획된 시작·종료 시간 및 작업장 | SkyPlanner → Lemonsoft | 일정 변경 시 SkyPlanner 웹훅으로 전송 |
완료 기록 (POST main_ws/sub_ws/completion_entry) | 실적 확인: 완료 수량, 불량 수량, 작업 시간, 작업자 | SkyPlanner → Lemonsoft | 실적 확인 시마다 |
| SkyPlanner에서 설정하는 스케줄링 규칙 | 작업별 허용 작업장, 준비 시간 매트릭스, 공구 | SkyPlanner에서 관리 | 온보딩 중 설정 |
연동 구현 방식
1. 기준정보 초기 적재. 설비와 설비 그룹, 공정이 포함된 제품 구조, 표준 공정을 조회합니다. 개별 설비를 각각 SkyPlanner 작업장에 매핑하세요. 상위 설비(Isäkone)는 하위 설비의 생산능력을 합산하므로 그룹화 용도로만 사용하세요.
2. 작업 번호 동기화. /api/production/workstage 또는 main_ws/sub_ws에서 미완료 작업 번호와 해당 공정을 상태별로 필터링하고 페이지를 나누어 조회합니다. 이후 main_ws/changed로 최신 상태를 유지하세요. Lemonsoft는 잔여 수량을 기준으로 일정을 수립하므로 work_amount가 아닌 work_amount_left를 매핑하세요. 구매 주문 정보는 SkyPlanner의 자재 기반 스케줄링에 반영되므로, 공정은 구매 주문의 입고 예정일까지 대기합니다.
3. 일정 결과 반영. 엔진이 배치하거나 이동한 각 공정에 대해 SkyPlanner는 작업과 해당 sub_workstages를 담아 PUT /api/production/workstage 요청을 보냅니다. 각 공정에는 start_time과 end_time이 포함되며, 대체 설비로 이동한 경우 machine_id도 포함됩니다.
4. 생산 현장 실적 확인. 작업자는 SkyPlanner Mobile Confirmations 또는 Production Timer로 작업 실적을 확인합니다. 각 확인 내용은 sub_workstage_id, person_number, done_amount, hours, failed_amount, job_done과 함께 completion_entry로 전송됩니다. 해당 공정에서 자재를 소비한다면 material_consumptions도 함께 전송하세요. 그러면 Lemonsoft가 일반적인 생산 완료 처리(valmistuskirjaus)를 수행합니다.
5. 데이터 관리 주체 및 충돌 처리 규칙. 운영을 시작하기 전에 다음 규칙을 문서화하세요.
| 데이터 | 관리 주체 |
|---|---|
| 제품, 제품 구조, 공정, 수량, 작업 상태 | Lemonsoft |
| 공정 순서, 시작·종료 시간, 설비 선택 | SkyPlanner |
| 작업별 허용 작업장, 준비 시간 매트릭스, 공구 | SkyPlanner |
| 근무조 및 부재 정보 | 범위 산정 시 선택한 하나의 시스템 |
| 생산 완료 및 재고 처리 | Lemonsoft에서 관리, SkyPlanner의 실적 확인 내용으로 처리 |
충돌의 주요 원인은 Lemonsoft 자체의 자동 스케줄링과 새로 고침 기능입니다. 두 기능 모두 잠기지 않은 공정을 다시 배치합니다. SkyPlanner가 일정을 관리하는 동안에는 AUTOTIMING을 0으로 유지하세요. 이 기능을 켜 둔다면 일정을 반영한 각 작업 번호에 일정 잠금을 설정하세요. 해당 번호의 모든 공정이 고정됩니다. 자동 스케줄링은 잠기지 않은 작업을 잠긴 날짜 밖으로 이동시키므로 Koneiden kapasiteetin lukitus만으로는 충분하지 않습니다. (출처)
일반적인 프로젝트 진행 단계
구축은 보통 온보딩 시작 후 몇 주 안에 완료됩니다. 그에 앞서 작업 번호, 공정, 설비를 Excel로 내보내 자사 데이터를 기반으로 30일 무료 체험을 진행합니다.
- 범위 산정. 매핑 표, 데이터 관리 주체에 관한 규칙, 폴링 간격을 확정합니다.
- 접근 권한 준비. 최종 고객이 Lemonsoft Service Desk에 테스트 환경을 신청하고 연동 사용자와 API 키를 생성합니다.
- 초기 적재. 설비, 그룹, 제품 구조, 공정을 적재합니다.
- 작업 번호 동기화. 델타 폴링, 삭제 이벤트 처리, 세션 갱신을 구현합니다.
- SkyPlanner의 제약 조건 설정. 작업별로 허용되는 작업장, 준비 시간 매트릭스, 공구를 설정합니다.
- Lemonsoft로 결과 반영. 테스트 환경에서 공정별 시간과 완료 기록이 반영되는지 검증합니다.
- 병행 운영 및 정식 가동. 기존 Gantt와 비교하고 기준정보를 수정한 뒤, 운영 환경에서 Lemonsoft로의 결과 반영 기능을 켭니다.
Lemonsoft 연동 시 미리 검토할 사항
- 공정당 설비 한 대. Lemonsoft의 각 공정에는 설비 한 대가 지정됩니다. 도입 과정에서 목록이나 제품 속성을 통해 제품별로 사용 가능한 설비를 파악하면, SkyPlanner가 그중에서 설비를 선택합니다.
- 일일 생산능력. 고정 생산능력은 일 단위 수량이며, 변동분에는 시각 정보가 없습니다. SkyPlanner에 실제 교대근무를 모델링하거나 계획된 교대근무 정보를 읽어오세요.
- 잔여 수량.
work_amount_left를 매핑하세요. STARTJOB_AUTOTIMENOW와 JOBDONE_AUTOTIMENOW 설정도 Lemonsoft 자체 부하의 배치 시점을 이동시킵니다. - 세션 만료. 장시간 동기화 전에 세션을 갱신하고, 강제 재로그인이 필요한 상황도 처리하세요.
- 실적 확정 규칙. 각 실적을 전송하기 전에 공정 상태에 맞는지 검증하고, 호출이 몰릴 때는 전송 간격을 조절하세요.
- 두 클라이언트 지원. LemonOnline과 Windows 버전은 하나의 데이터베이스를 공유하므로, 이 연동으로 두 클라이언트를 모두 지원합니다.
- 대규모 제품 구조. 대용량 데이터를 가져올 때는
/api/async/product/structure와/api/async/status/{jobId}를 함께 사용하세요.
Lemonsoft 연동: 설정과 지원은 누가 담당하나요?
연동 작업에는 고객사의 설비, 작업 공정, Lemonsoft 설정에 맞춘 매핑이 포함됩니다. SkyPlanner에서 관리하는 스케줄링 규칙, 즉 작업별로 허용되는 작업장, 준비 시간 매트릭스, 공구 설정도 포함됩니다.
- SkyPlanner 팀이 도입 과정에서 연동을 설정하고 정식 가동 후에도 지원합니다. 공장마다 Lemonsoft를 운영하는 방식이 다르므로, 이러한 현장 노하우를 설정에 반영합니다.
- 고객사의 Lemonsoft 파트너도 참여할 수 있습니다. 파트너는 고객사의 설정을 잘 알고 있으며 API 사용자, 권한, 테스트 환경을 담당할 수 있습니다. SkyPlanner는 REST API, Swagger/OpenAPI 문서, 웹훅을 제공합니다.
- 사내 개발팀이 연동 기능을 개발할 수도 있습니다. 동일하게 문서화된 REST API에 API 토큰으로 접근하면 됩니다. API 토큰만 있으면 시작할 수 있으며, 필요할 때 SkyPlanner 팀이 지원합니다.
연결이 완료되면 Arcturus 엔진이 Lemonsoft의 실시간 작업 번호 데이터를 바탕으로 일정을 수립하고, 계획 시간을 각 작업 공정에 반영합니다. SkyPlanner는 작업장 5개가 포함된 월 199 €부터 시작하며 매월 청구됩니다. 연동 비용은 고객사의 공정과 요구 사항에 맞춰 요금제와 함께 사전에 견적을 제공하므로, 시작 전에 전체 비용을 확인할 수 있습니다.
Lemonsoft 생산 스케줄링에서 실제 설비와 인력의 생산능력을 고려한 일정 수립 방식과 Lemonsoft 자체 계획 기능을 비교해 보세요. 개요는 Lemonsoft 페이지에서, 다른 시스템은 ERP 연동 안내에서 확인할 수 있습니다.
제조업 고객의 SkyPlanner 사용 후기
LemonsoftSkyPlanner와 양방향 연동
Kaskea Group
위탁 제조: CNC 가공, 철구조물 제작 및 조립
Lemonsoft와 양방향으로 연동된 SkyPlanner에서 생산 계획을 수립합니다.
가동 중단 감소자재 부족으로 인한 중단
“SkyPlanner의 가치는 일상 업무에서 실질적으로 활용할 수 있는 도구라는 점입니다. 특히 납기일을 정할 때 유용합니다.”
Tommi Männistö, 생산 계획 관리자
Eskomatic · 위탁 기계가공
부하를 자동으로 스케줄링해 납기일을 더 정확하게 산정하며, 자재 부족으로 인한 생산 중단도 크게 줄었습니다.
2시간매주 절약
“SkyPlanner 덕분에 Excel 스프레드시트로 하던 생산 계획을 실시간 생산 최적화로 전환했습니다.”
Kalle Kalliomäki, 공급망 전문가
UTU · 배전반 및 개폐장치
생산 계획에 드는 업무 시간이 매주 2시간 절약되며, 새로운 작업 대기열은 수초 만에 생산 라인에 전달됩니다.
+90%생산 효율 향상
“생산 효율이 90% 향상되었습니다.”
Abdul Rucyinga, IT 책임자
Laboratory & Allied · 의약품 제조
생산 효율이 90% 향상되었으며, 모든 작업장을 대상으로 석 달 치 최적화 계획을 수립하는 데 30분도 걸리지 않습니다.
자주 묻는 질문
Lemonsoft에 생산 데이터용 API가 있나요?
네. LemonRest는 생산 작업과 작업 공정, 설비, 제품 구조, 자재, 교대근무 데이터에 대한 접근과 완료 실적 등록 기능을 제공합니다. Alustapalvelu 고객 환경에는 사전 설치되어 있으며, 사용하려면 API 키와 사용자 권한이 필요합니다.
Lemonsoft는 웹훅을 지원하나요?
LemonRest에는 웹훅 엔드포인트가 명시되어 있지 않습니다. 몇 분 간격으로 폴링하여 main_ws/changed 델타 쿼리와 삭제 이벤트로 변경 사항을 읽어옵니다. SkyPlanner 자체 웹훅은 일정이 변경되는 즉시 변경 사항을 전송합니다.
계획 시간은 Lemonsoft에 어떻게 반영되나요?
PUT /api/production/workstage로 작업과 해당 작업 공정의 시작 시간, 종료 시간, 설비를 업데이트합니다. SkyPlanner가 일정을 관리하는 동안에는 Lemonsoft의 자동 스케줄링을 끄거나, 데이터를 반영한 각 작업 번호에 일정 잠금을 설정하세요. 그래야 SkyPlanner가 지정한 시간이 그대로 유지됩니다.
SkyPlanner에서 작업자가 확정한 실적을 Lemonsoft에 등록할 수 있나요?
네. 각 확정 실적은 완료 수량, 불량 수량, 작업 시간, 작업자 정보와 함께 완료 실적으로 등록됩니다. 고객 프로젝트에서 매일 사용하고 있는 기능입니다.
Lemonsoft 연동은 누가 구축하나요?
SkyPlanner 팀이 도입 과정에서 고객사의 Lemonsoft 설정에 맞춰 양방향 연동을 구성하고, 정식 가동 후에도 지원합니다. 고객사의 Lemonsoft 파트너나 사내 개발팀도 문서화된 SkyPlanner REST API를 활용해 개발할 수 있으며, API 토큰만 있으면 시작할 수 있습니다.
