SpreadJS 블로그 MESCIUS 기술 블로그 ·

SpreadJS로 계리 함수 기반 보험료 계산기 만드는 방법

웹 애플리케이션에서 보험료 계산 기능을 구현해야 하는 프론트엔드 개발자라면, 계리 수식을 JavaScript로 처음부터 재작성하는 대신 SpreadJS를 활용할 수 있습니다. SpreadJS(스프레드JS)는 500개 이상의 Excel 호환 수식 엔진을 브라우저에서 그대로 실행하는 JavaScript 스프레드시트 라이브러리로, 위험률·연금현가 같은 계리 함수를 커스텀 수식으로 등록해 셀에서 직접 호출할 수 있습니다.

React, Vue, Angular, Vanilla JS 등 어떤 프레임워크로 개발하더라도 '기존 Excel 계리 모델을 웹에 그대로 올려야 한다'는 요구사항은 흔한 도전 과제입니다. VLOOKUP·SUMPRODUCT로 얽힌 수식을 JavaScript 로직으로 변환하다 보면 부동소수점 오차와 수식 불일치가 발생하고, 결과 검증에 많은 시간이 소요됩니다.

이 글에서는 SpreadJS의 addCustomFunction API로 위험률(qx)·생존율(nPx)·연금현가(äx) 계리 함수를 등록하는 방법, Excel 계리 파일을 수식 손실 없이 가져오는 방법, 그리고 산출 결과를 PDF로 내보내는 전체 흐름을 단계별로 살펴봅니다.

⭐ Key Points
이 글에서 다루는 핵심 내용
01 SpreadJS의 500개 이상 Excel 호환 수식은 계리 모델에서 사용하는 VLOOKUP·SUMPRODUCT·IF를 JavaScript 재작성 없이 웹에서 그대로 실행합니다
02 addCustomFunction API를 사용하면 위험률(qx)·생존율(nPx)·연금현가(äx) 같은 계리 함수를 수식으로 등록해 셀에서 =MORTALITY(나이) 형태로 직접 호출할 수 있습니다
03 Excel 계리 파일(xlsx)을 수식·서식 손실 없이 가져오고 내보낼 수 있으며, includeFormulas:false 옵션으로 계리 로직은 숨기고 계산 결과만 외부에 공유할 수 있습니다
04 PDF 내보내기 기능으로 보험료 산출 결과를 계약자 제공용 확인서 형태로 버튼 한 번에 자동 출력할 수 있습니다
SpreadJS로 계리 함수 기반 보험료 계산기 만드는 방법 — 대표 이미지

계리 모델을 JavaScript 웹 앱으로 전환하기 어려운 이유

국내 보험사·보험대리점은 오랫동안 Excel로 계리 모델을 관리해 왔습니다. 순보험료·부가보험료·예정이율이 얽힌 수식, 위험률 테이블(생명표)을 참조하는 VLOOKUP, 납입기간별 연금현가를 산출하는 복잡한 배열 수식이 하나의 파일에 담깁니다.

이를 JavaScript로 재구현하면 수식 불일치와 부동소수점 오차 문제가 발생하고, 금융감독원 감리 시 계산 근거를 소명하기도 어렵습니다. 2026년 금융위원회의 보험업 IT시스템 고도화 권고로 웹 기반 보험료 산출 시스템 수요가 증가하는 지금, 재작성이 아닌 "그대로 가져오는" 접근이 필요합니다.

SpreadJS는 Excel 수식 엔진을 웹에 내장하므로, 기존 계리 모델을 다시 검증하는 비용 없이 웹으로 전환할 수 있습니다.

↗
500+
Excel 호환 수식
VLOOKUP·IF·SUMPRODUCT 즉시 사용
↗
~0줄
수식 재작성
기존 계리 모델 Import 후 바로 실행
↗
PDF
자동 출력
계약자용 보험료 확인서 즉시 생성

SpreadJS에서 계리 함수를 커스텀 수식으로 등록하는 방법

SpreadJS는 GC.Spread.CalcEngine.Functions.Function 을 상속해 사용자 정의 수식 함수를 만들고, spread.addCustomFunction() 으로 등록하면 셀 수식에서 직접 호출할 수 있습니다. 위험률(qx)·생존율(nPx)·연금현가(äx) 같은 계리 함수를 이 방식으로 등록하면 =MORTALITY(B3) , =SURVIVAL(B3,B4) 형태의 계리사 친화적 수식을 셀 안에서 그대로 사용할 수 있습니다.

아래 데모는 위험률 테이블 기반 계리 함수 3종을 등록하고, 40세 피보험자의 월 보험료(순보험료·영업보험료)를 자동 산출하는 미니 보험료 계산기입니다. '위험률 테이블' 탭에서 나이별 위험률 데이터도 확인할 수 있습니다.

STEP 1: 라이브러리 참조 (CDN)

STEP 2: HTML 구조

STEP 3: 계리 커스텀 함수 등록 및 보험료 산출

실행 결과
💡 TIP
spread.addCustomFunction() 으로 등록한 계리 함수는 셀 수식에서 =MORTALITY(B3) , =ANNUITYPV(B3, B4, B7/100) 형태로 직접 호출됩니다. 계리사가 Excel에서 쓰던 방식 그대로 웹에서도 수식을 유지할 수 있습니다.
ⓘ NOTE
위 예시의 위험률 데이터는 개념 설명용 간소화 값입니다. 실제 구현 시에는 금융감독원 표준생명표(제8회) 데이터를 바인딩하세요.
SpreadJS에서 계리 함수를 커스텀 수식으로 등록하는 방법 — SpreadJS 개념도

계리 함수가 담긴 Excel 파일을 웹 앱에서 가져오고 내보내는 방법

SpreadJS는 Excel 계리 모델 파일(xlsx)을 workbook.import() 메서드로 가져오고 workbook.export() 로 다시 내보내며, 그 과정에서 수식·서식을 그대로 유지합니다. VLOOKUP으로 구성된 위험률 참조 수식, SUMPRODUCT 기반 연금현가 배열 수식도 재작성 없이 웹에서 실행됩니다.

아래 데모는 페이지가 열리자마자 위험률(MORTALITY)·생존율(SURVIVAL)·연금현가(ANNUITYPV) 계리 함수가 이미 반영된 Excel 리포트를 보여줍니다. Excel 내보내기(수식포함)으로 현재 상태를 xlsx로 저장한 뒤, 그 파일을 다시 Excel 가져오기로 불러오면 계리 함수 수식이 그대로 재계산되는지 셀 값으로 즉시 검수할 수 있습니다.

계리 함수의 실제 계산 로직은 JS 코드로만 구현되어 있고 xlsx 파일에는 저장되지 않으므로, 보험료 산출 공식 자체는 항상 사내 코드베이스 안에 안전하게 남습니다. 다만 수식포함으로 내보내면 =MORTALITY(B4) 처럼 어떤 함수를 어떤 인수로 호출했는지는 파일에 텍스트로 남기 때문에, 계산에 사용한 함수 구성까지 외부에 드러내고 싶지 않을 수 있습니다. 이럴 때는 Excel 내보내기(값만)을 사용해 수식을 완전히 제거하고 계산된 숫자만 내보내면, 계리 모델의 구조를 노출하지 않고 산출 결과만 협력사·고객과 공유할 수 있습니다.

STEP 1: IO 플러그인 추가

STEP 2: HTML 구조

STEP 3: 계리 함수 리포트 초기화 + Excel 가져오기/내보내기

실행 결과
⭐ IMPORTANT
workbook.import() / workbook.export() 는 IO 플러그인( gc.spread.sheets.io.x.x.x.min.js ) 로드 후에만 동작합니다. 플러그인 없이 호출하면 메서드를 찾지 못해 오류가 발생합니다.
⚠ WARNING
내보내기(수식포함)은 xlsx 파일에 수식 텍스트( =MORTALITY(B4) )와 마지막 계산값을 함께 저장하며, 커스텀 함수의 JS 구현 자체는 포함되지 않습니다. 다른 브라우저·세션에서 이 파일을 가져올 때 spread.addCustomFunction() 으로 동일한 함수를 먼저 등록해두지 않으면 해당 셀은 #NAME? 오류로 표시됩니다.
⭐ IMPORTANT
export() 의 includeFormulas: false 옵션은 계산 로직을 보호하는 실질적인 방법입니다. 내보내기(값만)으로 저장한 파일을 열어보면 셀에는 계산된 숫자만 있고 수식은 아예 존재하지 않습니다 — MORTALITY , ANNUITYPV 같은 함수 이름조차 파일 어디에도 남지 않으므로, 회사의 계리 모델·계산 로직을 공개하지 않고 산출 결과만 감독기관·고객에게 전달해야 하는 경우에 적합합니다.
💡 TIP
가져오기 완료 콜백에서 계리 함수가 반환한 셀 값을 직접 읽어( sheet.getValue(row, col) ) 숫자인지 확인하면, 내보내기·가져오기 왕복 후에도 계리 수식이 깨지지 않았는지 자동으로 검수할 수 있습니다.

보험료 산출 결과를 PDF로 내보내는 방법

SpreadJS는 spread.savePDF() 메서드로 현재 워크북을 PDF로 내보냅니다. printInfo 객체로 인쇄 영역·여백·방향을 미리 설정해두면 계약자 제공용 보험료 확인서를 버튼 한 번에 생성할 수 있습니다. 아래 데모는 보험료 확인서 시트를 구성하고, PDF로 직접 다운로드하는 전체 흐름을 보여줍니다.

STEP 1: Print·PDF 플러그인 추가 (순서 엄수)

STEP 2: HTML 구조

STEP 3: PDF 내보내기 구현

실행 결과
⚠ WARNING
PDF 내보내기는 반드시 Print 플러그인을 PDF 플러그인보다 먼저 로드해야 합니다. 순서가 바뀌면 savePDF() 호출 시 내부 의존성 오류가 발생합니다.
⭐ BEST PRACTICE
pi.fitPagesTall(1) + pi.fitPagesWide(1) 로 보험료 확인서를 1페이지에 맞추면, 별도 페이지 조정 없이 깔끔한 계약자용 문서가 생성됩니다. pi.showGridLine(false) 로 격자선을 숨기면 인쇄 품질이 크게 향상됩니다. pi.showRowHeader() / pi.showColumnHeader() 를 PrintVisibilityType.hide 로 설정하면 SpreadJS의 행 번호·열 문자(A, B, 1, 2...)가 출력물에서 사라지고 확인서 내용만 남습니다.
⚠ WARNING
SpreadJS PDF 플러그인의 기본 폰트는 한글을 지원하지 않아, 폰트 등록 없이 savePDF() 를 호출하면 한글이 깨지거나 빈 사각형으로 출력됩니다. 위 데모처럼 PDFFontsManager.registerFont() 로 한글 폰트(NanumGothic)를 미리 등록하고, savePDF() 호출 전 반드시 await koreanFontPromise 로 로드 완료를 기다려야 합니다. 폰트는 fonts.gstatic.com 이 아닌 cdn.jsdelivr.net 에서 받아야 합니다 — gstatic은 CORS로 차단됩니다.
보험료 산출 결과를 PDF로 내보내는 방법 — SpreadJS 개념도

개발자가 자주 묻는 질문

Q01

JavaScript로 웹 보험료 계산기를 구현할 때 적합한 라이브러리는 무엇인가요?

SpreadJS는 500개 이상 Excel 호환 수식과 addCustomFunction API를 제공해, 위험률·연금현가·생존율 같은 계리 함수를 셀 수식으로 직접 등록할 수 있습니다. 기존 Excel 계리 모델과의 수식 호환성을 유지하면서 웹 기반 보험료 계산기를 구현하는 데 적합한 선택입니다.

Q02

Excel로 관리 중인 계리 모델을 웹 시스템으로 어떻게 전환할 수 있나요?

SpreadJS를 사용하면 기존 Excel 계리 파일의 수식·서식을 그대로 웹 보험료 산출 시스템으로 전환할 수 있습니다. workbook.import(file) 한 줄로 xlsx를 로드하면 VLOOKUP·SUMPRODUCT 같은 복잡한 계리 수식도 재작성 없이 브라우저에서 실행되며, workbook.export() 로 xlsx로 다시 내보내 수식 보존 여부를 검수할 수 있습니다.

Q03

보험료 계산 공식을 웹 애플리케이션에서 Excel과 동일하게 실행하려면 어떻게 해야 하나요?

SpreadJS의 내장 수식 엔진은 Excel과 동일한 계산 결과를 보장합니다. 순보험료·부가보험료·예정이율이 복잡하게 얽힌 수식을 셀에 그대로 입력하고, 커스텀 함수로 표준생명표 참조 함수를 추가하면 Excel 계리 모델과 동일한 산출 결과를 웹에서 얻을 수 있습니다.

Q04

SpreadJS로 계리 함수 기반 보험료 계산기를 직접 만들 수 있나요?

가능합니다. GC.Spread.CalcEngine.Functions.Function 을 상속해 위험률(qx)·생존율(nPx)·연금현가(äx) 함수를 정의하고 spread.addCustomFunction() 으로 등록하면, 셀 안에서 =MORTALITY(나이) , =ANNUITYPV(나이, 기간, 이율) 형태로 호출하는 계리 계산기를 VanillaJS만으로 만들 수 있습니다.

Q05

위험률 테이블·예정이율·연금현가 같은 보험 수식을 JavaScript로 계산하는 방법이 있나요?

SpreadJS의 addCustomFunction API를 활용하면 위험률 테이블 조회·생존율 누적 계산·예정이율 기반 현가 계산 로직을 JavaScript 클래스로 구현하고 수식으로 등록할 수 있습니다. 이렇게 등록한 함수는 일반 Excel 함수처럼 다른 셀 수식 안에서 중첩 호출이 가능하고, 수식 재계산도 자동으로 처리됩니다.

MESCIUS SpreadJS

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

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

SpreadJS 무료 체험판 다운로드