SERVICENBLOG
← 프로젝트 목록으로

외주종료

보험사 실적 정산 프로그램

보험사별 시책을 규칙으로 등록하고, 실적 엑셀을 올려 모집자 지급액을 자동 계산한다

대표 이미지
대표 이미지

소개

  • 이 프로그램은 보험대리점에서 매월 받는 시책(인센티브) 안내문을, 사람이 엑셀로 다시 짜지 않고 시스템이 이해하도록 바꾸는 데스크톱 정산기입니다.

  • 처음 문제는 단순했습니다. 보험사마다 시책 문장이 다르고, 상품 키워드·납입기간·구간 금액이 매달 바뀝니다. 실적 파일의 보험사 표기도 삼성생명, 삼성생명보험처럼 갈라집니다. 그걸 손으로 맞추면 지급액이 틀리고, 왜 빠졌는지 찾기 어렵습니다.

  • 지금은 그 과정을 네 칸으로 나눴습니다. 데이터 관리는 실적 엑셀을 받아 개인정보를 빼고 계약만 남깁니다. 규칙 관리는 시책 텍스트를 TSV로 바꾸거나, 전월 규칙을 복사하거나, 화면에서 직접 고칩니다. 정산 결과는 규칙과 실적을 맞춰 지급액을 내고, 빠진 건은 제외 목록과 매칭 진단으로 이유를 보여 줍니다. 설정은 보험사 마스터와 실적 파일의 별칭을 연결합니다.

  • 이 프로그램의 날짜는 “파일을 언제 올렸는가”보다 어느 정산월을 돌리는가입니다. 규칙은 월별로 쌓이고, 계산식은 결과 화면에 ₩49,058 × 250% = ₩122,645처럼 남습니다. 배포본은 Python 없이 돌아가는 ATAInsuranceSettlement.exe입니다.

  • 2026년 1월 기준으로 생명·손해 29개사 시책 규칙을 텍스트로 갖고 있습니다. ABL, AIG, DB, IBK연금, IM라이프, KB, KDB, NH농협, 교보, 동양, 라이나, 롯데, 메리츠, 메트라이프, 미래에셋, 삼성, 신한, 카디프, 하나, 한화, 현대, 흥국 등입니다.

흐름 요약

한 달 정산은 네 번에 맞춰져 있습니다. 사용자는 파일을 올리고 규칙을 확인한 뒤 버튼을 누릅니다.

  1. 정산월 선택 → 실적 엑셀 업로드 (같은 월은 덮어씀)

  2. 시책 등록 → 보험사 안내문을 자연어 변환하거나 TSV로 넣거나, 지난달 규칙을 복사

  3. 정산 실행 → 보험사 전체 또는 선택 회사만 계산

  4. 결과 확인 → 적용시책·계산식 확인 후 엑셀 다운로드. 빠진 건은 정산제외와 매칭 진단으로 확인

엑셀만 맞으면, 이후 계산과 사유 추적은 프로그램이 합니다.

기능

데이터 관리 — 실적 엑셀

  • 실적 파일에서 연락처·주소는 빼고, 정산에 쓰는 항목만 저장합니다.

  • 마감월, 사업단, 모집자, 사번, 보험사, 증권번호, 계약자, 피보험자, 본인가족, 상품명, 상품군, 계약일, 납입방법, 납입기간, 초회보험료, 신계약정산보험료, 정산평가인정입니다.

  • 미리보기에서 마감월·모집자·보험사·상품명으로 찾고, 최근 500건을 페이징합니다.

  • 같은 정산월을 다시 올리면 기존 건을 지우고 다시 넣습니다.

규칙 관리 — 시책을 기계가 읽게

  • 보험사 안내문을 그대로 붙여 넣으면 자연어 → TSV로 바꿉니다.

  • 변환 결과는 셀에서 고친 뒤 파일로 저장하거나 DB에 넣습니다. 규칙은 직접 추가, 더블클릭 수정, 지난달 복사, TSV 일괄 임포트, 선택·전체 삭제로 관리합니다.

  • 상품은 포함 키워드·제외 키워드·제외 상품으로 고릅니다. 보험료 구간, 납입기간, 건당·합산 최대인정실적도 규칙에 넣습니다.

  • 시책 구분은 일곱 가지입니다.

    • 익월시책 — 건별 보험료 × 비율 또는 정액

    • 13회시책 / 15회시책 — 회차 시점 지급, 계산은 익월과 같음

    • 기간합산 — 모집자 합산 후 구간별 정액

    • 건당시상 — 건별 조건 충족 시 정액

    • 연속가동 — 전기간과 당기간을 모두 채워야 지급

    • 분기멤버스 — 3개월 연속 조건. 세 달 데이터가 있어야 계산

정산 엔진 — 맞춘 뒤 식을 남김

  • 정산 결과는 모집자·보험사·시책명·적용시책·계산식·대상보험료·계약건수·지급액·증권번호·상품명을 보여 줍니다. 적용시책과 계산식은 엑셀에도 같이 나갑니다.

  • 정산에 안 들어간 건은 정산제외 탭에 모입니다. 반영 건 + 제외 건이 업로드 건수와 맞는지 검증 표시가 있습니다.

  • 규칙 매칭 진단은 상품이 왜 빠졌는지 단계로 봅니다. 보험사 매핑, 적용월, 키워드, 납입기간, 보험료 조건을 하나씩 검사한 뒤 계산 엔진으로 최종 확인합니다.

설정 — 보험사 이름 맵핑

  • 왼쪽은 마스터(손해/생명/기타), 오른쪽은 실적 파일의 별칭 매핑입니다.

  • 이름이 같으면 자동 연결하고, 영문 소문자는 저장 시 대문자로 맞춥니다. 정산 엔진은 보험사 비교를 대소문자 무시로 합니다.

사용기술

  • Python 3.10+
  • PyQt6
  • qt-material
  • pandas