Sylob ERP 연동 가이드 SkyPlanner APS를 활용한 생산 스케줄링
이 가이드는 파트너와 IT 팀을 대상으로 Sylob ERP를 SkyPlanner APS에 연결하는 방법을 설명합니다. SkyPlanner와 Sylob ERP는 다음과 같이 양방향으로 연동됩니다.
- Articles, nomenclatures, gammes, 작업 센터, 직원, OF, 재고, 구매 발주 데이터를 SkyPlanner로 가져옵니다.
- 공정별 계획 시작·종료 시각과 작업 센터를 OF 공정에 다시 반영합니다.
- 작업자의 시간 기록은 생산 실적으로 다시 전달됩니다.
- SkyPlanner 웹훅은 일정이 변경되는 즉시 변경 사항을 전송합니다.
SkyPlanner 팀은 온보딩 과정에서 고객의 Sylob 환경에 맞게 연동을 설정하고, 운영 개시 후에도 지원합니다. 이 가이드는 연동 작업에 참여하거나 SkyPlanner의 문서화된 REST API(API 참조 문서)를 활용해 직접 개발하려는 파트너와 개발자를 위한 문서입니다.
Sylob ERP 인터페이스
Sylob 문서에는 공개 REST API 두 가지가 설명되어 있습니다. “L’ERP Sylob expose deux types d’API REST publiques (autrement nommées \”webservices\”) qui autorise la lecture et l’écriture de données.”(Sylob ERP는 데이터를 읽고 쓸 수 있는 두 가지 공개 REST API, 즉 웹 서비스를 제공합니다.) (Forterro 기술 자료)
- API REST Système d’information(읽기). “Interroger le système d’information” 기능에서 만든 저장 쿼리(requête)를 실행합니다. 쿼리별 호출 URL은 “Autres actions” > “Afficher le web service”에서 확인할 수 있으며, 형식은
/rest/query/{identifiantQuery}/resultat입니다. 매개변수로 결과 수 제한, 숫자 형식, 쿼리 변수, 결과 구조를 설정합니다. 기본 응답 형식은 XML이며,Accept: application/json헤더를 사용하면 JSON으로 받습니다. 이 API는 ERP에 포함되어 있습니다. - API REST Action(읽기 및 쓰기). Sylob의 액션 카탈로그인 “Gérer les actions web service” 기능에서 정의한 액션을 실행합니다. 두 가지 호출을 제공합니다.
GET /rest/v2/action/{code}/describe는 액션의 데이터 스키마를 반환하고,POST /rest/v2/action/{code}/execute는 JSON 본문으로 액션을 실행합니다. 액션 유형은 다음과 같습니다.
– Modification de données: Sylob의 빠른 편집 기능을 통해 레코드의 필드를 하나 이상 변경합니다. Describe는 편집 가능한 필드 목록을 반환합니다. – Message EDI: EDI 메시지로 레코드를 생성, 변경 또는 삭제합니다. – Scénario de saisie: 질문 순서에 따라 입력 시나리오를 실행합니다. Sylob이 제공하는 예로는 공정의 시작 또는 종료를 신고하는 “Déclarer un début ou une fin”(Sylob_Action_006)이 있습니다. – 문서 게시, 업로드 및 다운로드.
- EDI 메시지. Sylob EDI 엔진이 데이터 내보내기와 가져오기를 처리합니다. 표준 메시지인 Sylob_Recup_Decl_Pro는 생산 실적을 조회합니다. (Forterro)
- 파일 및 ETL. Sylob ERP Cloud는 “Intégration de fichiers via SFTP pour une migration facile des intégrations existantes.”(기존 연동을 쉽게 이전할 수 있도록 SFTP를 통한 파일 연동을 제공합니다.) (Sylob) 쿼리 결과를 Excel로 내보낼 수도 있어 SkyPlanner 체험을 빠르게 시작할 수 있습니다.
인증
Sylob의 API 접근 방식은 배포 환경에 따라 다릅니다. 모든 호출은 TLS 1.2 기반 HTTPS를 사용합니다. API 인증 정보는 사용자의 ERP 로그인 정보와 별개입니다.
- Sylob ERP Cloud (AWS). OAuth2 / OpenID Connect의
client_credentials흐름과 Amazon Cognito에서 발급한 Bearer 토큰을 사용합니다. 클라이언트 ID, 풀 URL, 시크릿은 “Gérer les paramètres des publications”에서 확인합니다. 토큰 요청에는 라이선스 범위와 회사 범위ERP/<unité de persistance>를 함께 지정합니다. 라이선스 범위는 Système d’information API의 경우ClientExterne/rest_read, Action API의 경우ClientExterne/rest_write입니다. (Forterro) - MyForterro의 Sylob. OAuth2와 OpenID Connect를 사용합니다. 연동용 “application”을 MyForterro에 생성하고, 필요한 역할과 API 라이선스를 할당합니다. (Forterro)
- 온프레미스. 사용자, 영속성 단위, 세션 식별자를 각각 두 개의 @ 기호로 구분해 구성한 로그인 정보로 HTTP Basic 인증을 수행합니다. (Forterro)
연동 전용 사용자나 애플리케이션을 사용하고, 권한은 매핑 표에 있는 쿼리와 액션으로 제한하세요. 액션 카탈로그에 쓰기 권한이 있는 사용자는 Système d’information API를 통해 읽기도 할 수 있으므로, 하나의 연동 계정으로 양방향 처리가 가능합니다.
SkyPlanner의 REST API는 Authorization-Token 헤더에 담은 API 토큰으로 인증하며(SkyPlanner Settings > API), Swagger/OpenAPI로 문서화되어 있습니다. API 토큰만 있으면 시작할 수 있습니다. 연동 튜토리얼에서 첫 API 호출 과정을 안내합니다.
이벤트, 폴링 및 호출 제한
Sylob의 공개 기술 자료에는 외부로 전송하는 웹훅 구독 기능이 명시되어 있지 않습니다. 미완료 OF와 최근 변경 사항을 필터링하는 저장 쿼리를 설정한 주기로 폴링해 SkyPlanner에 변경 사항을 전달합니다.
Sylob은 과도한 쿼리로부터 ERP를 보호합니다. 2025.Q2 릴리스부터 회사 매개변수 “Protection des API”를 통해 사용자별 호출 제한과 대량 결과의 페이지 처리를 활성화할 수 있으며, Sylob은 2026.Q2 릴리스부터 이를 일괄 적용한다고 안내합니다. 응답에는 RateLimit 헤더가 포함되며, 할당량을 초과한 호출에는 Retry-After 값과 함께 HTTP 429 Too Many Requests가 반환됩니다. (Forterro) 이를 고려해 증분 쿼리, 페이지 처리, 429 응답 시 재시도 대기를 적용하도록 동기화를 설계하세요.
반대로 SkyPlanner는 상태나 일정이 변경되면 웹훅을 전송하므로, Sylob으로의 결과 반영은 이벤트 기반으로 이루어집니다.
데이터 매핑
| Sylob ERP 객체 | SkyPlanner 객체 | 방향 | 주기 |
|---|---|---|---|
| Article(구매 또는 제조 품목) | 제품 및 자재 | Sylob → SkyPlanner | 초기 적재 후 변경 시 |
| Nomenclature(다단계) | 제품 구조, 하위 제품, 제품별 자재 | Sylob → SkyPlanner | 최초 적재 후 변경 시 |
| Gamme: 공정, 셋업 시간 및 가공 시간, 작업 센터 | 소요 시간과 셋업 시간이 포함된 공정 단계 | Sylob → SkyPlanner | 최초 적재 후 변경 시 |
| Centre de charge: 자원 수, semaine type 및 예외 | 작업장, 작업장 그룹, 교대 근무, 부재 | Sylob → SkyPlanner | 초기 적재, 이후 캘린더는 매일 동기화하거나 SkyPlanner에서 관리 |
| Employé | 인력 및 교대 근무 | Sylob → SkyPlanner | 초기 적재 후 매일 |
| Ordre de fabrication (OF) 및 해당 공정과 구성품 | 납기와 우선순위가 포함된 주문 및 작업 | Sylob → SkyPlanner | 몇 분 간격으로 저장 쿼리 폴링 |
| 위치별 재고 | 자재 재고 | Sylob → SkyPlanner | 매시간 또는 스케줄링 실행 전마다 |
| 입고 예정 정보가 포함된 Commande fournisseur | 입고일 기준 입고 예정 자재 | Sylob → SkyPlanner | 매시간 또는 스케줄링 실행 전마다 |
| Opération d’ordre de fabrication: 계획 시작·종료 시각, 작업 센터 | 공정별로 배정된 시작·종료 시각과 작업장 | SkyPlanner → Sylob | 일정 변경 시 SkyPlanner 웹훅과 Modification de données 액션으로 전달 |
| 공정 시작 및 종료 | Mobile Confirmations에서 기록한 작업 시작 및 완료 | SkyPlanner → Sylob | 발생 즉시 “Déclarer un début ou une fin” 시나리오로 전달 |
| Déclaration de production: 셋업 시간, 가공 시간, 생산 수량, 불량 수량, 공정 완료 여부 | 시간 기록 및 수량 | SkyPlanner → Sylob | 실적 확인 건별 또는 교대 근무별로 Scénario de saisie 또는 Message EDI 액션을 통해 전달 |
| SkyPlanner 제약 조건 데이터 | 작업 전환 시간 행렬, 가용 수량이 제한된 자원으로 관리하는 공구, 대체 설비 및 인력 | SkyPlanner에서 관리 | 온보딩 중 설정 |
연동 패턴
1. 기준정보 초기 적재. 객체별(articles, nomenclatures, gammes, 작업 센터, 직원)로 저장 쿼리를 하나씩 만들어 Système d’information API로 읽거나, Excel로 내보낸 파일에서 한 번만 적재합니다. 작업 센터 매핑은 신중하게 설계하세요. Sylob의 centre de charge는 자원 그룹이므로, 설비가 세 대인 센터는 일반적으로 SkyPlanner에서 작업장 세 개로 구성된 작업장 그룹에 해당합니다.
2. 주문 동기화. 확정 OF와 해당 공정, 재고, 미결 구매 발주를 읽어옵니다. SkyPlanner는 발주한 자재를 구매 발주의 입고일에 사용 가능한 것으로 처리하고, 구매 발주가 Delivered 상태로 표시되면 재고를 갱신합니다. 따라서 스케줄링 시 현재 재고와 입고 예정 구매 물량을 모두 확인합니다.
CBN 제안이 아닌 확정 OF를 대상으로 스케줄링하세요. 제안은 다음 순소요량 계산 시 변경됩니다.
3. 스케줄링 결과 반영. 엔진이 배치하거나 이동한 각 공정에 대해, 연동 프로그램은 계획 시작·종료 시각과 작업 센터를 담아 OF 공정(Opération d’ordre de fabrication)의 Modification de données 액션을 호출합니다. 이 액션은 계획 담당자가 공정을 편집할 때와 동일한 Sylob의 빠른 편집 로직으로 실행됩니다. Describe가 편집 가능한 필드를 반환하므로, 연동 프로그램은 첫 호출 전에 페이로드를 검증합니다. 사용자가 편집 중인 레코드는 예상된 실패로 처리됩니다. 다음 변경 시 다시 시도하세요.
4. 생산 현장 실적 등록. 작업자는 SkyPlanner Mobile Confirmations 또는 Production Timer로 작업을 기록합니다. 시작과 완료 정보는 “Déclarer un début ou une fin” 시나리오를 통해 다시 전달됩니다. 시간 기록과 수량은 동일한 OF 공정의 생산 실적으로 반영되며, 셋업 시간, 가공 시간, 생산 수량, 불량 수량, 공정 완료 여부가 포함됩니다. 공장에서 이미 Sylob Apps나 현장 단말기로 실적을 등록하고 있다면, 중복 입력을 피하도록 등록 경로를 하나로 유지하세요.
5. 데이터 관리 주체 및 충돌 처리 규칙. 운영을 시작하기 전에 다음 규칙을 문서화하세요.
| 데이터 | 관리 주체 |
|---|---|
| Articles, nomenclatures, gammes, OF 수량 및 상태 | Sylob ERP |
| 공정 순서, 시작·종료 시각, 공정별 작업장 | SkyPlanner |
| 작업 전환 시간 매트릭스, 공구, 작업자 수, 대체 자원 | SkyPlanner |
| 교대 근무, 캘린더 및 부재 | 범위 산정 시 선택한 하나의 시스템 |
| 생산 실적, 재고 이동, 원가 | SkyPlanner 작업 시간 기록 또는 Sylob Apps에서 데이터를 받는 Sylob ERP |
SkyPlanner에는 CADPLAN이나 Sylob의 유한능력 계획 기능이 필요하지 않습니다. 두 계획 도구가 같은 날짜를 기록하면 서로 덮어쓰므로 공정 일정은 SkyPlanner에서 관리하도록 하세요. SkyPlanner가 공정 일정을 관리하면 유의미한 변경이 발생할 때마다 Autopilot이 자동으로 일정을 재조정하고 새 일정을 Sylob으로 전송합니다.
일반적인 프로젝트 진행 단계
구축은 보통 온보딩 시작 후 몇 주 안에 완료됩니다. 그에 앞서 30일 무료 체험에서 자사 데이터로 테스트할 수 있습니다. Sylob 쿼리에서 미완료 OF, 공정, 작업 센터를 CSV 또는 Excel로 내보내고 SkyPlanner로 가져와 연동 작업에 착수하기 전에 일정을 검증하세요.
- 매핑 워크숍. 매핑 표, 데이터 관리 주체별 규칙, 동기화 주기, 생산 실적 보고 채널을 확정합니다.
- Sylob 설정. 저장된 쿼리, “Gérer les actions web service”의 쓰기 액션, 연동용 사용자 또는 MyForterro 애플리케이션을 생성합니다. 먼저 테스트 회사에서 적용한 뒤 운영 환경에 적용합니다.
- 초기 데이터 적재. Articles, nomenclatures, gammes, 작업 센터, 캘린더를 적재합니다.
- 주문, 재고, 구매 주문 동기화. 페이지 처리와 백오프를 적용한 증분 쿼리를 사용합니다.
- SkyPlanner 제약 조건 설정. 작업 전환 시간 매트릭스, 공구, 작업자 수, 대체 설비 또는 인력을 설정합니다.
- 스케줄링 결과 반영. 계획 일정을 OF 공정에 기록합니다. 생산 실적 보고도 이 단계에서 추가합니다.
- 병행 운영. SkyPlanner의 일정을 현재 계획과 비교하고 생산 기술 데이터를 수정합니다.
- 정식 운영 시작. 데이터가 일치하면 결과 반영 기능을 활성화합니다.
Sylob ERP 연동 시 미리 검토할 사항
- Action API 라이선스. 저장된 쿼리를 통한 읽기 기능은 기본으로 포함됩니다. 액션 카탈로그를 통해 데이터를 쓰려면 Sylob의 “Webservice” 모듈 또는 MyForterro의 API 라이선스가 필요합니다. 결과 반영 단계에 들어가기 전에 Sylob 담당자와 준비하세요.
- 쿼리가 연동 규약입니다. 데이터 읽기는 저장된 쿼리에 의존합니다. 쿼리 이름을 명확하게 지정하고, 실행 시 필터를 변수 속성으로 전달하며, 연동 버전과 함께 쿼리 버전도 관리하세요.
- 작업 센터 그룹. Sylob 작업 센터 하나에 여러 설비를 포함할 수 있습니다. SkyPlanner에서 하나의 작업장 그룹으로 처리할지 개별 설비로 처리할지 센터별로 결정하세요.
- 역방향 스케줄링과 부하 계산. Sylob은 필요일을 기준으로 역방향으로 일정을 잡으며, 예약된 부하 계산을 실행해 지연된 OF의 일정을 다시 계획할 수 있습니다. SkyPlanner가 공정 일자를 관리하기 시작한 뒤에도 Sylob에서 공정 일자를 기록하는 기능을 계속 사용할지, 사용한다면 어떤 기능을 사용할지 합의하세요.
- 셋업 시간과 가동 시간의 단위. 데이터를 가져오기 전에 시간 단위와 셋업 시간이 OF당 기준인지 개당 기준인지 확인하세요. 단위가 잘못되면 모든 소요 시간이 왜곡됩니다.
- 캘린더. 작업 센터의 주간 근무 패턴과 예외 일정은 스케줄링 대상 기간 전체를 포함해야 합니다. 그렇지 않으면 계획에서 가용 생산능력이 누락됩니다.
- 호출 제한. Sylob은 사용자별 호출 수를 제한하고 대량의 결과를 페이지 단위로 반환합니다. 증분 폴링을 사용하면 호출 한도 내에서 충분한 여유를 두고 처리할 수 있습니다.
- CORS와 브라우저. 서버 간 호출에는 CORS가 적용되지 않습니다. 브라우저 클라이언트를 사용하려면 Sylob 측에서 허용할 출처를 설정해야 합니다.
Sylob ERP 연동 설정과 지원은 누가 담당하나요?
연동 작업에는 gammes, 작업 센터, OF 매핑과 Sylob 측의 저장된 쿼리 및 카탈로그 액션 설정이 포함됩니다. 작업 전환 시간 매트릭스와 공구 등 SkyPlanner의 제약 조건도 설정합니다.
- SkyPlanner 팀이 온보딩 중에 연동을 설정하고 정식 운영 이후에도 지원합니다. 공장마다 Sylob 쿼리, gammes, 작업 센터의 구성이 다릅니다. 이 과정에서 각 공장의 운영 노하우를 반영합니다.
- 기존 Sylob 파트너나 연동 구축 업체도 참여할 수 있습니다. 이들은 귀사의 쿼리, 추가 속성, 액션 카탈로그를 잘 알고 있으며 API 접근을 설정할 수 있습니다. SkyPlanner는 REST API, Swagger/OpenAPI 문서, 웹훅을 제공합니다.
- 사내 개발자가 직접 개발할 수도 있습니다. API 토큰으로 동일한 REST API를 이용하면 됩니다. 필요할 때 SkyPlanner 팀이 지원합니다. 제품 문서는 SkyPlanner 문서에서 공개적으로 확인할 수 있습니다.
SkyPlanner는 작업장 5개를 포함해 월 199 €부터 시작하며 매월 청구됩니다. 귀사의 프로세스와 요구 사항에 맞춰 연동 비용과 요금제 비용의 견적을 사전에 제공하므로, 시작 전에 전체 비용을 확인할 수 있습니다. Sylob의 생산능력 계획 방식은 Sylob ERP는 실제 생산능력을 반영한 생산 스케줄링을 지원하나요?에서, 연동 개요는 Sylob ERP 페이지에서 확인하세요. 다른 시스템은 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%를 유지하고 있습니다.
98%약 50%에서 향상된 납기 준수율
“SkyPlanner는 납기 준수율을 유지하는 데 결정적인 역할을 합니다.”
Hannu Lahtinen, 대표이사
KJH-Comp · 판금 가공 및 위탁 제조
납기 준수율은 약 50%에서 최대 98%까지 높아졌으며, 두 명이 담당하던 스케줄링을 이제는 관리자 한 명이 담당합니다.
자주 묻는 질문
연동에는 어떤 Sylob API를 사용하나요?
공개 REST API 두 가지를 모두 사용합니다. Système d’information API는 저장된 쿼리에서 OF, gammes, 작업 센터, 재고, 구매 주문을 읽습니다. Action API는 Sylob 액션 카탈로그를 통해 OF 공정에 계획 일정을 기록하고 생산 실적을 다시 반영합니다.
Sylob ERP는 웹훅을 지원하나요?
Sylob의 공개 지식 베이스에는 아웃바운드 웹훅 구독이 문서화되어 있지 않습니다. 변경 사항은 몇 분마다 저장된 쿼리를 증분 폴링하여 SkyPlanner에 전달합니다. Sylob으로의 쓰기 반영은 SkyPlanner 자체 웹훅을 통해 이벤트 기반으로 처리합니다.
계획 일정은 Sylob의 어디에 기록되나요?
OF의 각 공정(Opération d’ordre de fabrication)에 계획 시작일, 계획 종료일, 작업 센터를 기록합니다. 수량, 상태, 구성품, 원가는 Sylob에서 계속 관리합니다.
작업자의 작업 시간은 Sylob에 어떻게 반영되나요?
OF 공정의 생산 실적으로 반영됩니다. 셋업 시간, 가동 시간, 생산 수량, 불량 수량, 공정 완료 여부가 포함됩니다. 시작과 종료는 Action API를 통해 “Déclarer un début ou une fin” 시나리오로 처리합니다.
Sylob Cloud와 온프레미스 모두 연동할 수 있나요?
네. Sylob ERP Cloud, MyForterro, 온프레미스 모두 동일한 REST API 두 가지를 제공합니다. 인증 방식만 다릅니다. 클라우드에서는 Cognito 또는 MyForterro를 통한 OAuth2를 사용하고, 온프레미스에서는 Basic 인증을 사용합니다.
Sylob 연동 구축 업체는 CADPLAN과 SkyPlanner 중 무엇을 제안해야 하나요?
고객이 공장 전체에 실시간 일정을 빠르게 적용하고자 한다면 SkyPlanner를 제안하세요. SkyPlanner는 월 199 €부터 Sylob REST API를 통해 기존 OF와 gammes를 읽고, 자동으로 일정을 재계획하며, 작업 전환, 공구, 작업조, 자재를 계획하고 작업자에게 Mobile Confirmations를 제공합니다. CADPLAN은 자체 공정 설계 데이터를 바탕으로 계획 담당자가 정의한 시뮬레이션을 실행합니다. (Forterro 교육 프로그램)
