Exact Online 연동 가이드 SkyPlanner APS로 생산 스케줄링하기
이 가이드는 Exact 파트너와 IT 팀을 대상으로 Exact Online Manufacturing을 SkyPlanner APS에 연결하는 방법을 설명합니다. SkyPlanner와 Exact Online은 다음과 같이 양방향으로 연동됩니다.
- Exact Online REST API를 통해 제조 오더, 공정 순서의 각 단계, 자재 계획, 작업 센터, 공정, 자재 명세서를 가져옵니다.
- 품목, 재고 현황, 구매 오더, 판매 오더를 가져오고, 변경 사항은 Exact Online 웹훅으로 전달받습니다.
- 계획 시작일과 종료일을 각 공정 단계와 제조 오더에 다시 반영합니다.
- 작업자의 시간 기록은 작업 시간 내역으로, 완성 수량은 제조 오더 입고 내역으로 등록합니다.
SkyPlanner 팀은 온보딩 과정에서 고객의 Exact Online 환경에 맞게 연동을 구성하고, 가동 후에도 지원합니다. 이 가이드는 연동 작업에 참여하거나 SkyPlanner의 REST API 문서(API 참조 문서)를 바탕으로 직접 개발하려는 파트너와 개발자를 위한 문서입니다. 마지막에는 Exact Globe+도 간략히 다룹니다.
제조용 Exact Online REST API
Exact Online은 하나의 REST API로 데이터를 제공하며, 리소스는 서비스별로 구분됩니다. 기본 경로는 /api/v1/{division}/<service>/<resource>이며, division은 Exact Online의 회사를 나타냅니다. REST API 참조 문서에는 제조 서비스에서 스케줄링에 사용할 수 있는 다음 리소스가 나와 있습니다.
| 리소스 | 포함 데이터 | 메서드 |
|---|---|---|
manufacturing/ShopOrders | 제조 오더 번호, 품목, PlannedQuantity, PlannedStartDate, PlannedDate, 상태, 작업 지시 여부 플래그 | GET, POST, PUT, DELETE |
manufacturing/ShopOrderRoutingStepPlans | 제조 오더별 공정 단계: 공정, Workcenter, LineNumber, PlannedStartDate, PlannedEndDate, PlannedSetupHours, PlannedRunHours | GET, POST, PUT, DELETE |
manufacturing/ShopOrderMaterialPlans | 제조 오더별 자재 항목 | GET, POST, PUT, DELETE |
manufacturing/Workcenters | 코드, 유형, 생산 구역, 생산능력 값, 요율 | GET, POST, PUT, DELETE |
manufacturing/Operations, OperationResources | 공정과 각 공정을 수행하는 작업 센터, 준비 시간과 가동 시간 | GET, POST, PUT, DELETE |
manufacturing/BillOfMaterialVersions, BillOfMaterialMaterials, BillOfMaterialRoutings | BOM 버전, 구성품, 공정 순서 | GET, POST, PUT, DELETE |
manufacturing/TimeTransactions | 제조 오더 및 공정 단계별로 기록된 작업 시간 | GET, POST, PUT, DELETE |
manufacturing/ShopOrderReceipts | 제조 오더에서 입고된 완성 수량 | GET, POST |
manufacturing/MaterialIssues | 제조 오더에 출고된 자재 | GET, POST |
manufacturing/ShopOrderPriorities | 제조 오더별 우선순위 모드 | GET, PUT |
다른 서비스에서 제공하는 리소스는 다음과 같습니다.
| 리소스 | 포함 데이터 |
|---|---|
logistics/Items | 품목 기준정보 |
inventory/ItemWarehouses | 품목 및 창고별 재고 |
purchaseorder/PurchaseOrders, PurchaseOrderLines | 미결 구매 오더와 입고일 |
salesorder/SalesOrders, SalesOrderLines | 고객 수요와 납품일 |
인증 및 접근 권한
Exact Online은 OAuth 2.0의 인증 코드 흐름과 리프레시 토큰을 사용합니다. Exact는 다음과 같이 안내합니다. “Before you can start integration with Exact Online, you must first register your app in the App Store.”(Exact Online 연동을 시작하려면 먼저 App Store에 앱을 등록해야 합니다.) (Exact Online 도움말) 앱을 등록하려면 Exact Online Developer 구독이 필요합니다(Exact App Store).
- 연동 기능을 리디렉션 URI가 있는 앱으로 등록합니다.
- 제조, 재고, 구매에 대한 접근 권한이 있는 Exact Online 사용자가 한 번 동의합니다.
- 모든 요청에
Authorization: Bearer <access_token>을 보내고, 경로에 division을 포함합니다. - 액세스 토큰은 리프레시 토큰으로 갱신합니다. Exact는 새 토큰을 요청할 수 있는 빈도를 제한하므로, 만료될 때까지 토큰을 캐시에 보관해 사용하세요.
Exact는 앱과 회사별로 분당 및 일일 호출 횟수도 제한하며, 병렬 호출 대신 순차 호출을 요구합니다. 현재 제한은 Exact의 API 제한 안내에서 확인할 수 있습니다. 연동은 이러한 제한을 고려해 설계되었습니다. $filter와 $select로 조회 범위를 좁히고, 대량 변경 사항에는 Sync API를 사용합니다.
SkyPlanner의 REST API는 Authorization-Token 헤더에 API 토큰을 넣어 인증하며(SkyPlanner Settings > API), Swagger/OpenAPI 문서를 제공합니다. 연동 튜토리얼에서 첫 API 호출 방법을 단계별로 안내합니다.
웹훅과 폴링
Exact Online 웹훅은 구독한 토픽에 변경이 생기면 콜백 URL로 HMAC SHA256 해시로 서명한 POST 요청을 보냅니다(웹훅). 토픽에는 Items, StockPosition, PurchaseOrders, PurchaseOrderLines, SalesOrders, SalesOrderLines가 있습니다. 이를 통해 재고, 구매, 수요의 변경 사항이 발생하는 즉시 SkyPlanner로 전달됩니다.
제조 오더와 공정 단계는 주기적으로 조회합니다. ShopOrders와 ShopOrderRoutingStepPlans를 Modified 기준으로 필터링하고, 대량 조회에는 Sync API를 사용하세요(API 제약 사항).
SkyPlanner는 일정이 변경되면 자체 웹훅을 보냅니다. 따라서 Exact Online으로 결과를 다시 반영하는 작업은 이벤트 기반으로 이루어집니다.
데이터 매핑
| Exact Online 리소스 | SkyPlanner 객체 | 방향 | 주기 |
|---|---|---|---|
Items | 제품 및 자재 | Exact Online → SkyPlanner | 초기 적재 후 웹훅 |
BillOfMaterialVersions, BillOfMaterialMaterials | 제품 구조, 하위 제품, 제품별 자재 | Exact Online → SkyPlanner | 변경 시 |
Workcenters, OperationResources | 작업장, 작업장 그룹 | Exact Online → SkyPlanner | 초기 적재 |
Operations, BillOfMaterialRoutings | 준비 시간과 가동 시간이 포함된 공정 단계 | Exact Online → SkyPlanner | 변경 시 |
ShopOrders | 수량과 납기가 포함된 오더 | Exact Online → SkyPlanner | 몇 분마다 |
ShopOrderRoutingStepPlans | 순서, 작업 센터, 준비 시간과 가동 시간이 포함된 작업 | Exact Online → SkyPlanner | 몇 분마다 |
ShopOrderMaterialPlans | 작업별 자재 | Exact Online → SkyPlanner | 몇 분마다 |
ItemWarehouses, StockPosition | 재고 잔량 | Exact Online → SkyPlanner | 웹훅 |
PurchaseOrderLines | 입고 예정일이 포함된 구매 주문 | Exact Online → SkyPlanner | 웹훅 |
SalesOrderLines | 고객 납기 및 우선순위 | Exact Online → SkyPlanner | 웹훅 |
ShopOrderRoutingStepPlans: PlannedStartDate, PlannedEndDate, Workcenter (PUT) | 공정별 계획 시작일, 종료일 및 작업장 | SkyPlanner → Exact Online | 변경 시 웹훅으로 전송 |
ShopOrders: PlannedStartDate, PlannedDate (PUT) | 제조 오더 시작일 및 완료일 | SkyPlanner → Exact Online | 변경 시 웹훅으로 전송 |
TimeTransactions (POST) | 작업 시간 기록 및 작업자 실적 확정 | SkyPlanner → Exact Online | 실적 확정 시마다 또는 교대조별 |
ShopOrderReceipts (POST) | 최종 공정의 완성 수량 | SkyPlanner → Exact Online | 실적 확정 시마다 |
| Exact Online에서 보유하지 않음 | 준비 시간 매트릭스, 가용 수량에 제약이 있는 도구 자원, 작업별 작업자, 대체 작업장, 교대조 | SkyPlanner에서 관리 | 온보딩 |
연동 방식
1. 기준정보 초기 적재. Workcenters, Operations, OperationResources를 먼저 읽어 온 뒤, 품목과 BOM 버전을 공정 순서와 함께 읽어 옵니다. 설비 세 대가 있는 작업 센터는 작업장 세 개 또는 작업장 그룹 하나로 구성합니다. Exact의 작업 센터에는 생산능력 값이 하나만 있으므로 교대조, 부재 및 초과근무는 SkyPlanner에서 설정합니다.
2. 오더 동기화. 미결 ShopOrders와 해당 ShopOrderRoutingStepPlans, ShopOrderMaterialPlans를 읽어 오고, 재고와 구매 주문 항목도 함께 가져옵니다. 일정을 수립할 때는 현재 재고와 입고 예정 구매 물량을 모두 확인합니다. Exact Online의 MRP는 계속 오더를 제안하고, SkyPlanner는 사용자가 생성한 제조 오더의 일정을 수립합니다.
3. 일정 반영. 엔진이 배치하거나 이동한 각 공정에 대해 SkyPlanner는 PlannedStartDate, PlannedEndDate, Workcenter를 담은 PUT 요청을 ShopOrderRoutingStepPlans로 보냅니다. 제조 오더의 PlannedStartDate와 PlannedDate는 각각 첫 공정과 마지막 공정의 날짜를 따릅니다. 수량, 자재 계획 및 원가 계산은 Exact Online에서 계속 관리합니다.
4. 생산 현장 실적 확정. 작업자는 SkyPlanner Mobile Confirmations 또는 Production Timer로 작업을 기록하며, 이 시간 기록을 통해 일정이 최신 상태로 유지됩니다. 기록한 시간은 제조 오더와 해당 공정에 연결된 TimeTransactions로 등록되며, 준비 시간 또는 가동 시간으로 구분됩니다. 최종 실적 확정 시 완성 수량에 대한 ShopOrderReceipts 레코드가 등록됩니다. 공장에서 이미 Shop Floor Control로 시간을 기록하고 있다면 기록 채널을 하나로 정하세요.
5. 관리 주체 및 충돌 처리 규칙. 운영 시작 전에 다음 사항을 문서화하세요.
| 데이터 | 관리 주체 |
|---|---|
| 품목, BOM, 제조 오더 수량, 자재 계획, 원가 | Exact Online |
| 공정 순서, 시작 및 종료 시간, 작업 센터 배정 | SkyPlanner |
| 준비 시간 매트릭스, 도구, 작업별 작업자, 대체 자원, 교대조 | SkyPlanner |
| 작업 시간 내역 및 생산 입고 내역 | Exact Online에서 관리, SkyPlanner에서 데이터 전송 |
충돌의 주된 원인은 날짜를 수동으로 수정하는 것입니다. 계획 담당자가 Exact Online에서 제조 오더 날짜를 계속 변경하면 두 시스템이 날짜를 관리하게 됩니다. 공정별 날짜는 SkyPlanner에서 관리하도록 하세요. Autopilot을 사용하면 생산 상황이 바뀔 때 SkyPlanner가 자동으로 일정을 다시 수립합니다.
일반적인 프로젝트 진행 단계
구축은 일반적으로 온보딩 시작 후 몇 주 안에 완료됩니다. 그 전에 미결 제조 오더와 공정 데이터를 CSV 또는 Excel로 내보내 30일 무료 체험에서 일정을 검증하세요. 이후 프로젝트는 다음 순서로 진행됩니다.
- 범위 산정. 에디션, 회사 단위(division), 동기화 주기, 시간 기록 채널 및 생산 입고 등록 방식을 확인합니다.
- 앱 등록 및 동의. 앱을 등록한 뒤 Exact Online 사용자가 각 회사 단위에 대해 OAuth 동의를 부여합니다.
- 초기 적재. 작업 센터, 공정, 품목, BOM 버전 및 공정 순서를 가져옵니다.
- 오더 동기화. 제조 오더, 공정별 계획 및 자재 계획은 정해진 주기로, 재고와 구매 데이터는 웹훅으로 동기화합니다.
- SkyPlanner 제약 조건 설정. 교대조, 준비 시간 매트릭스, 도구, 작업별 작업자 수, 대체 설비 또는 인력을 설정합니다.
- 일정 반영. 공정별 계획 날짜를 Exact Online에 반영한 뒤 작업 시간 내역과 생산 입고 내역도 전송합니다.
- 병행 테스트 및 운영 시작. 기존 계획과 날짜를 비교하고 기준정보를 수정한 뒤, 일정 반영 기능을 활성화합니다.
Exact Online 연동 시 사전에 검토할 사항
- 공정별 소요 시간.
PlannedSetupHours와PlannedRunHours는 BOM의 공정 순서에서 가져옵니다. 먼저 실제 작업 시간과 비교해 확인하세요. - 작업 센터 그룹화. Exact는 작업 센터마다 생산능력 값을 하나씩 보유합니다. 각 작업 센터를 작업장 하나, 여러 작업장 또는 그룹 중 어떤 형태로 구성할지 결정하세요.
- 캘린더. 교대조, 휴일 및 부재는 SkyPlanner에서 관리합니다. 첫 일정을 수립하기 전에 설정하세요.
- 호출 한도. Exact는 앱과 회사별 호출 수를 제한하며 순차 호출을 요구합니다. 지원되는 토픽에는 웹훅을 사용하고,
Modified에는$filter를 적용하세요. 대량 조회에는 Sync API를 사용하세요. - 여러 회사 단위. Exact Online의 각 회사 단위는 고유 경로와 별도 동의가 필요한 회사입니다. 각 공장을 해당 회사 단위에 매핑하세요.
- 릴리스된 제조 오더. SkyPlanner가 날짜를 변경할 수 있는 상태를 합의하세요. 미결 오더와 릴리스된 오더를 모두 포함할지, 미결 오더만 포함할지 정하면 됩니다.
- 날짜 관리 주체 일원화. SkyPlanner가 공정별 날짜를 관리하기 시작하면 Exact Online에서 날짜를 수동으로 수정하지 마세요.
Exact Globe+
Exact Globe+는 Exact Globe+ 파트너를 통해 판매하고 구축하는 Exact의 ERP입니다. Exact는 이 제품이 “koppelt eenvoudig en snel met andere systemen”(다른 시스템과 쉽고 빠르게 연결됨)이라고 설명합니다(Exact Globe+). SkyPlanner는 Exact Globe+의 생산 오더도 같은 방식으로 스케줄링합니다. 생산 오더, 공정 순서, 자원 및 재고를 가져오고, 계획 날짜와 기록된 작업 시간을 다시 보냅니다. 범위 산정 단계에서 Exact Globe+ 파트너와 SkyPlanner 팀이 인터페이스 및 데이터를 다시 기록할 객체를 합의합니다.
Exact Online 연동: 설정 및 지원 담당
- SkyPlanner 팀이 온보딩 중 연동을 설정하고 운영 시작 후에도 지원합니다.
- 기존 Exact 파트너도 참여할 수 있습니다. 해당 파트너는 사용 중인 에디션, 회사 단위 및 제조 설정을 잘 알고 있습니다.
- 문서화된 SkyPlanner REST API를 사용해 사내 개발자가 연동을 확장할 수도 있습니다. API 토큰만 있으면 시작할 수 있으며, 필요할 때 SkyPlanner 팀이 지원합니다.
연결이 완료되면 Arcturus 엔진이 Exact Online의 실시간 제조 오더를 바탕으로 일정을 수립하고, 모든 공정에 계획 날짜를 반영합니다. SkyPlanner는 작업장 5개를 포함해 월 199 €부터 시작하며 매월 청구됩니다. 연동 비용은 고객의 프로세스와 요구사항에 맞춰 요금제와 함께 사전에 견적으로 제시하므로, 시작 전에 전체 비용을 확인할 수 있습니다. 요금과 기능을 확인하고, Exact Online 생산 스케줄링에서 실제 설비 및 인력의 가용 능력을 고려한 스케줄링이 Exact Online 자체 계획 기능과 어떻게 다른지 살펴보세요. 개요는 Exact Online 페이지에서, 다른 ERP는 ERP 연동 모음에서 확인할 수 있습니다.
제조업체의 SkyPlanner 사용 후기
자재 부족으로 인한생산 중단 감소
“SkyPlanner의 가치는 일상 업무에서 실질적으로 쓸 수 있는 도구라는 점입니다. 특히 납기를 정할 때 유용합니다.”
Tommi Männistö, 생산 계획 관리자
Eskomatic · 위탁 기계가공
부하를 자동으로 스케줄링해 납기를 더 정확하게 산정할 수 있으며, 자재 부족으로 인한 생산 중단도 크게 줄었습니다.
1,000건 단위의작업 지시를 자동 스케줄링
“생산을 관리하는 방식이 달라졌고, 생산능력에 대한 이해도 완전히 다른 수준으로 높아졌습니다.”
Hannu Ryynänen, 대표
Mamec · 산업용 믹서, 펌프 및 첨단 위탁 제조
수천 건의 작업 지시가 자동으로 스케줄링되며, 조직 전체가 생산 현황을 실시간으로 파악합니다.
자주 묻는 질문
Exact Online API에 제조 오더와 공정이 포함되어 있나요?
네. 제조 서비스는 ShopOrders, ShopOrderRoutingStepPlans, ShopOrderMaterialPlans, Workcenters, Operations 및 BOM 리소스를 제공하며, 모두 읽기와 쓰기가 가능합니다. 작업 시간은 TimeTransactions를 통해, 완성 수량은 ShopOrderReceipts를 통해 등록합니다.
계획 날짜는 Exact Online에 어떻게 반영되나요?
SkyPlanner는 각 공정을 배치하거나 이동할 때마다 PlannedStartDate, PlannedEndDate, Workcenter를 담은 PUT 요청을 ShopOrderRoutingStepPlans로 보냅니다. 제조 오더의 PlannedStartDate와 PlannedDate도 이에 맞춰 업데이트됩니다.
Exact Online 연동은 누가 구축하나요?
SkyPlanner 팀은 온보딩 과정에서 고객의 Exact Online 환경에 맞춰 양방향 연동을 구성하고, 가동 후에도 지원합니다. 고객의 Exact 파트너도 참여할 수 있습니다. 사내 개발자가 SkyPlanner의 문서화된 REST API를 활용해 직접 구축할 수도 있으며, API 토큰만 있으면 시작할 수 있습니다.
Exact Online에서 변경 사항을 실시간으로 전송할 수 있나요?
Exact Online 웹훅은 품목, 재고 현황, 구매 오더, 판매 오더의 변경 사항을 전송합니다. 제조 오더와 공정 순서의 각 단계는 짧은 주기로 필터 조건을 지정해 조회합니다. 반대 방향으로는 SkyPlanner 웹훅이 일정 변경 사항을 발생 즉시 전송합니다.
