Senior ERP 연동 가이드 SkyPlanner APS로 생산 스케줄링 구현하기
이 가이드는 파트너와 IT 팀을 위해 Senior Sistemas의 Senior ERP(Senior X를 사용하는 Gestão Empresarial | ERP XT)를 SkyPlanner APS에 연결하는 방법을 설명합니다. SkyPlanner는 Senior가 제공하는 인터페이스를 통해 Senior ERP와 양방향으로 연동됩니다.
- 생산 오더(OP)와 해당 단계, 공정 경로(roteiros), 자원과 자원 센터, SKU, 제품 구조, 재고, 구매 오더를 가져옵니다.
- OP의 각 단계에 계획된 시작·종료 시점과 선택된 자원을 해당 OP에 다시 반영합니다.
- 원하는 경우 작업자의 작업 시간 기록을 apontamentos de produção로 다시 전송합니다.
- Senior X Events Hub는 OP 단계의 상태가 바뀌면 SkyPlanner에 알리고, SkyPlanner 웹훅은 일정 변경이 발생할 때마다 이를 전송합니다.
SkyPlanner 팀은 온보딩 과정에서 고객의 Senior ERP 환경에 맞게 연동을 설정하고, 가동 후에도 지원합니다. 이 가이드는 연동 작업에 참여하거나 SkyPlanner의 문서화된 REST API(API 참조 문서)를 활용해 직접 개발하려는 파트너와 개발자를 위한 문서입니다.
Senior ERP의 연동 인터페이스
ERP XT는 하이브리드 방식입니다. Senior 문서에 따르면 Gestão Empresarial XT는 “becomes a hybrid system: an on-premises (local) system with integration of cloud solutions”(클라우드 솔루션과 연동되는 온프레미스(로컬) 하이브리드 시스템이 됩니다)(Senior 문서, 번역본). 스케줄러는 Senior의 세 가지 인터페이스를 사용합니다.
- G5 웹 서비스(SOAP). Senior 서버에서 실행되며 모듈별로 이름이 지정된 서비스입니다(com.senior.g5.co.<module>…). 각 서비스는 sapiens_Sync, sapiens_Async, sapiens_Scheduled의 세 가지 WSDL 형식으로 제공됩니다. 생산 관련 서비스에는 com.senior.g5.co.mpr.pcp.ordemproducao가 있습니다. Senior 문서는 이 서비스가 ERP 화면과 마찬가지로 “calls the same production order generation routine”(동일한 생산 오더 생성 루틴을 호출합니다)이라고 설명합니다(Senior 문서, 번역본). 제품 서비스(com.senior.g5.co.ger.cad.produto)와 생산 실적 보고 서비스도 있습니다.
- Senior X Platform REST API. api.senior.com.br에서 제공되며, 제품과 판매 오더 등 Senior가 Senior X에 공개한 ERP 영역을 다룹니다(Senior 문서).
- Events Hub 웹훅. Senior X의 Tecnologia > Customização > Events Hub > Webhooks에서 생성합니다. Manufacturing은 OP 단계의 상태가 바뀌면 erp_man/pcp_programacaocontrole/orderProductionStageChangeStatus 이벤트를 발행합니다(Senior 문서).
인증 및 접근 권한
- Senior X Platform. 연동 프로그램은 사용자 이름을 user@tenant 형식으로 지정하고 platform.senior.com.br의 /t/senior.com.br/bridge/1.0/rest/platform/authentication/actions/Login에 POST 요청을 보내 로그인합니다. 응답에는 Bearer 액세스 토큰과 갱신 토큰이 포함됩니다. 애플리케이션 키로는 loginWithKey(access key, secret, tenant)를 사용해 로그인할 수 있습니다. REST 호출에는 authorization 헤더와 연결 애플리케이션을 식별하는 client_id 헤더가 포함됩니다. 이 애플리케이션은 Senior API 포털에 등록하고 ERP의 역할에 연결해야 합니다.
- G5 웹 서비스. 호출 시 user, password, encryption 매개변수를 전달합니다. Senior X 토큰을 사용하는 경우 토큰이 비밀번호를 대신합니다(Senior 문서).
- 권한. 연동 전용 Senior 사용자 계정을 생성하고, 연동 과정에서 읽고 쓰는 PCP, 엔지니어링, 재고, 구매 데이터에 대한 접근 권한을 부여하세요.
SkyPlanner의 REST API는 Authorization-Token 헤더에 담긴 API 토큰으로 인증하며(SkyPlanner Settings > API), Swagger/OpenAPI로 문서화되어 있습니다. 연동 튜토리얼에서 첫 API 호출 과정을 안내합니다.
이벤트와 폴링
Events Hub는 생산 현장의 변경 사항을 전달합니다. OP 단계의 상태가 바뀌면 웹훅이 SkyPlanner에 전달되어 일정이 업데이트됩니다. 다른 데이터는 폴링으로 가져옵니다. 확정 및 릴리스된 OP와 최근 변경 사항을 필터링해 조회하면 새로운 작업을 가져올 수 있습니다. 조회 주기는 공장별로 설정하며, OP는 몇 분마다, 재고는 매시간 조회하는 방식입니다.
SkyPlanner는 상태나 일정이 변경되면 웹훅을 전송하므로, 변경 사항을 다시 반영하는 작업은 이벤트 기반으로 처리됩니다.
데이터 매핑
| Senior ERP 객체(인터페이스) | SkyPlanner 객체 | 전송 방향 | 주기 |
|---|---|---|---|
| SKU: produto 및 derivação, 측정 단위(G5 웹 서비스 또는 Senior X 엔터티) | 제품 및 자재 | Senior → SkyPlanner | 최초 적재 후 폴링 |
| 제품 구조(engenharia do SKU) | 제품 구조, 하위 제품, 제품별 자재 | Senior → SkyPlanner | 최초 적재 후 변경 시 |
| estágios를 포함한 Roteiro: 순서, 이전 단계에 대한 종속 관계 | 순서에 따른 공정 단계 | Senior → SkyPlanner | 최초 적재 후 변경 시 |
| Recurso: Tempo processo, Tempo setup, Tempo carga e descarga, Tempo transferência, Fator de carga | 작업장, 소요 시간, 준비 및 정리 시간, 효율 | Senior → SkyPlanner | 최초 적재 후 드물게 갱신 |
| Centro de recurso | 작업장 그룹 | Senior → SkyPlanner | 최초 적재 후에는 드물게 갱신 |
| Calendário: Feriados, 교대조별 생산 캘린더 | 교대근무 및 비가동일 | Senior → SkyPlanner | 매일 갱신하거나 SkyPlanner에서 교대근무를 별도 관리 |
| 단계 및 자재를 포함한 Ordens de produção(Firme, Liberada) | 납기 및 자재 소요량이 포함된 오더와 작업 | Senior → SkyPlanner | 수분 간격으로 폴링 |
| OP 단계 상태(Events Hub orderProductionStageChangeStatus) | 작업 진행 상황 | Senior → SkyPlanner | 웹훅으로 실시간 전달 |
| SKU별 Estoque | 재고 잔량 | Senior → SkyPlanner | 매시간 또는 스케줄링 실행 시 폴링 |
| 납품일을 포함한 Ordens de compra | 구매 오더, 납품일별 입고 예정 자재 | Senior → SkyPlanner | 매시간 또는 스케줄링 실행 시 폴링 |
| OP 단계: 계획된 시작·종료 시점, 자원 | 작업별 계획된 시작·종료 시점, 배정된 작업장 | SkyPlanner → Senior | 일정 변경 시 SkyPlanner 웹훅으로 전달 |
| Apontamento de produção: numOrp, codEtg, seqRot, qtdRel, qtdRfg, 시작 및 종료 일시 | 작업 시간 기록 및 작업자 실적 등록 | SkyPlanner → Senior | 선택한 경우 실적 등록 건별 또는 교대조별 |
| Senior ERP에 없음 | 준비 시간 매트릭스, 가용 수량이 제한된 자원으로 관리하는 공구, 여러 작업자가 필요한 작업, 대체 설비 및 인력 | SkyPlanner에서 관리 | 온보딩 중 설정 |
연동 패턴
1. 기준정보 최초 적재. SKU, 제품 구조, roteiros, recursos, centros de recurso, 생산 캘린더를 읽어옵니다. 자원 센터의 매핑 방식은 신중하게 정하세요. 설비 네 대가 있는 centro de recurso는 하나의 작업장 그룹 또는 네 개의 작업장으로 구성할 수 있습니다. Fator de carga는 SkyPlanner 작업장 효율이나 교대조 중 한쪽에만 반영하고, 양쪽에 모두 반영하지 마세요.
2. OP 동기화. Firme 및 Liberada 상태인 OP의 단계와 자재, 미결 구매 오더를 읽어옵니다. Planejada 상태의 OP는 MRP가 아직 변경하거나 삭제할 수 있으므로, 향후 일정을 미리 보고 싶은 경우에만 스케줄링하세요. SkyPlanner는 발주한 자재를 구매 오더(PO)의 납품일부터 사용 가능한 것으로 간주하고, PO가 Delivered로 표시되면 재고를 업데이트합니다.
3. 일정 재반영. 엔진이 단계를 배치하거나 이동하면 SkyPlanner 웹훅이 일정 재반영을 실행합니다. 각 OP 단계의 계획된 시작·종료 시점과 선택된 자원이 설정됩니다. 이는 계획 담당자가 Programação de produção에서 편집하는 필드와 같습니다. 사용할 웹 서비스는 범위 산정 과정에서 SkyPlanner 팀이 고객 및 Senior 파트너와 협의해 정합니다.
4. 현장 실적 등록. 작업자는 SkyPlanner Mobile Confirmations 또는 Production Timer로 작업을 기록하며, 이 작업 시간 기록을 통해 일정이 최신 상태로 유지됩니다. 실제 작업 시간을 Senior에 다시 전송할지는 선택할 수 있습니다. 전송하는 경우 각 실적 등록 건은 생산 수량, 불량 수량, 시작·종료 시간을 포함한 OP 단계의 apontamento de produção가 됩니다. Senior는 Liberada 또는 Andamento 상태의 OP에만 생산 실적 등록을 허용합니다. Fábrica ao Vivo로 실적을 보고하는 경우 SkyPlanner는 대신 Events Hub를 통해 진행 상황을 읽어옵니다.
5. 데이터 관리 주체 및 충돌 처리 규칙. 가동 전에 다음 사항을 문서화하세요.
| 데이터 | 관리 주체 |
|---|---|
| SKU, 제품 구조, roteiros, OP 수량 및 상태 | Senior ERP |
| 단계 순서, 시작·종료 시간, 자원 배정 | SkyPlanner |
| 준비 시간 매트릭스, 필요한 공구 및 작업자, 대체 자원 | SkyPlanner |
| 생산 캘린더 및 교대조 | 범위 산정 시 선택한 하나의 시스템 |
| Apontamentos, 재고 이동, 원가 계산 | Senior ERP에서 관리하며, 직접 입력하거나 SkyPlanner 작업 시간 기록에서 전송 |
단계별 일정을 기록하는 주체는 하나로 정하세요. 계획 담당자가 Programação de produção나 Gantt 차트에서도 동일한 OP의 순서를 계속 조정한다면, 어떤 OP를 SkyPlanner에서 관리할지 합의하세요.
일반적인 프로젝트 진행 단계
구축은 일반적으로 온보딩 시작 후 몇 주 안에 완료됩니다. 그 전에 Senior에서 자원, roteiros, 미결 OP를 CSV 또는 Excel로 내보내 30일 무료 체험에서 일정을 검증하세요.
- 매핑. 매핑 표, 데이터 관리 주체 규칙, 동기화 주기, apontamentos를 Senior에 반영할지 여부를 확정합니다.
- Senior 접근 설정. 연동용 사용자를 생성하고, Senior API 포털에 애플리케이션을 등록한 뒤 G5 웹 서비스와 Events Hub 웹훅을 활성화합니다. 먼저 검증용 데이터베이스에서 테스트하세요.
- 최초 적재. SKU, 제품 구조, roteiros, recursos, centros de recurso, 캘린더를 적재합니다.
- OP 및 구매 오더 동기화. 필터와 재시도를 적용한 폴링 및 단계 상태 웹훅을 구성합니다.
- SkyPlanner 제약 조건 설정. 준비 시간 매트릭스, 공구, 작업별 작업자 수 및 대체 기계나 인력을 설정합니다.
- 일정 재반영. SkyPlanner 웹훅을 통해 단계별 일정과 자원을 반영하고, 선택한 경우 apontamentos도 전송합니다.
- 병행 테스트. 기존 계획과 SkyPlanner를 병행 운영하며 일정을 비교하고 기준정보를 수정합니다.
- 가동 시작. 데이터가 일치하면 역반영을 활성화합니다.
Senior ERP 연동 시 미리 고려할 사항
- 자원의 네 가지 시간. Recurso에는 가공, 준비, 적재·하역, 이송 시간이 저장됩니다. 적재와 이송 시간은 설비 가동 시간이 아니라 취급 작업 시간일 수 있습니다. 자원별로 각 시간을 어떻게 매핑할지 정하지 않으면 모든 소요 시간이 잘못 산정됩니다.
- 자원별 단일 준비 시간. Senior의 Tempo setup은 단일 값입니다. 온보딩 중 실제 작업 전환 시간을 바탕으로 SkyPlanner에서 준비 시간 매트릭스를 구성하세요.
- 제품 파생형. Senior의 SKU는 제품과 derivação의 조합이며, 파생형에 따라 roteiros가 다를 수 있습니다. SkyPlanner 제품 키에 파생형 코드를 포함하세요.
- OP 상태. Liberada 및 Andamento 상태의 OP에만 생산 실적을 등록할 수 있습니다. 상태 변경은 Senior에서 관리하고, SkyPlanner는 Events Hub를 통해 이를 반영하도록 하세요.
- 하이브리드 배포. G5 웹 서비스는 Senior 서버에서, Events Hub는 Senior X에서 실행됩니다. 양쪽 모두에 대한 네트워크 접근을 계획하세요.
- 숫자 형식. Senior 웹 서비스는 천 단위 구분 기호가 있는 숫자를 허용하지 않으며, 소수점 구분 기호로 쉼표를 사용해야 합니다. 이 형식에 맞춰 숫자를 전송하세요.
Senior ERP 연동 설정 및 지원 담당
- SkyPlanner 팀이 온보딩 중에 연동을 설정하고 정식 가동 후에도 지원합니다. 지원 범위는 합의된 웹 서비스, Senior X API 및 Events Hub 웹훅입니다. 공장마다 Senior ERP 운영 방식이 다르므로, 각 현장의 운영 노하우를 이 과정에 반영합니다.
- 귀사의 Senior 파트너도 참여할 수 있습니다. 파트너는 귀사의 시스템 설정, 맞춤 개발 내역과 라이선스를 파악하고 있으므로 SkyPlanner 팀과 함께 연동 사용자 설정, API 포털 등록, 웹 서비스 설정을 진행할 수 있습니다.
- 사내 개발자가 연동 기능을 확장할 수도 있습니다. API 토큰으로 SkyPlanner의 REST API를 이용하면 됩니다. API 토큰만 있으면 시작할 수 있으며, 필요할 때 SkyPlanner 팀이 지원합니다. 연동 관련 문서는 SkyPlanner 연동 문서에서 확인하세요.
SkyPlanner는 작업장 5개를 포함해 월 199 €부터 시작하며, 매월 청구됩니다. 연동 비용은 귀사의 프로세스와 요구 사항에 맞춰 이용 요금제와 함께 사전에 견적을 제공합니다. 요금, 실제 설비·인력 용량을 고려한 Senior ERP 생산 스케줄링, Senior ERP 페이지, ERP 연동 안내를 확인하세요.
제조업체의 SkyPlanner 사용 후기
2시간매주 절약
“SkyPlanner 덕분에 Excel 스프레드시트로 생산 계획을 세우던 방식에서 벗어나 실시간으로 생산을 최적화하고 있습니다.”
Kalle Kalliomäki, 공급망 전문가
UTU · 배전반 및 개폐장치
생산 계획 업무에 드는 시간을 매주 2시간 절약하고, 새로운 작업 대기열을 몇 초 만에 생산 라인에 전달합니다.
+90%생산 효율 향상
“생산 효율이 90% 높아졌습니다.”
Abdul Rucyinga, IT 책임자
Laboratory & Allied · 의약품 제조
생산 효율이 90% 높아졌으며, 모든 작업장에 걸쳐 석 달치 최적화 계획을 세우는 데 30분도 걸리지 않습니다.
1,000s작업 지시 일정 자동 수립
“생산을 관리하는 방식이 달라졌고, 생산능력을 파악하는 수준도 완전히 달라졌습니다.”
Hannu Ryynänen, CEO
Mamec · 산업용 믹서, 펌프 및 첨단 위탁 제조
수천 건의 작업 지시 일정이 자동으로 수립되며, 조직 전체가 생산 현황을 실시간으로 확인할 수 있습니다.
감소자재 부족으로 인한 생산 중단
“SkyPlanner의 가치는 일상 업무에서 실질적으로 쓸 수 있는 도구라는 점입니다. 특히 납기를 정할 때 유용합니다.”
Tommi Männistö, 생산 계획 관리자
Eskomatic · 위탁 기계가공
부하를 자동으로 배분해 일정을 세우면서 납기를 더 정확하게 산정할 수 있게 되었고, 자재 부족으로 인한 생산 중단도 크게 줄었습니다.
자주 묻는 질문
Senior ERP에 생산 오더용 API가 있나요?
네. G5 웹 서비스 com.senior.g5.co.mpr.pcp.ordemproducao는 ERP 화면과 동일한 처리 절차로 OP를 생성하며, 다른 G5 서비스는 제품과 생산 실적 보고를 처리합니다. Senior X Platform은 Bearer 토큰 로그인 방식의 REST API와 Events Hub 웹훅을 추가로 제공합니다.
Senior ERP는 웹훅을 지원하나요?
네. Senior X Events Hub는 OP 단계의 상태가 바뀔 때 전송하는 orderProductionStageChangeStatus를 비롯한 웹훅을 제공합니다. SkyPlanner는 이를 통해 생산 현장의 진행 상황을 실시간으로 추적하고, 자체 웹훅으로 일정 변경 사항을 다시 전달합니다.
계획 일자는 Senior ERP에 어떻게 다시 반영되나요?
SkyPlanner는 각 OP 단계의 계획 시작일과 종료일, 해당 단계에 배정할 자원을 설정합니다. 이는 계획 담당자가 Programação de produção에서 편집하는 필드와 동일합니다. 일정이 바뀔 때마다 SkyPlanner 웹훅이 재반영을 실행합니다. 이때 온보딩 범위 산정 과정에서 SkyPlanner 팀이 귀사의 Senior 설치 환경에 맞춰 설정한 경로를 사용합니다.
Senior X 및 ERP XT와도 연동되나요?
네. ERP XT는 귀사의 서버에서 실행되며, 클라우드 서비스는 Senior X에서 실행됩니다. 연동에는 서버의 G5 웹 서비스와 클라우드의 Senior X API 및 Events Hub를 사용합니다.
