Comarch ERP XL 연동 가이드 SkyPlanner APS로 생산 스케줄링하기
이 가이드는 파트너와 IT 팀을 대상으로 Comarch ERP XL을 SkyPlanner APS에 연결하는 방법을 설명합니다. SkyPlanner는 Comarch에서 제공하는 인터페이스를 통해 Comarch ERP XL과 양방향으로 연동됩니다.
- 프로세스와 공정이 포함된 생산 오더(zlecenia produkcyjne), 생산 기술 정보, 작업 센터, 자원, 품목, 재고 및 구매 오더를 가져옵니다.
- XL API를 통해 각 생산 오더의 공정에 계획 시작·종료 시간을 반영합니다.
- 선택에 따라 작업자의 작업 시간 기록을 공정 실적으로 다시 전송합니다.
- SkyPlanner 웹훅은 일정이 변경되는 즉시 변경 사항을 전송합니다.
SkyPlanner 팀은 온보딩 과정에서 고객의 Comarch ERP XL 환경에 맞게 연동을 구성하고, 가동 후에도 지원합니다. 이 가이드는 연동에 참여하거나 SkyPlanner의 문서화된 REST API(API 참조 문서)를 활용해 직접 개발하려는 파트너와 개발자를 위한 문서입니다.
Comarch ERP XL의 연동 인터페이스
Comarch는 ERP XL과 통신하는 방법으로 세 가지를 제시합니다. “DCOM, direct database connection (SQL Client), REST API”(DCOM, 직접 데이터베이스 연결(SQL Client), REST API)(Comarch 문서, 번역). 스케줄러 연동에서는 이 중 두 가지가 핵심 역할을 합니다.
- XL API (CDN_API.DLL). “These functions are collected in the CDN_API.DLL library, installed together with the whole Comarch ERP XL system.”(이 함수들은 Comarch ERP XL 시스템과 함께 설치되는 CDN_API.DLL 라이브러리에 포함되어 있습니다.)(Comarch 도움말, 번역) 외부 프로그램은 XLLogin으로 로그인한 뒤 같은 세션을 사용하는 함수들을 호출하고, XLLogout으로 로그아웃합니다. 각 구조체에는 ERP XL 릴리스에 맞는 매개변수 집합 버전을 선택하는 Wersja 필드가 있습니다.
- ERP XL Web REST API. Comarch ERP XL Web 2026.0은 REST 마이크로서비스를 제공합니다. “Each RestAPI microservice exposes its own interactive documentation at the /swagger endpoint.”(각 RestAPI 마이크로서비스는 /swagger 엔드포인트에서 자체 대화형 문서를 제공합니다.)(Comarch 도움말, 번역)
SQL Client로 직접 연결하면 ERP XL 데이터베이스에서 기준정보와 오더를 조회할 수 있습니다. 조회 범위는 IT 팀 및 Comarch 파트너와 합의합니다.
생산용 XL API 함수
Comarch 문서에는 다음 생산 함수가 설명되어 있습니다(XL128).
| 영역 | 함수 | 기능 |
|---|---|---|
| 생산 기술 정보 | XLNowaTechnologia, XLNowaCzynnoscTechnologia, XLNowaFunkcjaCzynnoscTechnologia, XLNowyZasobCzynnoscTechnologia | 생산 기술 정보, 공정, 공정별 작업 센터, 공정별 자재 또는 제품 신규 등록 |
| 생산 오더 | XLNoweZlecenieProd | 생산 오더 신규 생성 |
| 생산 오더 | XLZamknijZlecenieProd | 동작 코드에 따라 생산 오더의 계획 수립, 재계획, 정산 또는 마감 수행 |
| 공정 | XLDodajCzynnoscDoProcesuProd, XLDodajZasobDoProcesuProd | 생산 프로세스에 공정 또는 자원 추가 |
| 일정 | XLDodajTerminDoProcesuProd | 공정에 일정 구간 추가: IdCzynnosci, TerminOd, TerminDo |
| 실적 | XLDodajRealizacjeOperacjiProd, XLProdZmienIloscRealizacji | 오더에 공정 실적 추가, 실적 수량 변경 |
| 문서 | XLProdObiektyDoDokumentow, XLProdGenerujDokumentyDlaObiektow | 생산 객체에 대한 RW 및 PW 문서 생성 |
인증 및 접근
- XL API. 연동 서비스는 XLLogin으로 ERP XL 운영자 계정을 사용해 데이터베이스에 로그인하고, 이후 호출에 사용할 세션을 받습니다. DLL은 ERP XL이 설치된 Windows 호스트에서 실행되므로, ERP XL에 데이터를 다시 반영하는 서비스도 ERP XL과 같은 사내 네트워크에서 실행됩니다.
- REST API. 접근 설정은 ERP XL Web 설치 환경별로 구성합니다. 각 마이크로서비스의 Swagger 페이지에서 호출 방법을 확인할 수 있습니다.
- SQL 조회. IT 팀이 승인한 읽기 전용 데이터베이스 계정을 사용합니다.
SkyPlanner의 REST API는 Authorization-Token 헤더에 담긴 API 토큰으로 인증합니다(SkyPlanner Settings > API). API 문서는 Swagger/OpenAPI로 제공됩니다. 연동 튜토리얼에서 첫 API 호출 과정을 단계별로 안내합니다.
이벤트 및 폴링
확인한 문서에는 Comarch ERP XL의 아웃바운드 웹훅이 명시되어 있지 않습니다. Comarch 자체 APS는 계획 담당자가 “Aktualizuj dane z ERP”(ERP 데이터 업데이트)를 누르면 데이터를 가져옵니다(Comarch APS 도움말).
따라서 ERP XL 측 데이터는 폴링으로 가져옵니다. 미결 생산 오더와 최근 변경 사항만 조회해 새로운 작업을 확인합니다. 조회 주기는 공장별로 정하며, 생산 오더는 몇 분 간격, 재고는 매시간 등으로 설정합니다.
SkyPlanner는 상태나 일정이 변경되면 웹훅을 전송하므로, ERP XL에 데이터를 다시 반영하는 처리는 이벤트 기반으로 이루어집니다.
데이터 매핑
| Comarch ERP XL 객체(인터페이스) | SkyPlanner 객체 | 방향 | 주기 |
|---|---|---|---|
| Karty towarów, 측정 단위(REST 또는 SQL 조회) | 제품 및 자재 | ERP XL → SkyPlanner | 최초 적재 후 폴링 |
| Technologia: 공정, 공정별 자재·반제품·제품 | 제품 구조, 하위 제품, 공정 단계별 자재 | ERP XL → SkyPlanner | 최초 적재 후 변경 시 |
| Technologia의 공정: 작업 센터, 자원, 시간 | 소요 시간, 셋업 시간 및 해체 시간을 포함한 공정 단계 | ERP XL → SkyPlanner | 최초 적재 후 변경 시 |
| Gniazda robocze 및 zasoby(설비, 공구, 직원) | 작업장, 작업장 그룹, 공구, 인력 | ERP XL → SkyPlanner | 최초 적재 후에는 드물게 갱신 |
| Kalendarze i okresy, przestoje i awarie | 교대 근무, 비근무 시간 및 가동 중단 | ERP XL → SkyPlanner | 매일 동기화하거나 SkyPlanner에서 교대 근무 별도 관리 |
| Zlecenia produkcyjne (ZP): 프로세스, 공정, 자재, 납기, 우선순위 포함 | 납기와 자재 소요량을 포함한 오더 및 작업 | ERP XL → SkyPlanner | 몇 분 간격으로 폴링 |
| 창고별 재고 | 재고 잔량 | ERP XL → SkyPlanner | 매시간 또는 스케줄링 실행 시 폴링 |
| 입고 예정일을 포함한 Zamówienia zakupu (ZZ) | 구매 오더, 입고 예정일별 입고 자재 | ERP XL → SkyPlanner | 매시간 또는 스케줄링 실행 시 폴링 |
| 공정 일정: TerminOd, TerminDo (XLDodajTerminDoProcesuProd) | 작업별 계획 시작·종료 시간 | SkyPlanner → ERP XL | 일정 변경 시 SkyPlanner 웹훅으로 전송 |
| Realizacja operacji (XLDodajRealizacjeOperacjiProd) | 작업 시간 기록 및 작업자 실적 확정 | SkyPlanner → ERP XL | 선택 시 실적 확정 건별 또는 교대 근무별 |
| ERP XL에 없음 | 준비·전환 시간 매트릭스, 수량이 제한된 자원으로 관리하는 공구, 여러 작업자가 필요한 작업, 대체 설비 및 인력 | SkyPlanner에서 관리 | 온보딩 중 설정 |
연동 패턴
1. 기준정보 최초 적재. 품목, 생산 기술 정보, 작업 센터, 자원 및 캘린더를 가져옵니다. 작업 센터를 SkyPlanner에 어떻게 매핑할지 신중하게 정해야 합니다. 설비 네 대가 있는 작업 센터는 작업장 그룹 하나 또는 작업장 네 개로 구성할 수 있습니다. ERP XL 자원에 등록된 공구는 SkyPlanner에서 수량이 제한된 공구로, 직원은 교대 근무가 배정된 인력으로 매핑합니다.
2. 오더 동기화. 공정과 자재가 포함된 생산 오더 및 미결 구매 오더를 가져옵니다. SkyPlanner는 발주한 자재를 구매 오더의 입고 예정일부터 사용 가능한 것으로 처리하고, 구매 오더가 Delivered로 표시되면 재고를 갱신합니다.
3. 일정 역전송. 엔진이 공정을 배치하거나 이동하면 SkyPlanner 웹훅이 역전송 서비스를 실행합니다. 이 서비스는 해당 공정의 TerminOd와 TerminDo를 사용해 XLDodajTerminDoProcesuProd를 호출합니다. 이렇게 각 ZP 공정에 SkyPlanner에서 계획한 시작 및 종료 일시가 기록됩니다.
4. 생산 현장 실적 등록. 작업자는 SkyPlanner Mobile Confirmations 또는 Production Timer로 작업을 기록하며, 이 시간 기록을 바탕으로 일정이 최신 상태로 유지됩니다. 실제 작업 시간을 ERP로 전송할지는 선택할 수 있습니다. 전송을 선택하면 서비스가 XLDodajRealizacjeOperacjiProd로 실적을 추가하며, RW 및 PW 문서는 ERP XL에 설정된 규칙을 따릅니다. 일부 작업장에서 Comarch MES를 사용한다면 공정별로 실적 보고 출처를 하나로 통일하세요.
5. 데이터 관리 주체와 충돌 처리 규칙. 정식 가동 전에 다음 사항을 문서화하세요.
| 데이터 | 관리 주체 |
|---|---|
| 품목, 제조 기술, 수량, ZP 상태, 원가 계산 | Comarch ERP XL |
| 공정 순서, 시작 및 종료 일시, 자원 배정 | SkyPlanner |
| 준비·전환 시간 매트릭스, 공구 및 작업자 요건, 대체 자원 | SkyPlanner |
| 교대 근무, 캘린더, 비가동 시간 | 범위 산정 단계에서 선택한 하나의 시스템 |
| 실적, RW 및 PW 문서 | Comarch ERP XL에서 관리하며, 직접 입력하거나 SkyPlanner 시간 기록에서 전송 |
공정 일시를 기록하는 시스템은 하나로 정하세요. ERP XL의 자동 재계획 기능이나 Comarch APS가 같은 생산 오더에 계속 일정을 기록하고 있다면, SkyPlanner가 일정을 계획하는 오더에 대해서는 해당 기능을 끄세요.
일반적인 프로젝트 단계
구축은 보통 온보딩을 시작한 후 몇 주 안에 완료됩니다. 그 전에 30일 무료 체험으로 일정을 검증하세요. ERP XL에서 작업 센터, 제조 기술, 미완료 생산 오더를 CSV 또는 Excel로 내보내 사용하면 됩니다.
- 매핑. 매핑 표, 데이터 관리 주체별 규칙, 동기화 주기, 실적 역전송 여부를 확정합니다.
- ERP XL 접근 설정. 연동용 사용자 계정을 만들고 읽기 연결을 설정한 다음, ERP XL이 설치된 호스트에 역전송 서비스를 배치합니다. 먼저 복제한 데이터베이스에서 테스트하세요.
- 초기 데이터 적재. 품목, 제조 기술, 작업 센터, 자원, 캘린더를 불러옵니다.
- 생산 오더 및 구매 오더 동기화. 필터와 재시도 기능을 적용해 폴링합니다.
- SkyPlanner 제약 조건 설정. 준비·전환 시간 매트릭스, 공구, 작업별 작업자 수, 대체 설비 또는 인력을 설정합니다.
- 일정 역전송. SkyPlanner 웹훅을 통해 XLDodajTerminDoProcesuProd를 호출하며, 선택한 경우 실적도 전송합니다.
- 병행 테스트. 기존 계획과 SkyPlanner를 병행 운영하면서 일정을 비교하고 기준정보를 수정합니다.
- 정식 가동. 데이터가 일치하면 역전송 기능을 켭니다.
Comarch ERP XL 연동 시 미리 검토할 사항
- 직접 입력하는 생산능력. ERP XL의 작업 센터 생산능력은 사용자가 정의한 수치와 허용 부하율(%)로 설정됩니다. 반면 SkyPlanner는 실제 교대 근무와 자원을 기준으로 생산능력을 산출합니다. 따라서 부하율 대신 교대 근무를 정확하게 설정하세요.
- 무한 생산능력 자원. ERP XL에서는 생산능력이 무한으로 설정된 자원의 점유 여부를 확인하지 않습니다. 각 자원을 SkyPlanner에서 생산능력에 한계가 있는 작업장으로 관리할지 결정하세요.
- 생산 지시가 내려진 오더. ERP XL은 “Przesuń na zwolnionych”를 선택하지 않으면 생산 지시가 내려진 공정을 재계획 대상에서 제외합니다. 해당 오더에 SkyPlanner 일정을 어떻게 적용할지 합의하고, Running Time Lock으로 앞으로 몇 시간 동안 진행할 작업의 일정을 고정하세요.
- 구조체 버전. XL API 구조체에는 Wersja 필드가 있습니다. 사용하는 ERP XL 릴리스에 맞게 설정하고, 매년 업그레이드 후 다시 테스트하세요.
- 폴란드식 단위와 시간. 데이터를 가져올 때 공정 시간과 캘린더 단위를 정확히 변환해야 합니다. 그렇지 않으면 모든 소요 시간이 잘못됩니다.
Comarch ERP XL 연동 설정 및 지원 담당
- SkyPlanner 팀이 온보딩 중 연동을 설정하고 정식 가동 후에도 지원합니다. 지원 범위는 합의된 데이터 읽기와 XL API 호출입니다. 공장마다 Comarch ERP XL 운영 방식이 다르므로, 그에 대한 실무 지식을 이 과정에 반영합니다.
- 기존 Comarch 파트너도 참여할 수 있습니다. 파트너는 고객사의 구성, 라이선스, XL API를 잘 알고 있으므로 SkyPlanner 팀과 함께 사용자 계정, 읽기 연결, 역전송 호스트를 설정할 수 있습니다.
- 사내 개발자가 연동 기능을 확장할 수도 있습니다. API 토큰으로 SkyPlanner의 REST API를 사용하면 됩니다. API 토큰만 있으면 시작할 수 있으며, 필요할 때 SkyPlanner 팀이 지원합니다. 연동 관련 문서는 SkyPlanner 연동 문서에서 확인하세요.
SkyPlanner는 작업장 5개를 포함해 월 199 €부터 시작하며 매월 청구됩니다. 연동 비용은 고객사의 프로세스와 요구 사항을 기준으로 요금제와 함께 사전에 견적을 제시합니다. 요금 안내, Comarch ERP XL 생산 스케줄링, Comarch ERP XL 페이지, ERP 연동 안내를 확인하세요.
제조업 고객의 SkyPlanner 후기
2시간매주 절약
“SkyPlanner 덕분에 Excel 스프레드시트로 생산 계획을 세우던 방식에서 벗어나 실시간으로 생산을 최적화하게 되었습니다.”
Kalle Kalliomäki, 공급망 전문가
UTU · 전기 배전반 및 개폐장치
생산 계획 업무에서 매주 2시간을 절약하고, 새로운 작업 대기열을 몇 초 만에 생산 라인에 전달합니다.
+90%생산 효율
“생산 효율이 90% 향상되었습니다.”
Abdul Rucyinga, IT 책임자
Laboratory & Allied · 의약품 제조
생산 효율이 90% 향상되었으며, 모든 작업장을 대상으로 석 달간의 최적화된 계획을 수립하는 데 30분도 걸리지 않습니다.
6개월앞까지 영업팀이 여유 생산능력 확인
“SkyPlanner는 모든 생산 계획의 기반을 마련하고 신뢰성을 높여 줍니다.”
Anu Järvinen, 생산 관리자
Fredman Operations · 식품용 포장지
영업팀은 여섯 달 앞까지 여유 생산능력을 확인할 수 있습니다. 한 시간 이상 걸리던 일정 변경 요청에도 몇 초 만에 답변합니다.
100%2021년부터 유지한 납기 준수율
“SkyPlanner 덕분에 생산능력을 파악하고 예측 가능한 계획을 세울 수 있습니다.”
Dan Berglund, COO/CFO
Opes Corporation · 화학제품 및 식품 제조
SkyPlanner를 도입한 2021년부터 사용 기간 내내 납기 준수율 100%를 유지하고 있습니다.
자주 묻는 질문
Comarch ERP XL에 생산 오더용 API가 있나요?
네. XL API(CDN_API.DLL)는 생산 오더를 생성하고, XLZamknijZlecenieProd로 계획 및 재계획을 수행하며, XLDodajTerminDoProcesuProd로 공정 일시를 추가하고, XLDodajRealizacjeOperacjiProd로 실적을 전송합니다. Comarch ERP XL Web은 Swagger에 문서화된 REST 마이크로서비스도 제공합니다.
계획된 일시는 Comarch ERP XL에 어떻게 역전송되나요?
XLDodajTerminDoProcesuProd를 통해 각 생산 오더의 공정에 기간(TerminOd, TerminDo)을 추가합니다. 일정이 변경될 때마다 SkyPlanner 웹훅이 이 호출을 실행합니다.
Comarch ERP XL은 웹훅을 지원하나요?
외부로 전송하는 웹훅은 문서에 명시되어 있지 않으므로, 연동 시 공장별로 정한 주기에 따라 ERP XL을 폴링합니다. SkyPlanner 자체 웹훅은 일정 변경이 발생하는 즉시 이를 전송합니다.
Comarch 파트너는 Comarch APS와 SkyPlanner 중 무엇을 제안해야 하나요?
고객이 몇 주 안에 실제 생산능력을 반영한 일정을 수립하고 이후에도 자동으로 최신 상태를 유지하기 원한다면 SkyPlanner를 제안하세요. Comarch APS는 자체 PostgreSQL 데이터베이스, 연동 도구, 라이선스 키를 사용하는 별도 애플리케이션입니다. 계획 담당자가 클릭해야 동기화되며, 셋업 시간은 공정마다 하나의 고정값으로 지정됩니다(Comarch APS 도움말). SkyPlanner는 자동으로 재계획하고 전환 작업, 공구, 작업조, 자재를 계획하는 클라우드 소프트웨어로, 월 199 €부터 이용할 수 있습니다.
