Page History

Không bắt buộc

- Khi màn hình mở 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 công tắc mặc định ở trạng thái Bật .(Active/On)

- Cho phép người dùng nhấn để bật/tắt công tắc 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à

  • nhà cung cấp đang hoạt

  động.

  • độ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ệ 

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

- 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 nhà cung cấp = 1 (Cá nhân/Person).

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

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

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

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.

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

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

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

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

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

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

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

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

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

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

- 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

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

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

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

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

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

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

Cho phép người dùng nhấn để hủy thao tác Thêm mới nhà cung cấp

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.

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

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

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

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.

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

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" 

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

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

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

- 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

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

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

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

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