📋 Tờ khai hải quan

Tạo, quản lý, và xuất tờ khai hải quan nhập khẩu, xuất khẩu, và gia công. Route: /declarations.

Xem và tìm kiếm toàn bộ tờ khai trong workspace.

🔍

Danh sách tờ khai — bộ lọc trạng thái, thống kê, và bảng dữ liệu

Lọc theo trạng thái:

Trạng thái	Ý nghĩa
Bản nháp	Đang soạn, chưa gửi
Chờ duyệt	Đã gửi, đang chờ duyệt
Đã duyệt	Đã được duyệt nội bộ, sẵn sàng nộp
Đã nộp	Đã nộp lên hệ thống hải quan
Hoàn thành	Đã thông quan
Từ chối	Hải quan từ chối, cần điều chỉnh và nộp lại

Lọc nâng cao:

• Theo loại tờ khai: Nhập khẩu / Xuất khẩu / Quá cảnh
• Theo khoảng thời gian tạo
• Tìm kiếm theo số tờ khai, tên hàng

Thao tác nhanh:

Thao tác	Mô tả
Tạo mới	Nhấn nút "Tạo mới" để bắt đầu wizard tạo tờ khai
Xem chi tiết	Nhấn vào dòng để xem chi tiết tờ khai
Xóa hàng loạt	Chọn nhiều tờ khai bằng checkbox, nhấn "Xóa"
Sắp xếp	Nhấn tiêu đề cột để sắp xếp theo ngày tạo, trị giá, trạng thái...

Phiên bản & lịch sử kiểm tra (Version History)

Mỗi lần tờ khai thay đổi đáng kể, hệ thống tạo DeclarationVersion — snapshot toàn bộ dữ liệu tại thời điểm đó.

Khi nào tạo version mới:

Hành động	Tạo version?
Lưu DRAFT lần đầu	Không
Chuyển DRAFT → PENDING_REVIEW	Có (v1)
Sửa sau khi REJECTED, nộp lại	Có (v2, v3...)
Cập nhật mặt hàng khi đang APPROVED	Có
Chỉ đổi ghi chú / trạng thái nội bộ	Không

Xem lịch sử:

Vào chi tiết tờ khai → tab Lịch sử → thấy danh sách version theo thứ tự thời gian, kèm:

• Người thay đổi
• Thời gian
• Trường nào thay đổi (diff view)
• Lý do (nếu có ghi nhận)

Khôi phục version cũ

Không thể tự động khôi phục version cũ từ UI — đây là thiết kế có chủ ý để tránh sai sót. Nếu cần khôi phục, liên hệ admin hoặc tạo tờ khai mới từ version cũ.

18 trạng thái tờ khai

Hệ thống theo dõi 18 trạng thái chi tiết hơn so với 6 nhóm hiển thị trên UI:

Nhóm DRAFT:

• DRAFT — Bản nháp đang soạn

Nhóm REVIEW:

• PENDING_REVIEW — Chờ duyệt nội bộ
• UNDER_REVIEW — Đang được review
• CHANGES_REQUESTED — Yêu cầu chỉnh sửa
• REVIEW_APPROVED — Duyệt nội bộ xong

Nhóm SUBMISSION:

• SUBMITTED — Đã nộp lên hải quan
• PROCESSING — Hải quan đang xử lý
• ADDITIONAL_INFO_REQUIRED — HQ yêu cầu bổ sung

Nhóm CLEARANCE:

• APPROVED — HQ duyệt
• PHYSICAL_INSPECTION — Kiểm tra thực tế (Luồng đỏ)
• INSPECTION_PASSED — Kiểm tra qua
• INSPECTION_FAILED — Kiểm tra không qua

Nhóm COMPLETED:

• CLEARED — Đã thông quan
• COMPLETED — Hoàn tất toàn bộ

Nhóm REJECTED/CANCELLED:

• REJECTED — Bị từ chối
• CANCELLED — Đã huỷ
• AMENDMENT_REQUIRED — Cần sửa đổi
• AMENDED — Đã sửa đổi xong

Ba loại tờ khai khác nhau

• IMP (đầu 1) — Nhập khẩu: có thể sửa/huỷ theo quy định HQ
• EXP (đầu 3) — Xuất khẩu: có thể sửa/huỷ theo quy định HQ
• OLA (đầu 5) — Vận chuyển độc lập: KHÔNG thể huỷ hoặc sửa sau khi đã nộp

Tính thuế tự động

Nhấn "Tính thuế" tại Bước 5 hoặc từ chi tiết tờ khai → hệ thống tính tự động:

Loại thuế	Cách tính
Thuế nhập khẩu (MFN)	Trị giá HQ × Thuế suất MFN
Thuế ưu đãi FTA	Trị giá HQ × Thuế suất FTA (nếu có C/O)
Thuế VAT	(Trị giá HQ + Thuế NK) × 8% hoặc 10%
Thuế TTĐB	Trị giá HQ × Thuế suất TTĐB (rượu, xe, thuốc lá...)
Thuế bảo vệ môi trường	Số lượng × Đơn giá thuế BVMT

Điều chỉnh trị giá hải quan (cost adjustments):

Tùy điều kiện giao hàng (Incoterm), trị giá hải quan được điều chỉnh trước khi tính thuế. Hệ thống hỗ trợ phân bổ chi phí theo 5 phương pháp:

Phương pháp	Mô tả
BY_VALUE	Phân bổ theo tỷ lệ trị giá từng mặt hàng
BY_WEIGHT	Phân bổ theo khối lượng
BY_VOLUME	Phân bổ theo thể tích (CBM)
BY_QUANTITY	Phân bổ theo số lượng (cái, kg...)
MANUAL	Nhập tay trị giá điều chỉnh cho từng dòng