Sage 200 연동 가이드 SkyPlanner APS를 활용한 생산 스케줄링
이 Sage 200 연동 가이드는 비즈니스 파트너와 IT 팀을 위해 Sage 200 Professional 및 제조 애드온을 SkyPlanner APS에 연결하는 방법을 설명합니다. SkyPlanner와 Sage 200은 다음과 같이 양방향으로 연동됩니다.
- Sage 200 REST API를 통해 제품, 창고 재고, 구매 주문, 판매 주문을 가져옵니다.
- 제조 애드온에서 작업 지시, 공정, 인력 및 설비 자원을 가져옵니다.
- 계획된 공정 일정을 작업 지시에 반영합니다.
- 작업자의 시간 기록을 다시 전송해 각 공정의 작업 시간으로 등록합니다.
SkyPlanner 팀은 온보딩 과정에서 고객의 Sage 200 환경에 맞게 연동을 구성하고, 가동 후에도 지원합니다. 이 가이드는 연동 작업에 참여하거나 SkyPlanner의 문서화된 REST API(API 참조 문서)를 활용해 직접 개발하려는 파트너와 개발자를 위한 문서입니다.
하나의 Sage 200 시스템, 두 가지 데이터 소스
Sage 200을 사용하는 제조 환경은 두 계층으로 구성되며, 연동 시 두 계층의 데이터를 모두 읽습니다.
1. 상거래 및 재고 데이터를 제공하는 Sage 200 REST API. Sage는 이 API가 “lets your application read and modify data in a Sage 200 site”(애플리케이션에서 해당 사이트의 데이터를 읽고 수정할 수 있도록 한다)고 설명합니다. 고객, 공급업체, 제품, 판매 및 구매 주문, 총계정원장 계정이 여기에 포함됩니다. Sage 200 Professional 참조 문서(2025.02)는 리소스를 Cash Book, Commercials, Financials, General, Nominal, POP, Price Book, Purchases, Sales, SOP, Stock으로 분류합니다. 스케줄링에 필요한 주요 리소스는 다음과 같습니다.
| 리소스 | 포함 데이터 |
|---|---|
products | 코드, 이름, 재고 단위, BOM 품목 유형, 표준 원가 |
warehouse_holdings | quantity_in_stock, quantity_on_order, quantity_allocated_bom, free_stock_available, is_default_manufacturing_warehouse |
pop_orders, pop_order_lines | 미결 구매 주문, line_quantity, requested_delivery_dates |
sop_orders, sop_order_lines | 고객 수요, requested_delivery_date, promised_delivery_date |
warehouses, units | 사업장 및 측정 단위 |
2. 작업 지시를 제공하는 제조 애드온. Sage 200 API에는 작업 지시, 공정, 자원 엔드포인트가 없습니다. 작업 지시는 Sicon Works Order Processing, Cim200 또는 기존 Sage 200 Manufacturing 모듈에서 관리합니다. 연동 시에는 애드온이 지원하는 경로로 작업 지시, 공정, 자원을 읽습니다. 이 경로는 범위 산정 단계에서 고객 및 Sage 200 파트너와 협의해 정합니다.
인증 및 접근 권한
Sage 200 API는 “uses OAuth 2.0 with OpenID Connect”(OpenID Connect와 OAuth를 함께 사용)하며, 인증 코드 부여 흐름을 따릅니다. 로그인은 Sage ID를 통해 이루어집니다.
- Sage 200 API Developer Programme에 가입하고 인증 정보를 요청합니다.
- 사용할 엔드포인트에 필요한 회사 및 기능 접근 권한을 가진 Sage 200 사용자에게 Sage ID를 매핑합니다.
offline_access범위를 요청합니다. 요청하지 않으면 갱신 토큰이 발급되지 않습니다.- 모든 데이터베이스 요청에
Authorization: Bearer <access_token>,X-Site,X-Company를 전송합니다. 두 ID는 모두/sites에서 가져옵니다.
Sage 200 Professional의 기본 URL은 https://api.columbus.sage.com/uk/sage200extra/accounts/v1입니다. 요청에는 GET, POST, PUT, DELETE 메서드와 OData 쿼리 옵션인 $filter, $select, $top, $skip, $orderby, $expand를 사용합니다.
Sage 200 Professional에서는 고객의 지원 서비스 제공업체가 API를 활성화합니다. Sage 체크리스트에 따라 “the API is enabled”(API가 활성화되어 있음)와 “each required user has a Sage ID assigned.”(필요한 각 사용자에게 Sage ID가 할당되어 있음)를 확인합니다. Sage 200 Standard는 API가 기본적으로 활성화되어 있습니다.
연동 설계 시 토큰 유효 기간을 고려해야 합니다. 액세스 토큰은 8시간 동안 유효합니다. 갱신 토큰의 유효 기간은 1~90일이며, “The refresh window is measured from the user’s initial sign-in, not from the most recent refresh.”(갱신 가능 기간은 마지막 갱신 시점이 아니라 사용자의 최초 로그인 시점부터 계산됩니다.) Sage는 재인증에 대해 “is unavoidable”(피할 수 없음)이라고 명시합니다. 갱신 가능 기간이 끝나기 전에 재동의 알림이 오도록 설계하세요.
SkyPlanner의 REST API는 API 토큰(SkyPlanner Settings > API)으로 인증하며, Swagger/OpenAPI 문서가 제공됩니다. 연동 튜토리얼에서 첫 API 호출 과정을 단계별로 안내합니다.
변경 사항 감지
Sage 200 API 참조 문서에는 웹훅이나 구독 리소스가 없습니다. 변경 사항은 폴링으로 감지합니다. 레코드에 date_time_created와 date_time_updated가 있으므로, 폴링할 때마다 $filter로 date_time_updated를 필터링하고 $top과 $skip으로 페이지를 나누어 조회합니다.
작업 지시는 몇 분마다, 재고와 구매 주문 항목은 매시간 폴링합니다. SkyPlanner는 일정이 변경되면 웹훅을 전송하므로, Sage 200으로 결과를 반영하는 처리는 이벤트 기반으로 이루어집니다.
데이터 매핑
| Sage 200 객체(원본) | SkyPlanner 객체 | 방향 | 주기 |
|---|---|---|---|
products, units (API) | 제품 및 자재 | Sage 200 → SkyPlanner | 초기 적재 후 폴링 |
| BOM 구성품(애드온 또는 BOM 모듈) | 제품 구조, 하위 제품, 제품별 자재 | Sage 200 → SkyPlanner | 변경 시 |
| 인력 및 설비 자원, 자원 그룹(애드온) | 작업장, 작업장 그룹, 인력 | Sage 200 → SkyPlanner | 초기 적재 |
| 자원 가용성: 가동 중단, 유지보수, 휴일(애드온) | 교대 근무, 부재 | Sage 200 → SkyPlanner | 매일 |
| 작업 지시 및 해당 공정, 공정별 소요 시간(애드온) | 단계, 소요 시간, 납기가 포함된 주문 및 작업 | Sage 200 → SkyPlanner | 몇 분마다 |
sop_order_lines: requested_delivery_date, promised_delivery_date (API) | 고객 납기 | Sage 200 → SkyPlanner | 폴링 |
warehouse_holdings: quantity_in_stock, free_stock_available (API) | 재고 잔량 | Sage 200 → SkyPlanner | 매시간 |
pop_order_lines: line_quantity, requested_delivery_dates (API) | 예상 납품일이 포함된 구매 주문 | Sage 200 → SkyPlanner | 매시간 |
| 작업 지시 공정의 계획 시작·종료 시점 및 자원 | 공정별 계획 시작·종료 시점 및 작업장 | SkyPlanner → Sage 200 | 변경 시 웹훅으로 전송 |
| 공정 작업 시간 등록(애드온) | 시간 기록 및 작업자 실적 등록 | SkyPlanner → Sage 200 | 실적 등록 시마다 또는 교대 근무별 |
| SkyPlanner 제약 조건 데이터 | 준비·전환 시간 매트릭스, 수량이 제한된 자원으로 관리하는 공구, 대체 설비 및 인력 | SkyPlanner에서 관리 | 온보딩 시 |
연동 패턴
1. 기준정보 초기 적재. API에서 제품과 단위를 가져온 다음, 애드온에서 자원, 자원 그룹, BOM 공정을 가져옵니다. 동일한 설비 세 대로 구성된 자원 그룹은 하나의 작업장 그룹 또는 세 개의 작업장으로 구성할 수 있습니다.
2. 주문 동기화. 애드온에서 미결 작업 지시와 해당 공정을 읽고, API에서 미결 pop_order_lines 및 warehouse_holdings를 읽습니다. 스케줄링 시 현재 재고와 구매 입고 예정량을 모두 확인합니다. MRP는 Sage 200에서 계속 작업 지시를 제안하고, SkyPlanner는 사용자가 생성한 작업 지시의 일정을 잡습니다.
3. 스케줄링 결과 반영. 엔진이 배치하거나 이동한 모든 공정에 대해 SkyPlanner가 계획 시작·종료 시점과 자원을 작업 지시에 다시 전송합니다. 수량, 할당, 원가 계산은 애드온이 계속 자체 관리합니다.
4. 생산 현장 실적 등록. 작업자는 SkyPlanner Mobile Confirmations 또는 Production Timer로 작업을 기록하며, 이 시간 기록을 통해 일정이 최신 상태로 유지됩니다. 기록된 시간은 작업 지시의 해당 공정에 작업 시간으로 다시 등록되므로, Sage 200의 원가 계산에 실제 작업 시간이 반영됩니다.
공장에서 이미 Sicon Shop Floor Data Capture 또는 Cim200 Shop Floor Data Capture로 작업 시간을 등록하고 있다면, 시간 등록 채널은 하나만 선택하세요.
5. 데이터 관리 주체 및 충돌 처리 규칙. 가동 전에 다음 사항을 문서로 정리하세요.
| 데이터 | 관리 주체 |
|---|---|
| 제품, BOM, 제조 오더 수량, 할당, 원가 | Sage 200 및 애드온 |
| 공정 순서, 시작 및 종료 시각, 작업장 배정 | SkyPlanner |
| 준비 시간 매트릭스, 공구 및 작업자 요건, 대체 자원 | SkyPlanner |
| 작업 시간 등록 | Sage 200에서 관리하며, SkyPlanner의 시간 기록을 수신 |
충돌이 주로 발생하는 곳은 생산 능력 차트입니다. 계획 담당자가 Sicon Rough Cut Capacity Planning이나 Cim200 Graphical Scheduler에서 제조 오더나 공정을 계속 드래그해 옮기면 두 시스템이 일정을 동시에 관리하게 됩니다. 공정 일정은 SkyPlanner에서 관리하도록 하세요. Autopilot을 사용하면 생산 상황이 바뀔 때 SkyPlanner가 자동으로 일정을 다시 편성합니다.
일반적인 프로젝트 진행 단계
구축은 보통 온보딩을 시작한 뒤 몇 주 내에 완료됩니다. 그 전에 미완료 제조 오더를 CSV나 Excel로 내보내 30일 무료 체험에서 일정을 검증하세요. 이후 프로젝트는 다음 순서로 진행됩니다.
- 범위 산정. 애드온과 버전, 제조 오더 조회 경로, 결과를 다시 기록할 경로, 동기화 주기, 작업 시간 등록 채널을 확인합니다.
- API 접근 설정. 지원 업체가 Sage 200 API를 활성화하고 Sage ID를 Sage 200 사용자에 매핑한 뒤 회사 및 기능별 접근 권한을 설정합니다.
- 초기 데이터 적재. 제품, 단위, 자원, 자원 그룹, BOM 공정 및 가용성 정보를 적재합니다.
- 오더 동기화. 폴링으로 제조 오더, 구매 오더 품목, 재고를 동기화하고 재동의 알림을 설정합니다.
- SkyPlanner에서 제약 조건 설정. 준비 시간 매트릭스, 공구, 작업별 작업자 수, 대체 설비 또는 인력을 설정합니다.
- 일정 기록. 계획된 공정 일정을 제조 오더에 다시 기록합니다. 이 단계에서 작업 시간 등록도 추가합니다.
- 병행 테스트 및 정식 가동. 기존 계획과 일정을 비교하고 기준정보를 수정한 뒤, 결과를 다시 기록하는 기능을 활성화합니다.
Sage 200 연동 시 미리 고려할 사항
- 새 버전에서 지원이 종료된 모듈. 기존 Sage 200 Manufacturing 모듈은 Sage 200 Professional 2025 R2부터 사용할 수 없습니다. 매핑을 시작하기 전에 정식 가동 시 어떤 제조 솔루션을 사용할지 확인하세요.
- 원가 데이터로 산정하는 공정 시간. Sicon MRP는 Sage 200 BOM의 원가 항목을 기준으로 인력 작업 시간과 설비 가동 시간을 추정합니다. 먼저 실제 소요 시간과 비교해 확인하세요.
- 원가 항목 설정 불일치. Sage는 BOM 공정과 원가 항목의 Nominal, Overhead Nominal, Overhead Recovery %가 일치해야 하며, 그렇지 않으면 “there will be cost discrepancies.”(원가 차이가 발생합니다)라고 경고합니다.
- 갱신 기한. 최대 90일의 기한은 최초 로그인부터 계산됩니다. 재동의를 하지 않는 연동은 분기마다 같은 날에 중단됩니다.
- 여러 회사가 있는 사이트. 한 사이트에 여러 회사가 있을 수 있으므로 모든 요청에 올바른
X-Company를 전송하세요.
Sage 200 연동 구성 및 지원 담당
- SkyPlanner 팀이 온보딩 중에 연동을 구성하고 정식 가동 후에도 지원합니다.
- 거래 중인 Sage 200 비즈니스 파트너도 참여할 수 있습니다. 파트너는 고객이 사용하는 애드온을 잘 알고 있으며 Sage 200 Professional에서 API를 활성화합니다.
- 사내 개발자도 연동을 개발할 수 있습니다. 문서가 제공되는 동일한 REST API에 API 토큰으로 접근하면 됩니다. API 토큰만 있으면 시작할 수 있으며, 필요할 때 SkyPlanner 팀이 지원합니다.
연결이 완료되면 Arcturus 엔진이 Sage 200의 실시간 제조 오더를 바탕으로 일정을 편성하고, 계획된 일정이 제조 오더의 공정에 반영됩니다. SkyPlanner는 작업장 5개를 포함해 월 199 €부터 시작하며 매월 청구됩니다. 연동 비용은 고객의 프로세스와 요구 사항에 맞춰 요금제와 함께 사전에 견적을 제공하므로, 시작 전에 전체 비용을 확인할 수 있습니다. 요금과 기능을 살펴보고, Sage 200 생산 스케줄링에서 Sage 200 자체 계획 기능과 비교해 보세요. 전체 개요는 Sage 200 페이지에서, 다른 ERP는 ERP 연동 안내에서 확인할 수 있습니다.
제조업체의 SkyPlanner 사용 후기
2시간매주 절약
“SkyPlanner 덕분에 Excel 스프레드시트로 생산 계획을 세우던 방식에서 벗어나 실시간으로 생산을 최적화하게 되었습니다.”
Kalle Kalliomäki, 공급망 전문가
UTU · 배전반 및 개폐장치
생산 계획 업무에서 매주 2시간을 절약하며, 새로운 작업 대기열이 수초 내에 생산 라인에 전달됩니다.
1,000s작업 오더 일정 자동 편성
“이전과는 다른 방식으로 생산을 관리하게 되었고, 생산 능력을 파악하는 수준도 완전히 달라졌습니다.”
Hannu Ryynänen, 대표
Mamec · 산업용 혼합기, 펌프 및 첨단 위탁 제조
수천 건의 작업 오더 일정이 자동으로 편성되고, 조직 전체가 생산 현황을 실시간으로 파악합니다.
자주 묻는 질문
Sage 200 API에 제조 오더가 포함되어 있나요?
아니요. Sage 200 Professional API는 제품, 재고, 판매 및 구매 오더, 재무 등을 지원하지만 제조 오더나 공정 리소스는 제공하지 않습니다. 제조 오더는 범위 산정 단계에서 합의한 경로를 통해 Sicon Works Order Processing이나 Cim200 같은 제조 애드온에서 가져옵니다.
Sage 200 연동은 누가 구축하나요?
SkyPlanner 팀이 온보딩 중에 고객의 Sage 200 환경에 맞춰 양방향 연동을 구성하고 정식 가동 후에도 지원합니다. Sage 200 비즈니스 파트너는 API를 활성화하며 프로젝트에도 참여할 수 있습니다. 사내 개발자도 문서가 제공되는 SkyPlanner의 REST API로 개발할 수 있으며, API 토큰만 있으면 시작할 수 있습니다.
Sage 200에서 변경 사항을 실시간으로 푸시할 수 있나요?
Sage 200 API는 웹훅을 제공하지 않습니다. 재고와 구매 오더는 date_time_updated를 기준으로 폴링하고, 제조 오더는 몇 분마다 애드온에서 읽어 옵니다. 반대 방향에서는 SkyPlanner 자체 웹훅이 일정 변경 사항을 발생 즉시 푸시합니다.
