View Source

	Nghiệp vụ		IT
	Người lập	Người duyệt	Người lập	Người duyệt
Họ và tên	Mai Kiều Mi	Vũ Thị Mơ
Tài khoản email/MS team	mimk2	movt2
Chức danh	Business Analyst (BA)	Business Analyst Business (BA BIZ)
Ngày soạn thảo
Ngày soạn thảo
Jira Link	[BPMKVH-3325] Bổ sung quản lý thông tin chung của nhà cung cấp, nhà thầu - Jira

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

Là admin nghiệp vụ, tôi muốn quản lý bổ sung thông tin tại danh mục nhà cung cấp, nhà thầu

2. Confirmation/ Acceptance Criteria (Tiêu chí nghiệm thu)

Tôi muốn quản lý được thông tin đánh giá nhà thầu theo thông tin đánh giá mới nhất:
- Ngày hoàn thành đánh giá: của đánh giá hoàn thành mới nhất
- Điểm đánh giá nhà cung cấp: Điểm đánh giá ncc, nhà thầu theo đánh giá hoàn thành mới nhất
- Xếp hạng nhà cung cấp: Xếp hạng nhà ncc, nhà thầu theo đánh giá hoàn thành mới nhất
- Đề xuất: Đề xuất nhà thầu theo đánh giá hoàn thành mới nhất
Tôi muốn quản lý được lĩnh vực hoạt động của nhà cung cấp dưới dạng list:
- Lĩnh vực
  - Ngành nghề (Theo lĩnh vực, quản lý cấp Cha-con, một lĩnh vực gồm nhiều ngành nghề)
  - Loại ngành nghề: Chính/phụ
Tôi muốn quản lý được thông tin ngân hàng thụ hưởng của nhà cung cấp, nhà thầu (Một nhà cung cấp có thể nhiều tài khoản) bao gồm:
1. Tên ngân hàng
2. Số tài khoản
3. Tên chủ tài khoản
4. Trạng thái mặc định
Tại bước soạn thảo hợp đồng, tôi muốn lấy được thông tin ngân hàng thụ hưởng mặc định theo nhà cung cấp, nhà thầu được chọn và cho phép chọn lại
Để lại: Liên quan đến xử lý data: Tôi muốn quản lý được thông tin đơn vị quản lý của mỗi nhà cung cấp nhà thầu bao gồm
1. Mã đơn vị quản lý
2. Tên đơn vị quản lý
3. Thông tin đơn vị quản lý mặc định tất cả phòng ban và cho phép chọn lại một số hoặc tất cả phòng ban trong danh mục cơ cấu tổ chức

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

3.1 UIUX:

3.1.1. Bổ sung màn hình danh sách thông tin nhà cung cấp:

3.1.2.Bổ sung màn hình tạo mới thông tin nhà cung cấp:

3.1.3.Bổ sung màn hình chi tiết thông tin nhà cung cấp sau:

3.1.4. Bổ sung màn hình chỉnh sửa thông tin nhà cung cấp sau:

3.2 Luồng:

3.3 API Spec: <gắn link tài liệu mô tả API vào đây>

Method	GET	URL	application/supplierEvaluation/list
Description	API lấy danh sách lịch sử đánh giá
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	evaluationGrade	false	String	Xếp hạng
4	name	false	String	tên NCC
5	cityId	false	Integer	id thành phố
6	businessId	false	Integer	id nghành nghề chính

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	Object	kết quả trả ra
4	(result) total	Integer	số lượng bản ghi
5	(result) page	Integer	page
6	(result) items	List<Object>	danh sách bản ghi
7	(items) id	Integer	id NCC
8	(items) contactOrg	String	Người liên tục
9	(items) capacityProfile	String	hồ sơ năng lực
11	(items) type	Integer	Loại
12	(items) name	String	tên NCC
13	(items) taxCode	String	mã số thuế
14	(items) evaluationGrade	String	Xếp hạng đánh giá
15	(items) cityId	Integer	thành phố
16	(items) districtId	Integer	huyện
17	(items) subdistrictId	Integer	xã
18	(items) address	String	địa chỉ
19	(items) legalRepresentative	String	đại diện pháp lý
20	(items) businessId	Integer	id ngành nghề chính
21	(items) active	Integer	trạng thái
22	(items) cityName	String	huyện
23	(items) districtName	String	thành phố
24	(items) subdistrictName	String	xã
25	(items) businessName	String	tên ngành nghề chính
26	(items) fieldName	String	tên lĩnh vực chính
27	(items) evaluationGrade	String	xếp hạng

Method	GET	URL	application/organization/get
Description	API chi tiết NCC
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 NCC

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	Object	kết quả trả ra
4	(result) id	Integer	id NCC
5	(result) contactOrg	String	Người liên tục
6	(result) capacityProfile	String	hồ sơ năng lực
7	(result) type	Integer	Loại
8	(result) name	String	tên NCC
9	(result) taxCode	String	mã số thuế
11	(result) evaluationGrade	String	Xếp hạng đánh giá
12	(result) cityId	Integer	thành phố
13	(result) districtId	Integer	huyện
14	(result) subdistrictId	Integer	xã
15	(result) address	String	địa chỉ
16	(result) legalRepresentative	String	đại diện pháp lý
17	(result) businessId	Integer	id ngành nghề chính
18	(result) active	Integer	trạng thái
19	(result) cityName	String	huyện
20	(result) districtName	String	thành phố
21	(result) subdistrictName	String	xã
22	(result) businessName	String	tên ngành nghề chính
23	(result) fieldName	String	tên lĩnh vực chính
24	(result) evaluationGrade	String	xếp hạng
25	(result) evaluationScore	String	điểm đánh giá
26	(result) supplierRatingRecommended	String	đề xuất
27	(result) completionDate	String	ngày hoàn thành
28	(result) fields	List<Object>	Danh sách Lĩnh vực phụ
29	(fields) id	Integer	id
30	(fields) organizationId	Integer	id NCC
31	(fields) fieldId	Integer	id lĩnh vực
32	(fields) fieldName	String	tên lĩnh vực
33	(result) businesses	List<Object>	Danh sách Ngành nghề phụ
34	(businesses) id	Integer	id
35	(businesses) organizationId	Integer	id NCC
36	(businesses) businessId	Integer	id ngành nghề phụ
37	(businesses) businessName	String	tên ngành nghề phụ
38	(result) bankAccounts	List<Object>	Danh sách tài khoản ngân hàng
39	(bankAccounts) id	Integer	id
40	(bankAccounts) organizationId	Integer	id NCC
41	(bankAccounts) bankName	String	tên ngân hàng
42	(bankAccounts) accountNumber	String	số tài khoản
43	(bankAccounts) accountHolder	String	tên tài khoản
44	(bankAccounts) isDefault	Integer	đánh dấu có mặc định hay không. 1: mặc định, 0: không mặc định

Method	GET	URL	application/organization/getBankAccounts
Description	API Lấy danh sách các tài khoản ngân hàng của 1 NCC
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. Request

STT	Field	Require	Data Type / Length	Description	Note	Sample Values
1	orgId	true	Integer	id NCC

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	(bankAccounts) id	Integer	id NCC
5	(bankAccounts) organizationId	Integer	id NCC
6	(bankAccounts) bankName	String	tên ngân hàng
7	(bankAccounts) accountNumber	String	số tài khoản
8	(bankAccounts) accountHolder	String	tên tài khoản
9	(bankAccounts) isDefault	Integer	đánh dấu có mặc định hay không. 1: mặc định, 0: không mặc định

Method	GET	URL	application/organization/delete
Description	API xóa 1 NCC
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	id	true	Integer	id NCC

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

Method	GET	URL	application/organization/update
Description	API thêm mới/ cập nhật NCC
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 body

STT	Field	Require	Data Type / Length	Description
1	id	false	Integer	id NCC
2	contactOr		String	Người liên tục
3	capacityProfile		String	hồ sơ năng lực
4	type		Integer	Loại
5	name		String	tên NCC
6	taxCode		String	mã số thuế
7	evaluationGrade		String	Xếp hạng đánh giá
8	cityId		Integer	thành phố
9	districtId		Integer	huyện
10	subdistrictId		Integer	xã
11	address		String	địa chỉ
12	legalRepresentative		String	đại diện pháp lý
13	businessId		Integer	id ngành nghề chính
14	active		Integer	trạng thái
15	fieldName		Integer	id lĩnh vực chính
16	fields		List<Object>	Danh sách Lĩnh vực phụ
17	(fields) organizationId		Integer	id NCC
18	(fields) fieldId		Integer	id lĩnh vực
19	businesses		List<Object>	Danh sách Ngành nghề phụ
20	(businesses) organizationId		Integer	id NCC
21	(businesses) businessId		Integer	id ngành nghề phụ
22	(result) bankAccounts		List<Object>	Danh sách tài khoản ngân hàng
23	(bankAccounts) organizationId		Integer	id NCC
24	(bankAccounts) bankName		String	tên ngân hàng
25	(bankAccounts)accountNumber		String	số tài khoản
26	(bankAccounts) accountHolder		String	tên tài khoản
27	(bankAccounts) isDefault		Integer	đánh dấu có mặc định hay không. 1: mặc định, 0: không mặc định

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

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

3.4.1. Màn hình Nhà cung cấp (Danh sách thông tin nhà cung cấp):

Cách truy cập: Phân hệ Quản lý NT/NCC > mục Danh mục NCC

Đối tượng sử dụng:

Admin: Có quyền truy cập và thao tác
End-user: Có quyền truy cập và thao tác

STT	Trường thông tin/ Nút chức năng	Kiểu dữ liệu	Điều kiện	Quy định	Mô tả
1	Ô tìm kiếm	Văn bản (Text)	Không bắt buộc	- Cho phép người dùng nhập từ khóa liên quan đến "Tên nhà cung cấp". - Hệ thống thực hiện tìm kiếm và cập nhật màn hình "Nhà cung cấp" khi người dùng nhấn Enter hoặc biểu tượng kính lúp sau khi hoàn thành nhập từ khóa. - Hành vi hệ thống khi Thể hiện kết quả: Trường hợp 1 - Có kết quả: Điều kiện: Có ít nhất một nhà cung cấp trong hệ thống khớp với từ khóa người dùng nhập. Hành vi: Hệ thống thể hiện danh sách nhà cung cấp khớp với từ khóa tìm kiếm. Trường hợp 2 - Không có kết quả/Danh sách trống (không có dữ liệu ban đầu): Điều kiện: Không có loại nhà cung cấp nào khớp với từ khóa tìm kiếm hoặc danh sách loại danh mục dùng chung ban đầu trống. Hành vi: Hệ thống Thể hiện thông báo "Ở đây chưa có gì cả. Hiện tại chưa có nhà cung cấp nào."	Thể hiện ô tìm kiếm với gợi ý mặc định (placeholder) “Tìm theo tên nhà cung cấp” và biểu tượng kính lúp ở phần đầu ô nhập.
2	Nút Xuất file excel	Nút chức năng (Button)	Không bắt buộc	Cho phép người dùng nhấn để điều hướng đến màn hình pop-up "Xuất dữ liệu excel": tham chiếu mục 3.4.2. Màn hình pop-up "Xuất file excel"	Thể hiện nút chức năng mở màn hình pop-up "Xuất file excel".
3	Nút Bộ 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.4.3. Màn hình pop-up "Bộ lọc".	Thể hiện nút chức năng cho phép mở màn hình pop-up bộ lọc
4	Nút Thêm mới	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 "Thêm mới nhà cung cấp": tham chiếu mục 3.4.4. Màn hình pop-up "Thêm mới nhà cung cấp"	Thể hiện nút chức năng cho phép mở màn hình pop-up Thêm mới nhà cung cấp
5	Hộp chọn (Select box)	Boolean (True/False)	Không bắt buộc	Cho phép người dùng tích chọn một, nhiều, hoặc tất cả bản ghi loại danh mục dùng chung để phục vụ cho chức năng xóa nhiều bản ghi	Thể hiện trường lựa chọn (select) phục vụ cho chức năng xóa nhiều bản ghi trên màn hình danh sách loại danh mục dùng chung.
6	STT	Văn bản (Text)	Không bắt buộc	- Số thứ tự động sinh, bắt đầu từ 1, tăng dần - Sau khi thêm mới bản ghi: Bản ghi mới hiển thị STT = 1 Các bản ghi khác tăng STT theo thứ tự hiển thị - Khi xóa bản ghi: STT không đánh lại (giữ nguyên để đảm bảo truy vết). - 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 thứ tự các bản ghi trên màn hình danh sách loại danh mục dùng chung.
7	Tên nhà cung cấp	Đường dẫn(Hyperlink)	Không bắt buộc	Cho phép người dùng nhấn vào bản ghi để hệ thống mở màn hình Xem chi tiết nhà cung cấp: tham chiếu mục 3.4.5. Màn hình pop-up "Xem chi tiết nhà cung cấp"	Thể hiện thông tin nhà cung cấp và đường dẫn cho phép mở pop-up Xem chi tiết nhà cung cấp
8	Mã số thuế/ CCCD	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).	Thể hiện thông tin Mã số thuế/ CCCD ứng với từng bản ghi nhà cung cấp
9	Lĩnh vực chính	Nút chức năng (Button)	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).	Thể hiện lĩnh vực kinh doanh chính của nhà cung cấp
10	Xếp hạng đánh giá	Nút chức năng (Button)	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: Trường "Xếp hạng đánh giá" từ màn hình chi tiết US 2489_User Story - Lịch sử đánh giá nhà cung cấp	Thể hiện giá trị xếp hạng đánh giá nhà cung cấp
11	Tỉnh/Thành phố	Văn bản (Text)	Không bắt buộc	Cho phép người dùng nhấn vào bản ghi để hệ thống mở màn hình Xem chi tiết nhà cung cấp: tham chiếu mục 3.4.3. Màn hình pop-up "Xem chi tiết nhà cung cấp"	Thể hiện tên tỉnh thành phố ứng với địa chỉ của từng bản ghi nhà cung cấp
12	Hoạt động	Văn bản (Text)	Không bắt buộc	- Cho phép người dùng thao tác để thay đổi trạng thái hoạt động của nhà cung cấp. Trạng thái bật (Active/On): Hệ thống ghi nhận nhà cung cấp đang hoạt động Hệ thống hiển thị thông báo (toast): Tiêu đề: Thành công Nội dung: Cập nhật nhà cung cấp thành công Trạng thái bật (Inactive/Off): Hệ thống ghi nhận Nhà cung cấp ngừng hoạt động. Hệ thống ghi nhận nhà cung cấp ngừng hoạt động Hệ thống hiển thị thông báo (toast): Tiêu đề: Thành công Nội dung: Cập nhật nhà cung cấp thành công	Thể hiện trạng thái hoạt động của từng bản ghi nhà cung cấp
13	Thanh icon chức năng	Nút chức năng (Button)	Không bắt buộc	Cho phép người dùng nhấn vào icon chức năng để hệ thống mở màn hình pop-up tương ứng với từng chức năng. Chỉnh sửa: tham chiếu mục 3.4.6. Màn hình pop-up Chỉnh sửa nhà cung cấp Pop-up: Nhân viên mua hàng tạo yêu cầu đánh giá nhà cung cấp Thông tin giao dịch Xác nhận xóa	Thể hiện thanh icon chức năng cho phép tương tác với từng bản ghi nhà cung cấp gồm các icon tương ứng với từng chức năng: Chỉnh sửa Tạo yêu cầu đánh giá - Pop-up: Nhân viên mua hàng tạo yêu cầu đánh giá nhà cung cấp Thông tin giao dịch Xóa

3.4.2. Màn hình pop-up Xuất file excel

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

3.4.4. Màn hình pop-up Thêm mới nhà cung cấp

3.4.1.1. Tab Thông tin chung

Cách truy cập: Phân hệ Quản lý danh mục > mục Danh mục nhà cung cấp > Nút Thêm mới > Tab Thông tin chung

Đối tượng sử dụng:

Admin: Có quyền truy cập và thao tác
End-user: Có quyền truy cập và thao tác

STT	Trường thông tin/ Nút chức năng	Kiểu dữ liệu	Điều kiện	Quy định	Mô tả
1	Tab Thông tin chung	Thẻ giao diện (Tab)	Không bắt buộc	- Cho phép người dùng nhấn để chọn thẻ “Thông tin chung”. - Sau khi người dùng nhấn chọn, hệ thống hiển thị nội dung thuộc nhóm Thông tin chung và ẩn nội dung của các thẻ còn lại.	Thể hiện nội dung nhóm Thông tin chung
2	Trạng thái hoạt động	Công tắc (Toggle/Switch)	Bắt buộc	- Khi mở pop-up Thêm mới nhà cung cấp, tại tab Thông tin chung, công tắc mặc định ở trạng thái Bật (Active/On) - Cho phép người dùng thao tác để thay đổi trạng thái hoạt động của nhà cung cấp. Trạng thái bật (Active/On): Hệ thống ghi nhận nhà cung cấp đang hoạt động Khi nhấn “Áp dụng”, hệ thống tự động kiểm tra: Phải có ≥ 1 người liên hệ Tất cả trường bắt buộc tại tab Người liên hệ phải được nhập đầy đủ, hợp lệ Hệ thống hiển thị thông báo (toast): Tiêu đề: Thành công Nội dung: Cập nhật nhà cung cấp thành công Trạng thái bật (Inactive/Off): Hệ thống ghi nhận Nhà cung cấp ngừng hoạt động. Hệ thống ghi nhận nhà cung cấp ngừng hoạt động Không bắt buộc phải có người liên hệ Hệ thống hiển thị thông báo (toast): Tiêu đề: Thành công Nội dung: Cập nhật nhà cung cấp thành công	Thể hiện công tắc để thiết lập trạng thái hoạt động của nhà cung cấp khi thêm mới.
3	Nhóm nhà cung cấp	Lựa chọn (Select)	Bắt buộc	- Cho phép người dùng chọn 01 giá trị từ danh sách thả xuống của trường. - Khi tích hợp sang hệ thống SAP, dữ liệu được ánh xạ (mapping) sang trường Groupping trên hệ thống SAP. - Nguồn dữ liệu danh sách thả xuống: Phân hệ Quản lý danh mục, mục Danh mục Dùng chung	Thể hiện trường lựa chọn (select) để khai báo nhóm nhà cung cấp phục vụ việc đồng bộ dữ liệu sang hệ thống SAP.
4	Loại nhà cung cấp*	Lựa chọn đơn (Radio)	Bắt buộc	- Cho phép người dùng chọn 01 giá trị từ danh sách phương án của trường gồm: Cá nhân Tổ chức - Khi tích hợp sang hệ thống SAP: Dữ liệu được ánh xạ (mapping) sang trường BP Type trên hệ thống SAP. Quy tắc ghi nhận giá trị trên SAP: Giá trị Cá nhân được ghi nhận là 1. Giá trị Tổ chức được ghi nhận là 2	Thể hiện trường lựa chọn đơn (dạng Radio) để khai báo thông tin nhóm nhà cung cấp phục vụ việc đồng bộ dữ liệu sang hệ thống SAP.
4.1	Nhánh Loại nhà cung cấp = Cá nhân
4.1.1	Tên nhà cung cấp*	Văn bản (Text)	Bắt buộc	- Cho phép nhập tên nhà cung cấp gồm 02 thành phần: Họ và tên đệm: Tham chiếu STT 4.1.1.1 Tên: Tham chiếu STT 4.1.1.2 - Khi nhấn vào trường, hệ thống mở màn hình Xem chi tiết nhà cung cấp	Thể hiện nhóm trường nhập văn bản để khai báo Tên nhà cung cấp (Cá nhân), gồm 02 trường con: Họ và tên đệm Tên
4.1.1.1	Họ*	Văn bản (Text)	Bắt buộc	- Cho phép người dùng nhập thông tin họ của nhà cung cấp. - Khi tích hợp sang hệ thống SAP: Dữ liệu được ánh xạ (mapping) sang trường Last Name trên SAP. Giá trị Họ được xác định là từ đầu tiên trong chuỗi họ tên đầy đủ. - Độ dài kí tự: 40	- Thể hiệntrường nhập văn bản để khai báo họ và tên đệm của nhà cung cấp. Ví dụ: "Bùi Huỳnh Anh” → Họ= “Bùi”
4.1.1.2	Tên và tên đệm*	Văn bản (Text)	Bắt buộc	- Cho phép người dùng nhập thông tin tên và tên đệm của nhà cung cấp. - Khi tích hợp sang hệ thống SAP: Dữ liệu được ánh xạ (mapping) sang trường First Name trên SAP. Giá trị là toàn bộ phần còn lại sau Họ. - Độ dài kí tự: 40	- Thể hiện trường nhập văn bản để khai báo tên của nhà cung cấp. Ví dụ: “Bùi Huỳnh Anh” → Tên và Tên đệm= “Huỳnh Anh”
4.1.1.3	Qúy danh	Lựa chọn (Select)	Không bắt buộc	- Cho phép người dùng chọn 01 giá trị từ danh sách phương án của trường gồm: Ông Bà - Dữ liệu: Khi tích hợp sang hệ thống SAP: Dữ liệu được ánh xạ (mapping) sang trường Title trên SAP. Độ dài kí tự: 40	Thể hiện trường lựa chọn (select) để khai báo thông tin Qúy danh của loại nhà cung cấp = loại nhà cung cấp = 1 (Cá nhân/Person).
4.1.1.4	Số CMT/CCCD*	Văn bản (Text)	Bắt buộc	- Cho phép người dùng nhập thông tin - Sau khi nhập, hệ thống thực hiện: Ghi nhận giá trị nhập vào và thực hiện làm sạch dữ liệu (loại bỏ khoảng trắng đầu/cuối). Kiểm tra hợp lệ tại chỗ (Inline validate): Rỗng / chỉ khoảng trắng → “Trường này là bắt buộc” - Khi người dùng di chuột vào (hover) tên trường, hệ thống hiển thị chú thích(tooltip) với nội dung là: Số Chứng minh thư/Căn cước công dân.	Thể hiện trường nhập văn bản để khai báo thông tin Chứng minh thư/Căn cước công dân khi loại nhà cung cấp = 1 (Cá nhân/Person).
4.2	Nhánh Loại nhà cung cấp = Tổ chức
4.2.1	Tên nhà cung cấp*	Văn bản (Text)	Bắt buộc	- Cho phép người dùng nhập thông tin - Sau khi nhập, hệ thống ghi nhận giá trị nhập vào và thực hiện làm sạch dữ liệu (loại bỏ khoảng trắng đầu/cuối). - Dữ liệu: Khi tích hợp sang hệ thống SAP, dữ liệu được ánh xạ (mapping) sang trường SAP như sau: Name1: tối đa 40 ký tự đầu Name2: 40 ký tự tiếp theo (nếu có) Name3: 40 ký tự tiếp theo (nếu có) Name4: 40 ký tự tiếp theo (nếu có)	Thể hiện nhóm trường nhập liệu để khai báo Tên nhà cung cấp khi loại nhà cung cấp = 2 (Công ty/Company).
4.2.2	Tên rút gọn phục vụ tích hợp SAP*	Văn bản (Text)	Bắt buộc	- Cho phép người dùng nhập thông tin - Sau khi nhập, hệ thống ghi nhận giá trị nhập vào và thực hiện làm sạch dữ liệu (loại bỏ khoảng trắng đầu/cuối). - Dữ liệu: Khi tích hợp sang hệ thống SAP, dữ liệu được ánh xạ (mapping) sang trường Tên rút gọn Độ dài kí tự: 40	Thể hiện nhóm trường nhập liệu để khai báo Tên rút gọn phục vụ tích hợp SAP khi loại nhà cung cấp = 2 (Công ty/Company).
4.2.3	Qúy danh	Lựa chọn (Select)	Không bắt buộc	- Khi Loại nhà cung cấp = 2 (Công ty/Company), hệ thống tự động điền giá trị “Công ty”. - Dữ liệu: Khi tích hợp sang hệ thống SAP: Dữ liệu được ánh xạ (mapping) sang trường Title trên SAP. Độ dài kí tự: 40	Thể hiện thông tin Qúy danh tương ứng khi loại nhà cung cấp = 2 (Công ty/Company).
4.2.4	Mã số thuế*	Văn bản (Text)	Bắt buộc	- Cho phép người dùng nhập thông tin - Cho phép người dùng nhập thông tin - Sau khi nhập, hệ thống thực hiện: Ghi nhận giá trị nhập vào và thực hiện làm sạch dữ liệu (loại bỏ khoảng trắng đầu/cuối). Kiểm tra hợp lệ tại chỗ (Inline validate): Rỗng / chỉ khoảng trắng → “Trường này là bắt buộc”	Thể hiện trường nhập văn bản để khai báo thông tin Mã số thuế khi loại nhà cung cấp = 2 (Công ty/Company).
5	Quốc gia*	Lựa chọn (Select)	Bắt buộc	- Cho phép người dùng chọn 01 giá trị từ danh sách thả xuống của trường. - Dữ liệu: Khi tích hợp sang hệ thống SAP, dữ liệu được ánh xạ (mapping) sang trường Country trên hệ thống SAP. Độ dài kí tự: 3 Nguồn dữ liệu danh sách thả xuống: Phân hệ Quản lý danh mục, mục Danh mục Dùng chung	Thể hiện trường lựa chọn (select) để khai báo thông tin về tên tiếng việt của quốc gia áp dụng cho cả 2 loại sau: Loại nhà cung cấp = 1 (Cá nhân/Person). Loại nhà cung cấp = 2 (Công ty/Company).
6	Tỉnh/Thành phố	Lựa chọn (Select)	Không bắt buộc	- Cho phép người dùng chọn 01 giá trị từ danh sách thả xuống của trường. - Khi thay đổi giá trị tỉnh/thành phố được chọn, hệ thống tự động làm mới (reset) trường Phường/Xã (STT 4.1.1.6). - Dữ liệu: Khi tích hợp sang hệ thống SAP, dữ liệu được ánh xạ (mapping) sang trường City trên hệ thống SAP. Độ dài kí tự: 40 Nguồn dữ liệu danh sách thả xuống: Phân hệ Quản lý danh mục, mục Danh mục Dùng chung	Thể hiện trường lựa chọn (select) để khai báo thông tin tỉnh/thành phố cho cả 2 loại sau: Loại nhà cung cấp = 1 (Cá nhân/Person). Loại nhà cung cấp = 2 (Công ty/Company).
7	Phường, Xã	Lựa chọn (Select)	Không bắt buộc	- Chỉ cho phép chọn giá trị Phường/Xã sau khi người dùng đã chọn giá trị Tỉnh/Thành phố(STT 4.1.1.6). - Khi thay đổi giá trị tỉnh/thành phố được chọn, hệ thống tự động làm mới (reset) trường này. - Dữ liệu: Khi tích hợp sang hệ thống SAP, dữ liệu được ánh xạ (mapping) sang trường Street 1 trên hệ thống SAP. Độ dài kí tự: 60 Nguồn dữ liệu danh sách thả xuống: Bảng dữ liệu cấu hình (Database Table).	Thể hiện trường lựa chọn (select) để khai báo thông tin phường/xã phụ thuộc theo giá trị tỉnh/thành phố (STT 4.1.1.6) đã chọn cho cả 2 loại nhà cung cấp: Loại nhà cung cấp = 1 (Cá nhân/Person). Loại nhà cung cấp = 2 (Công ty/Company).
8	Địa chỉ	Văn bản (Text)	Không bắt buộc	- Cho phép người dùng nhập thông tin - Sau khi nhập, hệ thống ghi nhận giá trị nhập vào và thực hiện làm sạch dữ liệu (loại bỏ khoảng trắng đầu/cuối). - Trường này không được tích hợp/đẩy dữ liệu sang hệ thống SAP do hai nền tảng không có trường tương ứng.	Thể hiện trường nhập văn bản để khai báo thông tin địa chỉ cho cả 2 loại nhà cung cấp: Loại nhà cung cấp = 1 (Cá nhân/Person). Loại nhà cung cấp = 2 (Công ty/Company).
9	Đại diện pháp lý	Văn bản (Text)	Không bắt buộc	- Cho phép người dùng nhập thông tin - Sau khi nhập, hệ thống ghi nhận giá trị nhập vào và thực hiện làm sạch dữ liệu (loại bỏ khoảng trắng đầu/cuối). - Dữ liệu: Khi tích hợp sang hệ thống SAP, dữ liệu được ánh xạ (mapping) sang trường Tên người đại diện theo PL trên hệ thống SAP. Độ dài kí tự: 132	Thể hiện trường nhập văn bản để khai báo thông tin tên đại diện pháp lý cho cả 2 loại nhà cung cấp: Loại nhà cung cấp = 1 (Cá nhân/Person). Loại nhà cung cấp = 2 (Công ty/Company).
10	Lĩnh vực chính	Lựa chọn (Select)	Không bắt buộc	- Cho phép người dùng chọn 01 giá trị từ danh sách thả xuống của trường. - Nguồn dữ liệu danh sách thả xuống: Phân hệ Quản lý danh mục → Danh mục Lĩnh vực - Khi thay đổi giá trị lĩnh vực chính được chọn, hệ thống tự động làm mới (reset) trường lĩnh vực phụ (STT 4.1.1.10). - Trường này không được tích hợp/đẩy dữ liệu sang hệ thống SAP do hai nền tảng không có trường tương ứng.	Thể hiện trường lựa chọn (select) để khai báo thông tin lĩnh vực chính cho cả 2 loại nhà cung cấp: Loại nhà cung cấp = 1 (Cá nhân/Person). Loại nhà cung cấp = 2 (Công ty/Company).
11	Lĩnh vực phụ	Lựa chọn (Select)	Không bắt buộc	- Cho phép chọn giá trị Lĩnh vực phụ sau khi người dùng đã chọn giá trị Lĩnh vực chính(STT 4.1.1.10). - Nguồn dữ liệu danh sách thả xuống: Phân hệ Quản lý danh mục → Danh mục Lĩnh vực - Khi thay đổi giá trị lĩnh vực chính được chọn, hệ thống tự động làm mới (reset) trường này. - Trường này không được tích hợp/đẩy dữ liệu sang hệ thống SAP do hai nền tảng không có trường tương ứng	Thể hiện trường lựa chọn (select) để khai báo thông tin lĩnh vực phụ cho cả 2 loại nhà cung cấp: Loại nhà cung cấp = 1 (Cá nhân/Person). Loại nhà cung cấp = 2 (Công ty/Company).
12	Ngành nghề kinh doanh chính	Lựa chọn (Select)	Không bắt buộc	- Cho phép người dùng chọn 01 giá trị từ danh sách thả xuống của trường. - Khi thay đổi giá trị trường này, hệ thống tự động làm mới (reset) trường lĩnh vực phụ (STT 4.1.1.13). - Dữ liệu: Khi tích hợp sang hệ thống SAP, dữ liệu được ánh xạ (mapping) sang trường Ngành nghề KD trên hệ thống SAP. Độ dài kí tự: 132	Thể hiện trường lựa chọn (select) để khai báo thông tin Ngành nghề kinh doanh chính cho cả 2 loại nhà cung cấp: Loại nhà cung cấp = 1 (Cá nhân/Person). Loại nhà cung cấp = 2 (Công ty/Company).
13	Ngành nghề kinh doanh phụ	Lựa chọn (Select)	Không bắt buộc	- Chỉ cho phép chọn giá trị Ngành nghề kinh doanh phụ sau khi người dùng đã chọn giá trị Ngành nghề kinh doanh chính(STT 4.1.1.12). - Khi thay đổi giá trị Ngành nghề kinh doanh chính ( STT 12), hệ thống tự động làm mới (reset) trường này. - Dữ liệu: Khi tích hợp sang hệ thống SAP, dữ liệu được ánh xạ (mapping) sang trường Ngành nghề KD trên hệ thống SAP. Độ dài kí tự: 132	Thể hiện trường lựa chọn (select) để khai báo thông tin Ngành nghề kinh doanh phụ cho cả 2 loại nhà cung cấp: Loại nhà cung cấp = 1 (Cá nhân/Person). Loại nhà cung cấp = 2 (Công ty/Company).
5	Bảng Tài khoản ngân hàng
5.1	STT	Văn bản (Text)	Không bắt buộc	Không cho phép thêm/sửa/xóa dữ liệu	Thể hiện số thứ tự của bản ghi tài khoản ngân hàng ứng với loại nhà cung cấp = 1 (Cá nhân/Person).
5.2	Tên ngân hàng	Văn bản (Text)	Không bắt buộc	- Cho phép người dùng nhập thông tin - Sau khi nhập, hệ thống ghi nhận giá trị nhập vào và thực hiện làm sạch dữ liệu (loại bỏ khoảng trắng đầu/cuối).	Thể hiện trường nhập văn bản để khai báo thông tin Tên ngân hàng khi loại nhà cung cấp = 1 (Cá nhân/Person).
5.3	Số tài khoản	Văn bản (Text)	Không bắt buộc	- Cho phép người dùng nhập thông tin - Sau khi nhập, hệ thống ghi nhận giá trị nhập vào và thực hiện làm sạch dữ liệu (loại bỏ khoảng trắng đầu/cuối).	Thể hiện trường nhập văn bản để khai báo thông tin Số tài khoản khi loại nhà cung cấp = 1 (Cá nhân/Person).
5.4	Tên chủ tài khoản	Văn bản (Text)	Không bắt buộc	- Cho phép người dùng nhập thông tin - Sau khi nhập, hệ thống ghi nhận giá trị nhập vào và thực hiện làm sạch dữ liệu (loại bỏ khoảng trắng đầu/cuối).	Thể hiện trường nhập văn bản để khai báo thông tin Tên chủ tài khoản khi loại nhà cung cấp = 1 (Cá nhân/Person).
5.5	Mặc định	Công tắc (Toggle/Switch)	Không bắt buộc	- Khi chỉ có 01 tài khoản, không cho phép thay đổi trạng thái của công tắc. - Khi có từ 02 tài khoản ngân hàng trở lên, người dùng được phép thay đổi trạng thái công tắc để thiết lập tài khoản mặc định. Trạng thái bật (Active/On): Hệ thống ghi nhận Thông tin tài khoản ở trạng thái mặc định. Trạng thái bật (Inactive/Off): Hệ thống ghi nhận Thông tin tài khoản ở trạng thái không mặc định.	Thể hiện công tắc bật/tắt để xác định việc mặc định tài khoản ngân hàng của loại nhà cung cấp = 1 (Cá nhân/Person).
5.6	Thao tác	Biểu tượng (Icon)	Không bắt buộc	- Cho phép người dùng nhấn vào biểu tượng xóa, hệ thống xóa dòng tài khoản ngân hàng tương ứng khỏi bảng. - Trường hợp chỉ còn 01 tài khoản ngân hàng, hệ thống vẫn cho phép xóa.	Thể hiện biểu tượng thao tác tại mỗi dòng trong Bảng Tài khoản ngân hàng cho phép người dùng thực hiện xóa tài khoản ngân hàng đã khai báo.
5.7	Nút Thêm tài khoản	Nút chức năng (Button)	Không bắt buộc	Cho phép người dùng nhấn vào nút để thêm mới một dòng để nhập bản ghi thông tin về tài khoản ngân hàng.	Thể hiện nút Thêm tài khoản cho phép thêm mới một dòng để nhập bản ghi thông tin về tài khoản ngân hàng.
6	Nút X	Nút chức năng (Button)	Không bắt buộc	Cho phép người dùng nhấn để thoát khỏi màn hình pop-up Thêm mới nhà cung cấp	Thể hiện nút chức năng cho phép thoát khỏi màn hình pop-up Thêm mới nhà cung cấp
7	Nút Hủy	Nút chức năng (Button)	Không bắt buộc	Cho phép người dùng nhấn để thoát khỏi màn hình pop-up Thêm mới nhà cung cấp	Thể hiện nút chức năng cho phép thoát khỏi màn hình pop-up Thêm mới nhà cung cấp
8	Nút Áp dụng	Nút chức năng (Button)	Không bắt buộc	1. Trường hợp 1: Tích hợp thành công 1.1. Điều kiện: - Tab Thông tin chung: Tất cả trường bắt buộc được nhập đầy đủ nhập hợp lệ - Tab Người liên hệ: NCC Hoạt động: Có ≥ 1 người liên hệ, dữ liệu hợp lệ NCC Không hoạt động: Không bắt buộc người liên hệ 1.2. Hành vi hệ thống khi nhấn nút “Áp dụng”: 1.2.1. Màn hình Nhà cung cấp - BPM gọi API gửi thông tin nhà cung cấp sang SAP - Hệ thống hiển thị thông báo (toast) thành công: Tiêu đề: Thành công Nội dung: Đồng bộ thông tin nhà cung cấp sang SAP thành công 1.2.2. Màn hình Tích hợp SAP - Tab nhà cung cấp - Hiển thị bản ghi tích hợp với các thông tin: STT: Bản ghi tích hợp mới nhất hiển thị STT = 1, các bản ghi cũ tăng dần (2, 3, …) Thời gian bắt đầu: Thời điểm BPM bắt đầu gọi API gửi dữ liệu sang SAP Thời gian kết thúc: Thời điểm nhận được phản hồi từ SAP (thành công) Người đồng bộ: Người dùng thực hiện điền thông tin thêm mới nhà cung cấp và nhấn nút “Áp dụng” 2. Trường hợp 2: Tích hợp thất bại 2.1. Điều kiện: - Tab Thông tin chung: Tất cả trường bắt buộc được nhập đầy đủ nhập hợp lệ - Tab Người liên hệ: NCC Hoạt động: Có ≥ 1 người liên hệ, dữ liệu hợp lệ NCC Không hoạt động: Không bắt buộc người liên hệ - SAP trả về lỗi / API lỗi / timeout 2.2. Hành vi hệ thống khi nhấn nút “Áp dụng”: 2.2.1. Màn hình Nhà cung cấp BPM gọi API gửi thông tin nhà cung cấp sang SAP Hệ thống hiển thị thông báo (toast) thất bại: Tiêu đề: Thất bại Nội dung: Đồng bộ thông tin nhà cung cấp sang SAP thất bại Hiển thị mã lỗi tại cột Mã lỗi màn hình Tích hợp SAP - Nhà cung cấp: 4305 - User Story -BPM về SAP- Đồng bộ thông tin nhà thầu 2.2.2. Màn hình Tích hợp SAP - Tab nhà cung cấp - Hiển thị bản ghi tích hợp với các thông tin: STT: Bản ghi tích hợp mới nhất hiển thị STT = 1, các bản ghi cũ tăng dần (2, 3, …) Thời gian bắt đầu: Thời điểm BPM bắt đầu gọi API gửi dữ liệu sang SAP Thời gian kết thúc: Thời điểm nhận được phản hồi từ SAP (thất bại) Người đồng bộ: Người dùng thực hiện điền thông tin thêm mới nhà cung cấp và nhấn nút “Áp dụng” Danh sách mã lỗi: Tham chiếu mục 3.4.4. Danh sách mã lỗi 3. Trường hợp 3: Dữ liệu không hợp lệ 3.1. Điều kiện: - Tab Thông tin chung: Có ≥ 1 trường bắt buộc chưa nhập / nhập sai định dạng hoặc - Tab Người liên hệ: Tab Trạng thái hoạt động ở trạng thái Bật/Active: Không có người liên hệ / sai định dạng → “Cần có ít nhất 1 người liên hệ” Tab Trạng thái hoạt động ở trạng thái Tắt/Inactive: Không bắt buộc, nếu có nhập → kiểm tra hợp lệ (inline validation) 3.2. Hành vi hệ thống khi nhấn nút “Áp dụng”: 3.2.1. Màn hình Thêm mới nhà cung cấp - Tab thông tin chung - Hệ thống KHÔNG gọi API sang SAP - Hệ thống thực hiện kiểm tra hợp lệ dữ liệu (inline validation) và hiển thị đồng thời lỗi tại các trường: Trường bắt buộc chưa nhập: “Chưa điền thông tin trường bắt buộc” Sai định dạng email: “Email chưa hợp lệ” Sai định dạng số điện thoại: “Số điện thoại không hợp lệ” Sai định dạng mã số thuế: “Mã số thuế không hợp lệ” Vượt quá độ dài cho phép: “Không được vượt quá [x] ký tự” Tab Người liên hệ không có dữ liệu: Thông báo lỗi: Tiêu đề: Không thành công Nội dung: Cần có ít nhất 1 người liên hệ” 3.2.2. Màn hình Thêm mới nhà cung cấp - Tab Người liên hệ Trường bắt buộc chưa nhập: “Chưa điền thông tin trường bắt buộc” 3.2.2. Màn hình Tích hợp SAP - Tab nhà cung cấp - Tạo bản ghi tích hợp mới ở trạng thái: Thất bại	Thể hiện nút chức năng cho phép áp dụng thông tin thêm mới cho cả 2 loại nhà cung cấp: Loại nhà cung cấp = 1 (Cá nhân/Person). Loại nhà cung cấ

3.4.1.2. Tab Người liên hệ

Cách truy cập: Phân hệ Quản lý danh mục > mục Danh mục nhà cung cấp > Nút Thêm mới > Tab Người liên hệ

STT	Trường thông tin/ Nút chức năng	Kiểu dữ liệu	Điều kiện	Quy định	Mô tả
1	Họ và tên người liên hệ*	Văn bản (Text)	Bắt buộc	- Cho phép người dùng nhập thông tin - Sau khi nhập, hệ thống ghi nhận giá trị nhập vào và thực hiện làm sạch dữ liệu (loại bỏ khoảng trắng đầu/cuối).	Thể hiện trường nhập văn bản để khai báo thông tin họ và tên của người liên hệ cho cả 2 loại nhà cung cấp: Loại nhà cung cấp = 1 (Cá nhân/Person). Loại nhà cung cấp = 2 (Công ty/Company).
2	Số điện thoại*	Văn bản (Text)	Bắt buộc	- Cho phép người dùng nhập thông tin số điện thoại - Dữ liệu: Cho phép nhập ký tự số (0–9). Độ dài hợp lệ: ≤ 11 ký tự. - Sau khi nhập, hệ thống ghi nhận giá trị nhập vào và thực hiện làm sạch dữ liệu (loại bỏ khoảng trắng đầu/cuối).	Thể hiện trường nhập văn bản để khai báo thông tin số điện thoại của người liên hệ cho cả 2 loại nhà cung cấp: Loại nhà cung cấp = 1 (Cá nhân/Person). Loại nhà cung cấp = 2 (Công ty/Company).
3	Chức vụ	Văn bản (Text)	Không bắt buộc	- Cho phép người dùng nhập thông tin chức vụ của người liên hệ thuộc nhà cung cấp. - Sau khi nhập, hệ thống ghi nhận giá trị nhập vào và thực hiện làm sạch dữ liệu (loại bỏ khoảng trắng đầu/cuối).	Thể hiện chức vụ của người liên hệ cho cả 2 loại nhà cung cấp: Loại nhà cung cấp = 1 (Cá nhân/Person). Loại nhà cung cấp = 2 (Công ty/Company).
4	Email*	Văn bản (Email)	Bắt buộc	- Cho phép người dùng nhập thông tin email của người liên hệ thuộc nhà cung cấp. - Sau khi nhập, hành vi hệ thống như sau: Ghi nhận giá trị nhập vào và thực hiện làm sạch dữ liệu (loại bỏ khoảng trắng đầu/cuối). Kiểm tra định dạng email hợp lệ (inline validation) Trường hợp 1: Dữ liệu hợp lệ Hệ thống chấp nhận dữ liệu và cho phép lưu. Trường hợp 2: Dữ liệu không hợp lệ Hiển thị thông báo lỗi màu đỏ ngay dưới trường Email: "Email không đúng định dạng"	Thể hiện địa chỉ email của người liên hệ cho cả 2 loại nhà cung cấp: Loại nhà cung cấp = 1 (Cá nhân/Person). Loại nhà cung cấp = 2 (Công ty/Company).
5	Mặc định	Công tắc (Toggle/Switch)	Không bắt buộc	- Khi chỉ có 01 thông tin người liên hệ, không cho phép thay đổi trạng thái của công tắc. - Khi có từ 02 thông tin người liên hệ, người dùng được phép thay đổi trạng thái công tắc để thiết lập tài khoản mặc định. Trạng thái bật (Active/On): Hệ thống ghi nhận thông tin người liên hệ ở trạng thái mặc định. Trạng thái bật (Inactive/Off): Hệ thống ghi nhận thông tin người liên hệ ở trạng thái không mặc định.	Thể hiện công tắc bật/tắt để xác định việc mặc định thông tin người liên hệ cho cả 2 loại nhà cung cấp: Loại nhà cung cấp = 1 (Cá nhân/Person). Loại nhà cung cấp = 2 (Công ty/Company).
6	Thêm người liên hệ	Nút chức năng (Button)	Không bắt buộc	Cho phép người dùng nhấn vào nút để thêm mới một dòng để nhập bản ghi thông tin về thông tin người liên hệ.	Thể hiện nút Thêm tài khoản cho phép thêm mới một dòng để nhập bản ghi thông tin về thông tin người liên hệ.
7	Biểu tượng Xóa	Nút chức năng (Button)	Không bắt buộc	- Cho phép người dùng nhấn vào nút để xóa thông tin người liên hệ. - Sau khi người dùng nhấn nút Xóa, hệ thống hiển thị pop-up xác nhận xóa: Tham chiếu mục 3.4.1.3.1. Pop-up Xác nhận xóa	Thể hiện nút dùng để xóa thông tin người liên hệ đã khai báo cho cả 2 loại nhà cung cấp: Loại nhà cung cấp = 1 (Cá nhân/Person). Loại nhà cung cấp = 2 (Công ty/Company).
8	Nút Áp dụng	Nút chức năng (Button)	Không bắt buộc	1. Trường hợp 1: Tích hợp thành công 1.1. Điều kiện: - Tab Thông tin chung: Tất cả trường bắt buộc được nhập đầy đủ nhập hợp lệ - Tab Người liên hệ: NCC Hoạt động: Có ≥ 1 người liên hệ, dữ liệu hợp lệ NCC Không hoạt động: Không bắt buộc người liên hệ 1.2. Hành vi hệ thống khi nhấn nút “Áp dụng”: 1.2.1. Màn hình Nhà cung cấp - BPM gọi API gửi thông tin nhà cung cấp sang SAP - Hệ thống hiển thị thông báo (toast) thành công: Tiêu đề: Thành công Nội dung: Đồng bộ thông tin nhà cung cấp sang SAP thành công 1.2.2. Màn hình Tích hợp SAP - Tab nhà cung cấp - Hiển thị bản ghi tích hợp với các thông tin: STT: Bản ghi tích hợp mới nhất hiển thị STT = 1, các bản ghi cũ tăng dần (2, 3, …) Thời gian bắt đầu: Thời điểm BPM bắt đầu gọi API gửi dữ liệu sang SAP Thời gian kết thúc: Thời điểm nhận được phản hồi từ SAP (thành công) Người đồng bộ: Người dùng thực hiện điền thông tin thêm mới nhà cung cấp và nhấn nút “Áp dụng” 2. Trường hợp 2: Tích hợp thất bại 2.1. Điều kiện: - Tab Thông tin chung: Tất cả trường bắt buộc được nhập đầy đủ nhập hợp lệ - Tab Người liên hệ: NCC Hoạt động: Có ≥ 1 người liên hệ, dữ liệu hợp lệ NCC Không hoạt động: Không bắt buộc người liên hệ - SAP trả về lỗi / API lỗi / timeout 2.2. Hành vi hệ thống khi nhấn nút “Áp dụng”: 2.2.1. Màn hình Nhà cung cấp BPM gọi API gửi thông tin nhà cung cấp sang SAP Hệ thống hiển thị thông báo (toast) thất bại: Tiêu đề: Thất bại Nội dung: Đồng bộ thông tin nhà cung cấp sang SAP thất bại Hiển thị mã lỗi tại cột Mã lỗi màn hình Tích hợp SAP - Nhà cung cấp: 4305 - User Story -BPM về SAP- Đồng bộ thông tin nhà thầu 2.2.2. Màn hình Tích hợp SAP - Tab nhà cung cấp - Hiển thị bản ghi tích hợp với các thông tin: STT: Bản ghi tích hợp mới nhất hiển thị STT = 1, các bản ghi cũ tăng dần (2, 3, …) Thời gian bắt đầu: Thời điểm BPM bắt đầu gọi API gửi dữ liệu sang SAP Thời gian kết thúc: Thời điểm nhận được phản hồi từ SAP (thất bại) Người đồng bộ: Người dùng thực hiện điền thông tin thêm mới nhà cung cấp và nhấn nút “Áp dụng” Danh sách mã lỗi: Tham chiếu mục 3.4.4. Danh sách mã lỗi 3. Trường hợp 3: Dữ liệu không hợp lệ 3.1. Điều kiện: - Tab Thông tin chung: Có ≥ 1 trường bắt buộc chưa nhập / nhập sai định dạng hoặc - Tab Người liên hệ: Tab Trạng thái hoạt động ở trạng thái Bật/Active: Không có người liên hệ / sai định dạng → “Cần có ít nhất 1 người liên hệ” Tab Trạng thái hoạt động ở trạng thái Tắt/Inactive: Không bắt buộc, nếu có nhập → kiểm tra hợp lệ (inline validation) 3.2. Hành vi hệ thống khi nhấn nút “Áp dụng”: 3.2.1. Màn hình Thêm mới nhà cung cấp - Tab thông tin chung - Hệ thống KHÔNG gọi API sang SAP - Hệ thống thực hiện kiểm tra hợp lệ dữ liệu (inline validation) và hiển thị đồng thời lỗi tại các trường: Trường bắt buộc chưa nhập: “Chưa điền thông tin trường bắt buộc” Sai định dạng email: “Email chưa hợp lệ” Sai định dạng số điện thoại: “Số điện thoại không hợp lệ” Sai định dạng mã số thuế: “Mã số thuế không hợp lệ” Vượt quá độ dài cho phép: “Không được vượt quá [x] ký tự” Tab Người liên hệ không có dữ liệu: Thông báo lỗi: Tiêu đề: Không thành công Nội dung: Cần có ít nhất 1 người liên hệ” 3.2.2. Màn hình Thêm mới nhà cung cấp - Tab Người liên hệ Trường bắt buộc chưa nhập: “Chưa điền thông tin trường bắt buộc” 3.2.2. Màn hình Tích hợp SAP - Tab nhà cung cấp - Tạo bản ghi tích hợp mới ở trạng thái: Thất bại	Thể hiện nút chức năng cho phép áp dụng thông tin thêm mới cho cả 2 loại nhà cung cấp: Loại nhà cung cấp = 1 (Cá nhân/Person). Loại nhà cung cấp = 2 (Công ty/Company).
9	Nút Hủy	Nút chức năng (Button)	Không bắt buộc	Cho phép người dùng nhấn để thoát khỏi màn hình pop-up Thêm mới nhà cung cấp	Thể hiện nút chức năng cho phép thoát khỏi màn hình pop-up Thêm mới nhà cung cấp

3.4.1.2.1. Pop-up Xác nhận xóa

Cách truy cập: Phân hệ Quản lý danh mục > mục Danh mục nhà cung cấp > Nút Thêm mới > Tab Người liên hệ > Nhấn biểu tượng Xóa tại bản ghi người liên hệ.

STT

Trường thông tin/ Nút chức năng

Kiểu dữ liệu

Điều kiện

Quy định

Mô tả

1

Văn bản cảnh báo

Văn bản (Text)

Không bắt buộc

Không cho phép thêm/sửa/xóa dữ liệu

- Thể hiện văn bản xác nhận xóa thông tin người liên hệ đã khai báo cho cả 2 loại nhà cung cấp với nội dung như sau:

"Bạn có chắc chắn muốn xóa người liên hệ này?"

2

Nút Hủy

Nút chức năng (Button)

Không bắt buộc

Cho phép người dùng nhấn để thoát khỏi màn hình pop-up Xác nhận xóa và hủy thao tác

Thể hiện nút chức năng cho phép thoát khỏi màn hình pop-up Xác nhận xóa và hủy thao tác

3

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

Nút chức năng (Button)

Không bắt buộc

- Cho phép người dùng nhấn xác nhận xóa người liên hệ

- Sau khi nhấn hành vi hệ thống như sau:

Xóa thông tin người liên hệ tương ứng khỏi danh sách.
Đóng pop-up Xác nhận xóa.
Hiển thị thông báo (toast) xóa người liên hệ thành công:
- Tiêu đề: Thành công
- Nội dung: Xóa thông tin người liên hệ thành công !

Thể hiện nút chức năng cho phép xác nhận xóa thông tin người liên hệ đã khai báo cho cả 2 loại nhà cung cấp.

3.4.1.3. Tab Hồ sơ năng lực

Cách truy cập: Phân hệ Quản lý danh mục > mục Danh mục nhà cung cấp > Nút Thêm mới > Tab Hồ sơ năng lực

STT	Trường thông tin/ Nút chức năng	Kiểu dữ liệu	Điều kiện	Quy định	Mô tả
1	Ghi chú	Văn bản (Textarea)	Không bắt buộc	- Cho phép người dùng nhập ghi chú liên quan đến hồ sơ năng lực của nhà cung cấp. - Sau khi nhập, hệ thống thực hiện làm sạch dữ liệu (loại bỏ khoảng trắng đầu/cuối).	Thể hiện thông tin ghi chú.
2	Tải lên hồ sơ năng lực
2.1	Nút Nhấn hoặc thả để tải lên	Nút (Upload button)	Không bắt buộc	Chức năng đính kèm tài liệu chung của hệ thống	Thể hiện nút để chọn hoặc kéo thả tệp tải lên.
3	Nút Áp dụng	Nút chức năng (Button)	Không bắt buộc	1. Trường hợp 1: Tích hợp thành công 1.1. Điều kiện: - Tab Thông tin chung: Tất cả trường bắt buộc được nhập đầy đủ nhập hợp lệ - Tab Người liên hệ: NCC Hoạt động: Có ≥ 1 người liên hệ, dữ liệu hợp lệ NCC Không hoạt động: Không bắt buộc người liên hệ 1.2. Hành vi hệ thống khi nhấn nút “Áp dụng”: 1.2.1. Màn hình Nhà cung cấp - BPM gọi API gửi thông tin nhà cung cấp sang SAP - Hệ thống hiển thị thông báo (toast) thành công: Tiêu đề: Thành công Nội dung: Đồng bộ thông tin nhà cung cấp sang SAP thành công 1.2.2. Màn hình Tích hợp SAP - Tab nhà cung cấp - Hiển thị bản ghi tích hợp với các thông tin: STT: Bản ghi tích hợp mới nhất hiển thị STT = 1, các bản ghi cũ tăng dần (2, 3, …) Thời gian bắt đầu: Thời điểm BPM bắt đầu gọi API gửi dữ liệu sang SAP Thời gian kết thúc: Thời điểm nhận được phản hồi từ SAP (thành công) Người đồng bộ: Người dùng thực hiện điền thông tin thêm mới nhà cung cấp và nhấn nút “Áp dụng” 2. Trường hợp 2: Tích hợp thất bại 2.1. Điều kiện: - Tab Thông tin chung: Tất cả trường bắt buộc được nhập đầy đủ nhập hợp lệ - Tab Người liên hệ: NCC Hoạt động: Có ≥ 1 người liên hệ, dữ liệu hợp lệ NCC Không hoạt động: Không bắt buộc người liên hệ - SAP trả về lỗi / API lỗi / timeout 2.2. Hành vi hệ thống khi nhấn nút “Áp dụng”: 2.2.1. Màn hình Nhà cung cấp BPM gọi API gửi thông tin nhà cung cấp sang SAP Hệ thống hiển thị thông báo (toast) thất bại: Tiêu đề: Thất bại Nội dung: Đồng bộ thông tin nhà cung cấp sang SAP thất bại Hiển thị mã lỗi tại cột Mã lỗi màn hình Tích hợp SAP - Nhà cung cấp: 4305 - User Story -BPM về SAP- Đồng bộ thông tin nhà thầu 2.2.2. Màn hình Tích hợp SAP - Tab nhà cung cấp - Hiển thị bản ghi tích hợp với các thông tin: STT: Bản ghi tích hợp mới nhất hiển thị STT = 1, các bản ghi cũ tăng dần (2, 3, …) Thời gian bắt đầu: Thời điểm BPM bắt đầu gọi API gửi dữ liệu sang SAP Thời gian kết thúc: Thời điểm nhận được phản hồi từ SAP (thất bại) Người đồng bộ: Người dùng thực hiện điền thông tin thêm mới nhà cung cấp và nhấn nút “Áp dụng” Danh sách mã lỗi: Tham chiếu mục 3.4.4. Danh sách mã lỗi 3. Trường hợp 3: Dữ liệu không hợp lệ 3.1. Điều kiện: - Tab Thông tin chung: Có ≥ 1 trường bắt buộc chưa nhập / nhập sai định dạng hoặc - Tab Người liên hệ: Tab Trạng thái hoạt động ở trạng thái Bật/Active: Không có người liên hệ / sai định dạng → “Cần có ít nhất 1 người liên hệ” Tab Trạng thái hoạt động ở trạng thái Tắt/Inactive: Không bắt buộc, nếu có nhập → kiểm tra hợp lệ (inline validation) 3.2. Hành vi hệ thống khi nhấn nút “Áp dụng”: 3.2.1. Màn hình Thêm mới nhà cung cấp - Tab thông tin chung - Hệ thống KHÔNG gọi API sang SAP - Hệ thống thực hiện kiểm tra hợp lệ dữ liệu (inline validation) và hiển thị đồng thời lỗi tại các trường: Trường bắt buộc chưa nhập: “Chưa điền thông tin trường bắt buộc” Sai định dạng email: “Email chưa hợp lệ” Sai định dạng số điện thoại: “Số điện thoại không hợp lệ” Sai định dạng mã số thuế: “Mã số thuế không hợp lệ” Vượt quá độ dài cho phép: “Không được vượt quá [x] ký tự” Tab Người liên hệ không có dữ liệu: Thông báo lỗi: Tiêu đề: Không thành công Nội dung: Cần có ít nhất 1 người liên hệ” 3.2.2. Màn hình Thêm mới nhà cung cấp - Tab Người liên hệ Trường bắt buộc chưa nhập: “Chưa điền thông tin trường bắt buộc” 3.2.2. Màn hình Tích hợp SAP - Tab nhà cung cấp - Tạo bản ghi tích hợp mới ở trạng thái: Thất bại	Thể hiện nút chức năng cho phép áp dụng thông tin thêm mới cho cả 2 loại nhà cung cấp: Loại nhà cung cấp = 1 (Cá nhân/Person). Loại nhà cung cấp = 2 (Công ty/Company).
4	Nút Hủy	Nút chức năng (Button)	Không bắt buộc	Cho phép người dùng nhấn để thoát khỏi màn hình pop-up Thêm mới nhà cung cấp	Thể hiện nút chức năng cho phép thoát khỏi màn hình pop-up Thêm mới nhà cung cấp
5	Nút X	Nút (Icon)	Không bắt buộc	Cho phép người dùng nhấn để hủy thao tác Thêm mới nhà cung cấp	Thể hiện nút chức năng cho phép hủy thao tác Thêm mới nhà cung cấp

3.4.5. Màn hình pop-up Xem chi tiết nhà cung cấp

3.4.6. Màn hình pop-up Chỉnh sửa nhà cung cấp

3.4.5. Bổ sung 2 trường khi xuất file excel trên màn hình danh sách nhà cung cấp

Trường/ Nút chức năng

Kiểu dữ liệu

Điều kiện

Quy định

Mô tả

1

Nút "Áp dụng"

Nút chức năng (Button)

Bắt buộc

- Cho phép người dùng nhấn để thực hiện quá trình xuất tệp dữ liệu nhà cung cấp
- Khi nhấn nút, hành vi hệ thống như sau:

Hành vi 1: kiểm tra việc người dùng đã hoàn thành chọn kiểu xuất File.
Hành vi 2: tiến hành xuất và tải file Excel chứa tệp dữ liệu excel đã chọn về máy tính.
Hành vi 3: Thể hiện thông báo (toast) thành công:
- Tiêu đề thông báo: Thành công
- Nội dung thông báo: Xuất dữ liệu thành công

- Thông tin tệp dữ liệu được xuất ra:

Tên tệp: DanhSachNhaCungCap_ddmmyyyy
Mẫu tệp dữ liệu: DanhSachNhaCungCap-19012026.xlsx

Thể hiện nút chức năng cho phép xuất tệp dữ liệu excel hợp đồng.

Mẫu file:

BPM1- số hóa khối vận hành > 3325 - User Story - Bổ sung quản lý thông tin chung của NCC (Danh sách nhà cung cấp/Danh mục NCC) > image-2026-1-19_15-15-28.png

Bổ sung 2 trường thông tin sau:

	Trường/ Nút chức năng	Mô tả
1	Lĩnh vực chính	Dữ liệu được lấy từ trường loại "lĩnh vực chính" của nhà cung cấp
2	Xếp hạng đánh giá	Dữ liệu được lấy từ trường "xếp hạng đánh giá"

3.4.6. Bổ sung màn hình Cập nhật trường "Số tài khoản" tại 2442 - User Story - Nhân viên kế hoạch - tổng hợp soạn thảo hợp đồng

Trường/ Nút chức năng

Kiểu dữ liệu

Điều kiện

Quy định

Mô tả

1

Số tài khoản-Ngân hàng

Lựa chọn (Select)

Bắt buộc

Cho phép chỉnh sửa dữ liệu
Hệ thống ưu tiên lấy số tài khoản trạng thái "mặc định"

Hiển thị thông tin "số tài khoản - tên ngân hàng" của nhà cung cấp

Dữ liệu được lấy từ trường "Số tài khoản" - "tên ngân hàng" từ thông tin chung NCC us 3325 - User Story - Mục Nhà cung cấp (Danh sách nhà cung cấp/Danh mục NCC)