이 기능은 무엇인가요?
부가세, 원천세, 법인세 등 세무 신고에 필요한 데이터를 집계하고 전자 신고를 지원합니다.
세무 신고 기한을 놓치지 않고, 정확한 세무 데이터로 세무 리스크를 최소화합니다.
업무 프로세스 개요
포함된 화면
관련 솔루션 연계
| 솔루션 | 연계 내용 | 데이터 흐름 |
|---|
| 재무관리 | 전표 연계 | 전표 → 세무 데이터 |
| 영업관리 | 매출세금계산서 | 매출 → 세금계산서 |
| 구매관리 | 매입세금계산서 | 매입 → 세금계산서 |
시작하기
- 처음 사용하시면 → 전자세금계산서 전송이력에서 시작하세요
- 각 화면의 상세 사용법은 개별 화면 문서를 참고하세요
- 궁금한 점은 FAQ를 확인하거나 시스템 관리자에게 문의하세요
참고: 데이터 구조
📋 기술 참고 정보 (개발자/관리자용)
관련 워크플로우
- 전자세금계산서 전송이력 (autoTask): 국세청 전자세금계산서 전송 후 결과 이력 자동 저장
데이터 관계도
테이블 요약
전자세금계산서전송이력 (etax_transmission_logs)
| 컬럼명 | 한글명 | 타입 | 설명 |
|---|
transmission_code | 전송번호 | VARCHAR *필수 *고유 | - |
tax_invoice_id | 세금계산서 | UUID (FK) *필수 | - |
transmission_type | 전송유형 | ENUM(정발행, 역발행, 수정발행, 위수탁발행) *필수 | - |
transmission_status | 전송상태 | ENUM(전송대기, 전송중, 전송완료, 전송실패, 취소) *필수 | - |
nts_approval_number | 국세청승인번호 | VARCHAR *고유 | 국세청 발급 24자리 승인번호 |
nts_response_code | 국세청응답코드 | VARCHAR | 국세청 응답 코드 (SUP000000: 성공) |
nts_response_message | 국세청응답메시지 | TEXT | - |
transmitted_at | 전송일시 | TIMESTAMP | - |
received_at | 수신확인일시 | TIMESTAMP | - |
retry_count | 재전송횟수 | INT | - |
max_retry | 최대재전송 | INT | - |
error_detail | 오류상세 | TEXT | - |
digital_signature | 전자서명값 | TEXT | 공인인증서 기반 전자서명 |
sender_biz_no | 발신사업자번호 | VARCHAR *필수 | 10자리 사업자등록번호 |
receiver_biz_no | 수신사업자번호 | VARCHAR *필수 | - |
transmitted_by | 전송자 | UUID (시스템참조) | - |
remarks | 비고 | TEXT | - |
매입세금계산서자동수집 (etax_purchase_auto_collect)
| 컬럼명 | 한글명 | 타입 | 설명 |
|---|
collect_code | 수집번호 | VARCHAR *필수 *고유 | - |
nts_approval_number | 국세청승인번호 | VARCHAR *필수 *고유 | 홈택스에서 수집한 승인번호 |
supplier_biz_no | 공급자사업자번호 | VARCHAR *필수 | 10자리 사업자등록번호 |
supplier_name | 공급자상호 | VARCHAR *필수 | - |
supplier_representative | 공급자대표자 | VARCHAR | - |
issue_date | 작성일자 | DATE *필수 | - |
supply_amount | 공급가액 | DECIMAL *필수 | - |
tax_amount | 세액 | DECIMAL *필수 | - |
total_amount | 합계금액 | DECIMAL (계산) | - |
invoice_type | 계산서유형 | ENUM(세금계산서, 계산서, 수정세금계산서, 수정계산서) *필수 | - |
match_status | 매칭상태 | ENUM(자동매칭, 수동매칭, 미매칭, 매칭제외) *필수 | - |
matched_ap_id | 매칭매입채무 | UUID (FK) | - |
matched_tax_invoice_id | 매칭세금계산서 | UUID (FK) | - |
matched_partner_id | 매칭거래처 | UUID (FK) | - |
collect_date | 수집일 | DATE *필수 | - |
collect_source | 수집출처 | ENUM(홈택스API, 홈택스스크래핑, 이메일수신, 수동등록) *필수 | - |
deduction_type | 공제구분 | ENUM(공제, 불공제, 공통매입) *필수 | 부가세 매입세액공제 여부 |
non_deduction_reason | 불공제사유 | ENUM(비영업용소형승용차, 접대비관련, 면세사업관련, 토지관련, 사업무관경비, 비실명거래, 기타) | 불공제 시 사유코드 |
matched_by | 매칭처리자 | UUID (시스템참조) | - |
matched_date | 매칭일 | DATE | - |
remarks | 비고 | TEXT | - |
부가가치세신고 (vat_returns)
| 컬럼명 | 한글명 | 타입 | 설명 |
|---|
vat_code | 신고번호 | VARCHAR *필수 *고유 | - |
fiscal_year | 과세연도 | VARCHAR *필수 | - |
return_period | 신고기간 | ENUM(1기예정(13월), 1기확정(16월), 2기예정(79월), 2기확정(712월)) *필수 | 부가가치세법 제48~49조 |
filing_deadline | 신고기한 | DATE *필수 | 예정: 해당월 25일, 확정: 해당월 25일 |
sales_tax_base | 매출과세표준 | DECIMAL | - |
sales_tax_amount | 매출세액 | DECIMAL (계산) | - |
zero_rate_sales | 영세율매출 | DECIMAL | 수출 등 영세율 적용 매출 |
exempt_sales | 면세매출 | DECIMAL | - |
purchase_tax_deductible | 매입세액(공제) | DECIMAL | - |
purchase_tax_non_deductible | 매입세액(불공제) | DECIMAL | - |
common_purchase_tax | 공통매입세액 | DECIMAL | 과세/면세 겸업사업자 안분계산 대상 |
credit_card_deduction | 신용카드매입공제 | DECIMAL | - |
tax_payable | 납부(환급)세액 | DECIMAL (계산) | - |
additional_tax | 가산세 | DECIMAL | 무신고/과소신고/납부불성실 가산세 |
final_tax_amount | 최종납부세액 | DECIMAL (계산) | - |
filing_status | 신고상태 | ENUM(미신고, 작성중, 검토중, 신고완료, 수정신고, 경정청구) *필수 | - |
filing_date | 신고일 | DATE | - |
filing_type | 신고유형 | ENUM(정기신고, 수정신고, 기한후신고, 경정청구) *필수 | - |
e_filing_receipt_no | 전자신고접수번호 | VARCHAR | 홈택스 전자신고 접수번호 |
payment_date | 납부일 | DATE | - |
prepared_by | 작성자 | UUID (시스템참조) | - |
approved_by | 승인자 | UUID (시스템참조) | - |
remarks | 비고 | TEXT | - |
원천징수관리 (withholding_taxes)
| 컬럼명 | 한글명 | 타입 | 설명 |
|---|
wht_code | 원천징수번호 | VARCHAR *필수 *고유 | - |
partner_id | 거래처(소득자) | UUID (FK) | 사업/기타소득 시 소득자 거래처. 근로소득 일괄신고 시 null 허용 |
income_type | 소득유형 | ENUM(사업소득, 기타소득, 이자소득, 배당소득, 근로소득, 퇴직소득, 연금소득, 양도소득) *필수 | 소득세법 소득분류 |
income_detail_code | 소득세부코드 | VARCHAR | 원천징수 소득종류코드 (국세청 기준) |
payment_date | 지급일 | DATE *필수 | - |
gross_amount | 지급총액 | DECIMAL *필수 | - |
necessary_expenses | 필요경비 | DECIMAL | 사업소득 필요경비, 기타소득 60% 공제 등 |
taxable_income | 과세소득 | DECIMAL (계산) | - |
tax_rate | 세율(%) | DECIMAL *필수 | 사업소득 3%, 기타소득 20%, 이자/배당 14% 등 |
income_tax | 소득세 | DECIMAL (계산) | - |
resident_tax | 지방소득세 | DECIMAL (계산) | 소득세의 10% |
total_tax | 원천징수세액합계 | DECIMAL (계산) | - |
net_payment | 차인지급액 | DECIMAL (계산) | - |
reporting_month | 귀속월 | VARCHAR *필수 | 소득 귀속 연월 (YYYY-MM) |
filing_month | 신고월 | VARCHAR *필수 | 원천세 신고 연월 (지급월 다음달 10일까지) |
filing_status | 신고상태 | ENUM(미신고, 신고완료, 수정신고) *필수 | - |
resident_id_masked | 주민번호(마스킹) | VARCHAR | 소득자 주민번호 마스킹 표시 (개인정보보호) |
journal_entry_id | 분개전표 | UUID (FK) | - |
ap_id | 매입채무 | UUID (FK) | - |
processed_by | 처리자 | UUID (시스템참조) | - |
remarks | 비고 | TEXT | - |