Page History

Không bắt buộc

- Khi mở pop-up Thêm mới nhà cung cấp, tại tab Thông tin chung, công tắc mặc định ở trạng thái Bật (Active/On)

- Cho phép người dùng thao tác để thay đổi trạng thái hoạt động của nhà cung cấp.

• Trạng thái bật (Active/On):

  • Hệ thống ghi nhận nhà cung cấp đang hoạt động

  • Khi nhấn “Áp dụng”, hệ thống tự động kiểm tra:

    • Phải có ≥ 1 người liên hệ

    • Tất cả trường bắt buộc tại tab Người liên hệ phải được nhập đầy đủ, hợp lệ 

  • Hệ thống hiển thị thông báo (toast):

    • • • • Tiêu đề: Thành công 
          • Nội dung: Cập nhật nhà cung cấp thành công
• Trạng thái bật (Inactive/Off): Hệ thống ghi nhận Nhà cung cấp ngừng hoạt động.

  • Hệ thống ghi nhận nhà cung cấp ngừng hoạt động

  • Không bắt buộc phải có người liên hệ

  • Hệ thống hiển thị thông báo (toast):

    • • • • Tiêu đề: Thành công 
          • Nội dung: Cập nhật nhà cung cấp thành công

- 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 

• 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

- 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 

- 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”

- 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”

Không bắt buộc

• Ô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

Bắt buộc

- Cho phép người dùng nhập thông tin
- Sau khi nhập, hệ thống thực hiện:

• Ghi nhận giá trị nhập vào và thực hiện làm sạch dữ liệu (loại bỏ khoảng trắng đầu/cuối).
• Kiểm tra hợp lệ tại chỗ (Inline validate): 

• • Rỗng / chỉ khoảng trắng → “Trường này là bắt buộc”

- Khi người dùng di chuột vào (hover) tên trường, hệ thống hiển thị chú thích(tooltip) với nội dung là: Số Chứng minh thư/Căn cước công dân.

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

- Cho phép người dùng nhập thông tin
- Sau khi nhập, hệ thống ghi nhận giá trị nhập vào và thực hiện làm sạch dữ liệu (loại bỏ khoảng trắng đầu/cuối).

- Dữ liệu:

• Khi tích hợp sang hệ thống SAP, dữ liệu được ánh xạ (mapping) sang trường Tên rút gọn
• Độ dài kí tự: 40

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

Bắt buộc

- Cho phép người dùng nhập thông tin

- Cho phép người dùng nhập thông tin
- Sau khi nhập, hệ thống thực hiện:

• Ghi nhận giá trị nhập vào và thực hiện làm sạch dữ liệu (loại bỏ khoảng trắng đầu/cuối).
• Kiểm tra hợp lệ tại chỗ (Inline validate): 

• • Rỗng / chỉ khoảng trắng → “Trường này là bắt buộc”

Quốc gia*

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

Tỉnh/Thành phố 

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

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

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

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

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

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

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

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

• Loại nhà cung cấp = 1 (Cá nhân/Person).
• Loại nhà cung cấp = 2 (Công ty/Company).

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

• Loại nhà cung cấp = 1 (Cá nhân/Person).
• Loại nhà cung cấp = 2 (Công ty/Company).

Bảng Tài khoản ngân hàng

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

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

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 khoả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).

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

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.

• Loại nhà cung cấp = 1 (Cá nhân/Person).
• Loại nhà cung cấp = 2 (Công ty/Company).

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.

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.

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

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

Nút chức năng

(Button)

Không bắt buộc

1. Trường hợp 1: Tích hợp thành công

1.1. Điều kiện:

- Tab Thông tin chung: Tất cả trường bắt buộc được nhập đầy đủ nhập hợp lệ 

- Tab Người liên hệ:

• NCC Hoạt động: Có ≥ 1 người liên hệ, dữ liệu hợp lệ

• NCC Không hoạt động: Không bắt buộc người liên hệ

1.2. Hành vi hệ thống khi nhấn nút “Áp dụng”:

1.2.1. Màn hình Nhà cung cấp

- BPM gọi API gửi thông tin nhà cung cấp sang SAP

- Hệ thống hiển thị thông báo (toast) thành công:

• Tiêu đề: Thành công
• Nội dung: Đồng bộ thông tin nhà cung cấp sang SAP thành công

1.2.2. Màn hình Tích hợp SAP - Tab nhà cung cấp

- Hiển thị bản ghi tích hợp với các thông tin:

• STT: Bản ghi tích hợp mới nhất hiển thị STT = 1, các bản ghi cũ tăng dần (2, 3, …)

• Thời gian bắt đầu: Thời điểm BPM bắt đầu gọi API gửi dữ liệu sang SAP

• Thời gian kết thúc: Thời điểm nhận được phản hồi từ SAP (thành công)

• Người đồng bộ: Người dùng thực hiện điền thông tin thêm mới nhà cung cấp và nhấn nút “Áp dụng”

2. Trường hợp 2: Tích hợp thất bại

2.1. Điều kiện: 

- Tab Thông tin chung: Tất cả trường bắt buộc được nhập đầy đủ nhập hợp lệ 

- Tab  Người liên hệ:

• NCC Hoạt động: Có ≥ 1 người liên hệ, dữ liệu hợp lệ

• NCC Không hoạt động: Không bắt buộc người liên hệ

- SAP trả về lỗi / API lỗi / timeout

2.2. Hành vi hệ thống khi nhấn nút “Áp dụng”:

2.2.1. Màn hình Nhà cung cấp

• BPM gọi API gửi thông tin nhà cung cấp sang SAP

• Hệ thống hiển thị thông báo (toast) thất bại:

  • Tiêu đề: Thất bại

  • Nội dung: Đồng bộ thông tin nhà cung cấp sang SAP thất bại

• Hiển thị mã lỗi tại cột Mã lỗi màn hình Tích hợp SAP - Nhà cung cấp: 

  4305 - User Story -BPM về SAP- Đồng bộ thông tin nhà thầu

2.2.2. Màn hình Tích hợp SAP - Tab nhà cung cấp

- Hiển thị bản ghi tích hợp với các thông tin:

• STT: Bản ghi tích hợp mới nhất hiển thị STT = 1, các bản ghi cũ tăng dần (2, 3, …)

• Thời gian bắt đầu: Thời điểm BPM bắt đầu gọi API gửi dữ liệu sang SAP

• Thời gian kết thúc: Thời điểm nhận được phản hồi từ SAP (thất bại)

• Người đồng bộ: Người dùng thực hiện điền thông tin thêm mới nhà cung cấp và nhấn nút “Áp dụng”

• Danh sách mã lỗi: Tham chiếu mục 3.4.4. Danh sách mã lỗi

3. Trường hợp 3: Dữ liệu không hợp lệ

3.1. Điều kiện:

- Tab Thông tin chung: Có ≥ 1 trường bắt buộc chưa nhập / nhập sai định dạng
hoặc
- Tab Người liên hệ:

• Tab Trạng thái hoạt động ở trạng thái Bật/Active: Không có người liên hệ / sai định dạng → “Cần có ít nhất 1 người liên hệ”
• Tab Trạng thái hoạt động ở trạng thái Tắt/Inactive: Không bắt buộc, nếu có nhập → kiểm tra hợp lệ (inline validation)

3.2. Hành vi hệ thống khi nhấn nút “Áp dụng”:

3.2.1. Màn hình Thêm mới nhà cung cấp - Tab thông tin chung

- Hệ thống KHÔNG gọi API sang SAP

- Hệ thống thực hiện kiểm tra hợp lệ dữ liệu (inline validation) và hiển thị đồng thời lỗi tại các trường:

• Trường bắt buộc chưa nhập:
  “Chưa điền thông tin trường bắt buộc”

• Sai định dạng email:
  “Email chưa hợp lệ”

• Sai định dạng số điện thoại:
  “Số điện thoại không hợp lệ”

• Sai định dạng mã số thuế:
  “Mã số thuế không hợp lệ”

• Vượt quá độ dài cho phép:
  “Không được vượt quá [x] ký tự”

• Tab Người liên hệ không có dữ liệu:

  • Thông báo lỗi:
  • Tiêu đề: Không thành công
  • Nội dung: Cần có ít nhất 1 người liên hệ”

3.2.2. Màn hình Thêm mới nhà cung cấp - Tab Người liên hệ

• Trường bắt buộc chưa nhập:
  “Chưa điền thông tin trường bắt buộc”

3.2.2. Màn hình Tích hợp SAP - Tab nhà cung cấp

- Tạo bản ghi tích hợp mới ở trạng thái: Thất bại

Thể hiện nút chức năng cho phép áp dụng thông tin thêm mới cho cả 2 loại nhà cung cấp: 

• Loại nhà cung cấp = 1 (Cá nhân/Person).
• Loại nhà cung cấp = 2 (Công ty/Company).