원천징수
개요
이 화면은 무엇인가요? 이 화면에서는 원천징수 데이터를 조회, 등록, 수정, 삭제합니다.
누가 사용하나요?
- 🏢 세무팀: 원천징수 등록, 조회, 수정 업무 수행
- 🏢 재무팀: 원천징수 등록, 조회, 수정 업무 수행
- 🏢 회계팀: 원천징수 등록, 조회, 수정 업무 수행
언제 사용하나요?
- 원천징수 정보를 등록/수정할 때
- 원천징수 현황을 조회할 때
- 관련 데이터를 검색하고 분석할 때
주요 기능
1. 원천징수 등록/조회
무엇을 하나요?: 이 화면에서는 원천징수 데이터를 조회, 등록, 수정, 삭제합니다.
어떻게 사용하나요?:
- 화면에 접속합니다
- 신규 버튼을 클릭합니다
- 필수 항목을 입력합니다
- 저장 버튼을 클릭합니다
- 등록 완료를 확인합니다
💡 팁: 자주 사용하는 검색 조건은 필터에 저장해두면 편리합니다.
입력 항목 가이드
| 항목 | 설명 | 입력 방법 | 예시 |
|---|---|---|---|
| 원천징수번호 (필수) | wht_code | 직접 입력 | - |
| 거래처(소득자) | partner_id | 검색 선택 | - |
| 소득유형 (필수) | income_type | 목록에서 선택 | - |
| 소득세부코드 | income_detail_code | 직접 입력 | - |
| 지급일 (필수) | payment_date | 달력에서 선택 | 2026-03-17 |
| 지급총액 (필수) | gross_amount | 숫자 입력 | 100 |
| 필요경비 | necessary_expenses | 숫자 입력 | 100 |
| 과세소득 | taxable_income | 숫자 입력 | 100 |
| 세율(%) (필수) | tax_rate | 숫자 입력 | 100 |
| 소득세 | income_tax | 숫자 입력 | 100 |
| 지방소득세 | resident_tax | 숫자 입력 | 100 |
| 원천징수세액합계 | total_tax | 숫자 입력 | 100 |
| 차인지급액 | net_payment | 숫자 입력 | 100 |
| 귀속월 (필수) | reporting_month | 직접 입력 | - |
| 신고월 (필수) | filing_month | 직접 입력 | - |
| 신고상태 (필수) | filing_status | 목록에서 선택 | - |
| 주민번호(마스킹) | resident_id_masked | 직접 입력 | - |
| 분개전표 | journal_entry_id | 검색 선택 | - |
| 매입채무 | ap_id | 검색 선택 | - |
| 처리자 | processed_by | 검색 선택 | - |
| 비고 | remarks | 텍스트 입력 | - |
업무 흐름에서의 위치
| 연결 화면 | 관계 | 설명 |
|---|---|---|
| 거래처 | 연관 | 거래처→원천징수(소득자) |
| 전표 | 연관 | 전표→원천징수 |
| 매입채무 | 연관 | 매입채무→원천징수 |
자주 묻는 질문 (FAQ)
Q. 데이터를 일괄로 등록할 수 있나요?
A. CSV 파일을 통한 일괄 가져오기(Import) 기능을 지원합니다. 화면 상단의 가져오기 버튼을 사용하세요.
Q. 삭제한 데이터를 복구할 수 있나요?
A. 감사 추적(Audit Trail)이 활성화되어 있어 변경 이력을 확인할 수 있습니다. 삭제된 데이터는 관리자에게 문의하세요.
실무 시나리오
시나리오: 원천징수 등록
새로운 원천징수 정보를 시스템에 등록해야 합니다.
- 화면에 접속합니다
- 신규 버튼을 클릭합니다
- 필수 항목을 입력합니다
- 저장 버튼을 클릭합니다
- 등록 완료를 확인합니다
참고: 데이터 구조
📋 기술 참고 정보 (개발자/관리자용)
테이블명: withholding_taxes
테이블 특성:
- 사용자 연결 (created_by, updated_by 자동 생성)
- 부서 연결 (department_id 자동 생성)
- 감사 추적 활성화
- 인쇄 기능 지원
입력 항목 원본
| 항목 | 의미 | 타입 | 필수 | 왜 필요한가 |
|---|---|---|---|---|
| 원천징수번호 | wht_code | VARCHAR | ✅ | - |
| 거래처(소득자) | partner_id | UUID | partners 테이블 참조 (partner_name 표시) | |
| 소득유형 | income_type | 사업소득 / 기타소득 / 이자소득 / 배당소득 / 근로소득 / 퇴직소득 / 연금소득 / 양도소득 | ✅ | 소득세법 소득분류 |
| 소득세부코드 | income_detail_code | VARCHAR | 원천징수 소득종류코드 (국세청 기준) | |
| 지급일 | payment_date | DATE | ✅ | - |
| 지급총액 | gross_amount | DECIMAL | ✅ | - |
| 필요경비 | necessary_expenses | DECIMAL | 사업소득 필요경비, 기타소득 60% 공제 등 | |
| 과세소득 | taxable_income | DECIMAL | 자동 계산: gross_amount - necessary_expenses | |
| 세율(%) | tax_rate | DECIMAL | ✅ | 사업소득 3%, 기타소득 20%, 이자/배당 14% 등 |
| 소득세 | income_tax | DECIMAL | 자동 계산: taxable_income * tax_rate / 100 | |
| 지방소득세 | resident_tax | DECIMAL | 자동 계산: income_tax * 0.1 | |
| 원천징수세액합계 | total_tax | DECIMAL | 자동 계산: income_tax + resident_tax | |
| 차인지급액 | net_payment | DECIMAL | 자동 계산: gross_amount - total_tax | |
| 귀속월 | reporting_month | VARCHAR | ✅ | 소득 귀속 연월 (YYYY-MM) |
| 신고월 | filing_month | VARCHAR | ✅ | 원천세 신고 연월 (지급월 다음달 10일까지) |
| 신고상태 | filing_status | 미신고 / 신고완료 / 수정신고 | ✅ | - |
| 주민 번호(마스킹) | resident_id_masked | VARCHAR | 소득자 주민번호 마스킹 표시 (개인정보보호) | |
| 분개전표 | journal_entry_id | UUID | journal_entries 테이블 참조 (entry_number 표시) | |
| 매입채무 | ap_id | UUID | accounts_payable 테이블 참조 (ap_number 표시) | |
| 처리자 | processed_by | UUID | 시스템 users 테이블 참조 | |
| 비고 | remarks | TEXT | - |
데이터 관계도
참조받는 테이블
- 거래처 (1:N) 거래처→원천징수(소득자)
- 전표 (1:N) 전표→원천징수
- 매입채무 (1:N) 매입채무→원천징수
화면 설정
목록 컬럼
| 컬럼 | 렌더링 | 고정 | 정렬 |
|---|---|---|---|
| withholding_no | link | - | ✅ |
| 소득유형 | tag | - | ✅ |
| payee_name | 기본 | - | ✅ |
| 지급일 | date | - | ✅ |
| 지급총액 | currency | - | ✅ |
| 세율(%) | percent | - | ✅ |
| withheld_amount | currency | - | ✅ |
| 차인지급액 | currency | - | ✅ |
| status | badge | - | ✅ |
| reporting_period | 기본 | - | ✅ |
필터 설정
| 필드 | 필터유형 |
|---|---|
| withholding_no | search |
| 소득유형 | select |
| status | select |
| 지급일 | dateRange |