세무 자동화 시스템 v7.0 — 사용자 매뉴얼
대표자: 김혜정
관리 사업체: 킴스홈즈 · 킴스아이텍 · 킴스올디자인 · 킴스매트로
시스템 주소: http://localhost:3030
📌 시작하기
서버 실행
``
cd tax-automation
"C:\Program Files\nodejs\node.exe" server.js
`
브라우저에서 http://localhost:3030 접속
📂 탭별 사용법
1. 📂 데이터 업로드
홈택스에서 받은 전자세금계산서, 카드사 Excel, 통장내역을 올리는 탭
1. 사업체 선택 (킴스홈즈 / 킴스아이텍 / 킴스올디자인 / 킴스매트로)
2. 파일 유형 선택:
- 전자세금계산서: 홈택스 → 전자(세금)계산서 합계표 → 조회 → Excel 다운로드
- 카드내역: 카드사 홈페이지 → 이용내역 → Excel 다운로드
- 통장내역: 인터넷뱅킹 → 거래내역 → Excel 다운로드
- 급여: 직원 정보(이름, 기본급, 수당 등) Excel 입력 후 업로드
3. 파일을 드래그앤드롭 또는 클릭으로 업로드
4. 업로드 즉시 자동 파싱 + 저장
💡 한 번 업로드된 데이터는 서버 재시작 후에도 유지됩니다 (Phase 6 파일 DB)
2. 📒 분개장
업로드된 데이터 → 자동 분개 (차변/대변 자동 생성)
- 소스별 필터 (전자세금계산서 / 카드 / 통장 / 급여)
- 🔴 검토필요 항목: 가지급금 의심 거래 자동 표시
- 대차 검증: 차변합계 = 대변합계 자동 확인
3. 🧮 부가세 신고서
업로드 데이터 기반 부가세 자동 계산
- 과세·영세율·면세 매출 자동 분리
- 공제/불공제 매입 자동 구분
- 납부(환급)세액 자동 산출
- 신고기간: 1기예정(4/25), 1기확정(7/25), 2기예정(10/25), 2기확정(1/25)
4. 💼 원천징수 신고서
급여 업로드 → A01(근로)/A03(사업)/A04(기타) 소득 자동 집계
- 납부기한 자동 계산 (귀속월 익월 10일)
- Excel 다운로드: 원천징수 신고서.xlsx
5. 🏢 법인세 (킴스홈즈·킴스아이텍)
- 세무조정 (접대비·가지급금) 자동 계산
- 창업중소기업 감면: 킴스홈즈 100% (강원 양양, 5년)
- R&D 세액공제 25% + 고용증대 공제: 킴스아이텍
- 최저한세 7% 자동 적용
- Excel 신고서 초안 다운로드
6. 👤 종합소득세 (킴스올디자인·킴스매트로)
- 2개 개인사업체 합산 계산
- 동주소 공동비용 자동 안분 (수입금액 비율)
- 기준경비율 추계 제공
- 신고기한: 매년 5월 31일
7. 📤 전자신고 패키지
홈택스 직접 업로드용 파일 생성
| 파일 | 내용 |
|------|------|
| 부가세신고서.xml | V101 — 홈택스 직접 업로드 |
| 매출처별합계표.xml | V301 |
| 매입처별합계표.xml | V401 |
| 원천세신고.txt | H/D/T 고정길이 형식 |
| 체크리스트.txt | 신고 전 확인 사항 |
신고 준비도 A~D 등급 확인 → 📦 전자신고 패키지 저장 → 홈택스에서 업로드
8. 📅 세금 캘린더
4개 사업체 연간 66개 세금 일정 한눈에 보기
- 긴급(🔴 D-7 이내) / 예정 자동 구분
- 사업체별 색상 표시
- 전체 대시보드: 업로드 현황 포함
9. ⚠️ 가산세 계산기
신고기한 경과 시 가산세 자동 계산
입력: 세금종류 / 실제 세액 / 신고한 세액 / 납부액 / 신고기한
결과: 신고불성실·납부불성실 가산세 + 지금 자진신고 시 절약액
| 자진신고 시기 | 감면율 |
|-------------|--------|
| 30일 이내 | 90% |
| 3개월 이내 | 75% |
| 6개월 이내 | 50% |
| 1년 이내 | 30% |
| 2년 이내 | 20% |
10. 💾 데이터 관리
- 저장 현황 조회 (사업체별 건수)
- 📦 지금 백업: output/backups/backup_YYYY-MM-DD.json
- 복원: 백업 파일 선택 → 복원
- 저장 경로 확인
11. 📊 종합 리포트 (Phase 7)
4개 사업체 전체를 한 번에 요약
- 경영자 한눈보기 대시보드
- 연간 납세 예측 (법인세·종소세·부가세 추정)
- Excel 리포트 다운로드 (5개 시트)
🗓️ 연간 세금 신고 일정
| 기한 | 신고 종류 | 대상 |
|------|----------|------|
| 매월 10일 | 원천세 신고납부 (전월 귀속) | 4개 사업체 |
| 4월 25일 | 부가세 1기 예정 | 법인 2개 |
| 7월 25일 | 부가세 1기 확정 | 4개 사업체 |
| 8월 31일 | 법인세 중간예납 | 법인 2개 (2년차~) |
| 10월 25일 | 부가세 2기 예정 | 법인 2개 |
| 1월 25일 | 부가세 2기 확정 | 4개 사업체 |
| 3월 31일 | 법인세 확정 신고 | 킴스홈즈·킴스아이텍 |
| 5월 31일 | 종합소득세 확정 | 킴스올디자인·킴스매트로 |
⚡ 긴급 일정 (2026년 초)
| 기한 | 내용 |
|------|------|
| 2026-01-10 | 원천세 (12월 귀속) — 4개 사업체 |
| 2026-01-25 | 부가세 2기 확정 — 4개 사업체 (킴스홈즈·아이텍 첫 신고) |
| 2026-03-31 | 법인세 확정 — 킴스홈즈·아이텍 (첫 사업연도) |
| 2026-05-31 | 종합소득세 — 김혜정 (올디자인+매트로 합산) |
🔑 주요 세액공제 요약
| 사업체 | 공제·감면 | 근거 |
|--------|----------|------|
| 킴스홈즈 | 창업중소기업 법인세 100% 감면 (5년) | 조특법 제6조 (강원 양양 = 수도권 외) |
| 킴스아이텍 | R&D 세액공제 25% | 조특법 제10조 |
| 킴스아이텍 | 고용증대 세액공제 1,300~1,550만/인 | 조특법 제29조의7 |
| 공통 | 최저한세 7% (중소기업) | 조특법 제132조 |
📁 저장 파일 경로
`
tax-automation/
├── db/store/ ← 영구 저장 데이터 (JSON)
│ ├── kimsholmes/
│ ├── kimsaitech/
│ ├── kimsalldesign/
│ └── kimsmetro/
└── output/
├── backups/ ← 백업 파일
└── filing_*/ ← 전자신고 패키지
`
❓ 자주 묻는 질문
Q. 서버를 껐다 켰는데 데이터가 사라졌나요?
A. 아닙니다. db/store/` 폴더의 JSON 파일에 자동 저장됩니다.
Q. 홈택스에서 세금계산서를 어떻게 받나요?
A. 홈택스 로그인 → 조회/발급 → 전자(세금)계산서 → 합계표 조회 → Excel 다운로드
Q. 부가세 신고서 XML을 홈택스에 올리려면?
A. 홈택스 → 신고/납부 → 부가가치세 → 일반과세자 → 전자신고 → XML 파일 첨부
Q. 가산세 감면을 받으려면?
A. 가산세 계산기 탭에서 확인 후 기한후 신고 or 수정신고 진행. 30일 이내 90% 감면!
*세무 자동화 시스템 v7.0 — Genspark Claw AI 구축*