Page History

https://jira.popplife.vn/browse/BPMKVH-3789

	Nghiệp vụ		IT
	Người lập	Người duyệt	Người lập	Người duyệt
Họ và tên	Bùi Nguyệt Anh	Nguyễn Đức Trung
	Vũ Thị Mơ
Tài khoản email/MS team	anhbn4	trungnd3
	movt2
Chức danh	Business Analyst (BA)	Product Owner (P.O)
	Business Analyst Business (BA BIZ)
Ngày soạn thảo	04 Dec 2025
	04 Dec 2025
Jira Link	https://jira.popplife.vn/browse/BPMKVH-3803
		[BPMKVH-3795] Quản lý ca làm việc - Jira

1. Card (Mô tả tính năng)

...

3.1.10. Màn hình pop-up "Xem chi tiết ca làm việc":

3.2 Luồng:

3.3 API Spec:

Panel

title	API lấy danh sách ca làm việc

Method	GET	URL	system/shift/list
Description	API lấy danh sách ca làm việc
Note	API cũ, sửa lại

1. Headers

STT	Field	Source Data Type / Length	Description	Sample Values
1	authorization	<token>	Token của người dùng đăng nhập	Bearer eyJhbGciOiJIUzI1NiJ9.eyJleHAiOjE3NjY0NTU3ODksInVzZXIiOiJ7XCJpZFwiOjIwMjAsXCJ1c2VybmFtZVwiOlwiMDM3NDc4ODQwNVwiLFwibmFtZVwiOlwiQ2h1IFRo4buLIExpw6puXCIsXCJyb2xlc1wiOltdLFwibWFwQmVhdXR5U2Fsb25cIjp7XCJicG0ucmVib3JuLnZuXCI6Nn0sXCJlbXBsb3llZUlkXCI6NTMxLFwiYnJhbmNoSWRcIjoyM30ifQ.wrvIFd-Q2kHgkTmPf6ryMY6aDIgXpNsWmSvvifQWc5k

2. Request

STT	Field	Require	Data Type / Length	Description
1	page	true	Integer	trang
2	limit	true	Integer	số bản ghi cần lấy
3	name	false	String	Tên ca làm việc hoặc mã ca làm việc
4	active	false	Integer	mã hợp đồng

3. Response / Incoming Data Specification

STT	Field	Data Type / Length	Description
1	code	Integer	0: thành công còn lại thất bại
2	message	String	message
3	result	List<Object>	kết quả trả ra
4	(result) id	Integer	id
5	(result) code	String	mã ca làm việc
6	(result) active	Integer	trạng thái (1: đang hoạt động, 0: không hoạt động)
7	(result) name	String	tên ca làm việc
8	(result) workDayConfigs	List<Object>	ngày áp dụng
9	(workDayConfigs) dayOfWeek	Integer	// 1 = Chủ Nhật, 2 = Thứ Hai, ..., 7 = Thứ Bảy
11	(workDayConfigs) isWorkingDay	Integer	// Có phải là ngày làm việc không (True/False)
12	(workDayConfigs) morningStartTime	String	// Thời gian bắt đầu làm việc buổi sáng (hh:mm:ss)
13	(workDayConfigs) morningEndTime	String	// Thời gian kết thúc làm việc buổi sáng (hh:mm:ss)
14	(workDayConfigs) afternoonStartTime	String	// Thời gian bắt đầu làm việc buổi chiều(hh:mm:ss)
15	(workDayConfigs) afternoonEndTime	String	// Thời gian kết thúc làm việc buổi chiều(hh:mm:ss)
16	(workDayConfigs) shiftId	Integer	id ca làm việc
17	(workDayConfigs) fmtMorningStartTime	String	// Thời gian bắt đầu làm việc buổi sáng (hh:mm)
18	(workDayConfigs) fmtMorningEndTime	String	// Thời gian kết thúc làm việc buổi sáng (hh:mm)
19	(workDayConfigs) fmtAfternoonStartTime	String	// Thời gian bắt đầu làm việc buổi chiều(hh:mm)
20	(workDayConfigs) fmtAfternoonEndTime	String	// Thời gian kết thúc làm việc buổi chiều(hh:mm)

Panel

title	API lấy chi tiết ca làm việc

Method	GET	URL	system/shift/get
Description	API lấy chi tiết ca làm việc
Note	API cũ, sửa lại

1. Headers

STT	Field	Source Data Type / Length	Description	Sample Values
1	authorization	<token>	Token của người dùng đăng nhập	Bearer eyJhbGciOiJIUzI1NiJ9.eyJleHAiOjE3NjY0NTU3ODksInVzZXIiOiJ7XCJpZFwiOjIwMjAsXCJ1c2VybmFtZVwiOlwiMDM3NDc4ODQwNVwiLFwibmFtZVwiOlwiQ2h1IFRo4buLIExpw6puXCIsXCJyb2xlc1wiOltdLFwibWFwQmVhdXR5U2Fsb25cIjp7XCJicG0ucmVib3JuLnZuXCI6Nn0sXCJlbXBsb3llZUlkXCI6NTMxLFwiYnJhbmNoSWRcIjoyM30ifQ.wrvIFd-Q2kHgkTmPf6ryMY6aDIgXpNsWmSvvifQWc5k

2. Request

STT	Field	Require	Data Type / Length	Description	Note	Sample Values
1	id	true	Integer	id ca làm việc

3. Response / Incoming Data Specification

STT	Field	Data Type / Length	Description
1	code	Integer	0: thành công còn lại thất bại
2	message	String	message
3	result	List<Object>	kết quả trả ra
4	(result) id	Integer	id
5	(result) code	String	mã ca làm việc
6	(result) active	Integer	trạng thái (1: đang hoạt động, 0: không hoạt động)
7	(result) name	String	tên ca làm việc

Panel

title	API lấy danh sách ngày áp dụng của ca làm việc

Method	GET	URL	system/workDayConfig/list
Description	API lấy danh sách ngày áp dụng của ca làm việc
Note	API cũ

1. Headers

STT	Field	Source Data Type / Length	Description	Sample Values
1	authorization	<token>	Token của người dùng đăng nhập	Bearer eyJhbGciOiJIUzI1NiJ9.eyJleHAiOjE3NjY0NTU3ODksInVzZXIiOiJ7XCJpZFwiOjIwMjAsXCJ1c2VybmFtZVwiOlwiMDM3NDc4ODQwNVwiLFwibmFtZVwiOlwiQ2h1IFRo4buLIExpw6puXCIsXCJyb2xlc1wiOltdLFwibWFwQmVhdXR5U2Fsb25cIjp7XCJicG0ucmVib3JuLnZuXCI6Nn0sXCJlbXBsb3llZUlkXCI6NTMxLFwiYnJhbmNoSWRcIjoyM30ifQ.wrvIFd-Q2kHgkTmPf6ryMY6aDIgXpNsWmSvvifQWc5k

2. Request

STT	Field	Require	Data Type / Length	Description	Note	Sample Values
1	shiftId	true	Integer	id ca làm việc

3. Response / Incoming Data Specification

STT	Field	Data Type / Length	Description
1	code	Integer	0: thành công còn lại thất bại
2	message	String	message
3	result	List<Object>	kết quả trả ra
4	(result) id	Integer	id ngày áp dụng
5	(result) dayOfWeek	Integer	// 1 = Chủ Nhật, 2 = Thứ Hai, ..., 7 = Thứ Bảy
6	(result) isWorkingDay	Integer	// Có phải là ngày làm việc không (True/False)
7	(result) morningStartTime	String	// Thời gian bắt đầu làm việc buổi sáng (hh:mm:ss)
8	(result) morningEndTime	String	// Thời gian kết thúc làm việc buổi sáng (hh:mm:ss)
9	(result) afternoonStartTime	String	// Thời gian bắt đầu làm việc buổi chiều(hh:mm:ss)
11	(result) afternoonEndTime	String	// Thời gian kết thúc làm việc buổi chiều(hh:mm:ss)
12	(result) shiftId	Integer	id ca làm việc
13	(result) fmtMorningStartTime	String	// Thời gian bắt đầu làm việc buổi sáng (hh:mm)
14	(result) fmtMorningEndTime	String	// Thời gian kết thúc làm việc buổi sáng (hh:mm)
15	(result) fmtAfternoonStartTime	String	// Thời gian bắt đầu làm việc buổi chiều(hh:mm)
16	(result) fmtAfternoonEndTime	String	// Thời gian kết thúc làm việc buổi chiều(hh:mm)

Panel

title	API thêm mới / cập nhật ca làm việc

Method	POST	URL	system/shift/update
Description	API thêm mới cập nhật ca làm việc
Note	API cũ sửa lại

1. Headers

STT	Field	Source Data Type / Length	Description	Sample Values
1	authorization	<token>	Token của người dùng đăng nhập	Bearer eyJhbGciOiJIUzI1NiJ9.eyJleHAiOjE3NjY0NTU3ODksInVzZXIiOiJ7XCJpZFwiOjIwMjAsXCJ1c2VybmFtZVwiOlwiMDM3NDc4ODQwNVwiLFwibmFtZVwiOlwiQ2h1IFRo4buLIExpw6puXCIsXCJyb2xlc1wiOltdLFwibWFwQmVhdXR5U2Fsb25cIjp7XCJicG0ucmVib3JuLnZuXCI6Nn0sXCJlbXBsb3llZUlkXCI6NTMxLFwiYnJhbmNoSWRcIjoyM30ifQ.wrvIFd-Q2kHgkTmPf6ryMY6aDIgXpNsWmSvvifQWc5k

2. Body

STT	Field	Require	Data Type / Length	Description
1	id	false	Integer	id ca làm việc
2	name	true	String	tên ca làm việc
3	code	true	String	mã ca làm việc
4	active	true	Integer	trạng thái hoạt động

3. Response / Incoming Data Specification

STT	Field	Data Type / Length	Description	Note	Sample Values
1	code	Integer	0: thành công còn lại thất bại
2	message	String	message

Panel

title	API xóa nhiều ca làm việc

Method	POST	URL	system/shift/deleteBatch
Description	API xóa nhiều ca làm việc
Note	API mới

1. Headers

STT	Field	Source Data Type / Length	Description	Sample Values
1	authorization	<token>	Token của người dùng đăng nhập	Bearer eyJhbGciOiJIUzI1NiJ9.eyJleHAiOjE3NjY0NTU3ODksInVzZXIiOiJ7XCJpZFwiOjIwMjAsXCJ1c2VybmFtZVwiOlwiMDM3NDc4ODQwNVwiLFwibmFtZVwiOlwiQ2h1IFRo4buLIExpw6puXCIsXCJyb2xlc1wiOltdLFwibWFwQmVhdXR5U2Fsb25cIjp7XCJicG0ucmVib3JuLnZuXCI6Nn0sXCJlbXBsb3llZUlkXCI6NTMxLFwiYnJhbmNoSWRcIjoyM30ifQ.wrvIFd-Q2kHgkTmPf6ryMY6aDIgXpNsWmSvvifQWc5k

2. Body

STT	Field	Require	Data Type / Length	Description	Note	Sample Values
1	ids	true	List<Integer>	danh sách id ca làm việc muốn xóa

3. Response / Incoming Data Specification

STT	Field	Data Type / Length	Description	Note	Sample Values
1	code	Integer	0: thành công còn lại thất bại
2	message	String	message

Panel

title	API import ca làm việc

Method	POST	URL	system/shift/import
Description	API import ca làm việc
Note	API mới

1. Headers

STT	Field	Source Data Type / Length	Description	Sample Values
1	authorization	<token>	Token của người dùng đăng nhập	Bearer eyJhbGciOiJIUzI1NiJ9.eyJleHAiOjE3NjY0NTU3ODksInVzZXIiOiJ7XCJpZFwiOjIwMjAsXCJ1c2VybmFtZVwiOlwiMDM3NDc4ODQwNVwiLFwibmFtZVwiOlwiQ2h1IFRo4buLIExpw6puXCIsXCJyb2xlc1wiOltdLFwibWFwQmVhdXR5U2Fsb25cIjp7XCJicG0ucmVib3JuLnZuXCI6Nn0sXCJlbXBsb3llZUlkXCI6NTMxLFwiYnJhbmNoSWRcIjoyM30ifQ.wrvIFd-Q2kHgkTmPf6ryMY6aDIgXpNsWmSvvifQWc5k

2. Body

STT	Field	Require	Data Type / Length	Description	Note	Sample Values
1	file	true	file	file excel import

3. Response / Incoming Data Specification

STT	Field	Data Type / Length	Description
1	code	Integer	0: thành công còn lại thất bại
2	message	String	message
3	results	List<Object>	danh sách các bản ghi đọc từ file excel
4	(results) rowNumber	Integer	dòng trong excel
5	(results) shiftCode	String	mã ca làm việc
6	(results) shiftName	String	tên ca làm việc
7	(results) dayOfWeekStr	String	ngày áp dụng
8	(results) morningStartTimeStr	String	// Thời gian bắt đầu làm việc buổi sáng (hh:mm)
9	(results) morningEndTimeStr	String	// Thời gian kết thúc làm việc buổi sáng (hh:mm)
10	(results) afternoonStartTimeStr	String	// Thời gian bắt đầu làm việc buổi chiều(hh:mm)
11	(results) afternoonEndTimeStr	String	// Thời gian kết thúc làm việc buổi chiều(hh:mm)
12	(results) importExcelStatus	Integer	trạng thái (0: lỗi, 1: không lỗi)
13	(results) messageError	String	Thông báo lỗi

3.4 Mô tả những trường thông tin và nút chức năng trên màn hình:

...

Page tree

Versions Compared

Old Version 58

New Version Current

Key

1. Card (Mô tả tính năng)

3.1.10. Màn hình pop-up "Xem chi tiết ca làm việc":

3.2 Luồng:

3.3 API Spec:

1. Headers

2. Request

3. Response / Incoming Data Specification

1. Headers

2. Request

3. Response / Incoming Data Specification

1. Headers

2. Request

3. Response / Incoming Data Specification

1. Headers

2. Body

3. Response / Incoming Data Specification

1. Headers

2. Body

3. Response / Incoming Data Specification

1. Headers

2. Body

3. Response / Incoming Data Specification

3.4 Mô tả những trường thông tin và nút chức năng trên màn hình: