Giao diện
Chuyển khoản ngân hàng
Quyền truy cập: Xem cần quyền xem bảng lương (PAYROLL_VIEW); tạo lệnh và xuất file chuyển khoản cần quyền chuyển khoản ngân hàng (BANK_TRANSFER) hoặc Admin · Điều hướng: Bảng lương > Chuyển khoản (
/manage/payroll/bank-transfers)
Màn Chuyển khoản (BankTransfersManager, tiêu đề "Chuyển Khoản Ngân Hàng") là nơi admin HR sinh lệnh và file chuyển khoản để trả lương thực nhận cho nhân viên qua ngân hàng. Từ một kỳ lương đã có kết quả tính lương, hệ thống lập một lệnh chuyển khoản gồm danh sách nhân viên, số tài khoản và số tiền net, rồi kết xuất ra file theo đúng định dạng của từng ngân hàng để admin tải lên internet banking doanh nghiệp.
Quan trọng: Số tài khoản ngân hàng KHÔNG được lưu trong bản chụp dữ liệu (snapshot) của kỳ lương. Khi sinh file chuyển khoản, hệ thống luôn lấy số tài khoản LIVE từ hồ sơ Lương thưởng phúc lợi hiện hành của nhân viên, để tránh chuyển nhầm vào tài khoản cũ đã thay đổi.
Tổng quan
Mỗi lệnh chuyển khoản gắn với một kỳ lương nguồn (payrollRunId) và một ngân hàng thụ hưởng. Hệ thống gom các dòng chi trả net của kỳ đó thành một lệnh, tính tổng tiền và tổng số nhân viên, rồi cho phép kết xuất file theo định dạng ngân hàng. Sau khi tải file, đẩy lên ngân hàng và ngân hàng chi thành công, admin cập nhật dần trạng thái của lệnh cho tới khi hoàn tất, sau đó quay lại trang chi tiết kỳ lương để bấm "Đánh dấu đã chi".
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 và biến môi trường ALLOW_PAYROLL_FEATURE).
Giao diện màn Chuyển khoản
Màn hình liệt kê các lệnh chuyển khoản đã lập. Mỗi lệnh mang các thông tin sau:
| Trường | Mô tả |
|---|---|
| Mã lệnh | Mã định danh của lệnh chuyển khoản |
| Kỳ lương nguồn | Kỳ lương (payrollRunId) mà lệnh này chi trả |
| Ngân hàng | Ngân hàng thụ hưởng, gồm mã (bankCode) và tên (bankName) |
| Tổng tiền | Tổng số tiền net phải chuyển của cả lệnh |
| Tổng số NV | Số nhân viên có trong lệnh chuyển khoản |
| Danh sách chuyển khoản | Từng dòng gồm tên nhân viên, số tài khoản, chi nhánh và số tiền |
| Định dạng file | Định dạng kết xuất: VCB / TCB / ACB / NAPAS / EXCEL |
| Trạng thái | Vị trí của lệnh trong vòng đời (xem bảng bên dưới) |
Tạo và xuất file chuyển khoản
1. Tạo lệnh chuyển khoản
Nhấn tạo lệnh (payroll.bank.create) và chọn kỳ lương nguồn cùng ngân hàng thụ hưởng. Hệ thống lấy danh sách nhân viên của kỳ, đọc số tài khoản live từ hồ sơ Lương thưởng phúc lợi và dựng các dòng chuyển khoản với số tiền bằng lương thực nhận của từng người.
2. Sinh file theo định dạng ngân hàng
Chọn định dạng và sinh file (generateFile / payrollReport.bankFile). File được tạo đúng khuôn của ngân hàng đã chọn để có thể tải thẳng lên internet banking doanh nghiệp mà không cần chỉnh tay.
3. Cập nhật trạng thái theo tiến trình chi trả
Sau khi tải file và đẩy lên ngân hàng, admin đánh dấu lần lượt: đã tải (markAsUploaded), đã xác nhận (markAsConfirmed) rồi hoàn tất (markAsCompleted) khi ngân hàng chi xong.
Định dạng file ngân hàng
Hệ thống hỗ trợ 5 định dạng kết xuất:
| Định dạng | Dùng cho |
|---|---|
| VCB | Khuôn file chuyển lương của Vietcombank |
| TCB | Khuôn file chuyển lương của Techcombank |
| ACB | Khuôn file chuyển lương của ngân hàng ACB |
| NAPAS | Khuôn NAPAS dùng chung cho chuyển khoản liên ngân hàng |
| EXCEL | File bảng tính Excel tổng quát để đối chiếu hoặc dùng với ngân hàng khác |
Vòng đời lệnh chuyển khoản
Một lệnh đi qua 5 trạng thái theo trình tự sau:
| Trạng thái | Ý nghĩa | Thao tác đưa tới |
|---|---|---|
| Nháp | Lệnh vừa được lập, chưa kết xuất | Tạo chuyển khoản (payroll.bank.create) |
| Đã tạo | Lệnh và file đã được sinh | Sinh file theo định dạng ngân hàng |
| Đã tải | File đã được tải xuống để đẩy lên ngân hàng | Đánh dấu đã tải (markAsUploaded) |
| Đã xác nhận | Ngân hàng đã nhận và xác nhận lệnh | Đánh dấu đã xác nhận (markAsConfirmed) |
| Hoàn tất | Ngân hàng đã chi trả xong | Đánh dấu hoàn tất (markAsCompleted) |
Nhân viên thiếu số tài khoản
Khi lập lệnh, những nhân viên chưa có số tài khoản ngân hàng trong hồ sơ Lương thưởng phúc lợi sẽ bị tách ra một danh sách riêng (missingBank) và KHÔNG được xuất thành dòng chuyển khoản.
Lưu ý: Trước khi sinh file, hãy rà soát danh sách missingBank và bổ sung số tài khoản trong hồ sơ Lương thưởng phúc lợi của các nhân viên này, sau đó lập lại lệnh. Do số tài khoản được lấy live, việc cập nhật hồ sơ sẽ được phản ánh ngay khi tạo lệnh mới mà không cần tính lại kỳ lương. Ở bước kiểm tra trước khi trình duyệt kỳ lương, nhân viên thiếu tài khoản ngân hàng chỉ tạo cảnh báo (không phải lỗi chặn), nên kỳ vẫn có thể được duyệt trước khi bổ sung tài khoản.