Giao diện
Tỷ giá ngoại tệ
Quyền truy cập: Xem cần quyền "Xem bảng lương" (PAYROLL_VIEW); thêm, sửa, xóa tỷ giá cần quyền quản trị bảng lương (PAYROLL_ADMIN) hoặc Admin · Điều hướng: Bảng lương > Tỷ giá (
/manage/payroll/fx-rates)
Màn Tỷ giá là nơi admin HR khai báo tỷ giá quy đổi các loại ngoại tệ về đồng Việt Nam (VND), phục vụ những nhân viên được trả lương bằng ngoại tệ. Khi chạy kỳ lương, hệ thống lấy tỷ giá ở đây để quy phần lương ngoại tệ về VND rồi mới tính bảo hiểm và thuế TNCN. Mỗi tỷ giá gắn với một ngày hiệu lực, cho phép lưu lại lịch sử tỷ giá theo thời gian.
Lưu ý: Màn hình này chỉ dùng để khai báo tỷ giá. Loại tiền lương của từng nhân viên được lấy từ module Lương thưởng phúc lợi (compensation); nhân viên xem phiếu lương của mình ở app Nhân viên (noova-employee).
Tổng quan
Màn Tỷ giá (component FxRatesManager) liệt kê danh sách các tỷ giá đã khai báo và cho phép thêm, sửa, xóa. Đây là một trong 9 mục của menu Bảng lương, chỉ hiện khi module đã được bật tại Cài đặt hệ thống > Tính năng (cờ __payroll cùng biến môi trường ALLOW_PAYROLL_FEATURE).
Tỷ giá không tự động cập nhật từ nguồn bên ngoài. Admin HR chủ động nhập tỷ giá và ghi rõ nguồn tham chiếu để phục vụ đối soát. Nếu doanh nghiệp không trả lương bằng ngoại tệ thì không cần dùng đến màn này.
Bảng trường tỷ giá
Mỗi bản ghi tỷ giá gồm các trường sau:
| Trường | Mô tả |
|---|---|
| Loại tiền | Mã ngoại tệ được quy đổi (ví dụ: USD, EUR, JPY) |
| Tỷ giá quy đổi sang VND | Số VND tương ứng với một đơn vị ngoại tệ (rateToVnd) |
| Ngày hiệu lực | Ngày bắt đầu áp dụng tỷ giá này (effectiveDate) |
| Nguồn | Nguồn tham chiếu của tỷ giá, phục vụ đối soát và kiểm tra (source) |
Lưu ý: Số liệu ví dụ nêu trên chỉ để minh họa cấu trúc trường. Giá trị thực tế do admin HR nhập theo tỷ giá của doanh nghiệp.
Thao tác
Trên màn Tỷ giá, admin HR có thể thực hiện các thao tác sau:
Thêm hoặc sửa tỷ giá
Mở cửa sổ "Tỷ giá" (FxRateFormModal) để khai báo một tỷ giá mới hoặc chỉnh sửa tỷ giá đã có. Nhập loại tiền, tỷ giá quy đổi sang VND, ngày hiệu lực và nguồn, sau đó lưu lại. Thao tác lưu chạy qua phương thức fxRate.upsert trên máy chủ.
Xóa tỷ giá
Xóa một bản ghi tỷ giá không còn dùng (fxRate.remove).
Xem danh sách
Danh sách tỷ giá được nạp qua fxRate.list, hiển thị các tỷ giá đã khai báo kèm loại tiền, giá trị quy đổi và ngày hiệu lực.
Cách tỷ giá tham gia tính lương
Tỷ giá không đứng riêng: nó là mắt xích bắt buộc khi một nhân viên hưởng lương bằng ngoại tệ. Phần này giải thích cách engine tính lương sử dụng tỷ giá để admin hiểu vì sao cần khai báo đầy đủ.
Quy đổi để tính bảo hiểm và thuế
Khi tính lương, phần lương ghi bằng ngoại tệ được nhân với tỷ giá để quy về VND. Toàn bộ nền tính bảo hiểm bắt buộc (BHXH, BHYT, BHTN) và thuế TNCN đều dựa trên giá trị VND sau quy đổi, đảm bảo đúng quy định pháp luật Việt Nam vốn tính theo VND.
Lưu net theo cả hai loại tiền
Phiếu lương của nhân viên hưởng ngoại tệ lưu song song hai con số: lương thực nhận theo VND và lương thực nhận theo nguyên tệ. Net nguyên tệ được suy ra từ net VND chia cho tỷ giá (netInPayCurrency = netVnd / fxRate), giúp nhân viên đối chiếu số tiền nhận thực tế bằng đồng tiền mình được trả.
Quan trọng: Nếu một nhân viên hưởng lương ngoại tệ mà THIẾU tỷ giá tương ứng, kỳ lương sẽ chặn nhân viên đó (lý do chặn
fx-missing) và không tính được lương cho họ. Hãy khai báo đủ tỷ giá cho mọi loại tiền đang có nhân viên hưởng trước khi chụp dữ liệu và tính kỳ lương.