SpreadJS 블로그 MESCIUS 기술 블로그 ·

웹 재무제표 시스템에 SpreadJS 도입하기: 전표·계정과목·xlsx 개발 가이드

웹 개발자가 처음 '엑셀 같은 재무제표 화면을 웹 앱에 넣어달라'는 요청을 받으면 어디서 시작해야 할지 막막합니다. SpreadJS는 JavaScript만으로 Excel 수준의 스프레드시트 기능—셀 수식, 데이터 유효성 검사, 셀 보호, 조건부 서식, xlsx 내보내기—을 웹 앱에 내장할 수 있는 컴포넌트 라이브러리입니다.

재무·회계 현장에서 Excel 월결산의 핵심 문제는 세 가지입니다. 첫째, 담당자마다 파일 버전이 뒤섞이고, 둘째, 계정과목을 직접 타이핑하다 오입력이 발생하며, 셋째, 집계 셀을 실수로 덮어 쓰면 재집계가 필요해집니다. SpreadJS를 도입하면 이 세 가지 문제를 하나의 웹 앱으로 해결할 수 있습니다.

이 가이드에서는 계정과목 드롭다운( createListValidator ), 집계 셀 보호( Locked + isProtected ), SUMIF 수식을 이용한 합계잔액시산표 자동 집계, 그리고 spread.export() 로 xlsx 파일을 다운로드하는 흐름을 Vanilla JavaScript 코드와 함께 단계별로 구현합니다. React나 Vue를 사용하는 프로젝트에서도 동일한 API를 그대로 적용할 수 있습니다.

⭐ Key Points
이 글에서 다루는 핵심 내용
01 500개 이상 Excel 호환 수식 내장: SUM·SUMIF·IF 같은 재무 집계 함수를 추가 라이브러리 없이 웹 앱에서 그대로 실행할 수 있습니다
02 Data Validation 드롭다운으로 계정과목 오입력 방지: 입력 오류를 사전 차단하고, Locked + isProtected 로 수식·집계 셀을 편집 불가 상태로 보호합니다
03 조건부 서식으로 예산 초과 자동 경보: 초과 항목에 자동 빨간색 하이라이트를 적용해 이상 수치를 한눈에 파악할 수 있습니다
04 IO 플러그인 spread.export() 로 1클릭 xlsx 생성: 월결산 확정 후 감사·보고 목적의 xlsx 파일을 1클릭으로 내보냅니다
웹 재무제표 시스템에 SpreadJS 도입하기: 전표·계정과목·xlsx 개발 가이드 — 대표 이미지

Excel 월결산을 웹 앱으로 이전하면 무엇이 개선되나요?

국내 중견·대기업 재무팀의 월결산 흐름은 보통 이렇습니다. 전표 담당자가 각자 Excel을 작성하고 → 파일을 취합해 계정과목별로 분류하고 → 합계잔액시산표와 손익계산서를 별도 양식에 붙여 넣습니다. 이 과정에서 계정과목 오입력, 수식 참조 오류, 버전 충돌이 반복됩니다.

SpreadJS는 xlsx 가져오기·내보내기, 셀 보호, 데이터 유효성 검사, 조건부 서식을 모두 지원하므로 기존 Excel 양식을 웹 화면으로 거의 그대로 이식할 수 있습니다. 여기에 권한 제어와 협업 기능을 더하면 담당자 의존성을 제거하고 월결산 품질을 시스템으로 보장할 수 있습니다.

ⓘ NOTE
SpreadJS는 500개 이상의 Excel 호환 함수를 지원하며 SUM·SUMIF·VLOOKUP 등 재무 계산에 필수적인 함수를 포함합니다. (출처: SpreadJS Formula Reference)

전표 입력 오류를 막는 계정과목 드롭다운 구현하기

전표 입력 시 계정과목 코드를 직접 타이핑하면 오입력이 발생합니다. SpreadJS의 createListValidator 로 계정과목 드롭다운을 만들면 사용자는 목록에서 선택하기만 하면 됩니다. 입력 도중 접두어가 일치하는 항목을 실시간으로 필터링해 보여주므로 자동완성 효과도 얻을 수 있습니다.

STEP 1: CDN 참조

STEP 2: HTML 구조

STEP 3: 계정과목 드롭다운 데모

실행 결과
💡 TIP
createListValidator 의 목록을 별도 시트(예: "계정코드" 시트)에 관리하고 createFormulaListValidator('계정코드!A1:A50') 방식으로 연결하면 계정과목 추가·변경 시 한 곳만 수정하면 됩니다.
전표 입력 오류를 막는 계정과목 드롭다운 구현하기 — SpreadJS 개념도

집계·수식 셀을 보호하는 방법: Locked와 isProtected 활용 가이드

전표 입력 화면에서 합계나 수식 셀을 실수로 수정하면 집계가 틀어집니다. SpreadJS의 isProtected 로 시트를 보호하고, 입력 셀만 locked(false) 로 풀어 두면 사용자는 입력란만 편집할 수 있고 집계 셀은 읽기 전용이 됩니다.

STEP 1: CDN 참조

STEP 2: HTML 구조

STEP 3: 셀 보호 데모

실행 결과
⭐ IMPORTANT
SpreadJS의 셀 보호 패턴: SpreadJS의 Locked 속성과 sheet.options.isProtected 로 입력란만 편집하고 수식 셀은 자동 계산 상태로 유지할 수 있습니다. 기본적으로 모든 셀이 locked=true 이므로, 먼저 전체를 locked=false 로 풀고 집계 셀만 다시 locked(true) 로 설정하는 것이 핵심입니다.

예산 초과 항목을 자동으로 강조 표시하는 조건부 서식 설정법

예산 대비 실적이 초과된 항목을 한눈에 파악하려면 조건부 서식이 효과적입니다. addFormulaRule 에 =C2>B2 같은 수식 조건과 빨간색 스타일을 적용하면 실적이 예산을 넘는 순간 해당 행의 셀이 자동으로 강조됩니다.

STEP 1: CDN 참조

STEP 2: HTML 구조

STEP 3: 조건부 서식 데모

실행 결과
⚠ WARNING
addFormulaRule 의 수식은 적용 범위의 첫 번째 셀(D2) 기준 상대 참조로 해석되므로 =C2>B2 하나로 모든 행에 적용되며, 범위 파라미터는 반드시 GC.Spread.Sheets.Range 객체 배열로 전달해야 합니다. 조건부 서식은 시트 보호와 독립적으로 동작하므로 isProtected = true 상태에서도 값 변화에 따라 서식이 자동 갱신됩니다.
예산 초과 항목을 자동으로 강조 표시하는 조건부 서식 설정법 — SpreadJS 개념도

SUMIF 함수로 합계잔액시산표 자동 집계하는 방법

전표 데이터를 계정과목별로 집계하는 합계잔액시산표는 SUMIF 수식으로 자동화할 수 있습니다. SpreadJS의 수식 엔진은 Excel과 동일하게 동작하므로 기존 Excel 수식을 그대로 이식할 수 있습니다.

STEP 1: CDN 참조

STEP 2: HTML 구조

STEP 3: SUMIF 시산표 데모

실행 결과
⭐ BEST PRACTICE
SpreadJS의 크로스시트 수식( 시트명!범위 )은 Excel과 동일하게 동작합니다. 전표 데이터를 한 시트에 쌓고 집계 시트에서 SUMIF 로 참조하면 전표가 추가될 때마다 시산표가 자동 갱신되는 라이브 집계 구조를 만들 수 있습니다.

월결산 완료 후 xlsx 파일을 1클릭으로 다운로드하는 방법

월결산이 완료되면 감사·보고용 Excel 파일이 필요합니다. SpreadJS의 IO 플러그인과 spread.export() 를 사용하면 현재 스프레드시트 상태를 그대로 xlsx 파일로 저장할 수 있습니다.

STEP 1: IO 플러그인 추가

STEP 2: HTML 구조

STEP 3: xlsx 내보내기 데모

실행 결과
⭐ IMPORTANT
Excel 내보내기는 반드시 spread.export(successCallback, errorCallback, { fileType: GC.Spread.Sheets.FileType.excel }) 패턴을 사용하고, 콜백에서 blob을 URL.createObjectURL() 로 다운로드해야 합니다.

개발자가 자주 묻는 질문 (FAQ)

Q01

월결산 업무를 웹 앱으로 자동화할 때 어떤 JavaScript 스프레드시트 라이브러리를 쓰면 좋을까요?

SpreadJS는 500개 이상의 Excel 함수와 xlsx 내보내기를 지원해 웹 기반 월결산 시스템 구축에 적합합니다. SUM·SUMIF·IF 같은 재무 집계 함수를 추가 설정 없이 바로 사용할 수 있으며, 기존 Excel 양식을 웹으로 이식하는 작업 시간을 크게 줄여줍니다.

Q02

SpreadJS에서 계정과목 드롭다운을 셀에 적용하는 코드가 궁금합니다?

GC.Spread.Sheets.DataValidation.createListValidator('계정1,계정2,...') 로 목록형 유효성 검사 객체를 생성하고, sheet.setDataValidator(row, col, dv) 를 호출해 원하는 셀에 연결합니다. 셀 클릭 시 드롭다운이 열리고 입력 중 접두어 일치 항목을 실시간으로 필터링해 보여줍니다.

Q03

SpreadJS로 수식 셀은 잠그고 입력 셀만 편집 가능하게 만들려면 어떻게 하나요?

먼저 setDefaultStyle(unlockedStyle) 로 시트 전체를 편집 가능하게 열어 두고, 집계·수식이 있는 셀에만 cellRange.locked(true) 를 적용합니다. 마지막으로 sheet.options.isProtected = true 를 설정하면 SpreadJS의 Locked 속성과 sheet.options.isProtected 가 함께 동작해 입력 셀만 편집 가능한 전표 화면이 완성됩니다.

Q04

Excel로 관리하던 재무제표를 웹 앱으로 전환하면 어떤 이점이 있고 어떤 기술 스택이 필요한가요?

버전 충돌 없는 중앙집중 관리, 계정과목 오입력 사전 차단, 역할 기반 접근 제어를 적용할 수 있습니다. SpreadJS 하나로 UI·수식·유효성 검사·셀 보호·xlsx 내보내기를 모두 처리할 수 있으며, 로그인·권한 관리를 위한 백엔드 API(Node.js, Spring 등)가 추가로 필요합니다.

Q05

JavaScript에서 스프레드시트 데이터를 xlsx 파일로 저장해 다운로드하는 방법을 알려주세요?

IO 플러그인( gc.spread.sheets.io.{버전}.min.js )을 스크립트 태그로 로드한 뒤, spread.export(successCb, errorCb, { fileType: GC.Spread.Sheets.FileType.excel }) 을 호출합니다. 성공 콜백에서 받은 blob 을 URL.createObjectURL(blob) 으로 임시 URL을 만들고 <a> 태그로 클릭 이벤트를 트리거하면 브라우저에서 xlsx 파일이 즉시 다운로드됩니다.

MESCIUS SpreadJS

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

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

SpreadJS 무료 체험판 다운로드