장기적 법인카드 세무항목 매칭 전략

바로빌 카드조회 API 기반 완전 자동화 시스템

카드 승인 · 매입 매칭 · 계정과목 분류 · 금전출납부 생성

법인카드 사용부터 세무 처리까지 완전 자동화

프로젝트 개요

배경

법인카드 사용 내역을 바로빌 API로 자동 수집하여
승인↔매입 매핑, VAT 처리, 계정과목 분류를 자동화하고
금전출납부 및 일일일보에 즉시 반영

핵심 목표

바로빌 카드조회 API 통합: 모든 법인카드 내역을 단일 API로 통합 수집
승인↔매입 자동 매핑: 카드 승인 내역과 매입 전표를 자동으로 연결
VAT/불공제 자동 판정: 접대비, 복리후생비 등 불공제 항목 자동 분류
계정과목 자동 분류: 룰 기반 + ML 하이브리드 엔진으로 정확도 95% 달성
금전출납부/일일일보 자동 생성: 카드 사용 시점부터 회계 처리까지 실시간 반영
멀티테넌트 구조: 여러 법인의 카드를 안전하게 격리 관리

프로젝트 범위

✅ 포함 범위

카드 내역 수집: 바로빌 카드조회 API 연동, 일일 자동 수집

데이터 정규화: 승인/매입 분리, 중복 제거, 취소 매칭

자동 전표화: 계정과목, 거래처, 사업자등록번호, VAT 분류

금전출납부/일보: 실시간 리포트 생성 및 검토 화면

엑스포트: 세무사 제출용 CSV/Excel 내보내기

❌ 제외 범위

영수증 OCR: 향후 로드맵 (Phase 2)

법인카드 실물 발급: 카드사 직접 처리

실시간 결제 알림: 카드사 앱 활용

여신 관리: 카드사 관리 기능

시스템 아키텍처 개요

[카드사 1, 2, 3...N] → [바로빌 API] → [ETL/수집 스케줄러]
                                              ↓
                                [정규화 & 중복제거 & 취소 매핑]
                                              ↓
                            [분류 엔진: Rule + ML Hybrid]
                                              ↓
                    [승인↔매입 매칭 & VAT 처리 & 계정과목 분류]
                                              ↓
                        [전표 생성 & 금전출납부/일일일보 반영]
                                              ↓
            [검토 대시보드 & 예외 처리 & 세무사 제출용 리포트]

아키텍처 핵심 전략

멀티테넌시: 테넌트별 카드 등록정보/인증 격리, 데이터 완전 분리
일일 배치 수집: 매일 오전 자동 수집 + 수동 즉시 수집 옵션
이중화 설계: (카드번호, 승인번호, 승인일시) 고유키로 중복 방지
하이브리드 분류: 룰 기반 1차 분류 + ML 모델 2차 보조

기능 요구사항 (Functional Requirements)

ID	기능명	설명
F1	카드 등록/인증	테넌트별 법인카드 등록, 바로빌 인증 정보 안전 보관
F2	내역 자동 수집	일일 배치 + 수동 즉시 수집, 승인/매입 분리 저장
F3	데이터 정규화	가맹점명 표준화, 중복 제거, 취소 건 자동 매칭
F4	분류 엔진 (Rule + ML)	계정과목, VAT 처리, 불공제 판정 자동화
F5	승인↔매입 매칭 & 전표 생성	승인/매입 쌍 연결, 차액 발생 시 알림
F6	금전출납부/일일일보 통합	실시간 리포트 생성, 월말 마감 자동화
F7	감사 추적	모든 수정/분류 이력 로그, 담당자 기록
F8	내보내기/연동	CSV/Excel 추출, 세무사 제출용 포맷

비기능 요구사항 (Non-Functional Requirements)

N1. 멀티테넌시 격리

모든 테이블 tenant_id 분리

카드 인증정보 암호화 보관

테넌트별 데이터 완전 격리

N2. 보안/컴플라이언스

카드번호 마스킹 (끝 4자리만)

HTTPS 통신 필수

개인정보 최소 수집

N3. 확장성

월 10만 건 처리 가능

테넌트 50개 동시 지원

API 호출 rate limit 준수

N4. 가용성/복구

수집 실패 시 재시도 3회

데이터 백업 일 1회

장애 시 수동 수집 가능

데이터 플로우 (End-to-End)

카드 등록: 법인카드 정보 + 바로빌 인증 정보 등록 → 시스템에 안전 저장
자동 수집: 스케줄러가 매일 오전 바로빌 API 호출 → 승인/매입 내역 수집
정규화: 가맹점명 표준화, 중복 제거, 취소 건 원 거래와 매칭
분류 엔진: 룰 기반 1차 분류 → ML 모델 2차 검증 → 계정과목 확정
승인↔매입 매칭: 승인번호 기준으로 승인/매입 쌍 연결, 차액 발생 시 알림
전표 생성: 계정과목, 거래처, VAT, 불공제 여부 포함한 전표 생성
검토: 담당자가 미분류/예외 건 검토 → 수정 시 학습 데이터 축적
금전출납부/일보 반영: 확정된 전표를 금전출납부/일일일보에 자동 반영
내보내기: 세무사 제출용 CSV/Excel 생성

데이터베이스 스키마 (핵심 테이블)

테이블명	주요 필드	용도
cards	id, tenant_id, card_no_masked, card_name, issuer, status	법인카드 등록 정보
card_transactions_raw	id, tenant_id, card_id, trans_type (승인/매입), approval_no, amount, merchant_name, trans_datetime, status	바로빌 API 원본 데이터
merchants	id, tenant_id, merchant_raw_name, merchant_std_name, bizno, category, vat_type	가맹점 마스터 (표준화)
classification_rules	id, tenant_id, condition (merchant/category/amount), account_code, vat_flag, priority	룰 기반 분류 규칙
card_postings	id, tenant_id, approval_trans_id, purchase_trans_id, account_code, amount, vat, is_non_deductible, posting_date, status	확정된 회계 전표
reports_cashbook	id, tenant_id, posting_id, date, debit_account, credit_account, amount, description	금전출납부 생성 데이터
audit_logs	id, tenant_id, entity_type, entity_id, action, old_value, new_value, actor, timestamp	모든 수정 이력 추적

분류 엔진 (Rule + ML Hybrid)

1차: 룰 기반 분류 (Rule-Based)

가맹점명 매칭: "GS25" → 복리후생비, "현대오일뱅크" → 차량유지비
카테고리 매칭: "주유소" → 차량유지비, "식당" → 접대비/복리후생비
금액 기준: 3만원 이상 식사 → 접대비, 3만원 미만 → 복리후생비
VAT 처리: 면세 가맹점 자동 판정, 불공제 항목 자동 마킹

2차: ML 모델 보조 (Machine Learning)

학습 데이터: 담당자가 수정한 이력을 학습 데이터로 축적
특징 추출: 가맹점명, 시간대, 요일, 금액, 사용자, 카테고리
모델: Random Forest 또는 XGBoost로 계정과목 추천
신뢰도 표시: 95% 이상 → 자동 확정, 미만 → 검토 필요 마킹

피드백 루프 (Continuous Learning)

[분류 엔진 예측] → [담당자 검토/수정] → [audit_logs 저장]
                                              ↓
                            [학습 데이터셋 업데이트] → [모델 재학습]
                                              ↓
                                    [정확도 향상] → [자동화율 증가]

회계/세무 처리 규칙

승인 vs 매입 처리

승인 내역: 카드 사용 시점 (실시간 알림용, 경비 지출 추적)
매입 내역: 실제 결제 확정 시점 (회계 전표 기준)
매칭 로직: (승인번호, 금액, 가맹점) 3개 기준으로 쌍 연결
차액 발생: 팁, 부분 취소 등으로 차액 발생 시 알림 → 수동 검토

VAT 처리

과세 거래: 공급가액 + VAT 10% 분리 저장
면세 거래: 전액 공급가액, VAT 0원
불공제 항목: 접대비, 개인 경비 등은 매입세액 불공제 마킹
영수증 매칭: 향후 OCR 연동 시 영수증 이미지와 카드 내역 자동 매칭

증빙 우선순위

세금계산서: 최우선 증빙 (VAT 공제 가능)
신용카드 매출전표: 2순위 (사업용 신용카드 등록 시 공제 가능)
현금영수증: 3순위 (간이과세자 등)
간이영수증: 3만원 미만 소액 (공제 불가, 경비 인정용)

사업용 신용카드 등록

국세청에 사업용 신용카드로 등록된 카드는 세금계산서 없이도 매입세액 공제 가능
→ 시스템에서 카드별 "사업용 등록 여부" 플래그 관리

리포트 & 대시보드

📊 금전출납부

일자별 입출금 내역, 카드 사용 자동 반영

📈 일일일보

일자별 매출/매입/경비 요약

⚠️ 예외/미분류 대시보드

검토 필요 건, ML 신뢰도 낮은 건 실시간 표시

📅 월말 마감 리포트

월별 카드 사용 집계, 계정과목별 요약

📋 세무사 제출용 리포트

CSV/Excel 내보내기, 전표별 증빙 첨부

📉 불공제 내역 리포트

접대비, 개인 경비 등 불공제 항목 집계

실시간 알림

미분류 건: 분류 실패 또는 ML 신뢰도 낮은 건 즉시 알림
승인↔매입 불일치: 금액 차이 발생 시 담당자에게 알림
고액 사용: 일정 금액 이상 카드 사용 시 관리자 알림
월말 마감 임박: 마감 D-3, D-1 알림

멀티테넌시 설계

논리적 격리 (Logical Isolation)

tenant_id 필수: 모든 테이블에 tenant_id 컬럼, 쿼리 시 필터링
인덱스 최적화: (tenant_id, created_at) 복합 인덱스로 성능 확보
데이터 완전 분리: 테넌트 간 데이터 조회 절대 불가

자격증명 격리 (Credential Isolation)

바로빌 API Key: 테넌트별 별도 등록, 암호화 저장
카드 인증 정보: AES-256 암호화, 사용 시에만 복호화
접근 제어: 테넌트 관리자만 자신의 카드 정보 열람 가능

속도 제한 & 쿼터 (Rate Limit & Quota)

API 호출 제한: 테넌트별 일일 API 호출 횟수 제한
데이터 용량: 테넌트별 월 거래 건수 쿼터 설정
공정 사용: 과도한 사용 시 경고 및 제한

보안 & 컴플라이언스

🔐 데이터 암호화

전송 중: HTTPS/TLS 1.3

저장 시: AES-256 암호화

카드번호: 마스킹 (끝 4자리만)

🛡️ 접근 제어

역할 기반 권한 (RBAC)

테넌트 관리자/회계담당자/열람자

IP 화이트리스트 옵션

📋 감사 지표

모든 수정 이력 로그

누가, 언제, 무엇을 변경했는지 추적

7년간 로그 보관

🔒 개인정보 최소화

필요한 정보만 수집

사용자 동의 기반

개인정보 보호법 준수

컴플라이언스 체크리스트

✅ 개인정보 보호법 준수 (카드번호 마스킹, 암호화)
✅ 전자금융거래법 준수 (인증, 암호화 통신)
✅ 법인세법 시행령 (증빙 보관 7년)
✅ 부가가치세법 (매입세액 공제 요건 충족)

개발 로드맵 (6 Phase, 18주)

단계	기간	주요 마일스톤
Phase 1	W1-3	바로빌 API 연동, 스키마 설계, 카드 등록 기능
Phase 2	W4-6	자동 수집 스케줄러, 데이터 정규화, 중복 제거
Phase 3	W7-9	룰 기반 분류 엔진, 가맹점 마스터 구축
Phase 4	W10-12	승인↔매입 매칭, 전표 생성, 금전출납부/일보 연동
Phase 5	W13-15	ML 모델 개발, 학습 데이터 수집, 피드백 루프
Phase 6	W16-18	대시보드, 리포트, 내보내기, 테스트 & 베타 운영

KPI & 성공 지표

지표	현재	목표	측정 방법
계정과목 분류 자동화율	50% (수동)	95%	자동 분류 건수 / 전체 건수
월말 마감 소요 시간	8시간	1시간	카드 내역 정리 시작~완료 시간
미분류/예외 건수	월 평균 200건	월 10건 이하	검토 필요 건수
승인↔매입 매칭 정확도	70% (수동)	98%	정확히 매칭된 건수 / 전체 건수
ML 모델 정확도	N/A	90% (F1 Score)	테스트 데이터셋 검증

향후 로드맵

📸 영수증 OCR

영수증 이미지 자동 인식

카드 내역과 자동 매칭

증빙 자료 디지털화

🔗 ERP 동기화

회계 시스템 실시간 연동

전표 자동 전송

양방향 데이터 동기화

🤖 ML 고도화

딥러닝 모델 적용

이상 거래 탐지

비용 최적화 제안

📊 홈택스 신고 보조

부가세 신고서 자동 작성

매입세액 공제 최적화

세무사 협업 기능

📱 모바일 앱

현장 영수증 촬영

카드 사용 즉시 알림

승인/반려 워크플로우

📈 고급 분석

부서별 비용 분석

예산 대비 실적

비용 절감 인사이트

감사합니다

장기적 법인카드 세무항목 매칭 전략

문의 및 피드백

본 계획안에 대한 의견이나 추가 논의가 필요하신 경우

프로젝트 팀으로 연락 주시기 바랍니다.