Sage 100 연동 가이드 SkyPlanner APS로 생산 스케줄링하기
이 가이드는 Sage 파트너와 IT 팀을 대상으로 Sage 100과 SkyPlanner APS를 연결하는 방법을 설명합니다. Sage 100이라는 이름을 사용하는 두 제품을 모두 다룹니다. 미국과 캐나다에서는 Production Management를 사용하는 Sage 100, 독일과 오스트리아에서는 Sage 100 Produktion을 사용하는 Sage 100이 대상입니다. SkyPlanner는 Sage 100과 다음과 같이 양방향으로 연동됩니다.
- 작업 지시서 또는 Fertigungsaufträge와 그에 속한 공정 단계 또는 Arbeitsgänge를 가져옵니다. 작업 센터, 품목, 재고, 구매 주문도 함께 가져옵니다.
- 계획 일정을 각 공정 단계 또는 Arbeitsgang에 다시 전송합니다.
- 작업자의 작업 시간 기록은 미국 버전에서는 노무 실적으로, 독일 버전에서는 Rückmeldungen으로 다시 전송합니다.
SkyPlanner 팀은 온보딩 과정에서 고객의 Sage 100 환경에 맞게 연동을 구성하고, 운영을 시작한 후에도 지원합니다. 이 가이드는 연동 작업에 참여하거나 SkyPlanner의 문서화된 REST API(API 참조 문서)를 활용해 직접 개발하려는 파트너와 개발자를 위한 안내서입니다.
미국 Sage 100: 연동 인터페이스
미국 Sage 100은 Standard, Advanced 또는 Premium을 온프레미스로 설치해 운영합니다. 연동 인터페이스는 Sage 100 서버에 있습니다.
Business Object Interface (BOI).
“The Business Objects Interface allows third-party developers with the necessary skills to access Sage 100 programs and applications using Component Object Model (COM).”(필요한 기술을 갖춘 외부 개발자는 Business Objects Interface를 통해 Component Object Model (COM)을 사용하여 해당 제품의 프로그램과 애플리케이션에 접근할 수 있습니다.) (Sage 100 도움말) Sage 개발자 포털에서는 이를 “Sage 100’s internal API layer, giving you access to the same logic used by the application itself.”(애플리케이션 자체에서 사용하는 것과 동일한 로직에 접근할 수 있는 제품 내부 API 계층)이라고 설명합니다. (developer.sage.com) BOI는 데이터를 쓰는 경로입니다. 모든 생성 및 업데이트에는 사용자가 Sage 100에서 작업할 때와 동일한 검증이 적용됩니다.
ODBC.
ProvideX ODBC 드라이버는 보고서 작성과 대량 조회를 위해 Sage 100 테이블을 읽습니다. Advanced에서는 클라이언트/서버 ODBC 드라이버를 사용할 수 있습니다. 연동 시 작업 지시서, 품목, 구매 주문은 ODBC로 대량 조회하고, 데이터 쓰기에는 BOI를 사용합니다.
Visual Integrator (VI).
VI의 가져오기 및 내보내기 작업은 Sage 100과 파일 또는 ODBC 데이터 원본 사이에서 데이터를 이동합니다. Sage는 다음과 같이 설명합니다. “One of the most powerful features of the Visual Integrator module is its ability to directly import data from and export data to an ODBC data source.”(Visual Integrator 모듈의 가장 강력한 기능 중 하나는 ODBC 데이터 원본에서 데이터를 직접 가져오고 내보낼 수 있다는 점입니다.) (출처) VI는 Essentials 패키지에 포함되어 있으며 파일 기반 데이터 교환에 적합합니다.
eBusiness Web Services는 SOAP 기반이며 “the Sage 100 sales order, customer, and customer contact entities.”(해당 제품의 판매 주문, 고객, 고객 연락처 엔터티)를 지원합니다. (출처) 판매 주문은 이 서비스로 전송할 수 있으며, 생산 데이터는 BOI와 ODBC를 통해 처리합니다.
연동 프로그램은 Sage 100과 함께 실행되며, 사용하는 Production Management, Inventory, Purchase Order 작업에 대한 권한이 있는 Sage 100 사용자 계정으로 동작합니다. 외부로 나가는 트래픽은 HTTPS를 통해 SkyPlanner의 REST API로 전송됩니다.
독일 Sage 100: 연동 인터페이스
독일 Sage 100은 로컬 설치형 또는 클라우드형으로 제공되며 Microsoft SQL Server에서 실행됩니다. Sage는 “Partnerlösungen via API-Schnittstelle ergänzen”(API 인터페이스를 통해 파트너 솔루션을 추가할 수 있음)이라고 설명합니다. (Sage 100) Sage에 등재된 생산용 추가 기능은 Sage AppDesigner와 Sage 100 비즈니스 객체를 기반으로 합니다.
연동에는 Sage 파트너 솔루션과 동일한 경로를 사용합니다. Sage 100 SQL Server 데이터베이스에서 Fertigungsaufträge, Arbeitsgänge, Arbeitsplätze, Ressourcenlisten, Artikel, Bestellungen을 읽습니다. Arbeitsgang 일정과 Rückmeldungen은 범위 산정 단계에서 Sage 파트너와 SkyPlanner 팀이 정한 쓰기 경로로 다시 전송하므로, 실적 등록에는 Sage 100 자체 로직이 적용됩니다. Sage 파트너가 버전(예: 9.0)과 접근 설정을 확인합니다.
인증 및 접근
| 연동 대상 | 인증 방식 |
|---|---|
| 미국 Sage 100, BOI | Sage 100 서버의 Sage 100 사용자 세션. 사용하는 각 작업에 대한 역할별 권한 필요 |
| 미국 Sage 100, ODBC | Sage 100 설치 환경의 DSN, 읽기 권한 |
| 독일 Sage 100 | Sage 파트너와 협의한 역전송용 Sage 100 사용자 계정 및 SQL Server 읽기 권한 |
| SkyPlanner | SkyPlanner Settings > API에서 생성하여 Authorization-Token 헤더에 넣는 API 토큰 |
SkyPlanner의 REST API는 Swagger/OpenAPI로 문서화되어 있습니다. 연동 튜토리얼에서 첫 API 호출 과정을 단계별로 안내합니다.
변경 사항 감지
Sage 100의 변경 사항은 정기 조회로 감지합니다. 미완료 작업 지시서 또는 Fertigungsaufträge는 짧은 주기로, 재고와 구매 주문은 매시간 조회하세요. 상태와 변경 일자로 필터링하여 매번 변경된 데이터만 가져오도록 합니다.
SkyPlanner는 일정이 변경되면 웹훅을 전송하므로 Sage 100으로의 역전송은 이벤트 기반으로 이루어집니다.
데이터 매핑
| Sage 100 (US) | Sage 100 (DE) | SkyPlanner 객체 | 전송 방향 | 주기 |
|---|---|---|---|---|
| Item | Artikel | 제품 및 자재 | Sage 100 → SkyPlanner | 최초 적재 후 매일 |
| Bill of Materials, 템플릿 자재 | Ressourcenliste 내 Stückliste | 제품 구조, 하위 제품, 제품별 자재 | Sage 100 → SkyPlanner | 변경 시 |
| 작업 센터: 작업자 또는 기계, 요일별 가동 시간, 비가동 기간 | Arbeitsplatz, Ressource (Mitarbeiter, Maschine) | 작업장, 작업장 그룹, 인력, 교대조 | Sage 100 → SkyPlanner | 최초 적재 |
| 작업 지시서 템플릿의 공정 단계, 활동 코드 | Arbeitsplan, Rüst- 및 Stückzeiten을 포함한 Arbeitsgänge | 준비 시간과 가공 시간을 포함한 공정 단계 | Sage 100 → SkyPlanner | 변경 시 |
| 공정 단계와 납기가 포함된 작업 지시서 | Arbeitsgänge, Liefertermin을 포함한 Fertigungsauftrag | 납기가 포함된 주문 및 작업 | Sage 100 → SkyPlanner | 짧은 주기로 조회 |
| 창고별 재고 수량 | Lagerbestand | 재고 잔량 | Sage 100 → SkyPlanner | 매시간 |
| 구매 주문 상세 항목, 필요 일자 | Bestellungen, Liefertermine | 예상 납품일이 포함된 구매 주문 | Sage 100 → SkyPlanner | 매시간 |
| 판매 주문 상세 항목, 약속 납기 | Kundenaufträge | 고객 납기, 고객 우선순위 | Sage 100 → SkyPlanner | 짧은 주기로 조회 |
| 작업 지시서의 공정별 일정 (BOI) | Arbeitsgang-Termine | 공정별 계획 시작·종료 시점 및 작업장 | SkyPlanner → Sage 100 | 변경 시 웹훅으로 전송 |
| Labor Entry, 작업 지시서 완료 처리 (BOI) | Rückmeldung: 시간, 수량 | 작업 시간 기록 및 작업자 실적 보고 | SkyPlanner → Sage 100 | 실적 보고 시마다 또는 교대조별 |
| Sage 100에 저장되지 않음 | Sage 100에 저장되지 않음 | 작업 전환 시간 매트릭스, 가용 수량이 제한된 자원으로 관리하는 공구, 작업별 작업자, 대체 작업장 | SkyPlanner에서 관리 | 온보딩 시 |
연동 패턴
1. 기준정보 최초 적재. 품목과 작업 센터를 먼저 적재한 다음, 템플릿 또는 Arbeitspläne와 그에 속한 공정 단계를 적재합니다. 미국 버전에서 기계 세 대와 작업자 두 명으로 구성된 작업 센터는 SkyPlanner에서 작업장 세 개, 작업장 그룹 하나, 인력 두 명으로 구성됩니다. 각각에 개별 타임라인이 부여됩니다.
2. 주문 동기화. 미완료 작업 지시서 또는 Fertigungsaufträge와 그에 속한 공정 단계, 재고, 미완료 구매 주문을 조회합니다. SkyPlanner는 작업을 배치하기 전에 재고와 입고 예정 물량을 모두 확인합니다. Sage 100은 계속 작업을 제안하고, SkyPlanner는 사용자가 생산 승인한 주문의 일정을 편성합니다.
3. 일정 역전송. 엔진이 배치하거나 이동한 모든 공정 단계에 대해 SkyPlanner가 계획 시작·종료 시점과 작업장을 전송합니다. 미국 Sage 100에서는 BOI를 통해 작업 지시서의 공정별 일정을 업데이트합니다. 독일 Sage 100에서는 범위 산정 단계에서 정한 경로로 Arbeitsgang 일정을 업데이트합니다. 수량, 할당, 원가 계산은 계속 Sage 100에서 관리합니다.
4. 생산 현장 실적 보고. 작업자는 SkyPlanner Mobile Confirmations 또는 Production Timer로 작업을 기록하며, 이 시간 기록을 통해 일정이 최신 상태로 유지됩니다. 미국 Sage 100에서는 기록된 시간이 작업 지시서의 해당 공정에 대한 Labor Entry로 등록되고, 최종 실적 보고 시 작업 지시서가 완료 처리됩니다. 독일 Sage 100에서는 시간과 수량이 포함된 Rückmeldung으로 등록됩니다. 공장에서 이미 Betriebsdatenerfassung이나 바코드 앱으로 시간을 등록하고 있다면, 등록 경로는 하나만 선택하세요.
5. 데이터 관리 주체와 충돌 처리 규칙. 운영을 시작하기 전에 문서로 정리하세요:
| 데이터 | 관리 주체 |
|---|---|
| 품목, BOM, 템플릿, 주문 수량, 원가 | Sage 100 |
| 공정 순서, 시작 및 종료 시각, 작업장 배정 | SkyPlanner |
| 준비 시간 매트릭스, 공구, 작업별 작업자, 대체 자원 | SkyPlanner |
| Labor 및 Rückmeldungen | Sage 100에서 관리하며, SkyPlanner의 작업 시간 기록을 전달받음 |
충돌의 주된 원인은 스케줄링 시스템을 중복으로 사용하는 데 있습니다. 계획 담당자가 미국판 Sage 100에서 Enhanced Scheduling을 계속 실행하거나 독일판 Sage 100의 Plantafel에서 작업을 계속 드래그해 옮기면, 두 시스템이 동시에 일정을 관리하게 됩니다. 공정별 일정은 SkyPlanner에서 관리하세요. Autopilot을 사용하면 생산 상황이 바뀔 때 SkyPlanner가 자동으로 일정을 다시 조정합니다.
일반적인 프로젝트 진행 단계
구축은 보통 온보딩을 시작한 뒤 몇 주 안에 완료됩니다. 그 전에 미완료 작업 지시서나 Fertigungsaufträge를 CSV 또는 Excel로 내보내 30일 무료 체험에서 일정을 검증하세요. 이후 프로젝트는 다음과 같이 진행됩니다:
- 범위 산정. 제품(미국판 또는 독일판 Sage 100), 버전과 설치 환경, 읽기 경로와 쓰기 경로, 동기화 주기, 작업 시간 등록 채널을 확인합니다.
- 접근 설정. Sage 파트너가 Sage 100 사용자와 권한, 데이터베이스 접근을 설정합니다.
- 초기 데이터 적재. 품목, 작업 센터, 템플릿 또는 Arbeitspläne, BOM, 교대 근무 정보를 불러옵니다.
- 주문 동기화. 작업 지시서 또는 Fertigungsaufträge, 구매 주문, 재고를 정해진 주기에 맞춰 동기화합니다.
- SkyPlanner에서 제약 조건 설정. 준비 시간 매트릭스, 공구, 작업별 작업자 수, 대체 설비 또는 인력을 설정합니다.
- 일정 역전송. 공정별 계획 일정을 Sage 100으로 다시 전송한 다음, 작업 시간과 Rückmeldungen을 전송합니다.
- 병행 테스트 및 운영 시작. 기존 계획과 일정을 비교하고 기준정보를 수정한 뒤, 역전송 기능을 켭니다.
Sage 100 연동 시 미리 검토할 사항
- 사용 중인 Sage 100 제품을 확인하세요. 미국판과 독일판 Sage 100은 데이터 모델과 인터페이스가 다릅니다. 첫 범위 산정 협의에서 제품명과 버전을 명확히 알려주세요.
- 여러 설비를 묶어 놓은 작업 센터. 미국판의 작업 센터는 “one or more persons or machines”(한 명 이상의 인력 또는 한 대 이상의 설비)를 하나의 생산능력 단위로 취급합니다. 작업 센터별로 하나의 작업장, 여러 작업장, 그룹 중 무엇으로 구성할지 결정하세요.
- 준비 시간과 가동 시간. 템플릿과 Arbeitspläne에는 SkyPlanner가 스케줄링에 사용하는 시간 정보가 들어 있습니다. 운영을 시작하기 전에 실제 가동 시간과 대조해 확인하세요.
- 캘린더. 미국판 작업 센터에는 요일별 근무 시간과 휴무일 정보가 있습니다. 이를 SkyPlanner의 교대 근무 정보로 불러온 뒤, SkyPlanner에서 작업자별 교대 근무와 부재 정보를 추가하세요.
- 측정 단위. 공정은 개별 제품, 배치 또는 시간 단위로 진행될 수 있습니다. 공정별로 단위를 매핑하세요.
- BOI 권한. BOI에는 Sage 100의 역할 기반 보안이 적용됩니다. 해당 작업의 권한이 없으면 쓰기가 차단됩니다. 연동용 사용자 계정으로 모든 쓰기 작업을 테스트하세요.
- 일정 관리 주체는 하나로 정하세요. SkyPlanner에서 일정을 관리하기 시작하면 다른 시스템의 스케줄링 실행이나 Plantafel에서의 작업 이동을 중단하세요.
Sage 100 연동 설정과 지원은 누가 담당하나요?
- SkyPlanner 팀이 온보딩 중에 연동을 설정하고 운영 시작 후에도 지원합니다.
- Sage 파트너도 참여할 수 있습니다. 파트너는 고객이 사용하는 Sage 100 버전을 잘 알고 있으며, 사용자와 권한을 설정하고 데이터베이스 접근을 확인합니다.
- 사내 개발자도 연동을 확장할 수 있습니다. 문서화된 SkyPlanner의 REST API를 활용하면 됩니다. API 토큰만 있으면 시작할 수 있으며, 필요할 때 SkyPlanner 팀이 지원합니다.
연동이 완료되면 Arcturus 엔진이 Sage 100의 실시간 주문 데이터를 바탕으로 일정을 수립하고, 각 공정에 계획 일정이 반영됩니다. SkyPlanner는 작업장 5개를 포함해 월 199 €부터 시작하며 매월 청구됩니다. 고객의 프로세스와 요구 사항에 맞춘 연동 견적을 요금제와 함께 사전에 제공하므로, 시작 전에 전체 비용을 확인할 수 있습니다. 요금과 기능을 확인하고, Sage 100 생산 스케줄링에서 Sage 100 자체 계획 기능과 비교해 보세요. 개요는 Sage 100 페이지에서 확인할 수 있습니다. Sage 200과 Sage X3의 별도 가이드는 각각 Sage 200 및 Sage X3 페이지에 있으며, 다른 ERP는 ERP 연동 허브에서 확인할 수 있습니다.
제조업체의 SkyPlanner 사용 후기
6개월앞까지 영업팀이 여유 생산능력 확인
“SkyPlanner는 모든 생산 계획의 토대를 마련하고 신뢰성을 높여 줍니다.”
Anu Järvinen, 생산 관리자
Fredman Operations · 식품용 포장지
영업팀은 여섯 달 앞까지 여유 생산능력을 확인할 수 있습니다. 한 시간 이상 걸리던 일정 변경 요청에도 이제 몇 초 만에 답할 수 있습니다.
100%2021년부터 유지한 납기 준수율
“SkyPlanner 덕분에 생산능력을 한눈에 파악하고 예측 가능한 계획을 세울 수 있습니다.”
Dan Berglund, COO/CFO
Opes Corporation · 화학 및 식품 제조
2021년 SkyPlanner를 도입한 이후 사용 기간 내내 납기 준수율 100%를 유지하고 있습니다.
자주 묻는 질문
Sage 100은 작업 지시서용 REST API를 제공하나요?
미국판 Sage 100은 Business Object Interface를 통해 비즈니스 로직에 접근할 수 있게 하며, 읽기에는 ODBC를, 파일 작업에는 Visual Integrator를 제공합니다. SkyPlanner는 ODBC와 BOI를 통해 작업 지시서를 읽고, BOI를 통해 공정 일정과 작업 시간을 기록합니다. 독일판 Sage 100의 경우 SQL Server 데이터베이스에서 데이터를 읽으며, 쓰기 반영 경로는 범위 산정 단계에서 Sage 파트너와 함께 정합니다.
Sage 100 연동은 누가 구축하나요?
SkyPlanner 팀이 온보딩 중에 고객의 Sage 100 환경에 맞춰 양방향 연동을 설정하고 운영 시작 후에도 지원합니다. Sage 파트너는 사용자, 권한, 데이터베이스 접근을 설정하며 연동 구축에도 참여할 수 있습니다. 사내 개발자도 문서화된 SkyPlanner의 REST API를 활용해 개발할 수 있으며, API 토큰만 있으면 시작할 수 있습니다.
계획 일정은 Sage 100에 어떻게 다시 반영되나요?
미국판 Sage 100에서는 BOI를 통해 작업 지시서의 각 공정에 대한 계획 일정을 업데이트하고, 작업자의 시간 기록을 바탕으로 Labor Entry를 등록합니다. 독일판 Sage 100에서는 각 Fertigungsauftrag의 Arbeitsgang 일정을 업데이트하고, 범위 산정 단계에서 Sage 파트너와 SkyPlanner 팀이 정한 쓰기 경로를 통해 Rückmeldungen을 등록합니다.
Sage 100에서 변경 사항을 실시간으로 푸시할 수 있나요?
SkyPlanner는 주기적으로 데이터를 읽어 Sage 100의 변경 사항을 가져옵니다. 미완료 주문은 짧은 주기로, 재고와 구매 주문은 매시간 읽습니다. 반대 방향으로는 SkyPlanner의 웹훅이 일정 변경이 발생하는 즉시 이를 푸시합니다.
