Nghiệp vụ | IT | |||
|---|---|---|---|---|
Người lập | Người duyệt | Người lập | Người duyệt | |
Tên, Chức danh | Nguyễn Thanh Vân | Vũ Thị Mơ | ||
Ngày ký |
| |||
Jira Link | https://jira.popplife.vn/browse/BPMKVH-2322 | |||
Là admin nghiệp vụ, tôi muốn thông tin hợp đồng của các nhà cung cấp được tự động cập nhật vào hồ sơ của nhà cung cấp, nhà thầu

![]()
3.2.1. Tìm kiếm hợp đồng của NCC

3.2.2. Xuất file excel
![]()
1. Headers
2. Body
3. Response / Incoming Data Specification
|
Tại màn hình danh sách nhà cung cấp, chọn
để mở pop-up Thông tin giao dịch NCC, chọn Tab Hợp đồng (bên trái Tab Lịch sử đánh giá nhà cung cấp) để mở danh sách các hợp đồng của nhà cung cấp bao gồm các trường thông tin:
Field (Trường dữ liệu) | Type (Kiểu dữ liệu) | Required (Bắt buộc) | Validation (Quy định) | Description (Mô tả) | |
|---|---|---|---|---|---|
| 1 | STT | Số (Number) | Không bắt buộc | - Không cho phép người dùng thao tác tương tác (nhấn/chọn/sửa). - Hệ thống tự động gán STT theo ngày ký hợp đồng: hợp đồng ký gần hơn nhận STT nhỏ hơn, hợp đồng ký xa hơn nhận STT lớn hơn. - Khi thực hiện thêm mới hợp đồng vào màn hình "Danh sách hợp đồng", hệ thống sẽ tự động cập nhật STT cho toàn bộ danh sách. | Thể hiện số thự tự tự sinh tăng dần của từng bản ghi trên màn hình danh sách Hợp đồng |
| 2 | Số hợp đồng | Đường dẫn (Hyperlink) | Không bắt buộc | - Không cho phép người dùng thao tác tương tác (nhấn/chọn/sửa). - Dữ liệu được lấy từ trường "Số hợp đồng" tại menu Quản lý hợp đồng dựa trên mã nhà cung cấp - Sau khi nhấn vào tên, hệ thống hiển thị màn hình xem chi tiết của hợp đồng đó (tham chiếu mục 3.4.2 Màn hình "Xem chi tiết hợp đồng" trong 2502 - User Story - Menu quản lý hợp đồng theo quy trình (ver1)) | - Thể hiện số hợp đồng |
| 3 | Tên hợp đồng | Văn bản (Text) | Không bắt buộc | - Không cho phép người dùng thao tác tương tác (nhấn/chọn/sửa). - Dữ liệu được lấy từ trường "Số hợp đồng/ gói thầu" tại menu Quản lý hợp đồng dựa trên mã nhà cung cấp và số hợp đồng | - Thể hiện tên hợp đồng |
| 4 | Loại hợp đồng | Văn bản (Text) | Không bắt buộc | - Không cho phép người dùng thao tác tương tác (nhấn/chọn/sửa). - Dữ liệu được lấy từ trường "Loại hợp đồng" tại menu Quản lý hợp đồng dựa trên mã nhà cung cấp và số hợp đồng | - Thể hiện thông tin loại hợp đồng |
| 5 | Dự án | Văn bản (Text) | Không bắt buộc | - Không cho phép người dùng thao tác tương tác (nhấn/chọn/sửa). - Dữ liệu được lấy từ trường "Dự án" tại menu Quản lý hợp đồng dựa trên mã nhà cung cấp và số hợp đồng | - Thể hiện tên dự án |
| 6 | Ngày ký hợp đồng | Thời gian (Date) | Không bắt buộc | - Không cho phép người dùng thao tác tương tác (nhấn/chọn/sửa). - Dữ liệu được lấy từ trường "Ngày ký hợp đồng" tại menu Quản lý hợp đồng dựa trên mã nhà cung cấp và số hợp đồng | - Thể hiện ngày ký hợp đồng |
| 7 | Ngày dự kiến hoàn thành | Thời gian (Date) | Không bắt buộc | - Không cho phép người dùng thao tác tương tác (nhấn/chọn/sửa). - Dữ liệu được lấy từ trường "Ngày dự kiến hoàn thành" tại menu Quản lý hợp đồng dựa trên mã nhà cung cấp và số hợp đồng | - Thể hiện ngày dự kiến hoàn thành triển khai |
| 8 | Giá trị hợp đồng trước thuế | Số (Number) | Không bắt buộc | - Không cho phép người dùng thao tác tương tác (nhấn/chọn/sửa). - Dữ liệu được lấy từ trường "Giá trị hợp đồng trước thuế" tại menu Quản lý hợp đồng dựa trên mã nhà cung cấp và số hợp đồng | - Thể hiện giá trị hợp đồng trước thuế |
| 9 | Giá trị hợp đồng sau thuế | Số (Number) | Không bắt buộc | - Không cho phép người dùng thao tác tương tác (nhấn/chọn/sửa). - Dữ liệu được lấy từ trường "Giá trị hợp đồng sau thuế" tại menu Quản lý hợp đồng dựa trên mã nhà cung cấp và số hợp đồng | - Thể hiện giá trị hợp đồng sau thuế |
| 10 | Giá trị hợp đồng trước thuế sau điều chỉnh | Số (Number) | Không bắt buộc | - Không cho phép người dùng thao tác tương tác (nhấn/chọn/sửa). - Dữ liệu được lấy từ trường "Giá trị hợp đồng trước thuế sau điều chỉnh" tại menu Quản lý hợp đồng dựa trên mã nhà cung cấp và số hợp đồng | - Thể hiện giá trị hợp đồng trước thuế sau điều chỉnh có bổ sung thêm các phụ lục |
| 11 | Giá trị hợp đồng sau thuế sau điều chỉnh | Số (Number) | Không bắt buộc | - Không cho phép người dùng thao tác tương tác (nhấn/chọn/sửa). - Dữ liệu được lấy từ trường "Giá trị hợp đồng sau thuế sau điều chỉnh" tại menu Quản lý hợp đồng dựa trên mã nhà cung cấp và số hợp đồng | - Thể hiện giá trị hợp đồng sau thuế sau điều chỉnh có bổ sung thêm các phụ lục |
| 12 | Trạng thái | Văn bản (Text) | Không bắt buộc | - Không cho phép người dùng thao tác tương tác (nhấn/chọn/sửa). - Dữ liệu được lấy từ trường "Trạng thái hợp đồng" tại menu Quản lý hợp đồng dựa trên mã nhà cung cấp và số hợp đồng - Giá trị của trường trạng thái:
| - Thể hiện trạng thái hiện tại của hợp đồng |
| 13 | Ô tìm kiếm | Văn bản (Text) | Không bắt buộc | Cho phép người dùng nhập từ khóa liên quan đến "Số hợp đồng" hoặc "Tên hợp đồng". - Hệ thống thực hiện tìm kiếm và cập nhật màn hình danh sách Hợp đồng khi người dùng nhấn Enter hoặc biểu tượng kính lúp sau khi hoàn thành nhập từ khóa. - Hệ thống thực hiện trả về kết quả theo 2 trường hợp:
| Thể hiện ô tìm kiếm với gợi ý mặc định (placeholder) “Tìm theo Số - Tên hợp đồng” và biểu tượng kính lúp ở đầu ô nhập. |
| 14 | Nút "Lọc" | Nút chức năng (Button) | Không bắt buộc | - Sau khi nhấn, hệ thống mở ra màn hình pop-up "Bộ lọc" - Màn hình pop-up "Bộ lọc": tham chiếu mục 3.4.1.1. Màn hình pop-up "Bộ lọc". | Thể hiện nút chức năng bộ lọc |
| 15 | Nút "Xuất file Excel" | Nút chức năng (Button) | Không bắt buộc | Sau khi nhấn nút, hệ thống hiển thị pop-up "Xuất file excel" | Cho phép người dùng xuất file danh sách hợp đồng theo định dạng excel |
Pop-up "Bộ lọc" hiển thị khi người dùng nhấn button "Lọc" trên màn hình danh sách
Trường thông tin/Nút chức năng | Kiểu dữ liệu | Điều kiện | Quy định | Mô tả |
|---|---|---|---|---|
| Dự án | Lựa chọn (Select) | Không bắt buộc | - Cho phép người dùng nhấn để chọn giá trị tên dự án từ danh sách thả xuống của trường. - Dữ liệu được lấy theo danh sách trường dự án từ Danh mục Dự án trong phân hệ Quản lý danh mục - Hành vi hệ thống khi thực hiện lọc như sau:
| Thể hiện tên dự án trong hợp đồng với gợi ý mặc định (placeholder) "Chọn dự án" |
| Thời gian ký hợp đồng | Nhãn (Label) | Không bắt buộc | Thể hiện khoảng thời gian ký hợp đồng | |
| Từ ngày: | Bộ chọn ngày (Date picker) | Không bắt buộc | - Cho phép người dùng nhấn để chọn ngày bắt đầu của khoảng thời gian ký hợp đồng - Hành vi hệ thống khi thực hiện lọc như sau:
| Thể hiện ngày bắt đầu của khoảng thời gian ký hợp đồng với gợi ý mặc định (placeholder) "DD/MM/YYYY" |
| Đến ngày: | Bộ chọn ngày (Date picker) | Không bắt buộc | - Cho phép người dùng nhấn để chọn ngày kết thúc của khoảng thời gian ký hợp đồng - Hệ thổng chỉ hiện thị những ngày sau ngày bắt đầu đã chon tại trường "Từ ngày" - Hành vi hệ thống khi thực hiện lọc như sau:
| Thể hiện ngày kết thúc của khoảng thời gian ký hợp đồng với gợi ý mặc định (placeholder) "DD/MM/YYYY" |
| Giá trị hợp đồng sau thuế | Nhãn (Label) | Không bắt buộc | Thể hiện giá trị hợp đồng sau thuế | |
| Giá trị nhỏ nhất: | Số (Number) | Không bắt buộc | - Cho phép người dùng nhập giá trị nhỏ nhất của khoảng giá trị hợp đồng sau thuế - Hành vi hệ thống khi thực hiện lọc như sau:
| Thể hiển giá trị nhỏ nhất của khoảng giá trị hợp đồng sau thuế từ với gợi ý mặc định (placeholder) "VD: 10.000.000" |
| Giá trị lớn nhất: | Số (Number) | Không bắt buộc | - Cho phép người dùng nhập giá trị lớn nhất của khoảng giá trị hợp đồng sau thuế - Hành vi hệ thống khi thực hiện lọc như sau:
| Thể hiển hợp giá trị lớn nhất của khoảng giá trị hợp đồng sau thuế từ với gợi ý mặc định (placeholder) "VD: 100.000.000" |
| Trạng thái hợp đồng | Lựa chọn (Select) | Không bắt buộc | - Cho phép người dùng nhấn để chọn giá trị trạng thái từ danh sách thả xuống của trường. - Giá trị của trường trạng thái:
- Hành vi hệ thống khi thực hiện lọc như sau:
| Thể hiện trạng thái của hợp đồng với gợi ý mặc định (placeholder) "Chọn trạng thái" |
| Nút "Áp dụng" | Nút chức năng (Button) | Không bắt buộc | - Sau khi nhấn nút, hệ thống thực hiện lọc danh sách hợp đồng theo điều kiện nhập/chọn: - Hành vi hiển thị kết quả hệ thống khi người dùng nhấn nút "Áp dụng" như sau:
- Hành vi hệ thống khi Thể hiện kết quả:
| Thể hiện nút áp dụng tiêu chí lọc được chọn |
| Nút "Đặt lại" | Nút chức năng (Button) | Không bắt buộc | - Cho phép người dùng nhấn để đặt lại tất cả tiêu chí lọc về trạng thái mặc định ban đầu. - Hành vi hệ thống khi người dùng nhấn nút "Đặt lại" như sau:
- Hệ thống thực hiện tìm kiếm và cập nhật màn hình danh sách Hợp đồng khi người dùng nhấn Enter hoặc biểu tượng kính lúp sau khi hoàn thành nhập từ khóa. - Hành vi hệ thống khi Thể hiện kết quả:
| Thể hiện nút đặt lại tất cả tiêu chí lọc về trạng thái mặc định ban đầu. |
| 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 để hủy bỏ thao tác lọc. | Thể hiện nút "X" để để hủy bỏ thao tác lọc. |
Pop-up "Xuất file excel" hiển thị khi người dùng nhấn button "Xuất file Excel" trên màn hình danh sách
| STT | Field (Trường dữ liệu) | Type (Kiểu dữ liệu) | Required (Bắt buộc) | Length (Độ dài ký tự) | Validation (Quy định) | Description (Mô tả) |
|---|---|---|---|---|---|---|
1 | Chọn kiểu xuất file | Nút chọn (Radio) | Không bắt buộc | Hệ thống cho phép người dùng chọn 1 trong 3 giá trị:
| Cho phép người dùng chọn kiểu xuất file sẽ tải xuống | |
2 | Xuất file | Nút chức năng (Button) | Không bắt buộc | - Quy tắc đặt tên: DanhSachHopDongCuaNCC-yyyymmdd
- Sau khi nhấn nút, hệ thống thực hiện tải xuống tài liệu, đóng pop-up và hiển thị toast thành công màu xanh lá sau khi tải xong: "Thành công - Xuất dữ liệu thành công" | Cho phép người dùng tải xuống file hợp đồng theo định dạng excel và kiểu xuất file đã chọn | |
3 | Nút “Hủy”/Nút Đóng “X” | Nút chức năng (Button) | Không bắt buộc | Sau khi nhấn nút, hệ thống đóng pop-up và quay về giao diện trước đó | Cho phép người dùng hủy thao tác xuất danh sách hợp đồng và đóng pop-up |
Thông tin fie excel: DanhSachHopDongCuaNCC.xlsx

STT | Field (Trường dữ liệu) | Description (Mô tả) |
| 1 | Thời gian xuất | Thể hiện thời gian xuất dữ liệu theo định dạng: dd/mm/yyyy hh:mm:ss |
| 2 | Người xuất | Thể hiện thông tin tên hiển thị của người thực hiện xuất dữ liệu |
| 3 | Mã số thuế | Thể hiện mã số thuế tương ứng với nhà cung cấp |
| 4 | Tên nhà cung cấp | Thể hiện tên tương ứng với nhà cung cấp |
| 5 | STT | Thể hiện số thự tự tự sinh tăng dần |
| 6 | Số hợp đồng | Thể hiện thông tin số hợp đồng |
| 7 | Tên hợp đồng | Thể hiện thông tin tên của hợp đồng |
| 8 | Loại hợp đồng | Thể hiện thông tin loại hợp đồng |
| 9 | Dự án | Thể hiện thông tin dự án của hợp đồng |
| 10 | Ngày ký hợp đồng | Thể hiện thông tin ngày ký của hợp đồng |
| 11 | Ngày dự kiến hoàn thành | Thể hiện thông tin ngày dự kiến hoàn thành triển khai của hợp đồng |
| 12 | Giá trị HĐ trước thuế | Thể hiện thông tin giá trị HĐ trước thuế của hợp đồng |
| 13 | Giá trị HĐ sau thuế | Thể hiện thông tin giá trị HĐ sau thuế của hợp đồng |
| 14 | Giá trị HĐ trước thuế sau điều chỉnh | Thể hiện thông tin giá trị HĐ trước thuế sau điều chỉnh của hợp đồng |
| 15 | Giá trị HĐ sau thuế sau điều chỉnh | Thể hiện thông tin giá trị HĐ sau thuế sau điều chỉnh của hợp đồng |
| 16 | Trạng thái hợp đồng | Thể hiện thông tin trạng thái hiện tại của hợp đồng |