SpreadJS 블로그 MESCIUS 기술 블로그 ·

SpreadJS로 JavaScript 급여 계산 시스템 구현하기

React나 Vue로 웹 앱을 개발하다 보면 "브라우저에서 엑셀처럼 동작하는 급여 계산 화면을 만들어 달라"는 요건을 받게 됩니다. SpreadJS는 MESCIUS가 개발한 JavaScript 기반 엔터프라이즈 스프레드시트 컴포넌트로, 소득세·4대보험 계산 함수, 조건부 서식, PDF 출력 등 Excel 핵심 기능을 React·Vue·Angular·Vanilla JS에서 그대로 활용할 수 있도록 설계된 UI 라이브러리입니다.

기존 Excel 기반 급여 관리의 가장 큰 문제는 유지보수 비용입니다. 세율이 바뀔 때마다 파일을 직접 열어 수식을 수정해야 하고, 직원별 명세서를 하나씩 출력하는 반복 작업이 뒤따릅니다. SpreadJS를 사용하면 setFormula() 로 4대보험 수식을 셀에 직접 연결하고, 커스텀 함수로 소득세 로직을 캡슐화해 세율 변경 시 서버에서 한 번만 수정하면 전 직원 계산이 즉시 반영되는 구조를 만들 수 있습니다.

이 가이드에서는 10인 급여 시트 구성, 소득세 커스텀 함수 등록, 공제 이상값 조건부 서식 경보, spread.savePDF() 기반 명세서 자동 출력까지 웹 급여 관리 시스템의 핵심 기능을 단계별 코드와 함께 설명합니다. 서버 사이드 계산 없이 클라이언트 한 곳에서 급여 처리 흐름 전체를 구현하고 싶은 프론트엔드 개발자라면 이 패턴을 바로 프로젝트에 적용할 수 있습니다.

⭐ Key Points
이 글에서 다루는 핵심 내용
01 SpreadJS는 JavaScript 기반 웹 스프레드시트 라이브러리 — React·Vue·Angular 등 모든 프레임워크에서 500개 이상의 내장 함수와 Excel 호환 인터페이스를 그대로 사용할 수 있습니다
02 4대보험 자동 계산: sheet.setFormula() 로 각 직원 행에 국민연금·건강보험·고용보험 수식을 연결하면 기본급이 바뀔 때마다 공제액이 자동으로 갱신됩니다
03 커스텀 함수: GC.Spread.CalcEngine.Functions.Function 을 상속하면 소득세 구간 세율 로직을 =CALC_INCOME_TAX(D2) 형식의 셀 함수로 등록해 여러 시트에서 재사용할 수 있습니다
04 PDF 명세서: spread.savePDF() 호출 한 번으로 현재 시트의 인쇄 설정을 반영한 급여 명세서 PDF를 브라우저에서 직접 생성할 수 있습니다
SpreadJS로 JavaScript 급여 계산 시스템 구현하기 — 대표 이미지

SpreadJS란? — 프론트엔드 개발자를 위한 웹 스프레드시트 컴포넌트

SpreadJS는 MESCIUS가 개발한 JavaScript 기반 엔터프라이즈 스프레드시트 컴포넌트로, 브라우저 환경에서 Excel과 동일한 UX를 제공합니다. 수식 엔진, 셀 서식, 조건부 서식, 차트, 피벗테이블 등 Excel 핵심 기능을 React·Vue·Angular 혹은 순수 JavaScript에서 그대로 활용할 수 있습니다.

↗
500+
내장 함수
Excel 호환 계산 엔진
↗
60FPS
렌더링 성능
대용량 데이터 처리
↗
3,000+
글로벌 고객사
엔터프라이즈 검증

국내 기업의 HR 시스템 현대화 프로젝트에서 SpreadJS를 선택하는 이유는 명확합니다. 기존 Excel 급여 관리 파일을 IO 플러그인으로 그대로 임포트한 뒤 웹 UI와 백엔드 API를 연결하면 최소한의 재작업으로 전환이 가능합니다. 세율 변경은 서버에서 일괄 관리하고, 접근 권한은 계정 단위로 제어하며, 명세서 출력은 자동화할 수 있습니다.

ⓘ NOTE
SpreadJS는 순수 클라이언트 사이드 라이브러리입니다. 서버 연동 없이도 계산 엔진이 브라우저에서 동작하며, 기존 ERP·그룹웨어와 REST API로 손쉽게 연동할 수 있습니다.

소득세·4대보험을 자동 계산하는 급여 시트 만드는 방법

sheet.setFormula() 를 사용하면 각 직원 행에 4대보험 공제 함수를 설정할 수 있습니다. 기본급 셀을 참조하므로 값이 바뀌면 국민연금·건강보험·고용보험이 즉시 재계산됩니다. 아래 예시는 2024년 기준 요율(국민연금 4.5%, 건강보험 3.545%, 고용보험 0.9%)을 적용한 10인 급여 시트입니다.

STEP 1: 라이브러리 참조

STEP 2: HTML 구조

STEP 3: JavaScript

실행 결과
💡 TIP
세율 변경 시 함수를 일괄 수정하려면 요율 값을 별도 "설정" 시트 셀에 저장하고 함수에서 참조하세요. 예: =ROUND(D2*설정!$B$1,0) . 요율 셀 하나만 수정하면 전 직원 계산이 자동 반영됩니다.

소득세 구간 세율을 SpreadJS 커스텀 함수로 캡슐화하는 방법

소득세 간이세액처럼 구간별 누진 세율 계산은 단순 수식 조합으로 표현하기 어렵습니다. GC.Spread.CalcEngine.Functions.Function 을 상속해 커스텀 함수를 정의하면 복잡한 로직을 =CALC_INCOME_TAX(D2) 형태로 셀에서 직접 호출할 수 있습니다. 한 번 등록한 함수는 워크북 전체 시트에서 공유됩니다.

STEP 2: HTML 구조

STEP 3: JavaScript

실행 결과
⭐ BEST PRACTICE
spread.addCustomFunction() 으로 워크북 레벨에 등록하면 모든 시트에서 공유됩니다. 세율 개정 시 서버에서 함수 정의를 내려받아 동적으로 교체하는 패턴이 실무에서 자주 사용됩니다.
소득세 구간 세율을 SpreadJS 커스텀 함수로 캡슐화하는 방법 — SpreadJS 개념도

조건부 서식으로 급여 공제 오류를 실시간으로 감지하는 방법

sheet.conditionalFormats.addCellValueRule() 을 사용하면 공제율이 기준을 초과하거나 공제 금액이 이상 범위에 들어올 때 셀 배경색·글자색을 자동 변경합니다. HR 담당자가 수백 건 데이터 중 이상값을 즉시 발견할 수 있어 검증 오류를 줄이는 데 효과적입니다.

STEP 2: HTML 구조

STEP 3: JavaScript

실행 결과
⚠ WARNING
addCellValueRule() 의 value2 파라미터는 Between / NotBetween 연산자에서만 의미가 있습니다. GreaterThan , LessThan 등 단항 연산자에서는 undefined 를 전달하면 됩니다.

웹에서 급여 명세서 PDF를 자동으로 생성하는 방법

PDF 출력은 Print·PDF 플러그인을 추가 로드한 후 spread.savePDF() 를 호출합니다. printInfo 객체로 격자선 숨김, 여백, 용지 크기 등을 세밀하게 제어할 수 있어 실무 수준의 급여 명세서를 생성할 수 있습니다.

추가 플러그인 로드 (STEP 1에 추가)

PDF 저장 코드

⭐ IMPORTANT
PDF 출력 시 한국어가 깨지지 않으려면 한글 폰트를 별도로 등록해야 합니다. 등록 방법은 SpreadJS PDF 한글 폰트 설정 가이드(3번 항목)를 참고하세요.
웹에서 급여 명세서 PDF를 자동으로 생성하는 방법 — SpreadJS 개념도

개발자가 자주 묻는 질문

Q01

SpreadJS로 웹 기반 급여 계산 시스템을 구현할 수 있나요?

네, 가능합니다. setFormula() 로 각 셀에 공제 수식을 지정하고, 커스텀 함수로 소득세 로직을 캡슐화하면 완전한 웹 급여 처리 시스템을 구축할 수 있습니다. IO 플러그인으로 기존 .xlsx 파일을 임포트하면 기존 Excel 급여 파일에서 웹으로 전환하는 작업도 최소화됩니다.

Q02

JavaScript에서 소득세와 4대보험 공제액을 자동으로 계산하려면 어떻게 하나요?

SpreadJS의 setFormula() 를 사용해 각 직원 행에 =ROUND(D2*0.045,0) 형식의 수식을 적용합니다. 소득세처럼 구간별 누진 세율 계산이 필요한 경우에는 GC.Spread.CalcEngine.Functions.Function 을 상속한 클래스를 작성하고 spread.addCustomFunction() 으로 워크북에 등록하면 됩니다.

Q03

웹 앱에서 급여 명세서를 PDF로 자동 출력하려면 어떻게 하나요?

SpreadJS Print·PDF 플러그인을 추가 로드한 후 spread.savePDF(successCb, errorCb, options, sheetIndex) 를 호출하면 현재 시트가 PDF 파일로 변환됩니다. 한국어 텍스트가 포함된 명세서의 폰트 설정 방법은 SpreadJS PDF 한글 폰트 설정 가이드 를 참고하세요.

Q04

기존 Excel 급여 파일을 SpreadJS 웹 앱으로 마이그레이션하는 방법은 무엇인가요?

IO 플러그인을 추가 로드한 후 spread.import() 에 .xlsx 파일 객체를 전달하면 서식·수식·데이터가 그대로 웹 환경에서 로드됩니다. 이후 웹 UI를 구성하고 백엔드 API와 연결하면 최소한의 재작업으로 전환이 가능합니다.

Q05

SpreadJS 커스텀 함수로 소득세 같은 복잡한 급여 공제 로직을 구현하는 방법은 무엇인가요?

GC.Spread.CalcEngine.Functions.Function 을 상속한 클래스에서 evaluate() 메서드를 재정의해 계산 로직을 구현합니다. 완성된 클래스를 spread.addCustomFunction() 으로 워크북에 등록하면 =CALC_INCOME_TAX(D2) 형식으로 내장 함수처럼 셀 수식에서 직접 호출할 수 있습니다.

MESCIUS SpreadJS

지금 바로 SpreadJS 를 무료로 체험해 보세요

30일 무료 체험판으로 모든 기능을 직접 확인하세요.

SpreadJS 무료 체험판 다운로드