Fulcrum 연동 가이드 SkyPlanner APS를 활용한 생산 스케줄링
이 Fulcrum 연동 가이드는 컨설턴트와 IT 팀을 대상으로 Fulcrum(Fulcrum Pro)을 SkyPlanner APS에 연결하는 방법을 설명합니다. SkyPlanner는 Fulcrum Public API를 통해 Fulcrum과 양방향으로 연동합니다.
- 생산할 품목과 공정이 포함된 작업, 품목별 공정 순서, 작업 센터, 설비, 부서별 교대 일정, 비가동 시간, 재고, 구매 발주를 가져옵니다.
- 각 작업 공정의 사용자 정의 필드에 계획 시작 시각, 계획 종료 시각, 작업장을 기록합니다.
- 작업자의 작업 시간과 완료 수량을 Fulcrum에 다시 전송해 타이머와 수량을 갱신합니다.
- SkyPlanner 웹훅은 일정이 변경되는 즉시 변경 사항을 전송합니다.
SkyPlanner 팀은 온보딩 과정에서 고객의 Fulcrum 환경에 맞게 연동을 구성하며, 가동 후에도 지원합니다. 이 가이드는 연동 작업에 참여하거나, 문서화된 SkyPlanner REST API(API 참조 문서)를 활용해 직접 개발하려는 컨설턴트와 개발자를 위한 문서입니다.
Fulcrum Public API
Fulcrum은 단일 멀티테넌트 클라우드 제품이므로 모든 고객이 동일한 API를 사용합니다. 개발자 허브는 이 공개 API를 “REST API calls directly into your Fulcrum site.”(고객의 Fulcrum 사이트에 직접 REST API 호출을 보내는 API)라고 설명합니다.
- 명세. OpenAPI “Fulcrum PublicAPI” v1은
https://api.fulcrumpro.com/swagger/v1/swagger.json에서 다운로드할 수 있습니다. Fulcrum은 이 명세로 타입이 지정된 클라이언트를 생성할 것을 권장합니다. History 페이지에는 모든 변경 사항이 날짜별로 나와 있습니다. - 호스트. 일반 사이트는
https://api.fulcrumpro.com을 사용합니다. ITAR 사이트는api.fulcrumpro.us를 사용하며, ITAR 토큰으로 .com 호스트에 접근하면 401 응답을 받습니다. - 호출 방식. 목록 조회에는
POST .../list를 사용합니다. 본문에 필터를 넣고,Skip과Take로 페이지를 나누며,Sort.Field/Sort.Dir로 정렬합니다. 여러 객체가 PUT을 지원하며, 작업은 JSON Patch도 지원합니다.
스케줄링 연동에 사용하는 엔드포인트는 다음과 같습니다.
| 영역 | 엔드포인트 |
|---|---|
| 품목 및 공정 순서 | /api/items, /api/items/{itemId}/routing, /routing/operations, /routing/input-items, /routing/input-materials |
| 생산 현장 설정 | /api/work-centers, /api/equipment, /api/operations, /api/department-shifts, /api/equipment-downtimes |
| 작업 | /api/jobs, /api/jobs/{jobId}/items-to-make/{itemToMakeId}/operations, /api/work-orders |
| 자재 | /api/inventory, /api/materials, /api/purchase-orders, /api/reporting/material-requirements/list |
| 생산 현장 | /api/job-tracking-timers/start 및 /stop, /api/timers, .../operations/{operationId}/add-quantity-completed, .../complete |
Fulcrum의 연동 안내 페이지는 필요한 작업을 명확히 설명합니다. “Every system is a little bit different and requires some configuration.”(시스템마다 조금씩 다르므로 그에 맞는 설정이 필요합니다.) SkyPlanner 팀은 온보딩 과정에서 바로 이 설정 작업을 담당합니다.
인증
Fulcrum은 Authorization 헤더에 Bearer 토큰을 넣어 인증합니다. “A public API token can be generated within your fulcrum site via Business Setup -> System Data -> Public Api.”(Fulcrum 사이트의 Business Setup -> System Data -> Public Api에서 공개 API 토큰을 생성할 수 있습니다.) 각 토큰에는 이름, 설명, 만료일이 있습니다. 필요한 만큼 생성할 수 있으며, 토큰을 삭제하면 폐기됩니다. SkyPlanner 연동 전용 토큰을 발급하고 만료 전에 알림을 받도록 설정하세요.
SkyPlanner의 REST API는 Authorization-Token 헤더에 API 토큰을 넣어 인증하며(SkyPlanner Settings > API), Swagger/OpenAPI 문서가 제공됩니다. 연동 튜토리얼에서 첫 API 호출 방법을 단계별로 확인할 수 있습니다.
이벤트와 폴링
Fulcrum은 관리자가 설정하는 웹훅을 지원합니다. 2026년 9월부터는 실패한 웹훅을 무한히 재시도하지 않고 일시 중지한 뒤 매일 다시 테스트합니다. API History에는 PurchaseOrderUpdated, ItemUpdated 등의 이벤트가 명시되어 있습니다.
연동 시 Fulcrum 데이터는 다음 방식으로 읽어옵니다.
- 미완료 작업은
scheduled,inProgress,hasIncompleteOperations: true조건으로 필터링해 몇 분마다 폴링합니다. Fulcrum이 자사 스케줄 페이지와 동일한 결과를 얻기 위해 제시하는 필터입니다. - 구매 발주와 재고는 매번 스케줄링 실행 전에 읽어오거나,
PurchaseOrderUpdated웹훅이 설정된 경우 해당 이벤트가 발생할 때 읽어옵니다. - 품목, 공정 순서, 설비, 교대 일정은 변경 시 또는 매일 밤 읽어옵니다.
반대 방향에서는 SkyPlanner 자체 웹훅이 스케줄 변경 사항을 발생 즉시 전송합니다. 따라서 Fulcrum에 다시 기록하는 과정은 이벤트 기반으로 작동합니다.
데이터 매핑
| Fulcrum 객체(엔드포인트) | SkyPlanner 객체 | 방향 | 주기 |
|---|---|---|---|
Item, Materials (/api/items, /api/materials) | 제품 및 자재 | Fulcrum → SkyPlanner | 최초 적재 후 매일 밤 |
공정 순서별 투입 품목 및 자재 (/routing/input-items, /input-materials) | 제품 구조, 하위 제품, 제품별 자재 | Fulcrum → SkyPlanner | 최초 적재 후 변경 시 |
공정 순서의 각 공정 (/routing/operations): setupTime, laborTime, machineTime(고정 또는 단위당), selectedEquipmentIds | 공정 단계, 준비 시간, 소요 시간, 사용 가능한 작업장 | Fulcrum → SkyPlanner | 최초 적재 후 변경 시 |
Work Center (/api/work-centers) | 작업장 그룹 | Fulcrum → SkyPlanner | 최초 적재 후에는 드물게 갱신 |
Equipment (/api/equipment): unlimitedCapacity, canRunUnattended, status | 작업장, 배치 작업, 무인 가동 | Fulcrum → SkyPlanner | 최초 적재, 상태는 매일 갱신 |
Department Shifts (/api/department-shifts), Equipment Downtimes | 교대 일정 및 부재 | Fulcrum → SkyPlanner | 최초 적재 후 매일 |
Job 및 작업 공정 (/api/jobs, .../items-to-make/{id}/operations): priority, productionDueDate, earliestStartDate, 예상 값 | 주문 및 작업 | Fulcrum → SkyPlanner | 몇 분마다 폴링 |
| Inventory, Expected Receive 날짜가 포함된 Purchase Orders | 재고 및 입고 예정 자재 | Fulcrum → SkyPlanner | 스케줄링 실행 전마다 |
작업 공정의 customFields (POST .../operations/{operationId}) | 계획 시작 시각, 계획 종료 시각, 작업장 | SkyPlanner → Fulcrum | 스케줄 변경 시 SkyPlanner 웹훅으로 전송 |
Job의 customFields (PUT /api/jobs/{jobId}/custom-fields) | 작업 계획 종료 시각 | SkyPlanner → Fulcrum | 스케줄 변경 시 |
작업 추적 타이머, /api/timers, add-quantity-completed, complete | 작업 시간 기록, 완료 수량 및 폐기 수량 | SkyPlanner → Fulcrum | 작업자가 작업을 기록할 때 |
| Fulcrum에 없음 | 개별 작업자, 준비 시간 매트릭스, 수량이 제한된 공구, 대체 작업장 | SkyPlanner에서 관리 | 온보딩 중 설정 |
연동 방식
1. 기준정보 최초 적재. 품목, 자재, 공정 순서, 작업 센터, 설비를 가져온 다음 부서별 교대 일정과 비가동 시간을 가져옵니다. Fulcrum의 각 작업 센터는 해당 설비를 구성원으로 하는 SkyPlanner 작업장 그룹이 됩니다. 각 공정에 선택된 설비는 해당 공정에서 사용할 수 있는 작업장으로 매핑됩니다. 오븐이나 도장 부스처럼 Unlimited Capacity로 설정된 설비는 배치 작업으로 매핑됩니다.
2. 주문 동기화. 미완료 작업과 각 작업의 생산 품목 및 공정, 미완료 구매 발주와 재고를 읽어옵니다. SkyPlanner는 발주한 자재를 구매 발주의 납품일에 사용 가능한 것으로 처리하며, 구매 발주가 Delivered로 표시되면 재고를 갱신합니다. 스케줄을 다시 수립할 때마다 재고와 구매 자재의 입고 예정 내역을 확인합니다.
3. 스케줄 결과 기록. Fulcrum은 scheduledStartUtc, scheduledEndUtc, scheduledEquipmentId를 자체적으로 계산해 읽기 전용 값으로 반환합니다. 공정 갱신 시에는 customFields를 사용할 수 있습니다. SkyPlanner는 각 작업 공정의 사용자 정의 필드에 계획 시작 시각, 계획 종료 시각, 작업장을 기록하고, 작업의 사용자 정의 필드에도 계획 종료 시각을 기록합니다. 영업팀과 구매팀은 Fulcrum의 해당 작업에서 SkyPlanner가 계획한 일정을 확인할 수 있습니다.
4. 생산 현장 실적 등록. 작업자는 SkyPlanner의 Mobile Confirmations, Production Timer 또는 Quick Log Mode로 작업을 기록합니다. SkyPlanner는 /api/job-tracking-timers/start와 /stop을 통해 시간을 Fulcrum에 전송하거나, /api/timers를 통해 완료된 시간 구간으로 전송합니다. 수량은 add-quantity-completed로 전송하고, 폐기 수량을 포함한 최종 수량은 complete로 전송합니다. Fulcrum의 작업 원가에는 이 실적이 실시간으로 반영됩니다.
5. 데이터 관리 주체와 충돌 처리 규칙. Fulcrum의 스케줄러는 “dictates the order of operations in Job Tracking.”(Job Tracking의 공정 순서를 결정합니다.) 따라서 공정마다 작업 지시 채널을 하나만 선택해야 합니다. SkyPlanner의 작업자 대기열이나 Fulcrum Job Tracking 중 하나를 사용하세요. 정식 가동 전에 다음 규칙을 문서화하세요:
| 데이터 | 관리 주체 |
|---|---|
| 품목, 공정 순서, 견적, 재고, 구매, 원가 계산 | Fulcrum |
| 공정 진행 순서, 시작 및 종료 시각, 작업장 배정 | SkyPlanner |
| 작업자, 준비 시간 매트릭스, 공구, 대체 자원 | SkyPlanner |
| 교대조와 가동 중단 시간 | 범위 산정 단계에서 선택한 단일 시스템 |
| 기록된 작업 시간과 완료 수량 | SkyPlanner에서 관리하고 Fulcrum으로 전송 |
일반적인 프로젝트 진행 단계
구축은 일반적으로 온보딩 시작 후 몇 주 안에 완료됩니다. 그에 앞서 30일 무료 체험으로 자사 데이터를 사용해 볼 수 있습니다. Fulcrum의 그리드에서 품목, 공정 순서, 미완료 작업을 CSV로 내보내 SkyPlanner에 가져온 뒤 일정을 검증하세요.
본 프로젝트는 다음 단계로 진행됩니다:
- 토큰과 범위. Public API 토큰을 생성하고 결과를 다시 기록할 사용자 정의 필드를 협의해 정합니다.
- 매핑. 매핑 테이블, 데이터 관리 규칙, 작업 지시 채널을 확정합니다.
- 초기 데이터 적재. 품목, 자재, 공정 순서, 작업 센터, 설비, 교대조, 가동 중단 시간을 불러옵니다.
- 주문 및 구매 발주 동기화. 작업 변경분을 폴링하고 구매 발주와 재고도 동기화합니다.
- SkyPlanner 제약 조건 설정. 작업자와 교대조, 준비 시간 매트릭스, 공구, 대체 작업장을 설정합니다.
- 결과 전송. 작업별 공정과 작업의 사용자 정의 필드에 결과를 기록합니다.
- 생산 현장 실적 전송. 타이머와 수량을 Fulcrum으로 전송합니다.
- 병행 테스트와 정식 가동. Fulcrum의 일정과 SkyPlanner를 병행 운영하며 날짜를 비교하고 기준정보를 수정한 뒤, 작업 지시 채널을 전환합니다.
Fulcrum 연동 시 고려할 사항
- 인력은 교대조별 설비 대수에 반영됩니다. Fulcrum의 교대조별 Max Equipment는 “is usually determined by how many people you have working in a certain area at that time.”(일반적으로 해당 시간에 특정 구역에서 근무하는 인원수에 따라 결정됩니다.) 개별 작업자와 교대조는 SkyPlanner에서 설정합니다. 작업자 이름은
/api/users의 사용자 정보에서 가져옵니다. - 일정은 설비별로 배정됩니다. Fulcrum의 작업 센터는 서로 대체 가능한 설비의 그룹입니다. 공정 순서에서 선택한 설비가 엔진이 선택할 대체 설비 후보가 되므로 정확하게 관리하세요.
- 작업지시는 여러 작업을 묶습니다. 작업지시는 네스팅과 같이 여러 작업의 공정을 하나로 묶습니다. 그룹화된 공정에서 타이머를 시작하면 개별 공정 대신 작업지시 타이머가 시작되며, 그룹에 속한 모든 작업의 공정에 적용됩니다.
- 타이머 제한.
/api/timers로 소급 등록하는 시간 구간에는 “may not be in the future, older than 30 days, or longer than 7 days.”(미래 시점이거나 명시된 소급 기한 또는 최대 기간을 벗어나는 구간은 허용되지 않습니다.)라는 제한이 있습니다. 작업자가 시간을 기록할 때 바로 전송하세요. - 시간 형식이 서로 다릅니다. 교대조는 현지 시간의 HHmm 값을 사용하고, 가동 중단 시간과 예정 일시는 UTC를 사용합니다. 공정 예상 시간은 초 단위로 제공됩니다.
- 설비 업데이트는 레코드 전체를 교체합니다. 설비 PUT 요청에서 누락한 필드는 모두 비워집니다. SkyPlanner는 설비 정보를 읽기만 하며 절대 쓰지 않습니다.
- ITAR 사업장.
.us호스트와 ITAR 토큰을 사용하세요.
Fulcrum 연동 구성과 지원 담당
구축 작업에는 부서, 작업 센터, 설비, 공정 순서의 매핑이 포함됩니다. 또한 Fulcrum에서 관리하지 않는 제약 조건인 개별 작업자, 준비 시간 매트릭스, 공구, 대체 자원도 설정합니다.
- SkyPlanner 팀이 온보딩 중에 연동을 구성하고 정식 가동 후에도 지원합니다. 제조 현장마다 Fulcrum 운영 방식이 다르며, 구성 과정에 이러한 현장 노하우를 반영합니다.
- Fulcrum 컨설턴트나 연동 파트너가 구축할 수도 있습니다. SkyPlanner는 REST API, Swagger/OpenAPI 문서, 웹훅을 제공합니다.
- 사내 개발자도 직접 개발할 수 있습니다. API 토큰만 있으면 시작할 수 있으며, 필요할 때 SkyPlanner 팀이 지원합니다. 구매 발주와 제품 및 자재 API를 포함한 제품 문서는 SkyPlanner 문서에서 확인할 수 있습니다.
SkyPlanner는 작업장 5개를 포함해 월 199 €부터 시작하며 매월 청구됩니다. 연동 비용은 귀사의 공정과 요구 사항에 맞춰 요금제와 함께 사전에 견적을 제공하므로, 시작 전에 전체 비용을 확인할 수 있습니다. 요금과 기능을 확인하고, Fulcrum 생산 스케줄링에서 Fulcrum 자체 스케줄러와의 비교를 살펴보세요. 전체 개요는 Fulcrum 페이지에서, 다른 ERP는 ERP 연동 허브에서 확인할 수 있습니다.
제조업 고객의 SkyPlanner 후기
2시간매주 절약
“SkyPlanner 덕분에 Excel 스프레드시트로 생산 계획을 세우던 방식에서 실시간 생산 최적화로 전환했습니다.”
Kalle Kalliomäki, 공급망 전문가
UTU · 배전반 및 개폐장치
생산 계획 업무에서 매주 2시간을 절약하며, 새로운 작업 대기열이 몇 초 만에 생산 라인에 전달됩니다.
+90%생산 효율 향상
“생산 효율이 90% 향상되었습니다.”
Abdul Rucyinga, IT 책임자
Laboratory & Allied · 의약품 제조
생산 효율이 90% 향상되었으며, 모든 작업장을 아우르는 석 달치 최적화 계획을 세우는 데 30분이 채 걸리지 않습니다.
99.2%납기 준수율
“SkyPlanner 덕분에 병목 구간을 눈으로 파악하고 생산 관리를 명확하게 할 수 있게 되었습니다.”
Toni Tuori, 생산 관리자
Piristeel · 지붕 안전 설비 및 빗물 배수 시스템
올해 납기 준수율이 99.2%에 도달했으며, 스케줄링 업무에서 하루 최대 네 시간을 절약합니다.
98%납기 준수율, 약 50%에서 향상
“SkyPlanner는 납기 준수율을 유지하는 데 결정적인 역할을 합니다.”
Hannu Lahtinen, 대표이사
KJH-Comp · 판금 가공 및 위탁 제조
납기 준수율이 약 50%에서 최고 98%로 높아졌으며, 이전에는 관리자 두 명이 필요했던 스케줄링을 이제 한 명이 담당합니다.
자주 묻는 질문
Fulcrum은 API를 제공하나요?
네. Fulcrum Public API는 OpenAPI v1 사양을 따르는 REST API입니다. Business Setup > System Data > Public Api에서 생성한 Bearer 토큰으로 인증합니다. ITAR 사업장은 별도의 .us 호스트를 사용합니다.
SkyPlanner의 일정을 Fulcrum에 다시 기록할 수 있나요?
네. Fulcrum 자체 예정 일시는 읽기 전용이므로, SkyPlanner는 각 작업 공정의 사용자 정의 필드에 계획 시작, 계획 종료, 작업장을 기록하고 작업에도 계획 종료를 기록합니다. 작업자의 작업 시간과 완료 수량은 타이머 및 수량 업데이트로 다시 전송합니다.
Fulcrum은 변경 사항을 실시간으로 푸시하나요?
Fulcrum은 관리자가 설정하는 웹훅을 제공하며, PurchaseOrderUpdated 등의 이벤트를 지원합니다. 미완료 작업은 Fulcrum의 일정 페이지와 동일한 필터로 몇 분마다 폴링합니다. SkyPlanner 자체 웹훅은 일정이 변경되는 즉시 변경 사항을 푸시합니다.
Fulcrum 연동은 누가 구축하나요?
SkyPlanner 팀이 온보딩 중에 양방향 연동을 구성하고 정식 가동 후에도 지원합니다. Fulcrum 컨설턴트, 연동 파트너 또는 사내 개발자가 SkyPlanner의 문서화된 REST API를 기반으로 구축할 수도 있습니다.
