SpreadJS로 JavaScript 급여 계산 시스템 구현하기
React나 Vue로 웹 앱을 개발하다 보면 "브라우저에서 엑셀처럼 동작하는 급여 계산 화면을 만들어 달라"는 요건을 받게 됩니다. SpreadJS는 MESCIUS가 개발한 JavaScript 기반 엔터프라이즈 스프레드시트 컴포넌트로, 소득세·4대보험 계산 함수, 조건부 서식, PDF 출력 등 Excel 핵심 기능을 React·Vue·Angular·Vanilla JS에서 그대로 활용할 수 있도록 설계된 UI 라이브러리입니다.
기존 Excel 기반 급여 관리의 가장 큰 문제는 유지보수 비용입니다. 세율이 바뀔 때마다 파일을 직접 열어 수식을 수정해야 하고, 직원별 명세서를 하나씩 출력하는 반복 작업이 뒤따릅니다. SpreadJS를 사용하면 setFormula()
로 4대보험 수식을 셀에 직접 연결하고, 커스텀 함수로 소득세 로직을 캡슐화해 세율 변경 시 서버에서 한 번만 수정하면 전 직원 계산이 즉시 반영되는 구조를 만들 수 있습니다.
이 가이드에서는 10인 급여 시트 구성, 소득세 커스텀 함수 등록, 공제 이상값 조건부 서식 경보, spread.savePDF()
기반 명세서 자동 출력까지 웹 급여 관리 시스템의 핵심 기능을 단계별 코드와 함께 설명합니다. 서버 사이드 계산 없이 클라이언트 한 곳에서 급여 처리 흐름 전체를 구현하고 싶은 프론트엔드 개발자라면 이 패턴을 바로 프로젝트에 적용할 수 있습니다.
sheet.setFormula()
로 각 직원 행에 국민연금·건강보험·고용보험 수식을 연결하면 기본급이 바뀔 때마다 공제액이 자동으로 갱신됩니다
GC.Spread.CalcEngine.Functions.Function
을 상속하면 소득세 구간 세율 로직을 =CALC_INCOME_TAX(D2)
형식의 셀 함수로 등록해 여러 시트에서 재사용할 수 있습니다
spread.savePDF()
호출 한 번으로 현재 시트의 인쇄 설정을 반영한 급여 명세서 PDF를 브라우저에서 직접 생성할 수 있습니다

SpreadJS란? — 프론트엔드 개발자를 위한 웹 스프레드시트 컴포넌트
SpreadJS는 MESCIUS가 개발한 JavaScript 기반 엔터프라이즈 스프레드시트 컴포넌트로, 브라우저 환경에서 Excel과 동일한 UX를 제공합니다. 수식 엔진, 셀 서식, 조건부 서식, 차트, 피벗테이블 등 Excel 핵심 기능을 React·Vue·Angular 혹은 순수 JavaScript에서 그대로 활용할 수 있습니다.
국내 기업의 HR 시스템 현대화 프로젝트에서 SpreadJS를 선택하는 이유는 명확합니다. 기존 Excel 급여 관리 파일을 IO 플러그인으로 그대로 임포트한 뒤 웹 UI와 백엔드 API를 연결하면 최소한의 재작업으로 전환이 가능합니다. 세율 변경은 서버에서 일괄 관리하고, 접근 권한은 계정 단위로 제어하며, 명세서 출력은 자동화할 수 있습니다.
소득세·4대보험을 자동 계산하는 급여 시트 만드는 방법
sheet.setFormula()
를 사용하면 각 직원 행에 4대보험 공제 함수를 설정할 수 있습니다. 기본급 셀을 참조하므로 값이 바뀌면 국민연금·건강보험·고용보험이 즉시 재계산됩니다. 아래 예시는 2024년 기준 요율(국민연금 4.5%, 건강보험 3.545%, 고용보험 0.9%)을 적용한 10인 급여 시트입니다.
STEP 1: 라이브러리 참조
STEP 2: HTML 구조
STEP 3: JavaScript
=ROUND(D2*설정!$B$1,0)
. 요율 셀 하나만 수정하면 전 직원 계산이 자동 반영됩니다.소득세 구간 세율을 SpreadJS 커스텀 함수로 캡슐화하는 방법
소득세 간이세액처럼 구간별 누진 세율 계산은 단순 수식 조합으로 표현하기 어렵습니다. GC.Spread.CalcEngine.Functions.Function
을 상속해 커스텀 함수를 정의하면 복잡한 로직을 =CALC_INCOME_TAX(D2)
형태로 셀에서 직접 호출할 수 있습니다. 한 번 등록한 함수는 워크북 전체 시트에서 공유됩니다.
STEP 2: HTML 구조
STEP 3: JavaScript
spread.addCustomFunction()
으로 워크북 레벨에 등록하면 모든 시트에서 공유됩니다. 세율 개정 시 서버에서 함수 정의를 내려받아 동적으로 교체하는 패턴이 실무에서 자주 사용됩니다.
조건부 서식으로 급여 공제 오류를 실시간으로 감지하는 방법
sheet.conditionalFormats.addCellValueRule()
을 사용하면 공제율이 기준을 초과하거나 공제 금액이 이상 범위에 들어올 때 셀 배경색·글자색을 자동 변경합니다. HR 담당자가 수백 건 데이터 중 이상값을 즉시 발견할 수 있어 검증 오류를 줄이는 데 효과적입니다.
STEP 2: HTML 구조
STEP 3: JavaScript
addCellValueRule()
의 value2
파라미터는 Between
/ NotBetween
연산자에서만 의미가 있습니다. GreaterThan
, LessThan
등 단항 연산자에서는 undefined
를 전달하면 됩니다.웹에서 급여 명세서 PDF를 자동으로 생성하는 방법
PDF 출력은 Print·PDF 플러그인을 추가 로드한 후 spread.savePDF()
를 호출합니다. printInfo
객체로 격자선 숨김, 여백, 용지 크기 등을 세밀하게 제어할 수 있어 실무 수준의 급여 명세서를 생성할 수 있습니다.
추가 플러그인 로드 (STEP 1에 추가)
PDF 저장 코드

개발자가 자주 묻는 질문
SpreadJS로 웹 기반 급여 계산 시스템을 구현할 수 있나요?
네, 가능합니다. setFormula()
로 각 셀에 공제 수식을 지정하고, 커스텀 함수로 소득세 로직을 캡슐화하면 완전한 웹 급여 처리 시스템을 구축할 수 있습니다. IO 플러그인으로 기존 .xlsx
파일을 임포트하면 기존 Excel 급여 파일에서 웹으로 전환하는 작업도 최소화됩니다.
JavaScript에서 소득세와 4대보험 공제액을 자동으로 계산하려면 어떻게 하나요?
SpreadJS의 setFormula()
를 사용해 각 직원 행에 =ROUND(D2*0.045,0)
형식의 수식을 적용합니다. 소득세처럼 구간별 누진 세율 계산이 필요한 경우에는 GC.Spread.CalcEngine.Functions.Function
을 상속한 클래스를 작성하고 spread.addCustomFunction()
으로 워크북에 등록하면 됩니다.
웹 앱에서 급여 명세서를 PDF로 자동 출력하려면 어떻게 하나요?
SpreadJS Print·PDF 플러그인을 추가 로드한 후 spread.savePDF(successCb, errorCb, options, sheetIndex)
를 호출하면 현재 시트가 PDF 파일로 변환됩니다. 한국어 텍스트가 포함된 명세서의 폰트 설정 방법은 SpreadJS PDF 한글 폰트 설정 가이드
를 참고하세요.
기존 Excel 급여 파일을 SpreadJS 웹 앱으로 마이그레이션하는 방법은 무엇인가요?
IO 플러그인을 추가 로드한 후 spread.import()
에 .xlsx
파일 객체를 전달하면 서식·수식·데이터가 그대로 웹 환경에서 로드됩니다. 이후 웹 UI를 구성하고 백엔드 API와 연결하면 최소한의 재작업으로 전환이 가능합니다.
SpreadJS 커스텀 함수로 소득세 같은 복잡한 급여 공제 로직을 구현하는 방법은 무엇인가요?
GC.Spread.CalcEngine.Functions.Function
을 상속한 클래스에서 evaluate()
메서드를 재정의해 계산 로직을 구현합니다. 완성된 클래스를 spread.addCustomFunction()
으로 워크북에 등록하면 =CALC_INCOME_TAX(D2)
형식으로 내장 함수처럼 셀 수식에서 직접 호출할 수 있습니다.
