Giao diện
Tờ khai thuế TNCN
Quyền truy cập: Cần quyền "Tờ khai thuế" (TAX_DECLARATION) hoặc quyền quản trị Bảng lương (PAYROLL_ADMIN); phải có quyền "Xem Bảng lương" (PAYROLL_VIEW) để mở module · Điều hướng: Bảng lương > Tờ khai thuế (
/manage/payroll/tax-declarations)
Màn Tờ khai thuế là nơi bộ phận HR lập tờ khai thuế thu nhập cá nhân (TNCN) cho cơ quan thuế, phục vụ mẫu 05/KK. Hệ thống gom số liệu thuế từ các kỳ lương đã tính (payroll-item) thành tờ khai theo tháng, quý hoặc năm, rồi xuất ra file XML/Excel để nộp. Toàn bộ số thuế được engine tính sẵn theo biểu thuế lũy tiến và các mức giảm trừ gia cảnh của luật Việt Nam.
Lưu ý: Màn hình này chỉ tổng hợp và xuất tờ khai. Số thuế của từng nhân viên đã được tính khi chạy kỳ lương, không nhập tay tại đây. Muốn thay đổi con số, hãy sửa ở kỳ lương (khi kỳ chưa duyệt) hoặc điều chỉnh tham số luật.
Tổng quan
Tờ khai thuế TNCN (component TaxDeclarationsManager, tiêu đề "Tờ Khai Thuế") hoạt động như một lớp báo cáo phía trên dữ liệu lương: mỗi khi bạn tạo tờ khai cho một kỳ, hệ thống chạy buildPitDeclaration để lấy các dòng thuế từ những nhân viên đã có phiếu lương trong kỳ đó. Mỗi dòng gồm mã số thuế, thu nhập tính thuế, số người phụ thuộc và số thuế TNCN phải nộp.
Module Bảng lương thuộc nhóm HR và chỉ hiện khi đã bật tại Cài đặt hệ thống > Tính năng (cờ __payroll, kèm biến môi trường ALLOW_PAYROLL_FEATURE).
Giao diện màn Tờ khai thuế
Danh sách tờ khai hiển thị các tờ khai đã lập cùng số liệu tổng hợp. Mỗi bản ghi tờ khai gồm các trường sau:
| Trường | Mô tả |
|---|---|
| Mã tờ khai | Mã định danh của tờ khai |
| Loại | Tháng / Quý / Năm (monthly / quarterly / annual) |
| Kỳ | Tháng, quý hoặc năm mà tờ khai áp dụng |
| Tổng số NV | Số nhân viên có trong tờ khai (totalEmployees) |
| Tổng thu nhập tính thuế | Cộng dồn thu nhập tính thuế của mọi nhân viên trong kỳ |
| Tổng thuế | Cộng dồn số thuế TNCN phải nộp |
| File | File XML / Excel đã kết xuất để nộp |
| Trạng thái | Nháp, đã tạo, đã nộp, đã duyệt |
Mỗi dòng nhân viên bên trong tờ khai chứa: mã số thuế, thu nhập tính thuế, số người phụ thuộc (NPT) và số thuế TNCN của người đó.
Lưu ý: Mã số thuế, số người phụ thuộc và tình trạng cư trú của nhân viên lấy từ hồ sơ nhân sự. Nhân viên thiếu mã số thuế hoặc khai sai số người phụ thuộc sẽ ra tờ khai lệch, nên rà soát hồ sơ trước khi lập tờ khai chính thức.
Cách tính thuế TNCN
Đây là phần lõi mà admin HR cần nắm để hiểu con số trên tờ khai. Engine tính thuế theo đúng luật Việt Nam hiệu lực 01/07/2024 (seed cấu hình nhãn "VN 2024-07-01 (áp dụng 2026)").
Thu nhập tính thuế
Trước khi áp biểu thuế, engine tính ra thu nhập tính thuế của mỗi nhân viên theo công thức:
Thu nhập tính thuế = Thu nhập chịu thuế − Bảo hiểm bắt buộc (phần nhân viên) − Giảm trừ bản thân − (Giảm trừ người phụ thuộc × số NPT)
Kết quả được kẹp không âm (nếu ra số âm thì tính bằng 0). Bảo hiểm bắt buộc phần nhân viên gồm BHXH, BHYT, BHTN; xem chi tiết ở trang Tham số luật.
Mức giảm trừ gia cảnh
| Khoản giảm trừ | Mức/tháng |
|---|---|
| Giảm trừ bản thân (người nộp thuế) | 11.000.000đ |
| Giảm trừ mỗi người phụ thuộc | 4.400.000đ |
Biểu thuế lũy tiến 7 bậc
Thuế TNCN áp dụng biểu lũy tiến từng phần trên thu nhập tính thuế/tháng: mỗi phần thu nhập rơi vào bậc nào thì chịu thuế suất của bậc đó.
| Bậc | Thu nhập tính thuế/tháng | Thuế suất |
|---|---|---|
| 1 | Đến 5.000.000đ | 5% |
| 2 | Trên 5.000.000đ đến 10.000.000đ | 10% |
| 3 | Trên 10.000.000đ đến 18.000.000đ | 15% |
| 4 | Trên 18.000.000đ đến 32.000.000đ | 20% |
| 5 | Trên 32.000.000đ đến 52.000.000đ | 25% |
| 6 | Trên 52.000.000đ đến 80.000.000đ | 30% |
| 7 | Trên 80.000.000đ | 35% |
Ví dụ tính thuế
Ví dụ kiểm chứng theo bộ test của engine: một nhân viên có thu nhập chịu thuế 100.000.000đ, bảo hiểm phần nhân viên 5.438.000đ, có 2 người phụ thuộc.
- Thu nhập tính thuế = 100.000.000 − 5.438.000 − 11.000.000 (bản thân) − 8.800.000 (2 NPT × 4.400.000) = 74.762.000đ
- Áp biểu lũy tiến 7 bậc lên 74.762.000đ → thuế TNCN = 16.578.600đ
Cá nhân không cư trú
Với nhân viên thuộc diện không cư trú (non_resident), engine không áp biểu lũy tiến và không tính giảm trừ, mà tính thuế khoán 20% trên toàn bộ thu nhập chịu thuế.
Lập tờ khai
Từ màn Tờ khai thuế, bạn có thể tạo tờ khai theo kỳ và kiểm tra số liệu trước khi kết xuất.
Tạo tờ khai theo kỳ
- "Tạo tờ khai tháng": lập tờ khai cho một tháng (payroll.tax.generateMonthly).
- "Tạo tờ khai quý": gom số liệu ba tháng thành tờ khai quý (generateQuarterly).
- "Tạo tờ khai năm": tổng hợp cả năm để quyết toán (generateAnnual).
Kiểm tra và xem giảm trừ
- "Tính thử PIT": chạy thử công thức thuế (calculatePIT) để đối chiếu con số trước khi chốt tờ khai.
- "Xem giảm trừ": xem các khoản giảm trừ đang áp dụng cho từng nhân viên (getDeductions), gồm giảm trừ bản thân và giảm trừ người phụ thuộc.
Kết xuất file
- "Xuất XML" / "Xuất Excel": kết xuất tờ khai ra file để nộp cho cơ quan thuế theo mẫu 05/KK.
Trạng thái tờ khai
Tờ khai đi qua các trạng thái sau:
| Trạng thái | Ý nghĩa |
|---|---|
| Nháp | Tờ khai vừa khởi tạo, chưa có số liệu chốt |
| Đã tạo | Đã gom số liệu và sẵn sàng kết xuất |
| Đã nộp | Đã nộp file cho cơ quan thuế |
| Đã duyệt | Cơ quan thuế đã duyệt tờ khai |
Lưu ý về pháp lý
Quan trọng: Mức giảm trừ gia cảnh (11.000.000đ bản thân, 4.400.000đ mỗi người phụ thuộc) đang có đề xuất nâng nhưng chưa thành luật. Khi có hiệu lực chính thức, hãy tạo một bản cấu hình luật ở chế độ "chờ hiệu lực" (staged) tại trang Tham số luật thay vì sửa trực tiếp, để số liệu kỳ cũ không bị thay đổi.
Lưu ý: Tờ khai thuế TNCN phục vụ mẫu 05/KK. Ngoài màn này, bạn có thể xuất báo cáo thuế TNCN 05/KK trong Trung tâm báo cáo lương. Báo cáo bảo hiểm (mẫu D02-TS) là một luồng riêng, không nằm trong tờ khai thuế.