Visma Net 연동 가이드 SkyPlanner APS로 생산 스케줄링하기
이 Visma Net 연동 가이드는 파트너와 IT 팀을 대상으로 Visma Net(Visma.net ERP)을 SkyPlanner APS에 연결하는 방법을 설명합니다. SkyPlanner는 Visma Net API를 통해 다음과 같이 양방향으로 연동됩니다.
- 재고 품목, Kit specifications, 판매 주문, 재고 수준, 구매 주문을 가져옵니다.
- 일정이 잡힌 작업은 Kit assemblies로 생성되며, 작업이 끝나면 확정 처리됩니다.
- 작업자의 작업 시간은 Employee time cards로 전송됩니다.
- SkyPlanner 웹훅은 일정이 변경되는 즉시 변경 사항을 전송합니다.
SkyPlanner 팀은 온보딩 과정에서 고객의 Visma Net 환경에 맞게 연동을 구성하고, 운영을 시작한 후에도 지원합니다. 이 가이드는 연동에 참여하거나 문서화된 SkyPlanner REST API(API 참조 문서)를 활용해 직접 개발하려는 파트너와 개발자를 위한 문서입니다.
Visma Net의 연동 인터페이스
- Visma Net ERP API. REST 방식이며, OpenAPI 명세의 제목은 여전히 “Visma.net ERP API v1″입니다. v1과 v2 경로를 제공합니다. 기본 URL은
https://api.finance.visma.net입니다. 기존integration.visma.net도메인은 2026년 2월 1일부터 호출량이 제한되며 폐지 절차가 진행 중입니다(공지). - SalesOrder service v3는
https://salesorder.visma.net에서 제공됩니다. v1과 v2 판매 주문 엔드포인트는 지원이 종료되었습니다. - 웹훅은 Visma Developer Portal을 통해 제공됩니다.
- Background API.
erp-api-background헤더를 사용하면 처리 시간이 긴 호출을 대기열에 넣고, 작업 ID와 함께 202를 반환하며, 결과가 준비되면 알림을 보냅니다. - Visma Net의 가져오기 및 내보내기 시나리오는 CSV, Excel 또는 SQL 데이터 공급자를 사용해 기준정보를 일회성으로 불러올 수 있습니다.
Visma Net에는 생산 주문, 공정 순서, 작업 센터 객체가 없으므로 API에도 해당 엔드포인트가 없습니다. 스케줄링에 필요한 데이터는 품목, 키트, 주문, 재고에서 가져옵니다.
GET /v1/inventory: 키트 플래그와 품목 분류를 포함한 재고 품목 및 비재고 품목GET /v1/KitSpecifications/{kitInventoryID}/{revisionID}: 개정별 구성품 항목GET /v1/kitassembly: 기존 조립 내역. 유형과 상태로 필터링 가능- SalesOrder service v3: 요청일과 주문 항목을 포함한 수요
GET /v1/inventorysummary/{inventoryNumber}: 창고별 현재고 및 가용 재고GET /v1/purchaseorder및GET /v2/PurchaseReceipt: 입고 예정 자재 및 입고 내역
모든 목록 조회 엔드포인트는 lastModifiedDateTime과 lastModifiedDateTimeCondition, 그리고 pageNumber와 pageSize를 지원하므로 매번 증분 동기화를 수행할 수 있습니다.
인증 및 제한
Visma Net은 Visma Connect(OpenID Connect 및 OAuth 2.0)를 사용합니다.
- Visma Developer Portal에서 Service Integration을 등록합니다.
- 고객사의 Visma Net 테넌트 관리자가 연동을 승인합니다.
- 클라이언트 자격 증명 흐름으로
https://connect.visma.com/connect/token에 토큰을 요청합니다. 이때tenant_id와visma_api:read등의 API 범위를 전달합니다. 토큰의 유효 기간은 3,600초입니다.
호출 한도는 회사와 클라이언트별로 고정된 한 시간 단위 구간에 적용됩니다. 응답에는 X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset이 포함됩니다. 한도를 초과하면 Retry-After와 함께 429를 반환합니다(호출 한도). ETag와 If-Match 헤더는 업데이트 시 데이터 충돌을 방지합니다.
파트너는 Visma의 무료 Integrator Programme을 통해 데모 회사 환경에서 테스트합니다. SkyPlanner의 REST API는 API 토큰(SkyPlanner Settings > API)으로 인증하며, Swagger/OpenAPI로 문서화되어 있습니다. 연동 튜토리얼에서 첫 API 호출 과정을 안내합니다.
이벤트, 웹훅 및 폴링
Visma Developer Portal의 웹훅은 스케줄링에 중요한 다음 이벤트를 지원합니다.
- Inventory Item의 Created, Updated, Changed 이벤트
- Purchase Order의 Changed, Status Changed 이벤트
- Sales Order의 Changed, Status Changed 이벤트. SalesOrderService 게시자로 이전 중
Kit assembly와 Kit specifications에는 이벤트가 없습니다. SkyPlanner는 lastModifiedDateTime 필터를 사용해 이 데이터를 폴링합니다. 재고 수량은 스케줄링을 실행할 때 폴링합니다. 반대 방향으로는 상태나 일정이 변경될 때 SkyPlanner가 웹훅을 보냅니다.
데이터 매핑
| Visma Net 객체(엔드포인트) | SkyPlanner 객체 | 방향 | 주기 |
|---|---|---|---|
재고 품목, 비재고 품목(/v1/inventory) | 제품 및 자재 | Visma Net → SkyPlanner | 최초 일괄 로드 후 웹훅 |
Kit specifications(/v1/KitSpecifications) | 제품 구조, 제품별 자재 | Visma Net → SkyPlanner | 최초 일괄 로드 후 폴링 |
| 판매 주문(SalesOrder service v3) | 납기와 고객 우선순위가 포함된 주문 | Visma Net → SkyPlanner | 웹훅 |
Visma Net에서 조립을 등록하는 경우, On hold 상태의 Kit assembly(/v1/kitassembly) | 작업 | Visma Net → SkyPlanner | 폴링 |
재고 요약(/v1/inventorysummary) | 창고별 재고 수량 | Visma Net → SkyPlanner | 스케줄링 실행 시 폴링 |
구매 주문, 구매 입고(/v1/purchaseorder, /v2/PurchaseReceipt) | 입고일이 포함된 입고 예정 자재. 구매 주문 입고 시 재고 업데이트 | Visma Net → SkyPlanner | 웹훅 수신 후 조회 |
| Visma Net에 없음 | 공정 단계, 작업장, 교대조, 준비 시간 매트릭스, 공구, 대체 자원 | SkyPlanner에서 관리 | 온보딩 시 설정 |
Kit assembly 생성 및 업데이트(POST/PUT /v1/kitassembly) | 일정이 잡힌 작업: 키트 품목, 수량, 완료 예정일 | SkyPlanner → Visma Net | 일정 변경 시 SkyPlanner 웹훅으로 전송 |
Kit assembly 확정 처리(/v1/kitassembly/{type}/{refNo}/action/release) | 완료된 작업: 생산량 및 구성품 소비량 | SkyPlanner → Visma Net | 완료 시 |
재고 입고, 재고 출고(/v1/inventoryReceipt, /v1/inventoryissue, 확정 처리) | 키트를 사용하지 않는 경우의 생산량 및 자재 사용량 | SkyPlanner → Visma Net | 완료 시 |
Employee time card(/v1/timeCard) | 작업자별 기록된 작업 시간 | SkyPlanner → Visma Net | 매주 |
연동 패턴
1. 최초 기준정보 로드. 재고 품목, 품목 분류, 각 키트의 최신 Kit specification 개정 정보를 조회합니다. 각 구성품 항목을 SkyPlanner 자재에 매핑합니다. 그런 다음 Visma Net에 없는 데이터를 구성합니다. 작업장, 교대조, 준비 시간과 가동 시간이 포함된 공정 단계, 준비 시간 매트릭스, 공구 요구사항이 여기에 해당합니다. 이 데이터는 CSV 또는 Excel로 가져옵니다. 이 작업이 프로젝트에서 가장 큰 비중을 차지합니다.
2. 주문 동기화. 다음 수요 모델 중 하나를 선택합니다.
- 판매 주문 기반. 키트 품목의 미결 판매 주문 항목을 SkyPlanner 주문으로 생성하고, 요청일을 납기로 설정합니다.
- 조립 기반. Visma Net에서 On hold 상태로 생성된 Kit assemblies를 SkyPlanner 작업으로 가져옵니다.
미결 구매 주문은 날짜 정보와 함께 가져옵니다. SkyPlanner는 주문한 자재를 구매 주문의 입고일부터 사용할 수 있는 것으로 간주하고, 구매 주문이 Delivered 상태로 표시되면 재고를 업데이트합니다. 스케줄링 시 재고 요약 정보와 함께 현재 재고와 구매 입고 예정분을 모두 확인합니다.
3. 일정 역전송. 판매 주문 기반으로 구성한 경우, SkyPlanner는 일정이 잡힌 각 작업에 대해 Production 유형의 Kit assembly를 생성합니다. 키트 품목, 개정, 창고, 수량, 구성품을 설정하고 해당 조립을 판매 주문 항목에 연결합니다. 조립일은 완료 예정일로 설정됩니다. Autopilot이 작업 일정을 옮기면 확정 처리 전에 PUT으로 날짜를 업데이트합니다.
Kit assembly에는 Date 필드가 하나뿐입니다. 따라서 공정별 시간 정보는 SkyPlanner에서 관리하고, Visma Net에는 판매와 재고에 필요한 날짜를 전달합니다.
4. 생산 현장 실적 등록. 작업자는 Mobile Confirmations 또는 Production Timer로 작업을 기록하며, 이 시간 기록을 통해 일정이 최신 상태로 유지됩니다. 마지막 공정이 끝나면 SkyPlanner는 Kit assembly의 확정 처리 액션을 호출합니다. 확정 처리 시 생산량과 구성품 소비량이 전기되고, 이어서 총계정원장 배치가 생성됩니다. 작업 시간은 주간 Employee time cards로 집계되며, 프로젝트 기반 작업의 경우에는 프로젝트 거래로 집계됩니다.
5. 데이터 관리 주체와 충돌 처리 규칙. 운영을 시작하기 전에 문서로 정리하세요:
| 데이터 | 관리 주체 |
|---|---|
| 품목, Kit specifications, 판매 주문, 구매 주문, 재고, 원가 | Visma Net |
| 공정 단계, 작업장, 교대조, 작업 준비, 공구 | SkyPlanner |
| 작업 순서, 시작 및 종료 시각, 작업장 배정 | SkyPlanner |
| 전기 전 Kit assembly 일자 | SkyPlanner |
| 전기된 Kit assemblies 및 근무 시간 기록표 | Visma Net에서 관리, SkyPlanner에서 전기 |
Kit specification을 변경하면 새 개정본이 생성됩니다. 생산에는 최신 개정본만 사용할 수 있으므로, 최신 개정본을 다시 읽어 매핑해야 합니다. 조립 문서에서 구성품을 수동으로 수정한 내용은 Visma Net에서 그대로 유효하므로, SkyPlanner는 전기 전에 조립 문서를 다시 읽습니다.
일반적인 프로젝트 진행 단계
구축은 보통 온보딩 시작 후 몇 주 안에 완료됩니다. 그에 앞서 30일 무료 체험에서는 Visma Net 내보내기 시나리오로 추출한 실제 데이터를 CSV 또는 Excel로 가져와 사용합니다.
- 범위 산정. 수요 모델, 매핑 테이블, 데이터 관리 주체에 관한 규칙, 결과를 기록할 대상(Kit assembly 또는 재고 입고)을 확정합니다.
- Visma Connect 설정. Service Integration을 등록하고 테넌트 관리자의 승인을 받습니다. 먼저 데모 회사에서 테스트합니다.
- 생산 모델. SkyPlanner에서 작업장, 교대조, 공정 단계, 작업 준비, 공구를 설정합니다.
- 초기 데이터 적재. 재고 품목, 품목 분류, Kit specifications, 창고, 재고를 적재합니다.
- 주문 및 구매 주문 동기화. 판매 주문, 구매 주문, 품목에는 웹훅을 사용하고 키트와 재고에는 폴링을 사용합니다. 토큰 갱신과 429 응답 처리도 이 단계에서 구현합니다.
- 결과 기록. Kit assembly 생성, 수정, 전기와 근무 시간 기록표 기록을 구현합니다.
- 병행 테스트. 기존 계획과 SkyPlanner를 병행 운영하며 일정을 비교합니다.
- 운영 시작. 데이터가 일치하면 결과 기록 기능을 활성화합니다.
Visma Net 연동 시 미리 준비할 사항
- 가져올 공정 순서가 없습니다. 모든 공정 단계와 준비 시간, 가동 시간은 SkyPlanner에서 처음 설정합니다. 필요한 작업량을 산정하고 담당자를 정하세요.
- Advanced logistics. Kit assembly를 사용하려면 Advanced logistics 그룹이 필요합니다. Standard logistics에서는 Inventory receipt와 Inventory issue로 생산 실적을 전기합니다.
- 개정본 수정 제한. 이미 사용한 Kit specification 개정본은 수정할 수 없으며, 생산에는 최신 개정본만 사용할 수 있습니다.
- 측정 단위. Kit assembly에는 자체 측정 단위가 있습니다. 데이터를 가져올 때 SkyPlanner 수량과 단위를 맞추세요.
- 이벤트가 없는 데이터의 폴링. 키트에는 웹훅이 없습니다. 시간당 호출 한도를 넘지 않도록 전체 데이터를 다시 불러오는 대신
lastModifiedDateTime을 기준으로 변경분만 가져오세요. - 현재 엔드포인트.
api.finance.visma.net과 SalesOrder service v3만 사용해 구현하세요. - 테넌트 승인. 테넌트 관리자가 앱을 승인하기 전에는 클라이언트 자격 증명 인증이 실패합니다. 승인 일정을 미리 잡으세요.
- 주간 근무 시간 기록표. 근무 시간 기록표를 사용하려면 Advanced financials가 필요하며, 기록표는 주 단위로 작성됩니다. 작업자 근무 시간을 주별로 집계하거나 프로젝트 트랜잭션으로 전기하세요.
Visma Net 연동 설정과 지원 담당
- SkyPlanner 팀이 온보딩 중에 연동을 설정하고 운영 시작 후에도 지원합니다. SkyPlanner 측 설정, Visma Net에 없는 생산 모델, 합의된 Visma Net API 호출이 지원 범위에 포함됩니다. 공장마다 Visma Net을 운영하는 방식이 다르므로, 이 과정에서 각 현장의 노하우를 반영합니다.
- 기존 Visma Net 파트너도 참여할 수 있습니다. Visma는 Visma 인증 파트너와 함께 Visma Net을 공급합니다. 파트너는 고객사의 설정을 잘 알고 있어 매핑과 Visma Connect 앱을 검토할 수 있습니다. SkyPlanner는 REST API, Swagger/OpenAPI 문서, 웹훅을 제공합니다.
- 사내 개발자가 직접 구현할 수도 있습니다. 문서화된 동일한 REST API와 API 토큰을 사용하면 됩니다. API 토큰만 있으면 시작할 수 있으며, 필요할 때 SkyPlanner 팀이 지원합니다. 공개 문서는 SkyPlanner 문서에서 확인할 수 있습니다.
연동이 완료되면 Arcturus 엔진이 Visma Net의 실시간 주문을 바탕으로 일정을 수립하고, 완료된 작업은 전기된 Kit assemblies로 Visma Net에 다시 기록됩니다. 요금은 작업장 5개를 포함해 월 199 €부터이며 매월 청구됩니다. 연동 비용은 고객사의 업무 방식과 요구사항에 맞춰 이용 요금제와 함께 사전에 견적을 제공하므로, 시작 전에 전체 비용을 확인할 수 있습니다.
요금을 확인하고, Visma Net 생산 스케줄링에서 Visma Net에 스케줄러가 필요한 이유를 알아보세요. 전체 개요는 Visma Net 페이지에서, 다른 ERP는 ERP 연동 안내에서 확인할 수 있습니다.
제조업 고객의 SkyPlanner 사용 후기
2시간매주 절약
“SkyPlanner 덕분에 Excel 스프레드시트로 하던 생산 계획이 실시간 생산 최적화로 바뀌었습니다.”
Kalle Kalliomäki, 공급망 전문가
UTU · 배전반 및 개폐장치
생산 계획 업무에서 매주 2시간을 절약하며, 새로운 작업 대기열이 몇 초 만에 생산 라인에 전달됩니다.
+90%생산 효율 향상
“생산 효율이 90% 높아졌습니다.”
Abdul Rucyinga, IT 총괄
Laboratory & Allied · 의약품 제조
생산 효율이 90% 향상되었으며, 모든 작업장을 아우르는 석 달치 최적화 계획을 수립하는 데 30분도 걸리지 않습니다.
98%납기 준수율, 약 50%에서 상승
“SkyPlanner는 납기 준수율을 유지하는 데 결정적인 역할을 합니다.”
Hannu Lahtinen, 대표이사
KJH-Comp · 판금 가공 및 위탁 제조
납기 준수율이 약 50%에서 최고 98%로 상승했으며, 이전에는 관리자 두 명이 하던 스케줄링을 이제 한 명이 처리합니다.
6개월앞까지 영업팀이 여유 생산능력 확인
“SkyPlanner는 모든 생산 계획의 기반을 마련하고 신뢰성을 뒷받침합니다.”
Anu Järvinen, 생산 관리자
Fredman Operations · 식품용 포장지
영업팀은 여섯 달 앞까지 여유 생산능력을 확인할 수 있으며, 답변을 받는 데 한 시간 이상 걸리던 일정 변경 요청도 이제 몇 초 만에 답변을 받을 수 있습니다.
자주 묻는 질문
Visma Net API에 생산 주문이 있나요?
아니요. Visma Net에는 생산 주문, 공정 순서, 작업 센터 객체가 없으므로 API에도 없습니다. 생산 문서는 /v1/kitassembly의 Kit assembly이며, 공정 순서와 작업장은 SkyPlanner에서 관리합니다.
연동에는 어떤 인증 방식을 사용하나요?
Visma Connect의 OAuth 2.0 클라이언트 자격 증명 흐름을 사용하며, Visma Developer Portal에 Service Integration으로 등록합니다. 테넌트 관리자의 승인이 필요하고, 토큰 유효기간은 한 시간입니다.
Visma Net에서 변경 사항을 실시간으로 전송할 수 있나요?
품목, 판매 주문, 구매 주문은 Visma Developer Portal 웹훅을 통해 실시간으로 전송할 수 있습니다. Kit assemblies와 Kit specifications에는 이벤트가 없으므로 증분 폴링으로 변경분을 가져옵니다. SkyPlanner 자체 웹훅은 일정이 변경되는 즉시 해당 내용을 전송합니다.
생산 완료 결과는 Visma Net에 어떻게 기록되나요?
SkyPlanner는 일정이 잡힌 작업마다 Kit assembly를 생성하고 일자를 최신 상태로 유지하며, 작업이 완료되면 release 동작을 호출합니다. 이 동작은 생산량과 구성품 소비량을 전기합니다. 키트를 사용하지 않는 경우에는 Inventory receipt와 Inventory issue가 같은 역할을 합니다.
