Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

      STT

Thông tin dữ liệu

Mô tả

Ghi chú

1

Mã nhân viên

Mã duy nhất cho từng nhân viên

Mã NV Hris 6 chữ số

2

Tên nhân viên

Lấy thông tin Tên nhân viên (Cột Name) HRIS trả về

Full name trên HRIS

3

Email

Dùng để đăng nhập vào và nhận thông báo từ hệ thống

Email

4

Công việc chính/phụ

Thể hiện công việc tại 1 công ty là chính hay phụ (kiêm nhiệm/điều động)

Trên HRIS: P - Chính, S - Phụ (Bổ sung)

5

Mã chức danh

Mã chức danh để xác định vai trò của nhân viên trong cơ cấu tổ chức

Mã chức danh HRIS

6

Chức danh

Dùng để xác định vai trò trong quy trình và phân quyền theo chức danh/ vai trò

Chức danh HRIS

7

Phòng/ ban

Dùng để phân quyền và điều hướng luồng trong quy trình

Tên phòng ban mà CBNV đó đang đứng

8

Mã phòng/ban

Mã phòng ban

Mã phòng ban tương ứng

9

Đơn vị cấp 1

Dùng để phân quyền và điều hướng luồng trong quy trình

Tên đơn vị cấp 1

10

Mã Đơn vị cấp 1


Mã đơn vị cấp 1

11

Đơn vị cấp 2

Dùng để phân quyền và điều hướng luồng trong quy trình

Tên đơn vị cấp 2

12

Mã Đơn vị cấp 2


Mã đơn vị cấp 2

13

Đơn vị cấp 3

Dùng để phân quyền và điều hướng luồng trong quy trình

Tên đơn vị cấp 3

14

Mã Đơn vị cấp 3


Mã đơn vị cấp 3

15

Đơn vị cấp 4

Dùng để phân quyền và điều hướng luồng trong quy trình

Tên đơn vị cấp 4

16

Mã Đơn vị cấp 4


Mã đơn vị cấp 4

17

Đơn vị cấp 5

Dùng để phân quyền và điều hướng luồng trong quy trình

Tên đơn vị cấp 5

18

Mã Đơn vị cấp 5


Mã đơn vị cấp 5

19

Trạng thái nhân sự

Để xác định trạng thái hoạt động của nhân sự/ account trên hệ thống

Trạng thái Đang làm việc, nghỉ việc của nhân sự

20

Ca làm việc

Lấy mã ca làm việc

Lấy thông tin mã ca tại HRIS và cấu hình thông tin thời gian làm việc trực tiếp tại BPM theo thông tin trả về tại file excel của HRIS ( Đã thống nhất lại giữa PO vs anh Dung vì tần suất thay đổi thời gian ca làm việc không nhiều nên BPM chủ động khai báo)

Trường hợp với nhân viên có các công việc phụ, thông tin mã ca làm việc được lấy theo công việc chínhactive ( Với trường hợp một nhân viên có nhiều công việc chính thì lấy ngẫu nhiên theo một công việc chính của nhân viên đó)

3. Conversation (Mô tả chi tiết)

3.1. UI/UX

...

Image RemovedImage RemovedImage Removed

3.2. Luồng:

...

Image Removed

3.3. API Spec: BPM1_Giai phap tich hop HRIS.docx

...

titleAPI đồng bộ Hris - service Integration gọi Hris

...

Method

...

URL

...

Description

...

API lấy thông tin nhân viên từ Hris

...

Note

...

API mới

3.3.3.1. Headers

...

STT

...

Field

...

Source Data Type / Length 

...

Description

...

Sample Values

...

3.3.3.2. RequestParam

...

STT

...

Field

...

Require

...

Data Type / Length

...

Description

...

Note

...

Sample Values

...

3.1.1. Màn hình Tích hợp HRIS

Image Added

3.1.2. Màn hình pop-up Bộ lọc

Image Added

3.1.3. Màn hình pop-up Cấu hình tích hợp HRIS

Image Added

Image Added        Image Added 

3.1.4. Màn hình pop-up Xác nhận đồng bộ dữ liệu

Image Added

3.1.6. Màn hình pop-up Cảnh báo

Image Added

3.1.6. Màn hình pop-up Đồng bộ thất bại

Image Added

3.2. Luồng:

tảđồtíchhợpgiữacácthànhphầncủahệthống BPM1, trong đó 2 hìnhchữnhậtmàuxanhtíchhợpmới cho hệthống HRIS với service tíchhợpcủahệthống BPM1

Image Added

3.3. API Spec: BPM1_Giai phap tich hop HRIS.docx

Panel
titleAPI đồng bộ Hris - service Integration gọi Hris

Method

POST

URL

/integration/hris/sync

Description

API lấy thông tin nhân viên từ Hris

Note

API mới

3.3.3.
3. Response / Incoming Data Specification
1. Headers

STT

Field

Source Data Type /

Length

Length 

Description

Note

Method

POST

URL

/integration/hris/sync

Description

API lấy thông tin nhân viên từ Hris

Note

API mới

Sample Values

1
codeInteger0: thành công còn lại thất bại2messageStringmessage3resultStringThông tin đồng bộ
Panel
titleAPI đồng bộ Hris - service Integration đẩy dữ liệu system
authorization<token>Token của người dùng đăng nhậpBearer eyJhbGciOiJIUzI1NiJ9.eyJleHAiOjE3NjY0NTU3ODksInVzZXIiOiJ7XCJpZFwiOjIwMjAsXCJ1c2VybmFtZVwiOlwiMDM3NDc4ODQwNVwiLFwibmFtZVwiOlwiQ2h1IFRo4buLIExpw6puXCIsXCJyb2xlc1wiOltdLFwibWFwQmVhdXR5U2Fsb25cIjp7XCJicG0ucmVib3JuLnZuXCI6Nn0sXCJlbXBsb3llZUlkXCI6NTMxLFwiYnJhbmNoSWRcIjoyM30ifQ.wrvIFd-Q2kHgkTmPf6ryMY6aDIgXpNsWmSvvifQWc5k
3.3.3.2. RequestParam

STT

Field

Require

Data Type / Length

Description

Note

Sample Values

1fromtrueStringngày hiện tại
định dạng (2025-12-06)
3.3.3.
1. Headers
3. Response / Incoming Data Specification
STT

Field

Source

Data Type /

Length 

Length

Description

Note

Sample Values

1
authorization
code
<token>Token của người dùng đăng nhậpBearer eyJhbGciOiJIUzI1NiJ9.eyJleHAiOjE3NjY0NTU3ODksInVzZXIiOiJ7XCJpZFwiOjIwMjAsXCJ1c2VybmFtZVwiOlwiMDM3NDc4ODQwNVwiLFwibmFtZVwiOlwiQ2h1IFRo4buLIExpw6puXCIsXCJyb2xlc1wiOltdLFwibWFwQmVhdXR5U2Fsb25cIjp7XCJicG0ucmVib3JuLnZuXCI6Nn0sXCJlbXBsb3llZUlkXCI6NTMxLFwiYnJhbmNoSWRcIjoyM30ifQ.wrvIFd-Q2kHgkTmPf6ryMY6aDIgXpNsWmSvvifQWc5k
3.3.3.2. RequestBody

STT

Field

Require

Data Type / Length

Description

Note

Sample Values

1List<Employee>trueStringdanh sách các bản ghi employee2(Employee) IDfa;seString3(Employee) ID_RCDtrueStringid record Hris4(Employee) EMPLIDtrueStringid employee hris5(Employee) EMPL_RCDtrueString6(Employee) NAMEtrueStringtên nhân viên7(Employee) EMAILtrueStringmail nhân viên8(Employee) JOB_INDICATORtrueStringCông việc chính/ phụ 
có 2 giá trị: P (chính), S (phụ)
9(Employee) MA_CHUC_DANHtrueStringmã chức danh10(Employee) CHUC_DANHtrueStringtên chức danh11(Employee) PHONG_BANtrueStringtên phòng ban12(Employee) MA_PHONG_BANtrueStringmã phòng ban13(Employee) BANDtrueString14(Employee) HAM trueString15(Employee) DV_C1trueStringtên đơn vị cấp 1 (tên công ty)16(Employee) MA_DV_C1trueStringmã đơn vị cấp 1 (mã công ty)17(Employee) MA_DV_C2trueStringtên đơn vị cấp 218(Employee) DV_C2trueStringmã đơn vị cấp 219(Employee) MA_DV_C3trueStringtên đơn vị cấp 320(Employee) DV_C3trueStringmã đơn vị cấp 321(Employee) DV_C4
Integer0: thành công còn lại thất bại

2messageStringmessage

3resultStringThông tin đồng bộ

Panel
titleAPI đồng bộ Hris - service Integration đẩy dữ liệu system

Method

POST

URL

/integration/hris/sync

Description

API lấy thông tin nhân viên từ Hris

Note

API mới

3.3.3.1. Headers

STT

Field

Source Data Type / Length 

Description

Sample Values

1authorization<token>Token của người dùng đăng nhậpBearer eyJhbGciOiJIUzI1NiJ9.eyJleHAiOjE3NjY0NTU3ODksInVzZXIiOiJ7XCJpZFwiOjIwMjAsXCJ1c2VybmFtZVwiOlwiMDM3NDc4ODQwNVwiLFwibmFtZVwiOlwiQ2h1IFRo4buLIExpw6puXCIsXCJyb2xlc1wiOltdLFwibWFwQmVhdXR5U2Fsb25cIjp7XCJicG0ucmVib3JuLnZuXCI6Nn0sXCJlbXBsb3llZUlkXCI6NTMxLFwiYnJhbmNoSWRcIjoyM30ifQ.wrvIFd-Q2kHgkTmPf6ryMY6aDIgXpNsWmSvvifQWc5k
3.3.3.2. RequestBody

STT

Field

Require

Data Type / Length

Description

Note

Sample Values

1List<Employee>trueStringdanh sách các bản ghi employee

2(Employee) IDfa;seString


3(Employee) ID_RCDtrueStringid record Hris

4(Employee) EMPLIDtrueStringid employee hris

5(Employee) EMPL_RCDtrueString


6(Employee) NAMEtrueStringtên nhân viên

7(Employee) EMAILtrueStringmail nhân viên

8(Employee) JOB_INDICATORtrueStringCông việc chính/ phụ 
có 2 giá trị: P (chính), S (phụ)


9(Employee) MA_CHUC_DANHtrueStringmã chức danh

10(Employee) CHUC_DANHtrueStringtên chức danh

11(Employee) PHONG_BANtrueStringtên phòng ban

12(Employee) MA_PHONG_BANtrueStringmã phòng ban

13(Employee) BANDtrueString


14(Employee) HAM trueString


15(Employee) DV_C1trueStringtên đơn vị cấp 4221 (tên công ty)

16(Employee) MA_DV_C4C1trueStringmã đơn vị cấp 4231 (mã công ty)

17(Employee) MA_DV_C5C2trueStringtên đơn vị cấp 2

18(Employee) DV_C2trueStringđơn vị cấp 52

2419(Employee) MA_DV_C5C3trueStringtên đơn vị cấp 53

2520(Employee) HRDV_STATUSC3trueString
Trạng thái nhân sự: A (active), I (inactive)
26mã đơn vị cấp 3

21(Employee) DV_C4trueStringtên đơn vị cấp 4

22(Employee) MA_CADV_LVC4trueStringca làm việc
3.3.3.3. Response / Incoming Data Specification
STT

Field

Data Type / Length

Description

Note

Sample Values

1codeInteger0: thành công còn lại thất bại2messageStringmessage

3.4. Mô tả HRIS API:

HRIS cung cấp API trả về danh sách toàn bộ nhân sự theo ngày. 

  • Nhân sự mới onboard 
  • Nhân sự thay đổi vị trí công việc. 
  • Nhân sự nghỉ việc 

Các trường dữ liệu được mô tả chi tiết theo tài liệu mô tả API. 

- Cập nhật dữ liệu 

Luồng cập nhật dữ liệu thông qua các bước sau: 

  • Tạo bảng Employee trên database Integration đóng vai trò lưu trữ dữ liệu lấy về từ HRIS theo ngày. 
  • Bảng integrations.employee được sử dụng làm nơi lưu trữ tạm thời dữ liệu nhân sự mới lấy về từ hệ thống HRIS. 
  • Dữ liệu được lấy theo từng đợt (theo ngày hoặc batch cụ thể). 
  • Mục tiêu: so sánh với dữ liệu hiện có trong hệ thống để xác định cần thêm mới hay cập nhật. 
  • Từ dữ liệu mới từ HRIS, sánh với dữ bảng dữ liệu đã có trong employee thuộc service system. 
  • Trường hợp bảng ghi mới: 
  • Có employee_id chưa tồn tại thì thêm mới vào bảng employee (thuộc service system) 
  • Trường hợp employee đã tồn tại employee_id và vị trí công việc trong bảng integration.employee đã tồn tại trong system.employee thì: 

...

đơn vị cấp 4

23(Employee) DV_C5trueStringtên đơn vị cấp 5

24(Employee) MA_DV_C5trueStringmã đơn vị cấp 5

25(Employee) HR_STATUStrueString
Trạng thái nhân sự: A (active), I (inactive)


26(Employee) MA_CA_LVtrueStringmã ca làm việc

3.3.3.3. Response / Incoming Data Specification
STT

Field

Data Type / Length

Description

Note

Sample Values

1codeInteger0: thành công còn lại thất bại

2messageStringmessage

Phần cấu hình đồng bộ và danh sách lích sử đồng bộ tương tự như phần SAP:  4304 - User Story- SAP về BPM- Đồng bộ thông tin dự án tương thị như phần đồng bộ dự án như thay type = HRIS_EMPLOYEE

3.4. Mô tả HRIS API:

HRIS cung cấp API trả về danh sách toàn bộ nhân sự theo ngày. 

  • Nhân sự mới onboard 
  • Nhân sự thay đổi vị trí công việc. 
  • Nhân sự nghỉ việc 

Các trường dữ liệu được mô tả chi tiết theo tài liệu mô tả API. 

- Cập nhật dữ liệu 

Luồng cập nhật dữ liệu thông qua các bước sau: 

  • Tạo bảng Employee trên database Integration đóng vai trò lưu trữ dữ liệu lấy về từ HRIS theo ngày. 
  • Bảng integrations.employee được sử dụng làm nơi lưu trữ tạm thời dữ liệu nhân sự mới lấy về từ hệ thống HRIS. 
  • Dữ liệu được lấy theo từng đợt (theo ngày hoặc batch cụ thể). 
  • Mục tiêu: so sánh với dữ liệu hiện có trong hệ thống để xác định cần thêm mới hay cập nhật. 
  • Từ dữ liệu mới từ HRIS, sánh với dữ bảng dữ liệu đã có trong employee thuộc service system. 
  • Trường hợp bảng ghi mới: 
  • Có employee_id chưa tồn tại thì thêm mới vào bảng employee (thuộc service system) 
  • Trường hợp employee đã tồn tại employee_id và vị trí công việc trong bảng integration.employee đã tồn tại trong system.employee thì: 
  • Tiến hành cập nhật thông tin đã thay đổi (so sánh giá trị từng trường). 

...

3.5. Mô tả các trường dữ liệu trên màn hình:

3.5.1. Màn hình danh sách

...

Tích hợp

...

HRIS

Trường dữ liệu

Kiểu dữ liệu

Bắt buộc

Quy định

Mô tả

1

STT

Số (Number)Không bắt buộc
-
  • Không cho phép người dùng thao tác tương tác (nhấn/chọn/sửa).
-
  • Hệ thống tự động gán STT theo thời gian đồng bộ gần nhất: 
    • Giao dịch đồng bộ gần nhận STT nhỏ hơn
    • Giao dịch đồng bộ gần xa hơn nhận STT lớn hơn.

Thể hiện thứ tự các bản ghi lịch sử đồng bộ trên màn hình "Tích hợp

Hris

HRIS"

2Thời gian bắt đầuThời gian (date-time)Không bắt buộc
-
  • Không cho phép người dùng thao tác tương tác (nhấn/chọn/sửa).
-
  • Nguồn dữ liệu: Lấy theo dữ liệu khi hệ thống bắt đầu việc đồng bộ thông tin

Thể hiện thời gian bắt đầu đồng bộ thông tin từ

Hris

HRIS

3Thời gian kết thúcThời gian (date-time)Không bắt buộc
-
  • Không cho phép người dùng thao tác tương tác (nhấn/chọn/sửa).
-
  • Nguồn dữ liệu: Lấy theo dữ liệu khi hệ thống bắt đầu việc đồng bộ thông tin

Thể hiện thời gian kết thúc đồng bộ thông tin từ

Hris

HRIS

4Người đồng bộVăn bản (Text)Không bắt buộc
-
  • Không cho phép người dùng thao tác tương tác (nhấn/chọn/sửa).
-
  • Quy tắc hiển thị:
    • Trường hợp 1: Hệ thống tự đồng bộ
      • Hiển thị giá trị trường: "Hệ thống”.
    • Trường hợp 2: Người dùng thao tác đồng bộ
      • Hiển thị giá trị trường là
họ
      • Mã - Họ tên của nhân sự thao tác đồng bộ tương ứng, lấy
từ Danh sách nhân viên
      • theo dữ liệu đồng bộ từ HRIS trả về.

Thể hiện tên người thực hiện đồng bộ dữ liệu (Hệ thống hoặc tên nhân viên tương ứng)

5Trạng tháiVăn bản (Text)Không bắt buộc
-
  • Không cho phép người dùng thao tác tương tác (nhấn/chọn/sửa).
-
  • Giá trị trạng thái gồm 3 giá trị và ý nghĩa như sau:
    • Thành công: Quá trình đồng bộ thông tin đã hoàn tất và không phát sinh lỗi.

    • Thất bại: Quá trình đồng bộ không thành công/xảy ra lỗi.

-
    • Quy tắc hiển thị:

      Trường hợp 1: Lỗi đồng bộ quy định mã giữa hai hệ thống

      • Điều kiện:
        • Lỗi đồng bộ giữa hai môi trường.
      • Hành vi hệ thống:
        • Hiển thị trạng thái Thất bại 
        • Trả về thông tin lỗi tương ứng (chưa có thông tin)

      Trường hợp 2: Lỗi đồng bộ do hệ thống đang xử lý tiến trình khác (đồng bộ tự động xảy ra trong lúc với hệ thống đang thực hiện đồng bộ thủ công)

      • Điều kiện:
        • Hệ thống đang xử lý một tiến trình đồng bộ/tác vụ liên quan khác tại cùng thời điểm
      • Hành vi hệ thống:
        • Không thực hiện tiến trình đồng bộ mới
Hiển thị trạng
        • Trạng thái: "Thất bại
Trả về thông tin lỗi chi tiết
        • "
        • Mã lỗi: "153"
        • Mô tả lỗi: "Đồng bộ tự động không thể thực hiện do hệ thống đang xử lý đồng bộ thủ công."
    • Đang thực hiện: Quá trình đồng bộ thông tin đang tiến hành và chưa có kết quả cuối cùng. 

Thể hiển trạng thái đồng bộ thông tin từ

Hris

HRIS

6Mã lỗiĐường dẫn (Hyperlink)Không bắt buộc
  • Cho phép người dùng nhấn để mở ra màn hình pop-up "
Xem chi tiết lỗi
  • Đồng bộ thất bại".
    • Màn hình pop-up "
Xem chi tiết lỗi
    • Đồng bộ thất bại": tham chiếu mục 3.5.6. Màn hình pop-up "
Xem chi tiết lỗi
    • Đồng bộ thất bại".
  • Thể hiện mã lỗi
hệ thống quy định
  • "99" trả về với trạng thái thất bại

Thể hiện mã lỗi hệ thống trả về khi đồng bộ thất bại

7

Nút

lọc

"Lọc"

Nút chức năng (Button)Không bắt buộc

Cho phép người dùng nhấn để mở ra màn hình pop-up "Bộ lọc"

    • Màn hình pop-up "Bộ lọc": tham chiếu mục 3.5.2. Màn hình pop-up "Bộ lọc".

Thể hiện nút chức năng bộ lọc

8Nút
cấu
"Cấu hình"Nút chức năng (Button)Không bắt buộc

Cho phép người dùng nhấn để mở ra màn hình pop-up "Cấu hình tích hợp HRIS"

    • Màn hình pop-up "Cấu hình tích hợp HRIS": tham chiếu mục 3.5.
6
    • 3. Màn hình pop-up "
Xem chi tiết lỗi".
  • chọn cấu hình tần suất đồng bộ thông tin. Khi nhấn mở ra màn hình chi tiết 3.5.3
  • Mở màn hình
      • Cấu hình tích hợp HRIS".

    Thể hiện nút chức năng cấu hình tích hợp/cấu hình lịch đồng bộ

    9Nút
    đồng
    "Đồng bộ ngay"Nút chức năng (Button)Không bắt buộc

    Cho phép người dùng nhấn

    khi muốn

    để mở ra màn hình pop-up "Xác nhận đồng bộ

    dự liệu ngay lập tức. Khi nhấn sẽ xuất hiện

    dữ liệu"

      • Màn hình pop-up
    xác nhận. Chi tiết
      • "Xác nhận đồng bộ dữ liệu": tham chiếu mục 3.5.4
    Khi người dùng nhấn nút "
      • . Màn hình pop-up "Xác nhận đồng bộ dữ liệu"
    trong lúc với hệ thống đang thực hiện đồng bộ song song tiến trình khác (Thao tác của người dùng xảy ra trước hệ thống tự động hoặc đang thực hiện đồng bộ thủ công tiếp tục nhấn thủ công nữa) Khi nhấn sẽ xuất hiện pop-up cảnh báo. Chi tiết 3.5.5Thể hiện
      • .

    Thể hiện nút chức năng đồng bộ dữ liệu ngay lập tức theo thời gian hiện tại

    3.5.2. Màn hình pop-up "Bộ lọc" 

    Trường dữ liệu

    Kiểu dữ liệu

    Bắt buộc

    Quy định

    Mô tả

    1Khoảng thời gianNgày tháng năm (
    date
    Date picker)Không bắt buộc

    Cho phép người dùng chọn khoảng thời gian từ ngày đến ngày đồng bộ

    khoản mục phí
  • Trường hợp 1: Hệ thống tự đồng bộ thông tin người đồng bộ là hệ thống
  • Trường hợp 2:

    Thể hiện thời gian lọc từ ngày đến ngày 
    2

    Người đồng bộ

    Lựa chọn (Droplist)Không bắt buộc

    Hệ thống lấy ra từ list danh sách

    • Cho phép người dùng chọn người thực hiện đồng bộ
    • Danh sách dữ liệu hiển thị được lấy:
      • "Hệ thống"
      • Người dùng thao tác đồng bộ,
      cho phép lấy Thể
      • thông tin
    trong mục danh sách nhân viên (Cài đặt cơ sở/Danh sách nhân viên)
      • Mã - Họ tên của nhân sự theo dữ liệu đồng bộ từ HRIS trả về.

    Thể hiện người thực hiện đồng bộ thông tin

    khoản mục phí

    từ HRIS

    3

    Trạng thái

    Lựa chọn (Droplist)Không bắt buộc

    Cho phép người dùng chọn giá trị trạng thái tương ứng:

    +
      • Thành công
    +
      • Thất bại
    +
      • Đang thực hiện
    +
      • Tất cả (Khi người dùng không chọn sẽ để mặc định)

    Thể hiện trạng thái đồng bộ

    khoản mục phí

    thông tin từ HRIS

    4

    Mã lỗi

    Văn bản (Text)Không bắt buộc

    Cho phép người dùng nhập mã lỗi đồng bộ thông tin không thành công

    Thể hiện thông tin mã lỗi khi đồng bộ thông tin từ HRIS

    5Nút "X" Nút chức năng (Button)Không bắt buộc
    • Cho phép người dùng nhấn để hủy bỏ thao tác lọc.
    • Khi nhấn, màn hình pop-up "Bộ lọc" đóng lại. 
    Thể hiện nút
    "X" để
    chức năng hủy bỏ thao tác lọc.
    6Nút "Đặt lại"Nút chức năng (Button)Không bắt buộc
    • Cho phép người dùng nhấn để đặt lại tất cả tiêu chí lọc về trạng thái mặc định ban đầu.
    -
    • Hành vi hệ thống khi người dùng nhấn nút "Đặt lại" như sau: 
      • Hành vi 1: Toàn bộ các trường trên màn hình pop-up "Bộ lọc" sẽ được chuyển về giá trị mặc định ban đầu.
      • Hành vi 2: Màn hình pop-up "Bộ lọc" vẫn được giữ trạng thái mở để người dùng có thể tiếp tục thao tác.
    Thể hiện nút chức năng đặt lại tất cả tiêu chí lọc về trạng thái mặc định ban đầu.
    7Nút "Áp dụng"Nút chức năng (Button)Không bắt buộc
    -
    • Cho phép người dùng nhấn để áp dụng những tiêu chí lọc đã chọn.
    -
    • Hành vi hiển thị kết quả hệ thống khi người dùng nhấn nút "Áp dụng" như sau: 
      • Trường hợp 1: Không chọn bất kỳ tiêu chí lọc nào:
        • Hệ thống vẫn cho phép người dùng nhấn nút “Áp dụng”.
        • Sau khi nhấn, hệ thống đóng pop-up nhưng không thực hiện lọc.
        • Màn hình "Tích hợp
    thông tin khoản mục phí
        • HRIS" vẫn giữ nguyên dữ liệu như trước khi thao tác
    .Không hiển thị bất kỳ thông báo lỗi hay cảnh báo nào
        • .
      • Trường hợp 2: Chọn một hoặc nhiều tiêu chí lọc:
        • Hệ thống vẫn cho phép người dùng nhấn nút “Áp dụng”.
        • Sau khi nhấn, hệ thống đóng pop-up và thực hiện lọc theo toàn bộ các tiêu chí mà người dùng đã chọn.
        • Màn hình "Tích hợp
    thông tin khoản mục phí
        • HRIS" được cập nhật và hiển thị theo đúng những tiêu chí người dùng
    chọn
        • đã chọn. 
    Thể hiện nút chức năng áp dụng tiêu chí lọc được chọn
    3.5.3. Màn hình pop-up "Cấu hình tích hợp HRIS"
    Nút

    Trường dữ liệu

    Kiểu dữ liệu

    Bắt buộc

    Quy định

    Mô tả

    1
    Tiêu đề màn hìnhNhãn hiệu (Label)Hiển thị tiêu đề " Tích hợp thông tin danh mục khoản mục phí (SAP)"2Nút đóng (X)
    Nút đóng (X)/ Nút "Hủy"Nút chức năng (Button)
    • Cho phép người dùng nhấn để hủy bỏ thao tác
    lọc
    • cấu hình tích hợp.
    • Khi nhấn, màn hình pop-up "
    Bộ lọc3
    • Cấu hình tích hợp HRIS" đóng lại. 
    Đóng màn hình cấu hình, không lưu thay đổi
    Thể hiện nút chức năng hủy bỏ thao tác cấu hình
    2Tần suấtNhãn hiệu (Label)

    Chỉ được chọn 1 trong 2 giá trị tần suất đồng bộ thông tin

    khoản mục phí hàng ngày/hàng tuần

    từ HRIS:

      • Hàng ngày
      • Tùy chọn
    Thể hiện tần suất người dùng chọn đồng bộ
    dữ liệu khoản mục phí4
    thông tin từ HRIS
    3Hàng ngàyNút chọn (Radio Option)
    Khi chọn nút "Hàng ngày" nút "Hàng tuần" sẽ bị ẩn

    Khi chọn Nút "Hàng ngày", hệ thống sẽ hiện hộp thời gian chọn thời điểm thực hiện đồng bộ thông tin khoản mục phí, theo kiểu thời gian time picker định dạng HH:mm (24h).

      • Hệ thống mặc định để thời gian là 00:00
    Thể hiện thời gian đồng bộ
    dữ liệu khoản mục phí
    thông tin từ HRIS được chọn trong ngày
    5
    4
    Hàng tuần
    Tùy chọnNút chọn (Radio Option)

    Khi chọn nút "

    Hàng tuần" nút "Hàng ngày" sẽ bị ẩnKhi chọn nút "Hàng tuần"

    Tùy chọn", hệ thống sẽ hiện

    các

    :

      • Các checkbox group thời gian từ thứ 2 đến chủ nhật
    .
      • : Người dùng có thể chọn thời gian
    thực
      • ngày thực hiện đồng bộ thông tin. Khi chọn nút "
    Hàng tuần
      • Tùy chọn" hệ thống mặc định chọn tất cả các ngày
    Sau khi chọn thời gian ngày trong tuần. hệ thống sẽ hiện hộp thời gian
      • Hộp thời gian: Người dùng có thể chọn thời điểm thực hiện đồng bộ thông tin
    khoản mục phí
      • , theo kiểu thời gian time picker định dạng HH:mm (24h).
        • Hệ thống mặc định để thời gian là 00:00
    Thể hiện thời gian đồng bộ
    dữ liệu khoản mục phí
    thông tin từ HRIS các ngày được chọn trong tuần
    6
    5Nút
    Hủy
    Áp dụngNút chức năng (Button)
    • Cho phép người dùng
     nhấn để hủy bỏ thao tác cấu hình Thể hiện để hủy bỏ thao tác cấu hình.7Nút Áp dụngNút chức năng (Button)
    • Cho phép người dùng nhấn để áp dụng những tiêu chí lọc đã chọn.

    - Hành vi hiển thị kết quả hệ thống khi người dùng nhấn nút "Áp dụng" như sau: 

    • Trường hợp 1: Không chọn bất kỳ tiêu chí lọc nào:
      • Hệ thống vẫn cho phép người dùng nhấn nút “Áp dụng”.
      • Sau khi nhấn, hệ thống đóng pop-up nhưng không thực hiện lọc.
      • Màn hình "Tích hợp thông tin khoản mục phí" vẫn giữ nguyên dữ liệu như trước khi thao tác.
      • Không hiển thị bất kỳ thông báo lỗi hay cảnh báo nào.
    • Trường hợp 2: Chọn một hoặc nhiều tiêu chí lọc:
      • Hệ thống vẫn cho phép người dùng nhấn nút “Áp dụng”.
      • Sau khi nhấn, hệ thống đóng pop-up và thực hiện lọc theo toàn bộ các tiêu chí mà người dùng đã chọn.
      • Màn hình "Tích hợp thông tin khoản mục phí (SAP)" được cập nhật và hiển thị theo đúng những tiêu chí người dùng chọn đã chọn. 
    Thể hiện nút áp dụng tiêu chí lọc được chọn
    • nhấn để áp dụng thời gian cài đặt cấu hình tự động mới.
    • Khi người dùng nhấn nút "Áp dụng", hệ thống cài đặt thời gian cấu hình tự động.
    Thể hiện nút chức năng áp dụng thời gian cài đặt cấu hình tự động mới
    3.5.4.

    ...

    Màn hình pop-up

    ...

    "Xác nhận đồng bộ

    ...

    dữ liệu"

    Trường dữ liệu

    Kiểu dữ liệu

    Bắt buộc

    Quy định

    Mô tả

    1
    Tiêu đề màn hìnhVăn bản thông báo
    Bạn có chắc chắc muốn đồng bộ dữ liệu HRIS?Nhãn hiệu (Label)
    Hiển thị tiêu đề " Xác nhận đồng bộ dữ liệu"2


    3Nút "Tôi chắc chắn" 

    Thể hiện văn bản thông báo

    2Nút "Tôi chắc chắn" Nút chức năng (Button)
    • Không cho phép người dùng thao tác tương tác (nhấn/chọn/sửa).

    - Thể hiện văn bản thông báo

    - Nội dung văn bản thông báo: "Bạn có chắc chắn muốn đồng bộ dữ liệu khoản mục phí (SAP)"


    • Cho phép người dùng nhấn để thực hiện đồng bộ thông tin từ HRIS
    • Khi người dùng nhấn nút "Tôi chắc chắn" trong lúc với hệ thống đang thực hiện đồng bộ song song tiến trình khác (Thao tác của người dùng xảy ra trước hệ thống tự động hoặc đang thực hiện đồng bộ thủ công tiếp tục nhấn thủ công nữa). Khi nhấn sẽ xuất hiện pop-up "Cảnh báo"
      • Màn hình pop-up "Cảnh báo": tham chiếu mục 3.5.5. Màn hình pop-up "Cảnh báo".

    Thể hiện nút chức năng để thực hiện đồng bộ thông tin từ HRIS theo cấu hình hiện tại

    3Nút "Hủy"
    Nút chức năng (Button)

    Cho phép người dùng nhấn để

    thực hiện đồng bộ thông tin khoản mục phí ngay 

    Cho phép người dùng nhấn để thực hiện đồng bộ thông tin khoản mục phí theo cấu hình hiện tại

    4Nút Hủy

    hủy bỏ thao tác đồng bộ ngay

    Thể hiện nút chức năng để hủy bỏ thao tác đồng bộ ngay.
    3.5.5. Pop-up "Cảnh báo"

    Trường dữ liệu

    Kiểu dữ liệu

    Bắt buộc

    Quy định

    Mô tả

    1Hệ thống đang thực hiện đồng bộ.
    Vui lòng chờ quá trình hoàn tất.
    Nhãn hiệu (Label)


    Thể hiện văn bản cảnh báo

    2Nút "Thoát"Nút chức năng (Button)

    Cho phép người dùng

     nhấn để hủy bỏ thao tác cấu hình 

    nhấn để đóng màn hình pop-up

    Thể hiện

    để hủy bỏ thao tác đồng bộ ngay.

    nút chức năng để đóng màn hình pop up

    3.5.

    ...

    6.Pop-up

    ...

    "Đồng bộ thất bại"

    Trường dữ liệu

    Kiểu dữ liệu

    Bắt buộc

    Quy định

    Mô tả

    1
    Tiêu đề màn hình

    <Mã lỗi>

    <Mô tả lỗi>

    Nhãn hiệu (Label)
    Hiển thị tiêu đề " Cảnh báo"


    Thể hiện văn bản thông báo

    2
    Văn bản thông báo
    Nút "Thoát"Nút chức năng (Button)
    Không cho

    Cho phép người dùng

    thao tác tương tác (nhấn/chọn/sửa).

    - Thể hiện văn bản cảnh báo

    - Nội dung văn bản thông báo:"Hệ thống đang thực hiện đồng bộ.
    Vui lòng chờ quá trình hoàn tất."

    3Nút "Thoát Nút chức năng (Button)
    • Cho phép người dùng nhấn để tắt màn hình pop-up.
      Khi nhấn, màn hình pop-up đóng lại và hệ thống điều hướng về màn hình về màn hình danh sách "Tích hợp dữ liệu khoản mục phí"

    Thể hiện nút "Thoát" để đóng màn hình pop up cảnh báo

    3.5.6. Pop-up "Xem chi tiết lỗi"

    Trường dữ liệu

    Kiểu dữ liệu

    Bắt buộc

    Quy định

    Mô tả

    1Tiêu đề màn hìnhNhãn hiệu (Label)Hiển thị tiêu đề "Đồng bộ thất bại"2Văn bản thông báoNút chức năng (Button)
    • Không cho phép người dùng thao tác tương tác (nhấn/chọn/sửa).

    - Thể hiện văn bản thông báo

    - Nội dung văn bản thông báo: "Mã lỗi. Mô tả chi tiết lỗi"

    3Nút "Thoát Nút chức năng (Button)
    • Cho phép người dùng nhấn để tắt màn hình pop-up.
      Khi nhấn, màn hình pop-up đóng lại và hệ thống điều hướng về màn hình về màn hình danh sách "Tích hợp dữ liệu khoản mục phí"
    Thể hiện nú

    nhấn để đóng màn hình pop-up.

    Thể hiện nút chức năng để đóng màn hình pop up

    Bảng mã lỗi


    Mã lỗiMô tả lỗi
    1153"Đồng bộ tự động không thể thực hiện do hệ thống đang xử lý đồng bộ thủ công."
    2162"Đồng bộ HRIS Employee thất bại: <log hệ thống>."
    3163"Gọi HRIS bị timeout (không nhận phản hồi kịp thời)."
    4164"DNS lỗi khi gọi HRIS: <log hệ thống>."
    5165"Không kết nối được tới HRIS: <log hệ thống>."
    6166"Lỗi mạng khi gọi HRIS: <log hệ thống>."
    7167"Parse dữ liệu HRIS thất bại: <log hệ thống>."
    8168"Có lỗi không mong muốn khi gọi/xử lý HRIS: <log hệ thống>."
    9169"Gọi system thất bại, HTTP: <code>."
    10170"Lưu/gửi employee thất bại: <log hệ thống>."
    11171"Không parse được response JSON: Hris trả về dữ liệu nhưng bị lỗi định dạng."