4667 - User Story - Cập nhật thông tin chung NCC phục vụ tích hợp SAP

	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
Họ và tên	Vũ Thị Mơ	Nguyễn Đức Trung
Tài khoản email/MS team	anhbn4	trungnd3
Tài khoản email/MS team	movt2	trungnd3
Chức danh	Business Analyst (BA)	Product Owner (P.O)
Chức danh	Business (BA BIZ)	Product Owner (P.O)
Ngày soạn thảo	14 Jan 2026
Ngày soạn thảo	05 Mar 2026
Jira Link	BPMKVH-3325] Bổ sung quản lý thông tin chung của nhà cung cấp, nhà thầu - Jira [BPMKVH-4667] Tích hợp SAP - Cập nhật thông tin chung NCC phục vụ tích hợp SAP - 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 để phục vụ tích hợp thông tin sang SAP

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

Tôi muốn Tạo mới/Sửa/Xem chi tiết được thông tin nhà cung cấp nhà thầu bổ sung các thông tin sau:
1. Nhóm nhà cung cấp: Chọn trong list lấy từ danh mục dùng chung
  1. N001 BP nước ngoài
  2. N002 BP trong nước
  3. N003 BP NB TNG TN
  4. N004 BP NB TNG NN
  5. N005 BP NB TNR TN
  6. N006 BP NB TNR NN
  7. N007 BP vãng lai
  8. N008 BP NB/ NG
  9. N009 BP khác
  10. N010 Nhóm ngân hàng
  11. N011 Nhóm CBNV
  12. N012 Nhóm nhà PP
  13. N008 BP NB/ NG
2. Qúy danh - Title:
  1. Trường hợp Cá nhân: Cho phép chọn Ông/Bà
  2. Trường hợp Tổ chức: Mặc định Company
3. Tên rút gọn nhà cung cấp (Chỉ áp dụng cho loại nhà cung cấp Tổ chức): Nhập thông tin
4. Mã NCC tại SAP: Lấy thông tin mã nhà cung cấp tại SAP trả về sau khi tích hợp thành công
5. Quốc gia: Cho phép chọn thông tin quốc gia tại danh mục dùng chung
Tôi muốn khi thực hiện tạo mới thông tin nhà cung cấp nhà thầu cập nhật thông tin sang hệ thống SAP
Tôi muốn khi chỉnh sửa thông tin nhà cung cấp nhà thầu các trường thông tin cần cập nhật sang SAP thì sẽ cập nhật thông tin tích hợp sang SAP
Tôi muốn khi thực hiện lưu thông tin sẽ gọi API tích hợp SAP, trường hợp tích hợp thất bại không cho lưu thông tin tại BPM và thực hiện lại thao tác lưu để tích hợp thông tin.
Trả lỗi tích hợp trên giao diện khi lưu thông tin

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

3.1 UIUX:

3.2 Luồng:

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

API Spec Document

Method		URL

1. Headers

STT	Field	Source Data Type / Length	Description	Sample Values

2. Body

STT	Path	Field	Data Type / Length	Description	Note	Sample Values

3. Response / Incoming Data Specification

STT	Field	Data Type / Length	Description	Note	Sample Values

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

3.4.1 Màn hình 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

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àn hình pop-up Thêm mới nhà cung cấp được mở, tại tab Thông tin chung, trường Trạng thái hoạt động mặc định ở trạng thái Bật. - Cho phép người dùng nhấn để bật/tắt công tắc 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. Trạng thái bật (Inactive/Off): Hệ thống ghi nhận Nhà cung cấp ngừng hoạt độ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.
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)	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). - 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 rút gọn*	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.1.1	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.1.2	Mã số thuế*	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 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ệ: Tất cả trường bắt buộc được nhập đầy đủ nhập hợp lệ Có ≥ 1 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ệ: Tất cả trường bắt buộc được nhập đầy đủ nhập hợp lệ Có ≥ 1 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 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ệ: Thiếu trường bắt buộc / nhập sai định dạng Không có Người liên hệ 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 - 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: Khi người dùng nhấn nút “Áp dụng” tại màn hình Thêm mới nhà cung cấp: Hiển thị thông báo lỗi: “Cần có ít nhất 1 người liên hệ” Vị trí hiển thị: Hiển thị tại tab Thông tin chung (toast) Đồng thời hiển thị tại tab Người liên hệ (toast) - Không hiển thị toast thành công/thất bại 3.2.2. Màn hình Tích hợp SAP - Tab nhà cung cấp - KHÔNG tạo bản ghi tích hợp mớ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).

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)	Không 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ệ: Tất cả trường bắt buộc được nhập đầy đủ nhập hợp lệ Có ≥ 1 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ệ: Tất cả trường bắt buộc được nhập đầy đủ nhập hợp lệ Có ≥ 1 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 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ệ: Thiếu trường bắt buộc / nhập sai định dạng Không có Người liên hệ 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 - 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: Khi người dùng nhấn nút “Áp dụng” tại màn hình Thêm mới nhà cung cấp: Hiển thị thông báo lỗi: “Cần có ít nhất 1 người liên hệ” Vị trí hiển thị: Hiển thị tại tab Thông tin chung (toast) Đồng thời hiển thị tại tab Người liên hệ (toast) - Không hiển thị toast thành công/thất bại 3.2.2. Màn hình Tích hợp SAP - Tab nhà cung cấp - KHÔNG tạo bản ghi tích hợp mớ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ệ: Tất cả trường bắt buộc được nhập đầy đủ nhập hợp lệ Có ≥ 1 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ệ: Tất cả trường bắt buộc được nhập đầy đủ nhập hợp lệ Có ≥ 1 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 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ệ: Thiếu trường bắt buộc / nhập sai định dạng Không có Người liên hệ 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 - 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: Khi người dùng nhấn nút “Áp dụng” tại màn hình Thêm mới nhà cung cấp: Hiển thị thông báo lỗi: “Cần có ít nhất 1 người liên hệ” Vị trí hiển thị: Hiển thị tại tab Thông tin chung (toast) Đồng thời hiển thị tại tab Người liên hệ (toast) - Không hiển thị toast thành công/thất bại 3.2.2. Màn hình Tích hợp SAP - Tab nhà cung cấp - KHÔNG tạo bản ghi tích hợp mớ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.2. Màn hình Xem chi tiết nhà cung cấp

3.4.2.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

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	Không cho phép thêm/sửa/xóa dữ liệu	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	Không cho phép thêm/sửa/xóa dữ liệu	Thể hiện công tắc để thiết lập trạng thái hoạt động của nhà cung cấp.
3	Nhóm nhà cung cấp	Lựa chọn (Select)	Bắt buộc	Không cho phép thêm/sửa/xóa dữ liệu	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	Không cho phép thêm/sửa/xóa dữ liệu	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	Không cho phép thêm/sửa/xóa dữ liệu	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	Không cho phép thêm/sửa/xóa dữ liệu	- 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	Không cho phép thêm/sửa/xóa dữ liệu	- 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	Không cho phép thêm/sửa/xóa dữ liệu	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)	Không bắt buộc	Không cho phép thêm/sửa/xóa dữ liệu.	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	Không cho phép thêm/sửa/xóa dữ liệu	Thể hiện nhóm trường nhập liệu để khai báo Tên nhà cung cấp (Tổ chức). Bao gồm các trường con: Tên 1, Tên 2, Tên 3, Tên 4 khi loại nhà cung cấp = 2 (Công ty/Company).
4.2.1.1	Tên pháp lý (phần 1)*	Văn bản (Text)	Bắt buộc	- Không cho phép thêm/sửa/xóa dữ liệu - Khi di chuột (hover) vào trường, hệ thống hiển thị ghi chú hướng dẫn nhập liệu(tooltip): Nội dung hướng dẫn: “Nhập tên đầy đủ của nhà cung cấp. Trường hợp tên dài, có thể tách và nhập tiếp ở các dòng bên dưới.”	Thể hiện trường nhập liệu tên pháp lý rút gọn của nhà cung cấp.
4.2.1.2	Tên pháp lý (phần 2)*	Văn bản (Text)	Bắt buộc	-Không cho phép thêm/sửa/xóa dữ liệu - Khi di chuột (hover) vào trường, hệ thống hiển thị ghi chú hướng dẫn nhập liệu(tooltip): Nội dung hướng dẫn: “Nhập tiếp phần tên còn lại tại đây nếu vượt quá giới hạn trường trước”	Thể hiện trường nhập liệu của tên pháp lý nhà cung cấp khi tên pháp lý (phần 1)* vượt quá kí tự
4.2.1.3	Tên pháp lý (phần 3)*	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 - Khi di chuột (hover) vào trường, hệ thống hiển thị ghi chú hướng dẫn nhập liệu(tooltip): Nội dung hướng dẫn: “Nhập tiếp phần tên còn lại tại đây nếu vượt quá giới hạn trường trước”	Thể hiện trường nhập liệu của tên pháp lý nhà cung cấp khi tên pháp lý (phần 3)* vượt quá kí tự
4.2.1.4	Tên pháp lý (phần 4)*	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 - Khi di chuột (hover) vào trường, hệ thống hiển thị ghi chú hướng dẫn nhập liệu(tooltip): Nội dung hướng dẫn: “Nhập tiếp phần tên còn lại tại đây nếu vượt quá giới hạn trường trước”	Thể hiện trường nhập liệu của tên pháp lý nhà cung cấp khi tên pháp lý (phần 4)* vượt quá kí tự
4.2.1.5	Qúy danh	Lựa chọn (Select)	Không bắt buộc	Không cho phép thêm/sửa/xóa dữ liệu	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.1.1.6	Mã số thuế*	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 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	Không cho phép thêm/sửa/xóa dữ liệu	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	Không cho phép thêm/sửa/xóa dữ liệu	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	Không cho phép thêm/sửa/xóa dữ liệu	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	Không cho phép thêm/sửa/xóa dữ liệu	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	Không cho phép thêm/sửa/xóa dữ liệu	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	Không cho phép thêm/sửa/xóa dữ liệu	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	Không cho phép thêm/sửa/xóa dữ liệu	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	Không cho phép thêm/sửa/xóa dữ liệu	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	Không cho phép thêm/sửa/xóa dữ liệu	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	Không cho phép thêm/sửa/xóa dữ liệu	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	Không cho phép thêm/sửa/xóa dữ liệu	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	Không cho phép thêm/sửa/xóa dữ liệu	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	Không cho phép thêm/sửa/xóa dữ liệu	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	Không cho phép thêm/sửa/xóa dữ liệu	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	Không cho phép thêm/sửa/xóa dữ liệu	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	Không cho phép thêm/sửa/xóa dữ liệu	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	Không cho phép thêm/sửa/xóa dữ liệu	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	Không cho phép thêm/sửa/xóa dữ liệu	Thể hiện nút chức năng cho phép áp dụng thông tin thêm mới nhà cung cấp được khai báo

3.4.2.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	Không cho phép thêm/sửa/xóa dữ liệu	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	Không cho phép thêm/sửa/xóa dữ liệu	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	Không cho phép thêm/sửa/xóa dữ liệu	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)	Không bắt buộc	Không cho phép thêm/sửa/xóa dữ liệu	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	Không cho phép thêm/sửa/xóa dữ liệu	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	Không cho phép thêm/sửa/xóa dữ liệu	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	Không cho phép thêm/sửa/xóa dữ liệu	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	Không cho phép thêm/sửa/xóa dữ liệu	Thể hiện nút chức năng cho phép áp dụng thông tin thêm mới 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).
9	Nút Hủy	Nút chức năng (Button)	Không bắt buộc	Không cho phép thêm/sửa/xóa dữ liệu	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.2.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	Không cho phép thêm/sửa/xóa dữ liệu	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	Không cho phép thêm/sửa/xóa dữ liệu	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	Không cho phép thêm/sửa/xóa dữ liệu	Thể hiện nút chức năng cho phép áp dụng thông tin thêm mới hồ sơ năng lực được 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).
4	Nút Hủy	Nút chức năng (Button)	Không bắt buộc	Không cho phép thêm/sửa/xóa dữ liệu	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	Không cho phép thêm/sửa/xóa dữ liệu	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.3. Màn hình Chỉnh sửa nhà cung cấp

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 chỉnh sửa

3.4.3.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

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	- Hệ thống hiển thị sẵn trạng thái đã khai báo trước đó Người dùng có thể chỉnh sửa hoặc giữ nguyên giá trị hiện có. Trường hợp không thay đổi thông tin, hệ thống vẫn ghi nhận giá trị cũ khi lưu dữ liệu.	Thể hiện công tắc để cho phép chỉnh sửa trạng thái hoạt động của nhà cung cấp.
3	Nhóm nhà cung cấp	Lựa chọn (Select)	Bắt buộc	- Hệ thống hiển thị sẵn giá trị đã khai báo trước đó tại trường Người dùng có thể chỉnh sửa hoặc giữ nguyên giá trị hiện có. Trường hợp không thay đổi thông tin, hệ thống vẫn ghi nhận giá trị cũ khi lưu dữ liệu - 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	- Hệ thống hiển thị sẵn giá trị đã khai báo trước đó tại trường Người dùng có thể chỉnh sửa hoặc giữ nguyên giá trị hiện có. Trường hợp không thay đổi thông tin, hệ thống vẫn ghi nhận giá trị cũ khi lưu dữ liệu - 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 chỉnh sửa 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 cho phép chỉnh sửa 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	- Hệ thống hiển thị sẵn giá trị đã khai báo trước đó tại trường Họ và cho phép chỉnh sửa: Người dùng có thể chỉnh sửa hoặc giữ nguyên giá trị hiện có. 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 hợp không thay đổi thông tin, hệ thống vẫn ghi nhận giá trị cũ khi lưu dữ liệu. - 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	- Hệ thống hiển thị sẵn giá trị đã khai báo trước đó tại trường Tên và Tên đệm và cho phép chỉnh sửa: Người dùng có thể chỉnh sửa hoặc giữ nguyên giá trị hiện có. 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 hợp không thay đổi thông tin, hệ thống vẫn ghi nhận giá trị cũ khi lưu dữ liệu. - 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	- Hệ thống hiển thị sẵn giá trị đã khai báo trước đó tại trường Người dùng có thể chỉnh sửa hoặc giữ nguyên giá trị hiện có. Trường hợp không thay đổi thông tin, hệ thống vẫn ghi nhận giá trị cũ khi lưu dữ liệu - 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)	Không bắt buộc	- Hệ thống hiển thị sẵn giá trị đã khai báo trước đó tại trường Người dùng có thể chỉnh sửa hoặc giữ nguyên giá trị hiện có. 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 hợp không thay đổi thông tin, hệ thống vẫn ghi nhận giá trị cũ khi lưu dữ liệu - 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 chỉnh sửa tên nhà cung cấp gồm 04 thành phần: Tên pháp lý (phần 1): Tham chiếu STT 4.2.1.1 Tên pháp lý (phần 2): Tham chiếu STT 4.2.1.2 Tên pháp lý (phần 3: Tham chiếu STT 4.2.1.3 Tên pháp lý (phần 4): Tham chiếu STT 4.2.1.4 - 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 liệu để khai báo Tên nhà cung cấp (Tổ chức). Bao gồm các trường con: Tên 1, Tên 2, Tên 3, Tên 4 khi loại nhà cung cấp = 2 (Công ty/Company).
4.2.1.1	Tên pháp lý (phần 1)*	Văn bản (Text)	Bắt buộc	- Hệ thống hiển thị sẵn giá trị đã khai báo trước đó tại trường Tên và Tên đệm và cho phép chỉnh sửa: Người dùng có thể chỉnh sửa hoặc giữ nguyên giá trị hiện có. 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 hợp không thay đổi thông tin, hệ thống vẫn ghi nhận giá trị cũ khi lưu dữ liệu. - Khi di chuột (hover) vào trường, hệ thống hiển thị ghi chú hướng dẫn nhập liệu(tooltip): Nội dung hướng dẫn: “Nhập tên đầy đủ của nhà cung cấp. Trường hợp tên dài, có thể tách và nhập tiếp ở các dòng bên dưới.” - Dữ liệu: Khi tích hợp sang hệ thống SAP, dữ liệu được ánh xạ (mapping) sang trường Name1 trên hệ thống SAP. Độ dài kí tự: 40	Thể hiện trường nhập liệu tên pháp lý rút gọn của nhà cung cấp.
4.2.1.2	Tên pháp lý (phần 2)*	Văn bản (Text)	Bắt buộc	- Hệ thống hiển thị sẵn giá trị đã khai báo trước đó tại trường Tên và Tên đệm và cho phép chỉnh sửa: Người dùng có thể chỉnh sửa hoặc giữ nguyên giá trị hiện có. 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 hợp không thay đổi thông tin, hệ thống vẫn ghi nhận giá trị cũ khi lưu dữ liệu. - Khi di chuột (hover) vào trường, hệ thống hiển thị ghi chú hướng dẫn nhập liệu(tooltip): Nội dung hướng dẫn: “Nhập tiếp phần tên còn lại tại đây nếu vượt quá giới hạn trường trước” - Dữ liệu: Khi tích hợp sang hệ thống SAP, dữ liệu được ánh xạ (mapping) sang trường Name2 trên hệ thống SAP. Độ dài kí tự: 40	Thể hiện trường nhập liệu của tên pháp lý nhà cung cấp khi tên pháp lý (phần 1)* vượt quá kí tự
4.2.1.3	Tên pháp lý (phần 3)*	Văn bản (Text)	Không bắt buộc	- Hệ thống hiển thị sẵn giá trị đã khai báo trước đó tại trường Tên và Tên đệm và cho phép chỉnh sửa: Người dùng có thể chỉnh sửa hoặc giữ nguyên giá trị hiện có. 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 hợp không thay đổi thông tin, hệ thống vẫn ghi nhận giá trị cũ khi lưu dữ liệu. - Khi di chuột (hover) vào trường, hệ thống hiển thị ghi chú hướng dẫn nhập liệu(tooltip): Nội dung hướng dẫn: “Nhập tiếp phần tên còn lại tại đây nếu vượt quá giới hạn trường trước” - Dữ liệu: Khi tích hợp sang hệ thống SAP, dữ liệu được ánh xạ (mapping) sang trường Name3 trên hệ thống SAP. Độ dài kí tự: 40	Thể hiện trường nhập liệu của tên pháp lý nhà cung cấp khi tên pháp lý (phần 3)* vượt quá kí tự
4.2.1.4	Tên pháp lý (phần 4)*	Văn bản (Text)	Không bắt buộc	- Hệ thống hiển thị sẵn giá trị đã khai báo trước đó tại trường Tên và Tên đệm và cho phép chỉnh sửa: Người dùng có thể chỉnh sửa hoặc giữ nguyên giá trị hiện có. 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 hợp không thay đổi thông tin, hệ thống vẫn ghi nhận giá trị cũ khi lưu dữ liệu. - Khi di chuột (hover) vào trường, hệ thống hiển thị ghi chú hướng dẫn nhập liệu(tooltip): Nội dung hướng dẫn: “Nhập tiếp phần tên còn lại tại đây nếu vượt quá giới hạn trường trước” - Dữ liệu: Khi tích hợp sang hệ thống SAP, dữ liệu được ánh xạ (mapping) sang trường Name4 trên hệ thống SAP. Độ dài kí tự: 40	Thể hiện trường nhập liệu của tên pháp lý nhà cung cấp khi tên pháp lý (phần 4)* vượt quá kí tự
4.2.1.5	Qúy danh	Lựa chọn (Select)	Không bắt buộc	- Hệ thống hiển thị sẵn giá trị đã khai báo trước đó tại trường Tên và Tên đệm và cho phép chỉnh sửa: Người dùng có thể chỉnh sửa hoặc giữ nguyên giá trị hiện có. Trường hợp không thay đổi thông tin, hệ thống vẫn ghi nhận giá trị cũ khi lưu dữ liệu. - 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.1.1.6	Mã số thuế*	Văn bản (Text)	Không bắt buộc	- Hệ thống hiển thị sẵn giá trị đã khai báo trước đó tại trường Tên và Tên đệm và cho phép chỉnh sửa: Người dùng có thể chỉnh sửa hoặc giữ nguyên giá trị hiện có. Trường hợp không thay đổi thông tin, hệ thống vẫn ghi nhận giá trị cũ khi lưu dữ liệu.	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	- Hệ thống hiển thị sẵn giá trị đã khai báo trước đó tại trường Tên và Tên đệm và cho phép chỉnh sửa: Người dùng có thể chỉnh sửa hoặc giữ nguyên giá trị hiện có. Trường hợp không thay đổi thông tin, hệ thống vẫn ghi nhận giá trị cũ khi lưu dữ liệu. - 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	- Hệ thống hiển thị sẵn giá trị đã khai báo trước đó tại trường Tên và Tên đệm và cho phép chỉnh sửa: Người dùng có thể chỉnh sửa hoặc giữ nguyên giá trị hiện có. Trường hợp không thay đổi thông tin, hệ thống vẫn ghi nhận giá trị cũ khi lưu dữ liệu. - 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	- Hệ thống hiển thị sẵn giá trị đã khai báo trước đó tại trường Tên và Tên đệm và cho phép chỉnh sửa: Người dùng có thể chỉnh sửa hoặc giữ nguyên giá trị hiện có. Trường hợp không thay đổi thông tin, hệ thống vẫn ghi nhận giá trị cũ khi lưu dữ liệu. - 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	- Hệ thống hiển thị sẵn giá trị đã khai báo trước đó tại trường Tên và Tên đệm và cho phép chỉnh sửa: Người dùng có thể chỉnh sửa hoặc giữ nguyên giá trị hiện có. 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 hợp không thay đổi thông tin, hệ thống vẫn ghi nhận giá trị cũ khi lưu dữ liệu. - 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	- Hệ thống hiển thị sẵn giá trị đã khai báo trước đó tại trường Tên và Tên đệm và cho phép chỉnh sửa: Người dùng có thể chỉnh sửa hoặc giữ nguyên giá trị hiện có. 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 hợp không thay đổi thông tin, hệ thống vẫn ghi nhận giá trị cũ khi lưu dữ liệu. - 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	- Hệ thống hiển thị sẵn giá trị đã khai báo trước đó tại trường Tên và Tên đệm và cho phép chỉnh sửa: Người dùng có thể chỉnh sửa hoặc giữ nguyên giá trị hiện có. Trường hợp không thay đổi thông tin, hệ thống vẫn ghi nhận giá trị cũ khi lưu dữ liệu. - 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	- Hệ thống hiển thị sẵn giá trị đã khai báo trước đó tại trường Tên và Tên đệm và cho phép chỉnh sửa: Người dùng có thể chỉnh sửa hoặc giữ nguyên giá trị hiện có. Trường hợp không thay đổi thông tin, hệ thống vẫn ghi nhận giá trị cũ khi lưu dữ liệu. - 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	- Hệ thống hiển thị sẵn giá trị đã khai báo trước đó tại trường Tên và Tên đệm và cho phép chỉnh sửa: Người dùng có thể chỉnh sửa hoặc giữ nguyên giá trị hiện có. Trường hợp không thay đổi thông tin, hệ thống vẫn ghi nhận giá trị cũ khi lưu dữ liệu. - 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	- Hệ thống hiển thị sẵn giá trị đã khai báo trước đó tại trường Tên và Tên đệm và cho phép chỉnh sửa: Người dùng có thể chỉnh sửa hoặc giữ nguyên giá trị hiện có. Trường hợp không thay đổi thông tin, hệ thống vẫn ghi nhận giá trị cũ khi lưu dữ liệu. - 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	Hệ thống hiển thị sẵn giá trị đã khai báo trước đó tại trường Tên và Tên đệm và cho phép chỉnh sửa: Người dùng có thể chỉnh sửa hoặc giữ nguyên giá trị hiện có. 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 hợp không thay đổi thông tin, hệ thống vẫn ghi nhận giá trị cũ khi lưu dữ liệu.	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	Hệ thống hiển thị sẵn giá trị đã khai báo trước đó tại trường Tên và Tên đệm và cho phép chỉnh sửa: Người dùng có thể chỉnh sửa hoặc giữ nguyên giá trị hiện có. 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 hợp không thay đổi thông tin, hệ thống vẫn ghi nhận giá trị cũ khi lưu dữ liệu.	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	Hệ thống hiển thị sẵn giá trị đã khai báo trước đó tại trường Tên và Tên đệm và cho phép chỉnh sửa: Người dùng có thể chỉnh sửa hoặc giữ nguyên giá trị hiện có. 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 hợp không thay đổi thông tin, hệ thống vẫn ghi nhận giá trị cũ khi lưu dữ liệu.	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	Hệ thống hiển thị sẵn giá trị đã khai báo trước đó tại trường Tên và Tên đệm và cho phép chỉnh sửa: Người dùng có thể chỉnh sửa hoặc giữ nguyên giá trị hiện có. 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 hợp không thay đổi thông tin, hệ thống vẫn ghi nhận giá trị cũ khi lưu dữ liệu.	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ệ: Tất cả trường bắt buộc được nhập đầy đủ nhập hợp lệ Có ≥ 1 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ệ: Tất cả trường bắt buộc được nhập đầy đủ nhập hợp lệ Có ≥ 1 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 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ệ: Thiếu trường bắt buộc / nhập sai định dạng Không có Người liên hệ 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 - 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: Khi người dùng nhấn nút “Áp dụng” tại màn hình Thêm mới nhà cung cấp: Hiển thị thông báo lỗi: “Cần có ít nhất 1 người liên hệ” Vị trí hiển thị: Hiển thị tại tab Thông tin chung (toast) Đồng thời hiển thị tại tab Người liên hệ (toast) - Không hiển thị toast thành công/thất bại 3.2.2. Màn hình Tích hợp SAP - Tab nhà cung cấp - KHÔNG tạo bản ghi tích hợp mớ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).

3.4.3.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	Hệ thống hiển thị sẵn giá trị đã khai báo trước đó tại trường Tên và Tên đệm và cho phép chỉnh sửa: Người dùng có thể chỉnh sửa hoặc giữ nguyên giá trị hiện có. 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 hợp không thay đổi thông tin, hệ thống vẫn ghi nhận giá trị cũ khi lưu dữ liệu.	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	Hệ thống hiển thị sẵn giá trị đã khai báo trước đó tại trường Tên và Tên đệm và cho phép chỉnh sửa: Người dùng có thể chỉnh sửa hoặc giữ nguyên giá trị hiện có. 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 hợp không thay đổi thông tin, hệ thống vẫn ghi nhận giá trị cũ khi lưu dữ liệu. - 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	Hệ thống hiển thị sẵn giá trị đã khai báo trước đó tại trường Tên và Tên đệm và cho phép chỉnh sửa: Người dùng có thể chỉnh sửa hoặc giữ nguyên giá trị hiện có. 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 hợp không thay đổi thông tin, hệ thống vẫn ghi nhận giá trị cũ khi lưu dữ liệu.	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)	Không bắt buộc	Hệ thống hiển thị sẵn giá trị đã khai báo trước đó tại trường Tên và Tên đệm và cho phép chỉnh sửa: Người dùng có thể chỉnh sửa hoặc giữ nguyên giá trị hiện có. Trường hợp không thay đổi thông tin, hệ thống vẫn ghi nhận giá trị cũ khi lưu dữ liệu. - 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ệ: Tất cả trường bắt buộc được nhập đầy đủ nhập hợp lệ Có ≥ 1 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ệ: Tất cả trường bắt buộc được nhập đầy đủ nhập hợp lệ Có ≥ 1 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 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ệ: Thiếu trường bắt buộc / nhập sai định dạng Không có Người liên hệ 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 - 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: Khi người dùng nhấn nút “Áp dụng” tại màn hình Thêm mới nhà cung cấp: Hiển thị thông báo lỗi: “Cần có ít nhất 1 người liên hệ” Vị trí hiển thị: Hiển thị tại tab Thông tin chung (toast) Đồng thời hiển thị tại tab Người liên hệ (toast) - Không hiển thị toast thành công/thất bại 3.2.2. Màn hình Tích hợp SAP - Tab nhà cung cấp - KHÔNG tạo bản ghi tích hợp mớ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.3.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.3.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	Hệ thống hiển thị sẵn giá trị đã khai báo trước đó tại trường Tên và Tên đệm và cho phép chỉnh sửa: Người dùng có thể chỉnh sửa hoặc giữ nguyên giá trị hiện có. 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 hợp không thay đổi thông tin, hệ thống vẫn ghi nhận giá trị cũ khi lưu dữ liệu.	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ệ: Tất cả trường bắt buộc được nhập đầy đủ nhập hợp lệ Có ≥ 1 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ệ: Tất cả trường bắt buộc được nhập đầy đủ nhập hợp lệ Có ≥ 1 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 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ệ: Thiếu trường bắt buộc / nhập sai định dạng Không có Người liên hệ 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 - 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: Khi người dùng nhấn nút “Áp dụng” tại màn hình Thêm mới nhà cung cấp: Hiển thị thông báo lỗi: “Cần có ít nhất 1 người liên hệ” Vị trí hiển thị: Hiển thị tại tab Thông tin chung (toast) Đồng thời hiển thị tại tab Người liên hệ (toast) - Không hiển thị toast thành công/thất bại 3.2.2. Màn hình Tích hợp SAP - Tab nhà cung cấp - KHÔNG tạo bản ghi tích hợp mớ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.4. Danh sách mã lỗi

STT	Phân loại lỗi	Mã lỗi (HTTP/Code)	Status	Thông báo lỗi (Message)	Hệ thống phát sinh	Diễn giải & Hướng xử lý
I	LỖI HỆ THỐNG					Liên quan đến kết nối và hạ tầng
1	Kết nối	401		Unauthorized	SAP/BMP	Sai ApiToken hoặc User/Pass tích hợp. Cần kiểm tra lại thông tin xác thực.
2	Kết nối	403		Forbidden	SAP/BMP	IP của PI/PO bị chặn bởi Firewall hoặc ACL trên Web Dispatcher.
3	Kết nối	404		Not Found	SAP/BMP	Sai URL Endpoint của API trên SAP ROX.
4	Hệ thống	500		Internal Server Error	SAP/BMP	Hệ thống đích bị treo hoặc gặp lỗi Runtime khi nhận Request.
5	Hệ thống	503		Service Unavailable	SAP/BMP	SAP ROX đang bảo trì hoặc quá tải, Web Dispatcher không thể forward request.
II	LỖI NGHIỆP VỤ					Phát sinh từ Logic xử lý của SAP ROX (Trong MT_API_OUT)
8	Dữ liệu	200	E	Chi tiết lỗi trả về	SAP	Xem chi tiết lỗi trả về
9	Dữ liệu	200	S	Message báo Tích hợp thành công, theo từng APIs	SAP	Trả thông báo thành công theo cấu trúc từng APIs

Page tree

4667 - User Story - Cập nhật thông tin chung NCC phục vụ tích hợp SAP

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

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

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

1. Headers

2. Body

3. Response / Incoming Data Specification

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

3.4.1 Màn hình Thêm mới nhà cung cấp:

3.4.1.1. Tab Thông tin chung

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

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

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

3.4.2. Màn hình Xem chi tiết nhà cung cấp

3.4.2.1. Tab Thông tin chung

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

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

3.4.3. Màn hình Chỉnh sửa nhà cung cấp

3.4.3.1. Tab Thông tin chung

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

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

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

3.4.4. Danh sách mã lỗi