세금코드 관리
개요
이 화면은 무엇인가요? 이 화면에서는 세금코드 데이터를 조회, 등록, 수정, 삭제합니다.
누가 사용하나요?
- 🏢 세무팀: 세금코드 등록, 조회, 수정 업무 수행
- 🏢 재무팀: 세금코드 등록, 조회, 수정 업무 수행
언제 사용하나요?
- 세금코드 정보를 등록/수정할 때
- 세금코드 현황을 조회할 때
- 관련 데이터를 검색하고 분석할 때
주요 기능
1. 세금코드 등록/조회
무엇을 하나요?: 이 화면에서는 세금코드 데이터를 조회, 등록, 수정, 삭제합니다.
어떻게 사용하나요?:
- 화면에 접속합니다
- 신규 버튼을 클릭합니다
- 필수 항목을 입력합니다
- 저장 버튼을 클릭합니다
- 등록 완료를 확인합니다
💡 팁: 자주 사용하는 검색 조건은 필터에 저장해두면 편리합니다.
입력 항목 가이드
| 항목 | 설명 | 입력 방법 | 예시 |
|---|---|---|---|
| 세금코드 (필수) | tax_code | 직접 입력 | - |
| 세금명 (필수) | tax_name | 직접 입력 | - |
| 세금유형 (필수) | tax_type | 목록에서 선택 | - |
| 세율(%) (필수) | tax_rate | 숫자 입력 | 100 |
| 세금계정 | tax_account_id | 검색 선택 | - |
| 공제여부 | is_deductible | 목록에서 선택 | - |
| 시행일 (필수) | effective_from | 달력에서 선택 | 2026-03-17 |
| 만료일 | effective_to | 달력에서 선택 | 2026-03-17 |
| 국가코드 (필수) | country_code | 직접 입력 | - |
| 사용여부 (필수) | is_active | 목록에서 선택 | - |
| 설명 | description | 텍스트 입력 | - |
업무 흐름에서의 위치
| 연결 화면 | 관계 | 설명 |
|---|---|---|
| 전표항목 | 연관 | 세금코드→전표항목 |
| 계정과목 | 연관 | 계정과목→세금코드(세금계정) |
자주 묻는 질문 (FAQ)
Q. 데이터를 일괄로 등록할 수 있나요?
A. CSV 파일을 통한 일괄 가져오기(Import) 기능을 지원합니다. 화면 상단의 가져오기 버튼을 사용하세요.
Q. 삭제한 데이터를 복구할 수 있나요?
A. 감사 추적(Audit Trail)이 활성화되어 있어 변경 이력을 확인할 수 있습니다. 삭제된 데이터는 관리자에게 문의하세요.
실무 시나리오
시나리오: 세금코드 관리 등록
새로운 세금코드 정보를 시스템에 등록해야 합니다.
- 화면에 접속합니다
- 신규 버튼을 클릭합니다
- 필수 항목을 입력합니다
- 저장 버튼을 클릭합니다
- 등록 완료를 확인합니다
참고: 데이터 구조
📋 기술 참고 정보 (개발자/관리자용)
테이블명: tax_codes
테이블 특성:
- 감사 추적 활성화
- 인쇄 기능 지원
입력 항목 원본
| 항목 | 의미 | 타입 | 필수 | 왜 필요한가 |
|---|---|---|---|---|
| 세금코드 | tax_code | VARCHAR | ✅ | 예: V10, A11 |
| 세금명 | tax_name | VARCHAR | ✅ | 부가세10%, 면세 등 |
| 세금유형 | tax_type | 매출세 / 매입세 / 원천세 / 지방소득세 / 면세 | ✅ | - |
| 세율(%) | tax_rate | DECIMAL | ✅ | - |
| 세금계정 | tax_account_id | UUID | chart_of_accounts 테이블 참조 (account_name 표시) | |
| 공제여부 | is_deductible | 공제 / 불공제 | - | |
| 시행일 | effective_from | DATE | ✅ | - |
| 만료일 | effective_to | DATE | - | |
| 국가코드 | country_code | VARCHAR | ✅ | - |
| 사용여부 | is_active | Y / N | ✅ | - |
| 설명 | description | TEXT | - |
데이터 관계도
참조하는 테이블
- 전표항목 (1:N) 세금코드→전표항목
참조받는 테이블
- 계정과목 (1:N) 계정과목→세금코드(세금계정)
참조받는 테이블
- 계정과목 (1:N) 계정과목→세금코드(세금계정)
화면 설정
목록 컬럼
| 컬럼 | 렌더링 | 고정 | 정렬 |
|---|---|---|---|
| 세금코드 | link | - | ✅ |
| 세금명 | 기본 | - | ✅ |
| 세금유형 | badge | - | ✅ |
| 세율(%) | 기본 | - | ✅ |
| 공제여부 | 기본 | - | ✅ |
| 사용여부 | badge | - | ✅ |
| 시행일 | date | - | ✅ |
필터 설정
| 필드 | 필터유형 |
|---|---|
| 세금코드 | search |
| 세금유형 | select |
| 사용여부 | select |
폼 구성
세금코드 기본정보
| 필드 | 필수 | 읽기전용 | 비고 |
|---|---|---|---|
| 세금코드 | ✅ | ||
| 세금명 | ✅ | ||
| 세금유형 | ✅ | ||
| 세율(%) | ✅ | ||
| 사용여부 |
상세설정
| 필드 | 필수 | 읽기전용 | 비고 |
|---|---|---|---|
| 공제여부 | |||
| 시행일 | ✅ |