Giao diện
Tổng quan
Quyền truy cập: Xem cần quyền "Xem bảng lương" (PAYROLL_VIEW); module chỉ hiện khi bật cờ
__payrollvà biến môi trườngALLOW_PAYROLL_FEATURE· Điều hướng: Bảng lương > Tổng quan (/manage/payroll/overview)
Bảng lương là hệ tính lương Việt Nam đầy đủ trong Noova: chạy kỳ lương theo tháng, tự lấy dữ liệu Chấm công và Lương thưởng phúc lợi, rồi tính lương gộp, bảo hiểm bắt buộc, thuế TNCN và lương thực nhận cho từng nhân viên. Màn "Tổng quan" là điểm vào nhanh của module cho admin lương, có khối "Cần hỗ trợ?" dẫn tới trợ giúp. Trang này giới thiệu vai trò của module và các chỉ số lương chính mà hệ thống theo dõi.
Lưu ý: Toàn bộ cấu hình và việc tính lương diễn ra ở app Quản trị (noova-manage). Nhân viên chỉ xem và tải phiếu lương của mình ở app Nhân viên (noova-employee) qua quyền PAYSLIP_VIEW_OWN và PAYSLIP_DOWNLOAD_OWN.
Tổng quan
Module Bảng lương thuộc nhóm HR và chỉ hiện sau khi bật tại Cài đặt hệ thống > Tính năng (cờ __payroll), đồng thời phải được cho phép bởi biến môi trường ALLOW_PAYROLL_FEATURE. Đằng sau các con số là một bộ máy tính toán (engine) thuần, tách rời giao diện, áp dụng đúng luật thuế và bảo hiểm Việt Nam hiệu lực 01/07/2024 (dùng cho năm 2026) và có bộ test kiểm chứng từng con số.
Mỗi kỳ lương đi qua một quy trình trạng thái chặt chẽ: chụp dữ liệu, tính, kiểm tra, trình duyệt, duyệt, chốt, chi, đóng. Sau khi được duyệt, kỳ lương bị khóa và không sửa được nữa để bảo đảm toàn vẹn số liệu đã chi.
Chỉ số chính
Với mỗi kỳ lương, hệ thống tổng hợp các chỉ số sau (hiển thị ở màn chi tiết kỳ lương và trung tâm Báo cáo):
| Chỉ số | Ý nghĩa |
|---|---|
| Số nhân viên | Số nhân viên có trong kỳ lương |
| Tổng lương Gross | Tổng lương gộp toàn kỳ (lương cơ bản + phụ cấp + OT + thưởng) |
| Tổng thuế | Tổng thuế thu nhập cá nhân (TNCN) toàn kỳ |
| Tổng lương Net | Tổng lương thực nhận toàn kỳ |
| Chi phí chủ sử dụng | Tổng chi phí lao động của chủ sử dụng lao động (totalEmployerCost) |
| NV thiếu hồ sơ | Số nhân viên bị chặn do thiếu hồ sơ lương (blockedCount) |
| Nhập tay | Số nhân viên phải nhập dữ liệu chấm công thủ công (manualCount) |
Lưu ý: Các chỉ số trên được tính theo từng kỳ lương, không phải số cố định của tổ chức. Để xem theo đơn vị, so sánh kỳ trước hoặc cùng kỳ năm ngoái, hãy dùng màn Báo cáo (
/manage/payroll/reports).
Các mục trong Bảng lương
Menu Bảng lương gồm 9 mục, mỗi mục phụ trách một phần của quy trình tính lương:
| Mục | Đường dẫn | Vai trò |
|---|---|---|
| Tổng quan | /manage/payroll/overview | Điểm vào và giới thiệu module |
| Kỳ tính lương | /manage/payroll/payroll-runs | Tạo và quản lý các kỳ lương theo tháng |
| Phiếu lương | /manage/payroll/payslips | Danh sách phiếu lương đã phát hành, xuất PDF, gửi email |
| Tờ khai thuế | /manage/payroll/tax-declarations | Lập tờ khai thuế TNCN theo tháng/quý/năm (mẫu 05/KK) |
| Chuyển khoản | /manage/payroll/bank-transfers | Tạo file chuyển khoản trả lương theo định dạng ngân hàng |
| Báo cáo | /manage/payroll/reports | Trung tâm báo cáo chi phí lương, thuế, bảo hiểm |
| Tỷ giá | /manage/payroll/fx-rates | Tỷ giá ngoại tệ quy đổi về VND cho nhân viên hưởng lương ngoại tệ |
| Tham số luật | /manage/payroll/statutory-config | Cấu hình biểu thuế, bảo hiểm, lương tối thiểu vùng theo phiên bản hiệu lực |
| Cơ chế thưởng | /manage/payroll/bonus-schemes | Quy đổi kết quả hiệu suất thành tiền thưởng |
Quan hệ với các module khác
Bảng lương không tự nhập số công hay lương cơ bản, mà lấy dữ liệu từ các module khác qua cơ chế chụp dữ liệu (snapshot) tại thời điểm chốt kỳ.
Chấm công (module 13)
Khi chụp dữ liệu, kỳ lương tự lấy dữ liệu chấm công và chuẩn hóa thành: số ngày nghỉ không lương (ngày vắng + nghỉ không lương) và 4 nhóm giờ làm thêm (OT ngày thường, cuối tuần, ngày lễ, ban đêm). Các con số này dùng để prorate lương theo công và tính tiền OT. Nếu một nhân viên không có dữ liệu chấm công, hệ thống không tự bỏ qua mà gắn cờ nguồn "manual" để admin nhập tay tại màn chi tiết kỳ lương.
Lương thưởng phúc lợi (module 14)
Đây là nguồn bắt buộc: cấu trúc lương cung cấp lương cơ bản, lương đóng bảo hiểm, phụ cấp (chịu thuế và không chịu thuế), loại tiền, số tài khoản ngân hàng và chi phí phúc lợi của chủ sử dụng lao động. Nhân viên thiếu cấu trúc lương sẽ bị chặn khỏi kỳ lương (được đánh dấu trong nhóm NV thiếu hồ sơ). Số tài khoản ngân hàng luôn được lấy trực tiếp (live) từ cấu trúc lương hiện hành khi xuất file chuyển khoản, không lưu trong snapshot, để tránh chi nhầm vào tài khoản cũ.
Hiệu suất (module 11)
Nếu module Hiệu suất được bật, kết quả hiệu suất theo kỳ (ví dụ "2026-03") được quy đổi qua Cơ chế thưởng thành tiền thưởng cho kỳ lương loại "Thưởng". Nếu tắt, phần thưởng theo hiệu suất được bỏ qua.
Quan trọng: Vì Bảng lương phụ thuộc vào Chấm công và Lương thưởng phúc lợi, nên trước khi chốt một kỳ lương, hãy bảo đảm dữ liệu chấm công của kỳ đã được tổng hợp và cấu trúc lương của mọi nhân viên đã đầy đủ. Nhân viên thiếu cấu trúc lương hoặc thiếu tỷ giá (với lương ngoại tệ) sẽ bị chặn khỏi kỳ và cần được xử lý trước.

