전자세금계산서 전송이력
개요
이 화면은 무엇인가요? 이 화면에서는 전자세금계산서 전송이력 데이터를 조회, 등록, 수정, 삭제합니다.
누가 사용하나요?
- 🏢 세무팀: 전자세금계산서 전송이력 등록, 조회, 수정 업무 수행
- 🏢 재무팀: 전자세금계산서 전송이력 등록, 조회, 수정 업무 수행
언제 사용하나요?
- 전자세금계산서 전송이력 정보를 등록/수정할 때
- 전자세금계산서 전송이력 현황을 조회할 때
- 관련 데이터를 검색하고 분석할 때
주요 기능
1. 전자세금계산서 전송이력 등록/조회
무엇을 하나요?: 이 화면에서는 전자세금계산서 전송이력 데이터를 조회, 등록, 수정, 삭제합니다.
어떻게 사용하나요?:
- 화면에 접속합니다
- 신규 버튼을 클릭합니다
- 필수 항목을 입력합니다
- 저장 버튼을 클릭합니다
- 등록 완료를 확인합니다
💡 팁: 자주 사용하는 검색 조건은 필터에 저장해두면 편리합니다.
입력 항목 가이드
| 항목 | 설명 | 입력 방법 | 예시 |
|---|---|---|---|
| 전송번호 (필수) | transmission_code | 직접 입력 | - |
| 세금계산서 (필수) | tax_invoice_id | 검색 선택 | - |
| 전송유형 (필수) | transmission_type | 목록에서 선택 | - |
| 전송상태 (필수) | transmission_status | 목록에서 선택 | - |
| 국세청승인번호 | nts_approval_number | 직접 입력 | - |
| 국세청응답코드 | nts_response_code | 직접 입력 | - |
| 국세청응답메시지 | nts_response_message | 텍스트 입력 | - |
| 전송일시 | transmitted_at | 직접 입력 | - |
| 수신확인일시 | received_at | 직접 입력 | - |
| 재전송횟수 | retry_count | 숫자 입력 | 100 |
| 최대재전송 | max_retry | 숫자 입력 | 100 |
| 오류상세 | error_detail | 텍스트 입력 | - |
| 전자서명값 | digital_signature | 텍스트 입력 | - |
| 발신사업자번호 (필수) | sender_biz_no | 직접 입력 | - |
| 수신사업자번호 (필수) | receiver_biz_no | 직접 입력 | - |
| 전송자 | transmitted_by | 검색 선택 | - |
| 비고 | remarks | 텍스트 입력 | - |
업무 흐름에서의 위치
| 연결 화면 | 관계 | 설명 |
|---|---|---|
| 세금계산서 | 연관 | 세금계산서→전송이력 |
자주 묻는 질문 (FAQ)
Q. 데이터를 일괄로 등록할 수 있나요?
A. CSV 파일을 통한 일괄 가져오기(Import) 기능을 지원합니다. 화면 상단의 가져오기 버튼을 사용하세요.
Q. 삭제한 데이터를 복구할 수 있나요?
A. 감사 추적(Audit Trail)이 활성화되어 있어 변경 이력을 확인할 수 있습니다. 삭제된 데이터는 관리자에게 문의하세요.
실무 시나리오
시나리오: 전자세금계산서 전송이력 등록
새로운 전자세금계산서 전송이력 정보를 시스템에 등록해야 합니다.
- 화면에 접속합니다
- 신규 버튼을 클릭합니다
- 필수 항목을 입력합니다
- 저장 버튼을 클릭합니다
- 등록 완료를 확인합니다
참고: 데이터 구조
📋 기술 참고 정보 (개발자/관리자용)
테이블명: etax_transmission_logs
테이블 특성:
- 사용자 연결 (created_by, updated_by 자동 생성)
- 부서 연결 (department_id 자동 생성)
- 감사 추적 활성화
- 인쇄 기능 지원
입력 항목 원본
| 항목 | 의미 | 타입 | 필수 | 왜 필요한가 |
|---|---|---|---|---|
| 전송번호 | transmission_code | VARCHAR | ✅ | - |
| 세금 계산서 | tax_invoice_id | UUID | ✅ | tax_invoices 테이블 참조 (invoice_number 표시) |
| 전송유형 | transmission_type | 정발행 / 역발행 / 수정발행 / 위수탁발행 | ✅ | - |
| 전송상태 | transmission_status | 전송대기 / 전송중 / 전송완료 / 전송실패 / 취소 | ✅ | - |
| 국세청승인번호 | 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 | 시스템 users 테이블 참조 | |
| 비고 | remarks | TEXT | - |
데이터 관계도
참조받는 테이블
- 세금계산서 (1:N) 세금계산서→전송이력
화면 설정
목록 컬럼
| 컬럼 | 렌더링 | 고정 | 정렬 |
|---|---|---|---|
| transmission_no | link | - | ✅ |
| etax_type | tag | - | ✅ |
| partner_id | 기본 | - | ✅ |
| issue_date | date | - | ✅ |
| supply_amount | currency | - | ✅ |
| vat_amount | currency | - | ✅ |
| total_amount | currency | - | ✅ |
| 전송상태 | badge | - | ✅ |
| nts_approval_no | 기본 | - | ✅ |
| 전송일시 | date | - | ✅ |
필터 설정
| 필드 | 필터유형 |
|---|---|
| transmission_no | search |
| 전송상태 | select |
| etax_type | select |
| issue_date | dateRange |