수입부대비용 배부
개요
이 화면은 무엇인가요? 이 화면에서는 수입부대비용 배부 데이터를 조회, 등록, 수정, 삭제합니다.
누가 사용하나요?
- 🏢 무역팀: 수입부대비용 배부 등록, 조회, 수정 업무 수행
언제 사용하나요?
- 수입부대비용 배부 정보를 등록/수정할 때
- 수입부대비용 배부 현황을 조회할 때
- 관련 데이터를 검색하고 분석할 때
주요 기능
1. 수입부대비용 배부 등록/조회
무엇을 하나요?: 이 화면에서는 수입부대비용 배부 데이터를 조회, 등록, 수정, 삭제합니다.
어떻게 사용하나요?:
- 화면에 접속합니다
- 신규 버튼을 클릭합니다
- 필수 항목을 입력합니다
- 저장 버튼을 클릭합니다
- 등록 완료를 확인합니다
💡 팁: 자주 사용하는 검색 조건은 필터에 저장해두면 편리합니다.
입력 항목 가이드
| 항목 | 설명 | 입력 방법 | 예시 |
|---|---|---|---|
| 배부번호 (필수) | allocation_code | 직접 입력 | - |
| 수입통관 (필수) | import_declaration_id | 검색 선택 | - |
| 비용유형 (필수) | cost_type | 목록에서 선택 | - |
| 비용금액 (필수) | amount | 숫자 입력 | 100 |
| 통화 (필수) | currency | 목록에서 선택 | - |
| 원화금액 (필수) | amount_krw | 숫자 입력 | 100 |
| 배부방법 (필수) | allocation_method | 목록에서 선택 | - |
| 배부대상품목 | allocated_to_item_id | 검색 선택 | - |
| 배부금액 | allocated_amount | 숫자 입력 | 100 |
| 배부비율(%) | allocation_ratio | 숫자 입력 | 100 |
| 비용발생거래처 | partner_id | 검색 선택 | - |
| 세금계산서 | tax_invoice_id | 검색 선택 | - |
| 분개전표 | journal_entry_id | 검색 선택 | - |
| 재고원가포함 (필수) | cost_included_in_inventory | 목록에서 선택 | - |
| 상태 (필수) | status | 목록에서 선택 | - |
| 담당자 | handler_id | 검색 선택 | - |
| 비고 | remarks | 텍스트 입력 | - |
업무 흐름에서의 위치
| 연결 화면 | 관계 | 설명 |
|---|---|---|
| 수입통관 | 연관 | 수입통관→부대비용배부 |
| 품목마스터 | 연관 | 품목→부대비용배부(배부대상) |
| 거래처 | 연관 | 거래처→부대비용배부(비용발생) |
| 세금계산서 | 연관 | 세금계산서→부대비용배부 |
| 전표 | 연관 | 전표→부대비용배부 |
자주 묻는 질문 (FAQ)
Q. 데이터를 일괄로 등록할 수 있나요?
A. CSV 파일을 통한 일괄 가져오기(Import) 기능을 지원합니다. 화면 상단의 가져오기 버튼을 사용하세요.
Q. 삭제한 데이터를 복구할 수 있나요?
A. 감사 추적(Audit Trail)이 활성화되어 있어 변경 이력을 확인할 수 있습니다. 삭제된 데이터는 관리자에게 문의하세요.
실무 시나리오
시나리오: 수입부대비용 배부 등록
새로운 수입부대비용 배부 정보를 시스템에 등록해야 합니다.
- 화면에 접속합니다
- 신규 버튼을 클릭합니다
- 필수 항목을 입력합니다
- 저장 버튼을 클릭합니다
- 등록 완료를 확인합니다
참고: 데이터 구조
📋 기술 참고 정보 (개발자/관리자용)
테이블명: import_cost_allocations
테이블 특성:
- 사용자 연결 (created_by, updated_by 자동 생성)
- 감사 추적 활성화
- 인쇄 기능 지원
입력 항목 원본
| 항목 | 의미 | 타입 | 필수 | 왜 필요한가 |
|---|---|---|---|---|
| 배부번호 | allocation_code | VARCHAR | ✅ | - |
| 수입통관 | import_declaration_id | UUID | ✅ | import_declarations 테이블 참조 (customs_declaration_no 표시) |
| 비용유형 | cost_type | 관세 / 부가세 / 해상운임 / 항공운임 / 보험료 / 통관수수료 / 검역비 / 하역비 / 내륙운송비 / 창고보관료 / 기타 | ✅ | - |
| 비용금액 | amount | DECIMAL | ✅ | - |
| 통화 | currency | KRW / USD / EUR / JPY / CNY | ✅ | - |
| 원화금액 | amount_krw | DECIMAL | ✅ | - |
| 배부방법 | allocation_method | 금액비례 / 수량비례 / 중량비례 / 균등배분 / 직접지정 | ✅ | - |
| 배부대상품목 | allocated_to_item_id | UUID | items 테이블 참조 (item_name 표시) | |
| 배부금액 | allocated_amount | DECIMAL | - | |
| 배부비율(%) | allocation_ratio | DECIMAL | 해당 품목에 배부된 비율 | |
| 비용발생거래처 | partner_id | UUID | partners 테이블 참조 (partner_name 표시) | |
| 세금계산서 | tax_invoice_id | UUID | tax_invoices 테이블 참조 (invoice_number 표시) | |
| 분개전표 | journal_entry_id | UUID | journal_entries 테이블 참조 (entry_number 표시) | |
| 재고원가포함 | cost_included_in_inventory | Y / N | ✅ | 취득원가 산입 여부 (K-IFRS 1002호 제11항) |
| 상태 | status | 작성 / 배부완료 / 전기완료 / 취소 | ✅ | - |
| 담당자 | handler_id | UUID | 시스템 users 테이블 참조 | |
| 비고 | remarks | TEXT | - |
데이터 관계도
참조받는 테이블
- 수입통관 (1:N) 수입통관→부대비용배부
- 품목마스터 (1:N) 품목→부대비용배부(배부대상)
- 거래처 (1:N) 거래처→부대비용배부(비용발생)
- 세금계산서 (1:N) 세금계산서→부대비용배부
- 전표 (1:N) 전표→부대비용배부
화면 설정
목록 컬럼
| 컬럼 | 렌더링 | 고정 | 정렬 |
|---|---|---|---|
| allocation_no | link | - | ✅ |
| declaration_id | 기본 | - | ✅ |
| 비용유형 | tag | - | ✅ |
| cost_description | 기본 | - | ✅ |
| total_cost | currency | - | ✅ |
| 배부방법 | tag | - | ✅ |
| allocation_date | date | - | ✅ |
| 상태 | badge | - | ✅ |
필터 설정
| 필드 | 필터유형 |
|---|---|
| allocation_no | search |
| 비용유형 | select |
| 상태 | select |
| allocation_date | dateRange |