웹 재무제표 시스템에 SpreadJS 도입하기: 전표·계정과목·xlsx 개발 가이드
웹 개발자가 처음 '엑셀 같은 재무제표 화면을 웹 앱에 넣어달라'는 요청을 받으면 어디서 시작해야 할지 막막합니다. SpreadJS는 JavaScript만으로 Excel 수준의 스프레드시트 기능—셀 수식, 데이터 유효성 검사, 셀 보호, 조건부 서식, xlsx 내보내기—을 웹 앱에 내장할 수 있는 컴포넌트 라이브러리입니다.
재무·회계 현장에서 Excel 월결산의 핵심 문제는 세 가지입니다. 첫째, 담당자마다 파일 버전이 뒤섞이고, 둘째, 계정과목을 직접 타이핑하다 오입력이 발생하며, 셋째, 집계 셀을 실수로 덮어 쓰면 재집계가 필요해집니다. SpreadJS를 도입하면 이 세 가지 문제를 하나의 웹 앱으로 해결할 수 있습니다.
이 가이드에서는 계정과목 드롭다운( createListValidator
), 집계 셀 보호( Locked
+ isProtected
), SUMIF 수식을 이용한 합계잔액시산표 자동 집계, 그리고 spread.export()
로 xlsx 파일을 다운로드하는 흐름을 Vanilla JavaScript 코드와 함께 단계별로 구현합니다. React나 Vue를 사용하는 프로젝트에서도 동일한 API를 그대로 적용할 수 있습니다.
Locked
+ isProtected
로 수식·집계 셀을 편집 불가 상태로 보호합니다
spread.export()
로 1클릭 xlsx 생성: 월결산 확정 후 감사·보고 목적의 xlsx 파일을 1클릭으로 내보냅니다

Excel 월결산을 웹 앱으로 이전하면 무엇이 개선되나요?
국내 중견·대기업 재무팀의 월결산 흐름은 보통 이렇습니다. 전표 담당자가 각자 Excel을 작성하고 → 파일을 취합해 계정과목별로 분류하고 → 합계잔액시산표와 손익계산서를 별도 양식에 붙여 넣습니다. 이 과정에서 계정과목 오입력, 수식 참조 오류, 버전 충돌이 반복됩니다.
SpreadJS는 xlsx 가져오기·내보내기, 셀 보호, 데이터 유효성 검사, 조건부 서식을 모두 지원하므로 기존 Excel 양식을 웹 화면으로 거의 그대로 이식할 수 있습니다. 여기에 권한 제어와 협업 기능을 더하면 담당자 의존성을 제거하고 월결산 품질을 시스템으로 보장할 수 있습니다.
전표 입력 오류를 막는 계정과목 드롭다운 구현하기
전표 입력 시 계정과목 코드를 직접 타이핑하면 오입력이 발생합니다. SpreadJS의 createListValidator
로 계정과목 드롭다운을 만들면 사용자는 목록에서 선택하기만 하면 됩니다. 입력 도중 접두어가 일치하는 항목을 실시간으로 필터링해 보여주므로 자동완성 효과도 얻을 수 있습니다.
STEP 1: CDN 참조
STEP 2: HTML 구조
STEP 3: 계정과목 드롭다운 데모
createListValidator
의 목록을 별도 시트(예: "계정코드" 시트)에 관리하고 createFormulaListValidator('계정코드!A1:A50')
방식으로 연결하면 계정과목 추가·변경 시 한 곳만 수정하면 됩니다.
집계·수식 셀을 보호하는 방법: Locked와 isProtected 활용 가이드
전표 입력 화면에서 합계나 수식 셀을 실수로 수정하면 집계가 틀어집니다. SpreadJS의 isProtected
로 시트를 보호하고, 입력 셀만 locked(false)
로 풀어 두면 사용자는 입력란만 편집할 수 있고 집계 셀은 읽기 전용이 됩니다.
STEP 1: CDN 참조
STEP 2: HTML 구조
STEP 3: 셀 보호 데모
Locked
속성과 sheet.options.isProtected
로 입력란만 편집하고 수식 셀은 자동 계산 상태로 유지할 수 있습니다. 기본적으로 모든 셀이 locked=true
이므로, 먼저 전체를 locked=false
로 풀고 집계 셀만 다시 locked(true)
로 설정하는 것이 핵심입니다.예산 초과 항목을 자동으로 강조 표시하는 조건부 서식 설정법
예산 대비 실적이 초과된 항목을 한눈에 파악하려면 조건부 서식이 효과적입니다. addFormulaRule
에 =C2>B2
같은 수식 조건과 빨간색 스타일을 적용하면 실적이 예산을 넘는 순간 해당 행의 셀이 자동으로 강조됩니다.
STEP 1: CDN 참조
STEP 2: HTML 구조
STEP 3: 조건부 서식 데모
addFormulaRule
의 수식은 적용 범위의 첫 번째 셀(D2) 기준 상대 참조로 해석되므로 =C2>B2
하나로 모든 행에 적용되며, 범위 파라미터는 반드시 GC.Spread.Sheets.Range
객체 배열로 전달해야 합니다. 조건부 서식은 시트 보호와 독립적으로 동작하므로 isProtected = true
상태에서도 값 변화에 따라 서식이 자동 갱신됩니다.
SUMIF 함수로 합계잔액시산표 자동 집계하는 방법
전표 데이터를 계정과목별로 집계하는 합계잔액시산표는 SUMIF
수식으로 자동화할 수 있습니다. SpreadJS의 수식 엔진은 Excel과 동일하게 동작하므로 기존 Excel 수식을 그대로 이식할 수 있습니다.
STEP 1: CDN 참조
STEP 2: HTML 구조
STEP 3: SUMIF 시산표 데모
시트명!범위
)은 Excel과 동일하게 동작합니다. 전표 데이터를 한 시트에 쌓고 집계 시트에서 SUMIF
로 참조하면 전표가 추가될 때마다 시산표가 자동 갱신되는 라이브 집계 구조를 만들 수 있습니다.월결산 완료 후 xlsx 파일을 1클릭으로 다운로드하는 방법
월결산이 완료되면 감사·보고용 Excel 파일이 필요합니다. SpreadJS의 IO 플러그인과 spread.export()
를 사용하면 현재 스프레드시트 상태를 그대로 xlsx 파일로 저장할 수 있습니다.
STEP 1: IO 플러그인 추가
STEP 2: HTML 구조
STEP 3: xlsx 내보내기 데모
spread.export(successCallback, errorCallback, { fileType: GC.Spread.Sheets.FileType.excel })
패턴을 사용하고, 콜백에서 blob을 URL.createObjectURL()
로 다운로드해야 합니다.개발자가 자주 묻는 질문 (FAQ)
월결산 업무를 웹 앱으로 자동화할 때 어떤 JavaScript 스프레드시트 라이브러리를 쓰면 좋을까요?
SpreadJS는 500개 이상의 Excel 함수와 xlsx 내보내기를 지원해 웹 기반 월결산 시스템 구축에 적합합니다. SUM·SUMIF·IF 같은 재무 집계 함수를 추가 설정 없이 바로 사용할 수 있으며, 기존 Excel 양식을 웹으로 이식하는 작업 시간을 크게 줄여줍니다.
SpreadJS에서 계정과목 드롭다운을 셀에 적용하는 코드가 궁금합니다?
GC.Spread.Sheets.DataValidation.createListValidator('계정1,계정2,...')
로 목록형 유효성 검사 객체를 생성하고, sheet.setDataValidator(row, col, dv)
를 호출해 원하는 셀에 연결합니다. 셀 클릭 시 드롭다운이 열리고 입력 중 접두어 일치 항목을 실시간으로 필터링해 보여줍니다.
SpreadJS로 수식 셀은 잠그고 입력 셀만 편집 가능하게 만들려면 어떻게 하나요?
먼저 setDefaultStyle(unlockedStyle)
로 시트 전체를 편집 가능하게 열어 두고, 집계·수식이 있는 셀에만 cellRange.locked(true)
를 적용합니다. 마지막으로 sheet.options.isProtected = true
를 설정하면 SpreadJS의 Locked
속성과 sheet.options.isProtected
가 함께 동작해 입력 셀만 편집 가능한 전표 화면이 완성됩니다.
Excel로 관리하던 재무제표를 웹 앱으로 전환하면 어떤 이점이 있고 어떤 기술 스택이 필요한가요?
버전 충돌 없는 중앙집중 관리, 계정과목 오입력 사전 차단, 역할 기반 접근 제어를 적용할 수 있습니다. SpreadJS 하나로 UI·수식·유효성 검사·셀 보호·xlsx 내보내기를 모두 처리할 수 있으며, 로그인·권한 관리를 위한 백엔드 API(Node.js, Spring 등)가 추가로 필요합니다.
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 파일이 즉시 다운로드됩니다.
