Đơn từ
Trang này được sinh tự động từ nội dung hướng dẫn trong ứng dụng — sửa ở
featureToggleGuidesrồi chạypnpm gen:feature-toggle-docs.
Cho phép gửi thay người khác
Chấp nhận đơn gửi hộ nhân viên khác qua API. Form tạo đơn trên web và mobile chưa có ô gửi hộ.
| Mã | Mặc định | Bật tại | Cần bật trước |
|---|---|---|---|
requests.allow_on_behalf | Tắt | /settings/others-configuration | — |
Cách hoạt động
Cho phép tạo đơn thay cho nhân viên khác bằng cách gửi nhân viên đó trong trường gửi hộ của API đơn từ. Người được gửi hộ thành người thụ hưởng và xem, thao tác trên đơn như đơn của chính mình.
Điều kiện để có hiệu lực
Phải bật Đơn từ nội bộ.
Khi BẬT
Lệnh gọi API tạo đơn hộ nhân viên khác được chấp nhận.
Khi TẮT
(Mặc định) Tạo đơn có nhân viên gửi hộ bị từ chối với lỗi Tính năng đang tắt. Đơn cho chính mình không bị ảnh hưởng.
Màn hình, chứng từ, báo cáo bị ảnh hưởng
API đơn từ (tạo), quyền xem đơn của người được gửi hộ.
Lưu ý
Form tạo đơn trên web và mobile chưa có ô gửi hộ, nên công tắc này chỉ có tác dụng với tích hợp gọi API. Chỉ kiểm lúc tạo: đơn đã gửi hộ trước đó vẫn hiện với người được gửi hộ sau khi tắt.
Đơn từ nội bộ
Biểu mẫu đơn từ và đề xuất nội bộ (nghỉ phép, hỗ trợ IT, tạm ứng, giấy xác nhận…).
| Mã | Mặc định | Bật tại | Cần bật trước |
|---|---|---|---|
requests.employee_requests | Tắt | /approvals/settings | — |
Cách hoạt động
Bật module Đơn từ nhân viên: loại đơn, biểu mẫu, định tuyến duyệt, thực hiện và báo cáo.
Khi BẬT
Trang đơn từ hiện trong My HR và Phê duyệt trên web; nhân viên tạo và gửi đơn; quản trị quản lý loại đơn; nhắc SLA chạy.
Khi TẮT
Menu và trang trên web bị ẩn; API đơn từ từ chối với lỗi Tính năng đang tắt (tạo, danh sách, chi tiết, tiến độ duyệt, quyết định, loại đơn, bình luận, đính kèm, thực hiện, báo cáo), công cụ AI/MCP liệt kê đơn cũng vậy. Nhắc SLA dừng.
Màn hình, chứng từ, báo cáo bị ảnh hưởng
My HR → Đơn từ, Phê duyệt → Đơn từ, Loại đơn, báo cáo đơn từ, đơn từ trên mobile, công cụ AI liệt kê đơn từ.
Lưu ý
Phải tắt trước Giai đoạn thực hiện, Duyệt một phần, Trả lại bổ sung và Hiện tên người xử lý (mặc định bật) — máy chủ từ chối tắt khi còn công tắc phụ thuộc đang bật. Đơn hiện có giữ nguyên. Hồ sơ đang mở trong hộp duyệt vẫn duyệt/từ chối được để không bỏ dở quyết định, đơn đã hoàn tất vẫn tự đóng. Trên mobile menu vẫn hiện rồi báo Tính năng đang tắt. Tenant hiện có đã được migration bật; tenant mới bật sẵn. Khi tắt, người gửi vẫn rút được đơn, đơn hiện có vẫn quyết được, thực hiện được (kể cả chi tạm ứng/ứng lương), xác nhận đã nhận và thử lại ghi ngược khi lỗi — chỉ tạo đơn mới bị chặn.
Giai đoạn thực hiện
Sau khi duyệt, bộ phận xử lý đánh dấu đã làm xong và có thể gắn chứng từ đã tạo.
| Mã | Mặc định | Bật tại | Cần bật trước |
|---|---|---|---|
requests.fulfillment_stage | Tắt | /approvals/settings | Đơn từ nội bộ (requests.employee_requests) |
Cách hoạt động
Với loại đơn đánh dấu “cần thực hiện”, đơn đã duyệt chờ bộ phận xử lý đánh dấu đã làm xong (có thể gắn chứng từ đã tạo) rồi mới sang Hoàn tất. Không tự sinh chứng từ.
Điều kiện để có hiệu lực
Phải bật Đơn từ nội bộ.
Khi BẬT
Đơn đã duyệt của loại đó nằm ở Đã duyệt (chờ thực hiện); người xử lý thấy nút Thực hiện trên đơn trong Phê duyệt.
Khi TẮT
Duyệt xong đơn sang thẳng Hoàn tất. Chi dòng tạm ứng lương không cần công tắc này.
Màn hình, chứng từ, báo cáo bị ảnh hưởng
Phê duyệt → chi tiết đơn (Thực hiện), trạng thái đơn sau duyệt, đồng hồ tự đóng.
Lưu ý
Đơn thuộc loại “cần thực hiện” đang Đã duyệt chờ thực hiện lúc tắt vẫn thực hiện nốt được, nên không đơn nào bị kẹt. Tenant mới bật sẵn; tenant hiện có đã được migration bật. Ứng lương đã duyệt luôn chi được, bất kể loại đơn.
Hiện tên người xử lý
Hiển thị ai đang xử lý đơn. Khi tắt, chỉ hiện vai trò (ví dụ “Quản lý trực tiếp”) — tên bị chặn ở máy chủ, không phải chỉ ẩn trên giao diện.
| Mã | Mặc định | Bật tại | Cần bật trước |
|---|---|---|---|
requests.show_approver_names | Bật | /approvals/settings | Đơn từ nội bộ (requests.employee_requests) |
Cách hoạt động
Quyết định tiến độ duyệt của đơn có hiện tên người đang xử lý hay không. Khi tắt, máy chủ không trả tên nên tên cũng không có trong dữ liệu trả về.
Điều kiện để có hiệu lực
Phải bật Đơn từ nội bộ.
Khi BẬT
(Mặc định) Tiến độ và dòng thời gian duyệt hiện tên những người bước hiện tại đang chờ.
Khi TẮT
Bước đang chờ chỉ hiện vai trò (ví dụ “Quản lý trực tiếp”) và số người duyệt. Không đọc được cấu hình thì cũng ẩn tên.
Màn hình, chứng từ, báo cáo bị ảnh hưởng
Tiến độ duyệt đơn trên web và mobile, tóm tắt trong danh sách đơn, dòng thời gian duyệt của đơn từ.
Lưu ý
Chỉ ẩn người ĐANG chờ: người đã duyệt/từ chối và người gửi vẫn hiện làm dấu vết kiểm toán. Người theo dõi đơn, danh sách uỷ quyền và các trợ lý AI giám sát cho quản trị vẫn hiện tên. Vì mặc định bật, phải tắt công tắc này trước khi tắt được Đơn từ nội bộ.
Phê duyệt một phần
Người duyệt được chốt số ít hơn số đề nghị. Chỉ áp dụng cho loại đơn đã khai đại lượng quyết định.
| Mã | Mặc định | Bật tại | Cần bật trước |
|---|---|---|---|
requests.partial_approval | Tắt | /approvals/settings | Đơn từ nội bộ (requests.employee_requests) |
Cách hoạt động
Với loại đơn khai quyết định một phần và trường đại lượng, người duyệt được chốt số ít hơn số đề nghị. Số được duyệt lưu trên đơn và trạng thái thành Duyệt một phần.
Điều kiện để có hiệu lực
Phải bật Đơn từ nội bộ, và loại đơn phải khai quyết định một phần cùng trường đại lượng (cài đặt Loại đơn).
Khi BẬT
Ô số lượng duyệt hiện khi quyết định đơn loại đó, ở Phê duyệt và hộp duyệt. Số phải lớn hơn 0 và không vượt số đề nghị.
Khi TẮT
(Mặc định) Người duyệt chỉ duyệt trọn số hoặc từ chối; gửi số nhỏ hơn bị từ chối với lỗi Tính năng đang tắt.
Màn hình, chứng từ, báo cáo bị ảnh hưởng
Quyết định đơn (Phê duyệt → chi tiết đơn, hộp duyệt), trạng thái đơn, số được duyệt trong báo cáo.
Lưu ý
Tắt không đổi các đơn đã duyệt một phần. Nếu người duyệt đã nhập số nhỏ hơn ở một bước workflow rồi bạn tắt công tắc trước bước cuối, số đã ghi vẫn được áp khi workflow kết thúc. Loại đơn không khai quyết định một phần thì không bao giờ cho, bất kể công tắc.
Trả lại bổ sung
Người duyệt trả đơn về người gửi để bổ sung thông tin, thay vì phải từ chối thẳng.
| Mã | Mặc định | Bật tại | Cần bật trước |
|---|---|---|---|
requests.return_for_revision | Tắt | /approvals/settings | Đơn từ nội bộ (requests.employee_requests) |
Cách hoạt động
Cho người duyệt trả đơn về người gửi để bổ sung thông tin thay vì từ chối. Đơn chuyển sang Chờ bổ sung và người gửi nhận thông báo kèm ghi chú của người duyệt.
Điều kiện để có hiệu lực
Phải bật Đơn từ nội bộ.
Khi BẬT
Nút Trả lại bổ sung hiện trên đơn đang chờ duyệt ở Phê duyệt và hộp duyệt (bắt buộc ghi chú). Người gửi sửa rồi gửi lại; việc duyệt bắt đầu lại.
Khi TẮT
(Mặc định) Nút bị ẩn và máy chủ từ chối với lỗi Tính năng đang tắt, ở cả Phê duyệt lẫn hộp duyệt.
Màn hình, chứng từ, báo cáo bị ảnh hưởng
Phê duyệt → chi tiết đơn, hộp duyệt, chi tiết đơn ở My HR (sửa và gửi lại), thông báo.
Lưu ý
Đơn đang ở Chờ bổ sung lúc tắt vẫn được người gửi sửa, gửi lại hoặc rút, nên không đơn nào bị kẹt. Thời gian nằm ở Chờ bổ sung không tính là quá hạn.
Tự đóng đơn đã hoàn tất sau (ngày)
Đơn đã hoàn tất tự đóng nếu người đề nghị không xác nhận đã nhận trong số ngày này. 0 = không tự đóng. Áp dụng cho đơn hoàn tất sau khi đổi cấu hình.
| Mã | Mặc định | Bật tại | Cần bật trước |
|---|---|---|---|
requests.auto_close_days | 7 | /approvals/settings | Đơn từ nội bộ (requests.employee_requests) |
Cách hoạt động
Khi đơn sang Hoàn tất, hệ thống đóng dấu ngày đóng sau số ngày này. Một job chạy mỗi giờ đóng các đơn hoàn tất đã quá ngày đó mà người đề nghị chưa xác nhận đã nhận. 0 = không tự đóng. Mặc định 7, tối đa 365.
Điều kiện để có hiệu lực
Phải bật Đơn từ nội bộ.
Khi BẬT
(Số ngày > 0) Đơn hoàn tất không được xác nhận kịp sẽ sang Đã đóng (tự đóng). Xác nhận đã nhận xoá đồng hồ; đơn có ticket helpdesk liên kết đã mở lại thì không bị đóng.
Khi TẮT
(0) Đơn hoàn tất mới không có ngày đóng và nằm ở Hoàn tất tới khi người đề nghị xác nhận.
Màn hình, chứng từ, báo cáo bị ảnh hưởng
Trạng thái đơn sau khi hoàn tất, danh sách đơn ở My HR và Phê duyệt.
Lưu ý
Ngày đóng được đóng dấu lúc đơn hoàn tất, nên đổi số chỉ ảnh hưởng đơn hoàn tất sau đó; đơn hoàn tất trước khi có tính năng không bao giờ tự đóng. Job vẫn đóng các đơn đã đóng dấu kể cả khi tắt Đơn từ nội bộ.