연동 / ERP / Acumatica Cloud ERP
Acumatica 연동 가이드 SkyPlanner APS로 생산 스케줄링하기
이 Acumatica 연동 가이드는 파트너와 IT 팀을 대상으로 Acumatica Cloud ERP (Manufacturing Edition)를 SkyPlanner APS에 연결하는 방법을 설명합니다. SkyPlanner와 Acumatica는 다음과 같이 양방향으로 연동됩니다.
- 생산 오더와 해당 공정, 작업 센터, 설비, 공구, 교대 근무, 재고 품목, 구매 오더를 가져옵니다.
- 생산 오더의 공정에 계획 시작일과 종료일을 기록하고 오더를 확정합니다.
- 작업자의 시간 기록을 노무 및 이동 전표로 전송합니다.
- SkyPlanner 웹훅은 일정이 변경되는 즉시 변경 사항을 전송합니다.
SkyPlanner 팀이 온보딩 과정에서 고객의 Acumatica 환경에 맞게 연동을 구성하고, 운영 개시 후에도 지원합니다. 이 가이드는 연동 작업에 참여하거나 SkyPlanner의 문서화된 REST API(API 참조 문서)로 직접 개발하려는 파트너와 개발자를 위한 문서입니다.
Acumatica 연동 인터페이스
연동에는 Acumatica가 기본으로 제공하는 인터페이스를 사용합니다. 인스턴스에 별도로 설치하는 항목은 없습니다.
- 계약 기반 REST API. 엔드포인트는 릴리스에 따라 버전이 관리됩니다. Manufacturing 엔드포인트(예: 2026 R2의 26.200.001)는
ProductionOrder,OrderOperationDetail,BillOfMaterial,WorkCenter,Machine,Tool,Shift,WorkCenterCrewSchedule,LaborEntry,MoveEntry,MaterialEntry를 제공합니다. Default 엔드포인트는StockItem,PurchaseOrder,SalesOrder를 제공합니다. URL 형식은{instance}/entity/{Endpoint}/{version}/{Entity}입니다. - 동일한 엔드포인트의 액션.
FirmProductionOrder,UndoFirmProductionOrder,ReleaseLaborEntry,ReleaseMoveEntry,ReleaseMaterialEntry는 화면의 버튼과 동일한 로직을 실행합니다. - OData. 모든 Generic Inquiry (SM208000)를 OData로 노출할 수 있습니다. 날짜를 포함한 미완료 생산 공정의 Generic Inquiry를 사용하면 가장 빠르게 대량 조회할 수 있습니다.
- 푸시 알림(SM302000). Generic Inquiry 또는 기본 제공 쿼리를 기반으로 삽입된 행과 삭제된 행을 지정한 URL로 전송합니다.
- CSV 및 Excel 공급자를 사용하는 가져오기 및 내보내기 시나리오로 데이터를 대량 적재합니다.
엔터티와 액션 목록은 Web Service Endpoints (SM207000)와 Acumatica의 REST 클라이언트 저장소에서 확인할 수 있습니다.
인증 및 사용 한도
Acumatica는 Connected Applications (SM303010)에 등록된 클라이언트 애플리케이션을 통해 OAuth 2.0과 OpenID Connect를 사용합니다. 문서에 명시된 인증 흐름은 Authorization Code, Implicit, Resource Owner Password Credentials, Hybrid입니다. 서버 연동 시에는 최소 권한 역할을 부여한 연동 전용 사용자를 등록하고, 새로 고침 토큰을 사용하는 Authorization Code 또는 Resource Owner Password Credentials를 사용하세요.
사용 한도는 라이선스에 따라 결정됩니다. License Monitoring Console (SM604000)에서 허용되는 분당 API 요청 수와 API 사용자 수를 확인할 수 있습니다.
SkyPlanner의 REST API는 API 토큰(SkyPlanner Settings > API)으로 인증하며, Swagger/OpenAPI 문서가 제공됩니다. 연동 튜토리얼에서 첫 API 호출 방법을 단계별로 안내합니다.
데이터 매핑
| Acumatica 객체(엔드포인트 / 화면) | SkyPlanner 객체 | 전송 방향 | 전송 주기 |
|---|---|---|---|
StockItem (Default; Stock Items IN202500) | 제품 및 자재 | Acumatica → SkyPlanner | 최초 적재 후 변경분 전송 |
BillOfMaterial (AM208000): 자재, 공정 | 제품 구조, 하위 제품, 제품별 자재 | Acumatica → SkyPlanner | 최초 적재 후 변경 시 전송 |
| BOM 공정: Setup, Run, Machine, Queue, Finish, Move Time | 소요 시간, 준비 시간 및 정리 시간이 포함된 공정 단계 | Acumatica → SkyPlanner | 최초 적재 후 변경 시 전송 |
WorkCenter (AM207000), Machine (AM204500), WorkCenterSubstitute | 작업장, 작업장 그룹, 효율, 대체 작업장 | Acumatica → SkyPlanner | 최초 적재 후 드물게 전송 |
Shift, Work Calendar (CS209000), WorkCenterCrewSchedule | 교대 근무 및 인력 가용량 | Acumatica → SkyPlanner | 매일 전송하거나 SkyPlanner에서 교대 근무 관리 |
Tool (AM205500) | 가용량이 제한된 자원으로 관리하는 공구 | Acumatica → SkyPlanner | 최초 적재 |
OrderOperationDetail이 포함된 ProductionOrder (Planned, Released, In Process) | 납기, 작업 배정 우선순위, 자재 소요량이 포함된 오더 및 작업 | Acumatica → SkyPlanner | 푸시 알림 또는 몇 분 간격으로 폴링 |
PurchaseOrder 상세 행(Default) | 입고 예정일이 포함된 구매 오더 | Acumatica → SkyPlanner | 매시간 또는 스케줄링 실행 시 폴링 |
| 품목별 창고 수량 | 재고 잔량 | Acumatica → SkyPlanner | 매시간 또는 스케줄링 실행 시 폴링 |
OrderOperationDetail: StartDate, EndDate, WorkCenter | 공정별 계획 시작일, 종료일 및 작업장 | SkyPlanner → Acumatica | 일정 변경 시 SkyPlanner 웹훅으로 전송 |
FirmProductionOrder 액션 | 기록된 날짜를 Acumatica APS가 변경하지 못하도록 잠금 | SkyPlanner → Acumatica | 결과를 반영한 후마다 실행 |
LaborEntry, MoveEntry 및 해당 전기 액션 | 시간 기록, 완료 수량, 작업자 실적 보고 | SkyPlanner → Acumatica | 실적 보고 시마다 또는 교대 근무별 전송 |
| Acumatica에 없음 | 준비 시간 매트릭스, 개별 작업자, 여러 작업자가 필요한 작업 | SkyPlanner에서 관리 | 온보딩 중 설정 |
연동 패턴
1. 기준정보 최초 적재. 먼저 작업 센터, 설비, 공구, 교대 근무, 캘린더를 조회합니다. 그런 다음 재고 품목과 BOM을 조회합니다. 여러 설비가 속한 작업 센터를 어떻게 매핑할지 결정하세요. 설비를 각각 작업장으로 두고 하나의 작업장 그룹으로 묶을 수도 있고, 작업 센터 전체를 하나의 작업장으로 매핑할 수도 있습니다. Acumatica의 Basis for Capacity를 보면 해당 공장에서 생산 능력을 어느 기준으로 관리하는지 알 수 있습니다.
2. 오더 동기화. 생산 오더와 해당 공정은 BOM이 아니라 오더에서 조회합니다. 공정은 오더에 복사되며, 계획 담당자가 오더에서 공정을 수정하기 때문입니다. 미완료 오더와 공정의 Generic Inquiry에 푸시 알림 구독을 설정하거나 폴링하세요. 미완료 구매 오더의 상세 행도 조회합니다. SkyPlanner는 발주한 자재를 구매 오더의 입고 예정일에 사용할 수 있는 것으로 처리하며, 구매 오더가 Delivered로 표시되면 재고를 갱신합니다.
3. 스케줄링 결과 반영. SkyPlanner는 엔진이 배치하거나 이동한 모든 공정의 StartDate와 EndDate를 OrderOperationDetail에 기록합니다. 대체 작업 센터로 작업을 옮긴 경우에는 작업 센터도 기록합니다. 그런 다음 FirmProductionOrder를 호출합니다. Acumatica 문서에는 다음과 같이 명시되어 있습니다. “When you run finite scheduling of production orders, the system does not reschedule the firmed production orders.” (실제 가용 능력을 고려해 생산 오더를 스케줄링할 때, 시스템은 확정된 생산 오더의 일정을 다시 조정하지 않습니다.) (출처)
4. 생산 현장 실적 보고. 작업자는 SkyPlanner Mobile Confirmations 또는 Production Timer로 작업을 기록합니다. 시간 기록은 LaborEntry 문서(공정별 시간 및 완료 수량) 또는 MoveEntry 문서(수량만)로 생성되며, 해당 액션으로 전기됩니다. 현장에서 이미 Labor (AM301000) 또는 Shop Floor Kiosk를 통해 Acumatica에 실적을 보고하고 있다면, 진행 상황은 반대 방향으로 전송됩니다. 반드시 한 가지 경로만 선택하고 두 경로를 동시에 사용하지 마세요.
5. 데이터 관리 주체 및 충돌 처리 규칙. 운영 개시 전에 다음 사항을 문서화하세요.
| 데이터 | 관리 주체 |
|---|---|
| 재고 품목, BOM, 수량, 오더 상태, 원가 계산 | Acumatica |
| 공정 순서, 시작 및 종료 시간, 작업장 배정 | SkyPlanner |
| 준비 시간 매트릭스, 공구, 작업자 요건, 대체 자원 | SkyPlanner |
| 교대 근무 및 부재 | 범위 산정 시 선택한 하나의 시스템 |
| 노무 및 이동 트랜잭션 | Acumatica에서 관리하며, SkyPlanner 시간 기록을 전기하거나 현장에서 직접 입력 |
충돌의 주된 원인은 Acumatica 자체 APS입니다. Rough Cut Planning이나 APS Maintenance Process가 SkyPlanner에서 일정을 잡은 오더의 날짜를 다시 계산할 수 있습니다. 날짜를 기록한 오더를 각각 확정하면 이를 방지할 수 있습니다. 일정이 잡힌 오더는 APS 실행 대상에서도 제외하세요.
일반적인 프로젝트 진행 단계
구축은 보통 온보딩 시작 후 몇 주 안에 완료됩니다. 그에 앞서 30일 무료 체험에서 자사 데이터로 SkyPlanner를 사용해 볼 수 있습니다. Generic Inquiry에서 작업 센터와 미완료 생산 오더 및 해당 공정을 Excel로 내보낸 다음, SkyPlanner로 가져와 일정을 검증하세요.
- 매핑. 매핑 테이블, 데이터 관리 주체별 규칙, 동기화 주기, 작업 실적 전송 경로를 확정합니다.
- 접근 설정. 연결 애플리케이션을 등록하고 연동용 사용자와 역할을 생성한 뒤, Web Service Endpoints에서 엔드포인트 버전을 확인합니다. 샌드박스에서 먼저 진행하세요.
- 초기 데이터 적재. 작업 센터, 기계, 공구, 교대조, 재고 품목, BOM을 적재합니다.
- 오더 동기화. 푸시 알림이나 폴링으로 생산 오더, 공정, 구매 오더를 동기화합니다.
- SkyPlanner 제약 조건 설정. 준비 시간 매트릭스, 지정 작업자, 여러 작업자가 필요한 작업, 대체 자원을 설정합니다.
- 결과 반영. 공정 날짜, 오더 확정, 작업 또는 이동 실적을 Acumatica에 반영합니다.
- 병행 운영. SkyPlanner의 날짜를 현재 계획과 비교하고 기준정보를 수정합니다.
- 정식 가동. 데이터가 일치하면 Acumatica로의 결과 반영을 활성화합니다.
Acumatica 연동 시 미리 검토할 사항
- 활성화된 APS 엔진을 확인하세요. Classic과 Optimized는 설정을 별도로 저장하며, 둘 중 하나만 활성화할 수 있습니다. 결과를 처음 반영하기 전에 Enable/Disable Features (CS100000)를 확인하세요.
- 엔드포인트 버전을 고정하세요. 버전은 URL에 포함됩니다. 릴리스 업그레이드 시 새 버전이 추가되므로 업그레이드할 때마다 다시 테스트하세요.
- 공정 업데이트. 일부 공정 필드는 REST에서 읽기 전용이며, 오더 상태도 영향을 줍니다. 샌드박스에서 Released 및 In Process 상태의 오더를 대상으로 결과 반영 순서를 테스트하세요.
- 단위와 시간 필드. 가동 시간은 Run Units 기준이며, 기계 시간은 Machine Units 기준입니다. 대기 시간과 이동 시간은 “affect the calculated schedule but do not occupy work center capacity.”(계산된 일정에는 영향을 주지만 작업 센터의 생산능력을 점유하지는 않습니다.) 데이터를 가져올 때 주의해서 변환하세요.
- 자재 가용성 판단. Classic APS는 모든 자재가 전량 확보되어 있어야 합니다. SkyPlanner는 재고와 입고 예정 구매 오더를 날짜별로 고려해 계획합니다. 생산 계획 담당자가 어느 쪽의 판단을 따를지 합의하세요.
- API 제한. 분당 요청 수는 라이선스에 따라 제한됩니다. 전체 데이터를 다시 적재하지 말고 변경분 조회와 푸시 알림을 사용하세요.
Acumatica 연동 설정 및 지원 담당
- SkyPlanner 팀이 온보딩 중에 연동을 설정하고 정식 가동 후에도 지원합니다. 공장마다 Acumatica 운영 방식이 다르므로, 각 현장에 맞는 노하우를 이 과정에 반영합니다.
- 기존 Acumatica 파트너도 참여할 수 있습니다. 파트너는 귀사의 맞춤 설정, Generic Inquiries, 역할을 잘 알고 있습니다. SkyPlanner는 REST API, Swagger/OpenAPI 문서, 웹훅을 제공합니다.
- 사내 개발자가 직접 연동을 개발할 수도 있습니다. API 토큰으로 동일한 REST API를 사용하면 됩니다. API 토큰만 있으면 시작할 수 있으며, 필요할 때 SkyPlanner 팀이 지원합니다. Laboratory & Allied는 SAP Business One에서 이 방식을 택했습니다. 사내 IT 팀이 SkyPlanner의 도움을 받으며 연동 작업 대부분을 직접 수행했습니다.
SkyPlanner는 작업장 5개를 포함해 월 199 €부터 시작하며, 매월 청구됩니다. 귀사의 프로세스와 요구사항에 맞는 연동 비용을 요금제와 함께 사전에 안내하므로, 시작 전에 전체 비용을 확인할 수 있습니다. Acumatica 자체 APS와의 비교는 Acumatica 생산 스케줄링에서, 개요는 Acumatica 페이지에서 확인하세요. 다른 시스템은 ERP 연동 안내에서 살펴볼 수 있습니다.
제조업 고객의 SkyPlanner 사용 후기
2시간매주 절약
“SkyPlanner 덕분에 Excel 스프레드시트로 생산 계획을 세우던 방식에서 실시간으로 생산을 최적화하는 방식으로 전환했습니다.”
Kalle Kalliomäki, 공급망 전문가
UTU · 배전반 및 개폐 장치
생산 계획 업무에서 매주 2시간을 절약하고, 새로운 작업 대기열을 몇 초 만에 생산 라인에 전달합니다.
+90%생산 효율 향상
“생산 효율이 90% 향상되었습니다.”
Abdul Rucyinga, IT 책임자
Laboratory & Allied · 의약품 제조
생산 효율이 90% 향상되었으며, 전체 작업장의 석 달 치 최적화 계획을 세우는 데 30분도 걸리지 않습니다.
수천 건(1,000s)작업 오더 일정 자동 편성
“생산을 관리하는 방식이 달라졌고, 생산능력에 대한 이해도 완전히 다른 수준으로 높아졌습니다.”
Hannu Ryynänen, 대표
Mamec · 산업용 믹서, 펌프 및 첨단 위탁 제조
수천 건의 작업 오더 일정을 자동으로 편성하고, 조직 전체가 생산 현황을 실시간으로 파악합니다.
99.2%납기 준수율
“SkyPlanner 덕분에 병목 구간을 눈으로 파악할 수 있게 되었고, 생산 관리도 명확해졌습니다.”
Toni Tuori, 생산 관리자
Piristeel · 지붕 안전설비 및 빗물 배수 시스템
올해 납기 준수율이 99.2%에 도달했으며, 스케줄링 업무에서 하루 최대 네 시간을 절약하고 있습니다.
자주 묻는 질문
Acumatica API에서 생산 오더도 제공하나요?
네. 계약 기반 REST API의 Manufacturing 엔드포인트는 ProductionOrder, OrderOperationDetail, BillOfMaterial, WorkCenter, Machine, Tool과 작업 및 이동 실적을 제공하며, FirmProductionOrder 같은 액션도 지원합니다.
Acumatica 연동은 누가 구축하나요?
SkyPlanner 팀이 온보딩 중에 귀사의 Acumatica 환경에 맞춰 양방향 연동을 설정하고, 정식 가동 후에도 지원합니다. Acumatica 파트너나 사내 개발자가 SkyPlanner의 문서화된 REST API로 직접 연동을 개발할 수도 있습니다. API 토큰만 있으면 시작할 수 있습니다.
이 연동에 Acumatica APS가 필요한가요?
아니요. Acumatica 자체에서 생산능력 제약을 반영한 스케줄링은 Rough Cut Planning 화면에서 실행하며, Classic APS는 종료일이 120일 이후인 오더에 대해 생산능력 제약 없이 계획합니다(출처). SkyPlanner는 생산 오더, 공정, 작업 센터, 기계, 공구를 바탕으로 실제 생산능력을 고려한 상세 일정을 직접 수립합니다. 따라서 Acumatica가 “is subject to licensing”(라이선스 적용 대상)이라고 명시한 APS의 활성화 여부와 관계없이 연동할 수 있습니다. Autopilot이 일정을 최신 상태로 유지하고, 작업자는 Mobile Confirmations로 작업 실적을 기록합니다.
Acumatica APS가 SkyPlanner의 날짜를 덮어쓰지 못하게 하려면 어떻게 하나요?
SkyPlanner는 공정 날짜를 기록한 뒤 각 생산 오더를 확정합니다. Acumatica는 생산능력 제약을 반영해 스케줄링할 때 확정된 오더의 일정을 다시 잡지 않습니다.
Acumatica에서 변경 사항을 실시간으로 푸시할 수 있나요?
네. Generic Inquiry에 설정한 푸시 알림(SM302000)이 행이 변경될 때마다 해당 행을 URL로 전송합니다. 반대 방향으로는 SkyPlanner 자체 웹훅이 일정 변경 사항을 푸시합니다.
연동에는 어떤 인증 방식을 사용해야 하나요?
Connected Applications (SM303010)에 등록한 클라이언트를 통해 OAuth 2.0을 사용하며, 연동 전용 사용자와 최소 권한 역할을 적용합니다. 범위 산정 단계에서 귀사의 인스턴스에 맞는 인증 흐름을 확인합니다.
