수입신고
개요
이 화면은 무엇인가요? 이 화면에서는 수입신고를 작성하고 승인/전결 처리합니다.
누가 사용하나요?
- 🏢 무역팀: 수입신고 등록, 조회, 수정 업무 수행
언제 사용하나요?
- 수입신고 정보를 등록/수정할 때
- 수입신고 현황을 조회할 때
- 관련 데이터를 검색하고 분석할 때
주요 기능
1. 수입신고 작성
무엇을 하나요?: 이 화면에서는 수입신고를 작성하고 승인/전결 처리합니다.
어떻게 사용하나요?:
- 화면에 접속하여 신규 작성 버튼을 클릭합니다
- 기본 정보(거래처, 일자 등)를 입력합니다
- 라인 항목을 추가합니다
- 금액이 자동 계산되는 것을 확인합니다
- 저장 후 승인요청을 클릭합니다
- 승인자가 검토 후 승인합니다
💡 팁: 저장 전에 라인 항목 금액이 올바른지 반드시 확인하세요.
입력 항목 가이드
| 항목 | 설명 | 입력 방법 | 예시 |
|---|---|---|---|
| 통관번호 (필수) | customs_declaration_no | 직접 입력 | - |
| 구매발주 | po_id | 검색 선택 | - |
| 수출자(거래처) (필수) | partner_id | 검색 선택 | - |
| 관세사(거래처) | customs_broker_id | 검색 선택 | - |
| 신용장번호 | lc_number | 직접 입력 | - |
| 인코텀즈 (필수) | incoterms | 목록에서 선택 | - |
| 원산지국 (필수) | origin_country | 직접 입력 | - |
| HS코드 (필수) | hs_code | 직접 입력 | - |
| 과세가격(CIF) (필수) | customs_value | 숫자 입력 | 100 |
| 통화 (필수) | currency | 목록에서 선택 | - |
| 적용환율 | exchange_rate | 숫자 입력 | 100 |
| 원화과세가격 | customs_value_krw | 숫자 입력 | 100 |
| 관세율(%) | duty_rate | 숫자 입력 | 100 |
| 관세 | customs_duty | 숫자 입력 | 100 |
| 부가세 | vat_amount | 숫자 입력 | 100 |
| 총납부세액 | total_tax | 숫자 입력 | 100 |
| FTA적용 (필수) | fta_applied | 목록에서 선택 | - |
| FTA협정명 | fta_agreement | 목록에서 선택 | - |
| 원산지증명번호 | origin_certificate_no | 직접 입력 | - |
| B/L번호 | bl_number | 직접 입력 | - |
| 입항일 | arrival_date | 달력에서 선택 | 2026-03-17 |
| 통관상태 (필수) | clearance_status | 목록에서 선택 | - |
| 수리일 | clearance_date | 달력에서 선택 | 2026-03-17 |
| 보세창고 | warehouse_id | 검색 선택 | - |
| 분개전표 | journal_entry_id | 검색 선택 | - |
| 담당자 | handler_id | 검색 선택 | - |
| 승인자 | approved_by | 검색 선택 | - |
| 통관서류 | customs_document | 파일 첨부 | - |
| 비고 | remarks | 텍스트 입력 | - |
업무 흐름에서의 위치
| 연결 화면 | 관계 | 설명 |
|---|---|---|
| 수입부대비용배부 | 연관 | 수입통관→부대비용배부 |
| 구매발주 | 연관 | 구매발주→수입통관 |
| 거래처 | 연관 | 거래처→수입통관(수출자) |
| 거래처 | 연관 | 거래처→수입통관(관세사) |
| 창고 | 연관 | 창고→수입통관(보세창고) |
| 전표 | 연관 | 전표→수입통관 |
자주 묻는 질문 (FAQ)
Q. 전표 번호는 어떻게 부여되나요?
A. 자동 채번 규칙에 따라 접두어+연도+순번 형태로 자동 생성됩니다. 수동으로 변경 할 수 없습니다.
Q. 이미 승인된 전표를 수정할 수 있나요?
A. 승인 완료된 전표는 직접 수정할 수 없습니다. 역분개(취소) 전표를 생성한 후 새로 작성해야 합니다.
실무 시나리오
시나리오: 수입신고 작성 및 승인
새로운 수입신고를 작성하고 승인을 받아야 합니다.
- 화면에 접속하여 신규 작성 버튼을 클릭합니다
- 기본 정보(거래처, 일자 등)를 입력합니다
- 라인 항목을 추가합니다
- 금액이 자동 계산되는 것을 확인합니다
- 저장 후 승인요청을 클릭합니다
- 승인자가 검토 후 승인합니다
참고: 데이터 구조
📋 기술 참고 정보 (개발자/관리자용)
테이블명: import_declarations
테이블 특성:
- 사용자 연결 (created_by, updated_by 자동 생성)
- 부서 연결 (department_id 자동 생성)
- 감사 추적 활성화
- 인쇄 기능 지원
입력 항목 원본
| 항목 | 의미 | 타입 | 필수 | 왜 필요한가 |
|---|---|---|---|---|
| 통관번호 | customs_declaration_no | VARCHAR | ✅ | 관세청 수입신고번호 (14자리) |
| 구매발주 | po_id | UUID | purchase_orders 테이블 참조 (po_number 표시) | |
| 수출자(거래처) | partner_id | UUID | ✅ | partners 테이블 참조 (partner_name 표시) |
| 관세사(거래처) | customs_broker_id | UUID | partners 테이블 참조 (partner_name 표시) | |
| 신용장번호 | lc_number | VARCHAR | L/C (Letter of Credit) 번호 | |
| 인코텀즈 | incoterms | FOB / CIF / DDP / EXW / CFR / CIP / DAP / FCA | ✅ | - |
| 원산지국 | origin_country | VARCHAR | ✅ | ISO 3166 국가코드 (예: CN, JP, US) |
| HS코드 | hs_code | VARCHAR | ✅ | 관세율표 분류번호 (HSK 10자리) |
| 과세가격(CIF) | customs_value | DECIMAL | ✅ | 관세 부과 기준가격 (CIF 가격) |
| 통화 | currency | USD / EUR / JPY / CNY / KRW | ✅ | - |
| 적용환율 | exchange_rate | DECIMAL | 관세청 고시환율 | |
| 원화과세가격 | customs_value_krw | DECIMAL | 자동 계산: customs_value * exchange_rate | |
| 관세율(%) | duty_rate | DECIMAL | HS코드 기준 기본관세율 또는 FTA 협정세율 | |
| 관세 | customs_duty | DECIMAL | 자동 계산: customs_value_krw * duty_rate / 100 | |
| 부가세 | vat_amount | DECIMAL | 자동 계산: (customs_value_krw + customs_duty) * 0.1 | |
| 총납부세액 | total_tax | DECIMAL | 자동 계산: customs_duty + vat_amount | |
| FTA적용 | fta_applied | Y / N | ✅ | FTA 협정세율 적용 여부 |
| FTA협정명 | fta_agreement | 한-중 / 한-미 / 한-EU / 한-아세안 / 한-일(RCEP) / 한-영 / 한-베트남 / 한-호주 / 한-캐나다 / 해당없음 | - | |
| 원산지증명번호 | origin_certificate_no | VARCHAR | C/O (Certificate of Origin) 번호 | |
| B/L번호 | bl_number | VARCHAR | 선하증권(Bill of Lading) 번호 | |
| 입항일 | arrival_date | DATE | - | |
| 통관상태 | clearance_status | 신고전 / 신고접수 / 심사중 / 검사대기 / 검사중 / 수리 / 반려 / 보류 | ✅ | - |
| 수리일 | clearance_date | DATE | 관세청 수리(통관완료)일 | |
| 보세창고 | warehouse_id | UUID | warehouses 테이블 참조 (warehouse_name 표시) | |
| 분개전표 | journal_entry_id | UUID | journal_entries 테이블 참조 (entry_number 표시) | |
| 담당자 | handler_id | UUID | 시스템 users 테이블 참조 | |
| 승인자 | approved_by | UUID | 시스템 users 테이블 참조 | |
| 통관서류 | customs_document | FILE | 수입신고서, C/O, B/L, 인보이스, 패킹리스트 등 | |
| 비고 | remarks | TEXT | - |
데이터 관계도
참조하는 테이블
- 수입부대비용배부 (1:N) 수입통관→부대비용배부
참조받는 테이블
- 구매발주 (1:N) 구매발주→수입통관
- 거래처 (1:N) 거래처→수입통관(수출자)
- 거래처 (1:N) 거래처→수입통관(관세사)
- 창고 (1:N) 창고→수입통관(보세창고)
- 전표 (1:N) 전표→수입통관
참조받는 테이블
- 구매발주 (1:N) 구매발주→수입통관
- 거래처 (1:N) 거래처→수입통관(수출자)
- 거래처 (1:N) 거래처→수입통관(관세사)
- 창고 (1:N) 창고→수입통관(보세창고)
- 전표 (1:N) 전표→수입통관
전표 설정
- 자동 채번: 접두어
IMP, yearly 리셋 - 상태 흐름: 작성 → 작성→신고 → 신고→심사 → 심사→수리 → 심사→반려 → 반려→작성 → 수리, 반려
라인 항목
- 수입신고 항목 (
import_declaration_items)
폼 구성
신고정보
| 필드 | 필수 | 읽기전용 | 비고 |
|---|---|---|---|
| declaration_no | ✅ | ||
| declaration_date | ✅ | ||
| customs_broker | |||
| bl_no | |||
| 원산지국 | ✅ | ||
| 인코텀즈 | |||
| status |
금액
| 필드 | 필수 | 읽기전용 | 비고 |
|---|---|---|---|
| total_cif_value | |||
| duty_amount | |||
| 부가세 | |||
| total_landed_cost | ✅ | ||
| 통화 | |||
| 적용환율 |
비고
| 필드 | 필수 | 읽기전용 | 비고 |
|---|---|---|---|
| remark |