Versions Compared

Old Version 42

changes.mady.by.user Bùi Nguyệt Anh

Saved on

compared with

New Version 43

changes.mady.by.user Bùi Nguyệt Anh

Saved on

Key

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

...

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 địnhMô tả
1Tab Thông tin chungThẻ 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 
2Trạng thái hoạt độngCô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.
3Nhó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.
4Loạ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.1Nhánh Loại nhà cung cấp = Cá nhân
4.1.1Tê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.1Họ*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.2Tê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.3Qúy danhLự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.4Số 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.2Nhánh Loại nhà cung cấp = Tổ chức
4.2.1Tê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 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.1Qúy danhLự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.2Mã số thuế*Văn bản (Text)
Không bắt

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).
7Phườ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).
10Lĩnh vực chínhLự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).
11Lĩ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).
12Ngành nghề kinh doanh chínhLự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).
13Ngà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.1STTVă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.2Tên ngân hàngVă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.3Số tài khoảnVă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.4Tên chủ tài khoảnVă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.5Mặc địnhCô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.6Thao tácBiể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.7Nú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.

6Nú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

7Nú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

8Nú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ệ

...