Page History

	Nghiệp vụ		IT
	Người lập	Người duyệt	Người lập	Người duyệt
Họ và tên	Mai Kiều Mi	Nguyễn Đức Trung
Họ và tên	Nguyễn Đức Trung	Nguyễn Đức Trung
Tài khoản email/MS team	mimk2	trungnd3
Tài khoản email/MS team	trungnd3	trungnd3
Chức danh	Business Analyst (BA)	Product Owner (P.O)
Chức danh	Business Analyst Business (BA BIZ)	Product Owner (P.O)
Ngày soạn thảo	10 Dec 2025
Ngày soạn thảo	04 Dec 2025
Jira Link	[BPMKVH-4250] Menu quản lý hợp đồng ngoài quy trình - Jira

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

Là nhân viên chịu trách nhiệm quản lý hợp đồng tôi muốn cập nhật thủ công các hợp đồng, phụ lục hợp đồng được ký kết (ngoài hệ thống) để quản lý Danh mục hợp đồng tập trung thuận tiện truy cập, tìm kiếm, xem, chỉnh sửa hoặc theo dõi toàn bộ hợp đồng mua sắm

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

Cho phép thêm mới hợp đồng thủ công hoặc import từ excel
Cho phép export dữ liệu excel
Cho phép tích hợp dữ liệu trạng thái thực hiện hợp đồng từ hệ thống bên ngoài (ERP)
Cho phép cập nhật phụ lục hợp đồng
1. Nhận biết phụ lục ký phát sinh so với phụ lục ban đầu
2. Người dùng truy cập các phụ lục từ số lần cập nhật phụ lục trên danh sách
Cho phép kích hoạt quy trình đàm phán phụ lục phát sinh của hợp đồng theo phân quyền
Cho phép upload các phụ lục, email ... dữ liệu quá trình đàm phán phụ lục (nếu việc đàm phán ko thực hiện trên hệ thống)
Ghi log toàn bộ hành động thêm/sửa/xóa/tải dữ liệu hợp đồng

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

3.1 UIUX:

3.1.1. Màn hình "Danh sách hợp đồng"

3.1.1.1. Màn hình kết quả tìm kiếm khi: Không có kết quả tìm kiếm/Danh sách trống

3.1.1.2. Màn hình pop-up "bộ lọc"

Image Modified

3.1.1.3. Màn hình pop-up "Tải tài liệu"

3.1.1.4. Màn hình pop-up "Thêm mới hợp đồng"

3.1.1.5. Màn hình pop-up "Chỉnh sửa hợp đồng"

3.1.1.5.1. Màn hình pop-up "Chỉnh sửa hợp đồng" với mã quy định HĐ NGOÀI quy trình BPM :

3.1.1.5.2. Màn hình pop-up "Chỉnh sửa hợp đồng" với mã quy định HĐ TRONG quy trình BPM :

3.1.1.6. Màn hình pop-up "Xem chi tiết hợp đồng"

3.1.1.7. Màn hình pop-up "Cảnh báo"

3.1.1.7. Màn hình pop-up "Cảnh báo trùng"

3.1.1.7. Màn hình pop-up "Cảnh báo điều kiện ngày hoàn thành (ngày hoàn thành nhỏ hơn ngày hợp đồng)

3.1.1.7. Màn hình pop-up "Cảnh báo ngày hết hạn bảo hành (ngày hết hạn bảo hành nhỏ hơn ngày dự kiến hoàn thành/ngày hợp đồng/ngày hiệu lực)"

3.1.1.8. Màn hình pop-up "Nhập file excel"

3.1.1.8. Màn hình pop-up "Xuất file excel"

3.1.1.8. Màn hình pop-up "Lỗi nhập file excel"

3.1.1.9. Màn hình pop-up "Thông báo"

3.1.1.9.1. Màn hình toast Nhập dữ liệu thành công

3.1.1.9.2. Màn hình toast Xuất dữ liệu thành công

3.1.1.9.3. Màn hình toast Không thành công

3.1.1.9.4. Màn hình toast Thành công

3.2 Luồng:

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

Panel

title	API Import danh sách hợp đồng

Method	GET	URL	/application/contract/list
Description	API tìm kiếm hợp đồng
Note	API mới

1. Headers

STT	Field	Source Data Type / Length	Description	Sample Values
1	authorization	String	Token	Bearer eyJhbGciOiJIUzI1NiJ9.eyJleHAiOjE3NjYzOTgyNDUsInVzZXIiOiJ7XCJpZFwiOjIwMjAsXCJ1c2VybmFtZVwiOlwiMDM3NDc4ODQwNVwiLFwibmFtZVwiOlwiQ2h1IFRo4buLIExpw6puXCIsXCJyb2xlc1wiOltdLFwibWFwQmVhdXR5U2Fsb25cIjp7XCJicG0ucmVib3JuLnZuXCI6Nn0sXCJlbXBsb3llZUlkXCI6NTMxLFwiYnJhbmNoSWRcIjoyM30ifQ.qRoaRDxjqyWS-3Az_ZqLmR0KAcPTM7jXggW1Ja5wpEc

2. Param

STT	Field	Required	Data Type / Length	Description	Note
1	name	false	String	Từ khóa tìm kiếm theo tên hợp đồng
2	orgId	false	Integer	ID tổ chức (nhà thầu)
3	projectId	false	Integer	ID dự án
4	status	false	Integer	Trạng thái hợp đồng (1: chờ, 2: thực hiện, 3: quyết toán, 4: hủy)
5	contractTypeId	false	Integer	ID loại hợp đồng
6	attachment	false	Integer	Trạng thái đính kèm (-1: tất cả, 0: không có, 1: có)
7	signedAtFrom	false	Date	Ngày ký hợp đồng từ	utc format
8	signedAtTo	false	Date	Ngày ký hợp đồng đến	utc format
9	page	false	Integer	Trang dữ liệu (phân trang)
10	size	false	Integer	Số bản ghi mỗi trang

3. Response / Incoming Data Specification

Field	Data Type / Length	Description
code	Integer	0: thành công, != 0 thất bại
message	String
result	Object[]	danh sách cấu hình grid
id	Integer	ID hợp đồng
isInWorkflow	Integer	Có trong quy trình (0: không, 1: có)
status	Integer	1: chờ thống nhất, 2: đang thực hiện, 3: đã quyết toán, 4: hủy
contractNo	String	Số hợp đồng
contractTypeId	Integer	ID loại hợp đồng
contractName	String	Tên hợp đồng/gói thầu
projectId	Integer	ID dự án
organizationId	Integer	ID nhà thầu
taxCode	String	Mã số thuế nhà thầu
departmentId	Integer	ID phòng ban
employeeId	Integer	ID nhân viên phụ trách
signedAt	Timestamp	Ngày ký hợp đồng
expectedFinishAt	Timestamp	Ngày dự kiến hoàn thành
executionTime	Integer	Thời gian thực hiện (ngày)
warrantyExpiredAt	Timestamp	Ngày hết hạn bảo hành
amountBeforeTax	Decimal(18,2)	Giá trị HĐ trước thuế
amountAfterTax	Decimal(18,2)	Giá trị HĐ sau thuế
adjAmountBeforeTax	Decimal(18,2)	Giá trị HĐ trước thuế sau điều chỉnh
adjAmountAfterTax	Decimal(18,2)	Giá trị HĐ sau thuế sau điều chỉnh
currencyUnitId	Integer	ID đơn vị tiền tệ
exchangeRate	String	Tỉ giá tương ứng
investorSigningUnitId	Integer	ID đơn vị chủ đầu tư ký hợp đồng
risk	String / Null	Rủi ro
potId	Integer / Null	ID POT
contractAttachments	String / Null	File đính kèm hợp đồng
appendixAttachments	String / Null	File đính kèm phụ lục
updatedAt	Timestamp	Ngày cập nhật
createdAt	Timestamp	Ngày tạo
contractTypeName	String	Tên loại hợp đồng
projectName	String	Tên dự án
organizationName	String	Tên nhà thầu
departmentName	String	Tên phòng ban
currencyUnitName	String	Tên đơn vị tiền tệ
investorSigningUnitName	String	Tên đơn vị chủ đầu tư ký hợp đồng

Panel

title	API get detail hợp đồng

Method	GET	URL	/application/contract/getDetail?id=1
Description	API get chi tiết hợp đồng
Note	API mới

1. Headers

STT	Field	Source Data Type / Length	Description	Sample Values
1	authorization	String	Token	Bearer eyJhbGciOiJIUzI1NiJ9.eyJleHAiOjE3NjYzOTgyNDUsInVzZXIiOiJ7XCJpZFwiOjIwMjAsXCJ1c2VybmFtZVwiOlwiMDM3NDc4ODQwNVwiLFwibmFtZVwiOlwiQ2h1IFRo4buLIExpw6puXCIsXCJyb2xlc1wiOltdLFwibWFwQmVhdXR5U2Fsb25cIjp7XCJicG0ucmVib3JuLnZuXCI6Nn0sXCJlbXBsb3llZUlkXCI6NTMxLFwiYnJhbmNoSWRcIjoyM30ifQ.qRoaRDxjqyWS-3Az_ZqLmR0KAcPTM7jXggW1Ja5wpEc

2. Param

STT	Field	Required	Data Type / Length	Description	Note
1	id	String

3. Response / Incoming Data Specification

Field	Data Type / Length	Description
code	Integer	0: thành công, != 0 thất bại
message	String
result	Object[]	danh sách cấu hình grid
id	Integer	ID hợp đồng
isInWorkflow	Integer	Có trong quy trình (0: không, 1: có)
status	Integer	1: chờ thống nhất, 2: đang thực hiện, 3: đã quyết toán, 4: hủy
contractNo	String	Số hợp đồng
contractTypeId	Integer	ID loại hợp đồng
contractName	String	Tên hợp đồng/gói thầu
projectId	Integer	ID dự án
organizationId	Integer	ID nhà thầu
taxCode	String	Mã số thuế nhà thầu
departmentId	Integer	ID phòng ban
employeeId	Integer	ID nhân viên phụ trách
signedAt	Timestamp	Ngày ký hợp đồng
expectedFinishAt	Timestamp	Ngày dự kiến hoàn thành
executionTime	Integer	Thời gian thực hiện (ngày)
warrantyExpiredAt	Timestamp	Ngày hết hạn bảo hành
amountBeforeTax	Decimal(18,2)	Giá trị HĐ trước thuế
amountAfterTax	Decimal(18,2)	Giá trị HĐ sau thuế
adjAmountBeforeTax	Decimal(18,2)	Giá trị HĐ trước thuế sau điều chỉnh
adjAmountAfterTax	Decimal(18,2)	Giá trị HĐ sau thuế sau điều chỉnh
currencyUnitId	Integer	ID đơn vị tiền tệ
exchangeRate	String	Tỉ giá tương ứng
investorSigningUnitId	Integer	ID đơn vị chủ đầu tư ký hợp đồng
risk	String / Null	Rủi ro
potId	Integer / Null	ID POT
contractAttachments	String / Null	File đính kèm hợp đồng
appendixAttachments	String / Null	File đính kèm phụ lục
updatedAt	Timestamp	Ngày cập nhật
createdAt	Timestamp	Ngày tạo
contractTypeName	String	Tên loại hợp đồng
projectName	String	Tên dự án
organizationName	String	Tên nhà thầu
departmentName	String	Tên phòng ban
currencyUnitName	String	Tên đơn vị tiền tệ
investorSigningUnitName	String	Tên đơn vị chủ đầu tư ký hợp đồng

Panel

title	API validate hợp đồng

Method	POST	URL	/application/contract/validate
Description	API validate hợp đồng
Note	API mới

1. Headers

STT	Field	Source Data Type / Length	Description	Sample Values
1	authorization	String	Token	Bearer eyJhbGciOiJIUzI1NiJ9.eyJleHAiOjE3NjYzOTgyNDUsInVzZXIiOiJ7XCJpZFwiOjIwMjAsXCJ1c2VybmFtZVwiOlwiMDM3NDc4ODQwNVwiLFwibmFtZVwiOlwiQ2h1IFRo4buLIExpw6puXCIsXCJyb2xlc1wiOltdLFwibWFwQmVhdXR5U2Fsb25cIjp7XCJicG0ucmVib3JuLnZuXCI6Nn0sXCJlbXBsb3llZUlkXCI6NTMxLFwiYnJhbmNoSWRcIjoyM30ifQ.qRoaRDxjqyWS-3Az_ZqLmR0KAcPTM7jXggW1Ja5wpEc

2. Param

STT	Field	Required	Data Type / Length	Description	Note
1	contractNo	String

3. Response / Incoming Data Specification

Field	Data Type / Length	Description
code	Integer	0: thành công, != 0 thất bại
message	String
result	String

Panel

title	API tạo hợp đồng

Method	POST	URL	/application/contract/insert
Description	API tạo hợp đồng
Note	API mới

1. Headers

STT	Field	Source Data Type / Length	Description	Sample Values
1	authorization	String	Token	Bearer eyJhbGciOiJIUzI1NiJ9.eyJleHAiOjE3NjYzOTgyNDUsInVzZXIiOiJ7XCJpZFwiOjIwMjAsXCJ1c2VybmFtZVwiOlwiMDM3NDc4ODQwNVwiLFwibmFtZVwiOlwiQ2h1IFRo4buLIExpw6puXCIsXCJyb2xlc1wiOltdLFwibWFwQmVhdXR5U2Fsb25cIjp7XCJicG0ucmVib3JuLnZuXCI6Nn0sXCJlbXBsb3llZUlkXCI6NTMxLFwiYnJhbmNoSWRcIjoyM30ifQ.qRoaRDxjqyWS-3Az_ZqLmR0KAcPTM7jXggW1Ja5wpEc

2. Param

Field	Required	Data Type / Length	Description
id	false	Integer	ID hợp đồng
status	false	Integer	Trạng thái: 1 chờ thống nhất, 2 đang thực hiện, 3 đã quyết toán, 4 hủy
contractNo	false	String	Số hợp đồng
contractTypeId	true	Integer	Loại hợp đồng (bắt buộc)
contractName	true	String	Tên hợp đồng (bắt buộc)
projectId	true	Integer	ID dự án (bắt buộc)
organizationId	true	Integer	ID nhà cung cấp (bắt buộc)
taxCode	true	String	Mã số thuế (bắt buộc)
departmentId	false	Integer	ID phòng ban
employeeId	false	Integer	ID người tạo
signedAtStr	true	String	Ngày ký hợp đồng (dd/MM/yyyy) (bắt buộc)
expectedFinishAtStr	true	String	Ngày dự kiến hoàn thành (dd/MM/yyyy) (bắt buộc)
executionTime	true	Integer	Thời gian thực hiện (ngày) (bắt buộc)
warrantyExpiredAtStr	false	String	Ngày hết hạn bảo hành (dd/MM/yyyy)
amountBeforeTax	true	BigDecimal	Giá trị HĐ trước thuế (bắt buộc)
amountAfterTax	true	BigDecimal	Giá trị HĐ sau thuế (bắt buộc)
adjAmountBeforeTax	false	BigDecimal	Giá trị HĐ trước thuế sau điều chỉnh
adjAmountAfterTax	false	BigDecimal	Giá trị HĐ sau thuế sau điều chỉnh
currencyUnitId	true	Integer	ID tiền tệ (bắt buộc)
exchangeRate	true	String	Tỉ giá tương ứng (bắt buộc)
investorSigningUnitId	false	Integer	Đơn vị chủ đầu tư ký hợp đồng (ID)
risk	false	String	Rủi ro
contractAttachments	false	String	File đính kèm hợp đồng
appendixAttachments	false	String	File đính kèm phụ lục
isInWorkflow	true	Integer	1: trong quy trình, 0: ngoài quy trình (bắt buộc)
signedAt	false	Timestamp	Ngày ký hợp đồng
expectedFinishAt	false	Timestamp	Ngày dự kiến hoàn thành
warrantyExpiredAt	false	Timestamp	Ngày hết hạn bảo hành
potId	false	Integer	POT ID
investorSigningUnitName	false	String	Tên đơn vị chủ đầu tư ký hợp đồng
departmentName	false	String	Tên phòng ban
contractTypeName	false	String	Tên loại hợp đồng
projectName	false	String	Tên dự án
organizationName	false	String	Tên nhà cung cấp
currencyUnitName	false	String	Tên đơn vị tiền tệ

3. Response / Incoming Data Specification

Field	Data Type / Length	Description
id	Integer	ID hợp đồng
status	Integer	Trạng thái: 1 chờ thống nhất, 2 đang thực hiện, 3 đã quyết toán, 4 hủy
contractNo	String	Số hợp đồng
contractTypeId	Integer	Loại hợp đồng (bắt buộc)
contractName	String	Tên hợp đồng (bắt buộc)
projectId	Integer	ID dự án (bắt buộc)
organizationId	Integer	ID nhà cung cấp (bắt buộc)
taxCode	String	Mã số thuế (bắt buộc)
departmentId	Integer	ID phòng ban
employeeId	Integer	ID người tạo
signedAtStr	String	Ngày ký hợp đồng (dd/MM/yyyy) (bắt buộc)
expectedFinishAtStr	String	Ngày dự kiến hoàn thành (dd/MM/yyyy) (bắt buộc)
executionTime	Integer	Thời gian thực hiện (ngày) (bắt buộc)
warrantyExpiredAtStr	String	Ngày hết hạn bảo hành (dd/MM/yyyy)
amountBeforeTax	BigDecimal	Giá trị HĐ trước thuế (bắt buộc)
amountAfterTax	BigDecimal	Giá trị HĐ sau thuế (bắt buộc)
adjAmountBeforeTax	BigDecimal	Giá trị HĐ trước thuế sau điều chỉnh
adjAmountAfterTax	BigDecimal	Giá trị HĐ sau thuế sau điều chỉnh
currencyUnitId	Integer	ID tiền tệ (bắt buộc)
exchangeRate	String	Tỉ giá tương ứng (bắt buộc)
investorSigningUnitId	Integer	Đơn vị chủ đầu tư ký hợp đồng (ID)
risk	String	Rủi ro
contractAttachments	String	File đính kèm hợp đồng
appendixAttachments	String	File đính kèm phụ lục
isInWorkflow	Integer	1: trong quy trình, 0: ngoài quy trình (bắt buộc)
signedAt	Timestamp	Ngày ký hợp đồng
expectedFinishAt	Timestamp	Ngày dự kiến hoàn thành
warrantyExpiredAt	Timestamp	Ngày hết hạn bảo hành
potId	Integer	POT ID
investorSigningUnitName	String	Tên đơn vị chủ đầu tư ký hợp đồng
departmentName	String	Tên phòng ban
contractTypeName	String	Tên loại hợp đồng
projectName	String	Tên dự án
organizationName	String	Tên nhà cung cấp
currencyUnitName	String	Tên đơn vị tiền tệ

Panel

title	API upload tài liệu

Method	PUT	URL	/application/contract/updateAttachment
Description	API upload tài liệu
Note	API mới

1. Headers

STT	Field	Source Data Type / Length	Description	Sample Values
1	authorization	String	Token	Bearer eyJhbGciOiJIUzI1NiJ9.eyJleHAiOjE3NjYzOTgyNDUsInVzZXIiOiJ7XCJpZFwiOjIwMjAsXCJ1c2VybmFtZVwiOlwiMDM3NDc4ODQwNVwiLFwibmFtZVwiOlwiQ2h1IFRo4buLIExpw6puXCIsXCJyb2xlc1wiOltdLFwibWFwQmVhdXR5U2Fsb25cIjp7XCJicG0ucmVib3JuLnZuXCI6Nn0sXCJlbXBsb3llZUlkXCI6NTMxLFwiYnJhbmNoSWRcIjoyM30ifQ.qRoaRDxjqyWS-3Az_ZqLmR0KAcPTM7jXggW1Ja5wpEc

2. Param

Field	Required	Data Type / Length	Description
id	true	Integer	ID hợp đồng
contractAttachments	false	String	File đính kèm hợp đồng
appendixAttachments	false	String	File đính kèm phụ lục
employeeId	false	Integer	ID nhân viên phụ trách/tạo hợp đồng

3. Response / Incoming Data Specification

Field	Data Type / Length	Description
id	Integer	ID hợp đồng
contractAttachments	String	File đính kèm hợp đồng
appendixAttachments	String	File đính kèm phụ lục
employeeId	Integer	ID nhân viên phụ trách/tạo hợp đồng

Panel

title	API service Task update

Method	PUT	URL	/application/contract/serviceTask/update
Description	API update service task
Note	API mới

1. Headers

STT	Field	Source Data Type / Length	Description	Sample Values
1	authorization	String	Token	Bearer eyJhbGciOiJIUzI1NiJ9.eyJleHAiOjE3NjYzOTgyNDUsInVzZXIiOiJ7XCJpZFwiOjIwMjAsXCJ1c2VybmFtZVwiOlwiMDM3NDc4ODQwNVwiLFwibmFtZVwiOlwiQ2h1IFRo4buLIExpw6puXCIsXCJyb2xlc1wiOltdLFwibWFwQmVhdXR5U2Fsb25cIjp7XCJicG0ucmVib3JuLnZuXCI6Nn0sXCJlbXBsb3llZUlkXCI6NTMxLFwiYnJhbmNoSWRcIjoyM30ifQ.qRoaRDxjqyWS-3Az_ZqLmR0KAcPTM7jXggW1Ja5wpEc

2. Param

Field	Required	Data Type / Length	Description
potId	false	Integer	ID POT (liên quan đến dự án hoặc quy trình)
employeeId	false	Integer	ID nhân viên phụ trách/tạo hợp đồng
contractNo	false	String	Số hợp đồng
status	false	Integer	Trạng thái hợp đồng (1: chờ, 2: thực hiện, 3: quyết toán, 4: hủy)
contractAttachments	false	String	File đính kèm hợp đồng
appendixAttachments	false	String	File đính kèm phụ lục

3. Response / Incoming Data Specification

Field	Description	Note
potId	Integer	ID POT (liên quan đến dự án hoặc quy trình)
employeeId	Integer	ID nhân viên phụ trách/tạo hợp đồng
contractNo	String	Số hợp đồng
status	Integer	Trạng thái hợp đồng (1: chờ, 2: thực hiện, 3: quyết toán, 4: hủy)
contractAttachments	String	File đính kèm hợp đồng
appendixAttachments	String	File đính kèm phụ lục

Panel

title	API update hợp đồng

Method	PUT	URL	/application/contract/contract/update
Description	API update hợp đồng
Note	API mới

1. Headers

STT	Field	Source Data Type / Length	Description	Sample Values
1	authorization	String	Token	Bearer eyJhbGciOiJIUzI1NiJ9.eyJleHAiOjE3NjYzOTgyNDUsInVzZXIiOiJ7XCJpZFwiOjIwMjAsXCJ1c2VybmFtZVwiOlwiMDM3NDc4ODQwNVwiLFwibmFtZVwiOlwiQ2h1IFRo4buLIExpw6puXCIsXCJyb2xlc1wiOltdLFwibWFwQmVhdXR5U2Fsb25cIjp7XCJicG0ucmVib3JuLnZuXCI6Nn0sXCJlbXBsb3llZUlkXCI6NTMxLFwiYnJhbmNoSWRcIjoyM30ifQ.qRoaRDxjqyWS-3Az_ZqLmR0KAcPTM7jXggW1Ja5wpEc

2. Param

Field	Required	Data Type / Length	Description
id	false	Integer
status	false	Integer	Trạng thái: 1 chờ thống nhất, 2 đang thực hiện, 3 đã quyết toán, 4 hủy
contractNo	false	String	Số hợp đồng
contractTypeId	true	Integer	Loại hợp đồng (bắt buộc)
contractName	true	String	Tên hợp đồng (bắt buộc)
projectId	true	Integer	ID dự án (bắt buộc)
organizationId	true	Integer	ID nhà cung cấp (bắt buộc)
taxCode	true	String	Mã số thuế (bắt buộc)
departmentId	false	Integer	ID phòng ban
employeeId	false	Integer	ID người tạo
signedAtStr	true	String	Ngày ký hợp đồng (dd/MM/yyyy) (bắt buộc)
expectedFinishAtStr	true	String	Ngày dự kiến hoàn thành (dd/MM/yyyy) (bắt buộc)
executionTime	true	Integer	Thời gian thực hiện (ngày) (bắt buộc)
warrantyExpiredAtStr	false	String	Ngày hết hạn bảo hành (dd/MM/yyyy)
amountBeforeTax	true	BigDecimal	Giá trị HĐ trước thuế (bắt buộc)
amountAfterTax	true	BigDecimal	Giá trị HĐ sau thuế (bắt buộc)
adjAmountBeforeTax	false	BigDecimal	Giá trị HĐ trước thuế sau điều chỉnh
adjAmountAfterTax	false	BigDecimal	Giá trị HĐ sau thuế sau điều chỉnh
currencyUnitId	true	Integer	ID tiền tệ (bắt buộc)
exchangeRate	true	String	Tỉ giá tương ứng (bắt buộc)
investorSigningUnitId	false	Integer	Đơn vị chủ đầu tư ký hợp đồng (ID)
risk	false	String	Rủi ro
contractAttachments	false	String	File đính kèm hợp đồng
appendixAttachments	false	String	File đính kèm phụ lục
isInWorkflow	true	Integer	1: trong quy trình, 0: ngoài quy trình (bắt buộc)
signedAt	false	Timestamp	Ngày ký hợp đồng
expectedFinishAt	false	Timestamp	Ngày dự kiến hoàn thành
warrantyExpiredAt	false	Timestamp	Ngày hết hạn bảo hành
potId	false	Integer	POT ID
investorSigningUnitName	false	String	Tên đơn vị chủ đầu tư ký hợp đồng
departmentName	false	String	Tên phòng ban
contractTypeName	false	String	Tên loại hợp đồng
projectName	false	String	Tên dự án
organizationName	false	String	Tên nhà cung cấp
currencyUnitName	false	String	Tên đơn vị tiền tệ

3. Response / Incoming Data Specification

Field	Data Type / Length	Description	Note
id	Integer	ID hợp đồng	ID POT (liên quan đến dự án hoặc quy trình)
status	Integer	Trạng thái: 1 chờ thống nhất, 2 đang thực hiện, 3 đã quyết toán, 4 hủy	ID nhân viên phụ trách/tạo hợp đồng
contractNo	String	Số hợp đồng	Số hợp đồng
contractTypeId	Integer	Loại hợp đồng (bắt buộc)	Trạng thái hợp đồng (1: chờ, 2: thực hiện, 3: quyết toán, 4: hủy)
contractName	String	Tên hợp đồng (bắt buộc)	File đính kèm hợp đồng
projectId	Integer	ID dự án (bắt buộc)	File đính kèm phụ lục
organizationId	Integer	ID nhà cung cấp (bắt buộc)
taxCode	String	Mã số thuế (bắt buộc)
departmentId	Integer	ID phòng ban
employeeId	Integer	ID người tạo
signedAtStr	String	Ngày ký hợp đồng (dd/MM/yyyy) (bắt buộc)
expectedFinishAtStr	String	Ngày dự kiến hoàn thành (dd/MM/yyyy) (bắt buộc)
executionTime	Integer	Thời gian thực hiện (ngày) (bắt buộc)
warrantyExpiredAtStr	String	Ngày hết hạn bảo hành (dd/MM/yyyy)
amountBeforeTax	BigDecimal	Giá trị HĐ trước thuế (bắt buộc)
amountAfterTax	BigDecimal	Giá trị HĐ sau thuế (bắt buộc)
adjAmountBeforeTax	BigDecimal	Giá trị HĐ trước thuế sau điều chỉnh
adjAmountAfterTax	BigDecimal	Giá trị HĐ sau thuế sau điều chỉnh
currencyUnitId	Integer	ID tiền tệ (bắt buộc)
exchangeRate	String	Tỉ giá tương ứng (bắt buộc)
investorSigningUnitId	Integer	Đơn vị chủ đầu tư ký hợp đồng (ID)
risk	String	Rủi ro
contractAttachments	String	File đính kèm hợp đồng
appendixAttachments	String	File đính kèm phụ lục
isInWorkflow	Integer	1: trong quy trình, 0: ngoài quy trình (bắt buộc)
signedAt	Timestamp	Ngày ký hợp đồng
expectedFinishAt	Timestamp	Ngày dự kiến hoàn thành
warrantyExpiredAt	Timestamp	Ngày hết hạn bảo hành
potId	Integer	POT ID
investorSigningUnitName	String	Tên đơn vị chủ đầu tư ký hợp đồng
departmentName	String	Tên phòng ban
contractTypeName	String	Tên loại hợp đồng
projectName	String	Tên dự án
organizationName	String	Tên nhà cung cấp
currencyUnitName	String	Tên đơn vị tiền tệ

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

3.4.1.2. Màn hình pop-up "Thêm mới hợp đồng"

	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	Mã HĐ ngoài quy trình BPM	Công tắc (Toggle)	Bắt buộc	- Không cho phép người dùng nhấn để thao tác chuyển đổi trạng thái của công tắc - Khi mở màn hình “Thêm mới hợp đồng”, công tắc được hiển thị mặc định ở trạng thái Bật (ON) và người dùng không được phép thay đổi trạng thái này trong bước tạo mới. Công tắc Bật (ON): Hợp đồng này được xử lý ngoài luồng quy trình BPM.	Thể hiện công tắc phân loại các hợp đồng có hoặc không được sử dụng trong luồng quy trình BPM.
2	Trạng thái hợp đồng	Lựa chọn (Select)	Bắt buộc	- Cho phép người dùng nhấn để chọn trạng thái hợp đồng từ danh sách thả xuống của trường: - Gía trị của trường Chờ thống nhất: Khi nhân viên KHTH bấm nút hoàn thành từ 2442 - User Story - Nhân viên kế hoạch - tổng hợp soạn thảo hợp đồng Đang thực hiện: Khi nhân viên KHTH bấm nút hoàn thành từ 1556 - User Story - Ký kết và phát hành hợp đồng giấy Đã quyết toán: để sẵn chờ tích hợp ERP Hủy - Không được để trống	Thể hiện trạng thái của hợp đồng khi thêm mới đơn 1 hợp đồng.
3	Số hợp đồng	Văn bản (Text)	Bắt buộc	- Cho phép người dùng chọn thông tin số hợp đồng. - Số hợp đồng là giá trị duy nhất, không được trùng với bất kỳ số hợp đồng nào đã tồn tại. - Không được để trống.	Thể hiện số hợp đồng
4	Loại hợp đồng	Lựa chọn (Select)	Bắt buộc	- Cho phép chọn loại hợp đồng với trạng thái đang hoạt động từ danh mục loại hợp đồng. - Sau khi người dùng chọn giá trị loại hợp đồng, giá trị này sẽ được hiển thị trực tiếp trong trường "Loại hợp đồng". - Không được để trống.	Thể hiện loại hợp đồng
5	Tên hợp đồng/ gói thầu	Văn bản (Text)	Bắt buộc	Cho phép nhập tên hợp đồng/gói thầu	Thông tin tên hợp đồng/ gói thầu
6	Dự án	Lựa chọn (Select)	Bắt buộc	- Cho phép nhập dự án với trạng thái đang hoạt động từ danh mục loại hợp đồng. - Sau khi người dùng chỉnh sửa giá trị dự án, giá trị này sẽ được hiển thị trực tiếp trong trường "Dự án". - Không được để trống.	Thể hiện tên dự án gói thầu
7	Nhà cung cấp	Lựa chọn (Select)	Bắt buộc	- Cho phép chọn nhà cung cấp với trạng thái hoạt động từ danh mục NT/NCC. - Sau khi người dùng chọn giá trị trong trường “Nhà cung cấp” và tự động hiển thị giá trị trong trường Mã số thuế (số thứ tự 8) tương ứng. - Không được để trống.	Thể hiện tên nhà cung cấp
8	Mã số thuế (NT)	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). - Sau khi người dùng chọn giá trị trong trường “Nhà cung cấp”, hệ thống tự động hiển thị giá trị trong trường Mã số thuế tương ứng.	Thể hiện mã số thuế nhà thầu
9	Phòng ban thực hiện	Lựa chọn (Droplist)	Không bắt buộc	- Cho phép chọn phòng ban thực hiện -Dữ liệu được lấy thông tin từ danh mục "Quản lý người dùng/ Cài đặt cơ sở/ Danh sách phòng ban) - Sau khi người dùng chọn giá trị phòng ban thực hiện, giá trị này sẽ được hiển thị trực tiếp trong trường "Phòng ban thực hiện". - Không được để trống.	Thông tin phòng ban thực hiển dự án
10	Ngày ký hợp đồng	Bộ chọn ngày (Date picker)	Bắt buộc	- Cho phép người dùng nhấn để chọn giá trị ngày ký của hợp đồng. - Sau khi người dùng chọn ngày và lưu, giá trị ngày được hiển thị trực tiếp trong trường "Ngày ký hợp đồng". - Không được để trống.	Thể hiện ngày ký hợp đồng
11	Ngày dự kiến hoàn thành	Bộ chọn ngày (Date picker)	Bắt buộc	- Cho phép người dùng nhấn để chọn giá trị ngày dự kiến hoàn thành của hợp đồng. - Không được để trống	Thể hiện ngày dự kiến hoàn thành triển khai hợp đồng
12	Thời gian thực hiện (ngày)	Số (Number)	Bắt buộc	- Cho phép nhập số dương (số nguyên hoặc số thập phân) với giá trị > 0 - Sau khi người dùng nhập số ngày thực hiện công việc, giá trị ngày được hiển thị trực tiếp trong trường "Thời gian thực hiện".	Thông tin thời gian số ngày triển khai thực hiện hợp đồng
13	Ngày hết hạn bảo hành	Thời gian (Date - Time)	Bắt buộc	- Cho phép nhập ngày hết hạn bảo hành - Sau khi người dùng nhập số ngày thực hiện công việc, giá trị ngày được hiển thị trực tiếp trong trường "Thời gian thực hiện (ngày)" - Không được để trống	Thông tin thời gian hết hạn bảo hành
14	Đơn vị chủ đầu tư ký hợp đồng	Lựa chọn (Select)	Bắt buộc	- Cho phép nhập tên đơn vị chủ đầu tư ký hợp đồng với trạng thái đang hoạt động ký hợp đồng từ danh mục quản lý người dùng/cài đặt cơ sở/danh sách chi nhánh - Sau khi người dùng nhập tên đơn vị chủ đầu tư ký hợp đồng, giá trị ngày được hiển thị trực tiếp trong trường "Tên đơn vị chủ đầu tư ký hợp đồng".	Thông tin đơn vị chủ đầu tư ký hợp đồng
15	Giá trị HĐ trước thuế	Số (Number)	Bắt buộc	- Cho phép nhập giá trị hợp đồng trước thuế - Sau khi người dùng nhập giá trị hợp đồng trước thuế, giá trị ngày được hiển thị trực tiếp trong trường "Giá trị hợp đồng trước thuế". - Không được để trống	Thể hiện giá trị hợp đồng trước thuế
16	Giá trị HĐ sau thuế	Số (Number)	Bắt buộc	- Cho phép nhập giá trị giá trị hợp đồng sau thuế. - Sau khi người dùng nhập giá trị hợp đồng sau thuế, giá trị ngày được hiển thị trực tiếp trong trường "Giá trị hợp đồng sau thuế.". - Không được để trống	Thể hiện giá trị hợp đồng sau thuế
17	Giá trị HĐ trước thuế sau điều chỉnh	Số (Number)	Không bắt buộc	- Cho phép nhập giá trị giá trị hợp đồng trước thuế sau điều chỉnh. - Sau khi người dùng nhập giá trị hợp đồng trước thuế sau điều chỉnh, giá trị ngày được hiển thị trực tiếp trong trường "Giá trị HĐ trước thuế sau điều chỉnh".	Thể hiện giá trị hợp đồng trước thuế khi bổ sung phụ lục
18	Giá trị HĐ sau thuế sau điều chỉnh	Số (Number)	Không bắt buộc	- Cho phép nhập giá trị giá trị hợp đồng sau thuế sau điều chỉnh. - Sau khi người dùng nhập giá trị hợp đồng sau thuế sau điều chỉnh, giá trị ngày được hiển thị trực tiếp trong trường "Giá trị HĐ sau thuế sau điều chỉnh".	Thể hiện giá trị hợp đồng sau thuế khi bổ sung phụ lục
19	Đơn vị tiền tệ	Lựa chọn (Select)	Bắt buộc	- Cho phép chọn tên đơn vị tiền tệ trạng thái hoạt động từ danh mục đơn vị tiền tệ - Sau khi người dùng nhập đơn vị tiền tệ, giá trị ngày được hiển thị trực tiếp trong trường "Đơn vị tiền tệ". - Không được để trống	Thể hiện đơn vị tiền tệ sử dụng cho hợp đồng
20	Tỉ giá tương ứng	Số (number)	Bắt buộc	- Cho phép chọn tỷ giá tương đương với đơn vị tệ tương ứng - Sau khi người dùng nhập tỷ giá tương đương với đơn vị tệ tương ứng, giá trị ngày được hiển thị trực tiếp trong trường "Tỉ giá tương ứng". - Không được để trống	Thể hiện tỷ giá quy đổi của ngoại tệ (nếu có)
21	Rủi ro	Văn bản (Text) area	Không bắt buộc	- Cho phép nhập rủi ro hợp đồng - Sau khi người dùng nhập thông tin rủi ro, giá trị ngày được hiển thị trực tiếp trong trường "Rủi ro". - Không được để trống	Thể hiện rủi ro của hợp đồng
22	File hợp đồng đính kèm	Nút chức năng (Button)	Không bắt buộc	Cho phép nhấn để tải lên file đính kèm file HĐ	Thể hiện nút tải lên file phụ lục được ký kết
23	File phụ lục đính kèm	Nút chức năng (Button)	Không bắt buộc	Cho phép nhấn để tải lên file phụ lục hợp đồng	Thể hiện nút tải lên phụ lục được ký kết
24	Nút đóng "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 thêm mới đơn 1 hợp đồng. - Khi nhấn, màn hình pop-up "Thêm mới hợp đồng" đóng lại và hệ thống điều hướng về màn hình "Danh sách hợp đồng. - Màn hình "Danh sách hợp đồng: Tham chiếu mục 3.4.1. Màn hình "Danh sách hợp đồng.	Thể hiện nút đóng cho phép hủy bỏ thao tác thêm mới đơn 1 hợp đồng.
25	Nút "Áp dụng"	Nút chức năng (Button)	Không bắt buộc	- Cho phép nhấn để lưu thông tin thêm mới đơn 1 hợp đồng - Trong mỗi trường hợp, hệ thống xử lý như sau: Trường hợp 1: Thêm mới dữ liệu hợp lệ: Điều kiện: Tất cả các trường bắt buộc được nhập đầy đủ. Ngày dự kiến hoàn thành > Ngày hợp đồng Ngày hết hạn bảo hành > Ngày dự kiến hoàn thành Số hợp đồng không trùng với bất kỳ bản ghi nào đang có trong hệ thống. Hành vi hệ thống: Hợp đồng được thêm mới hiển thị với giá trị trạng thái mặc định là "Hoạt động". Hệ thống hiển thị thông báo thành công. Tiêu đề thông báo: Thành công Nội dung thông báo: Thêm mới hợp đồng thành công Trường hợp 2: Thêm mới dữ liệu không hợp lệ: Điều kiện: Trường bắt buộc KHÔNG được nhập đầy đủ Trường đặc thù được nhập dữ liệu KHÔNG HỢP LỆ gồm: Ngày dự kiến hoàn thành < Ngày ký hợp đồng Ngày hết hạn bảo hành < Ngày dự kiến hoàn thành Số hợp đồng không trùng với bản ghi sẵn có trong hệ thống. Thời gian thực hiện (ngày): Nhập dấu phẩy “,” hoặc dấu chấm “.” nhưng không phải số hợp lệ (ví dụ: , ; . ; 1..2) Nhập số âm ( -5, -10 ) Nhập số bằng 0 Hành vi hệ thống: Kiểm tra dữ liệu tại dòng (inline validation) và hiển thị cảnh báo ngay dưới trường nhập chưa đầy đủ/không hợp lệ hoặc hiển thị pop-up cảnh báo như sau: Ngày dự kiến hoàn thành < Ngày ký hợp đồng → Hiển thị pop-up cảnh báo: Tham chiếu mục 3.4.3. Màn hình pop-up cảnh báo Ngày hết hạn bảo hành < Ngày dự kiến hoàn thành → Hiển thị pop-up cảnh báo: Tham chiếu mục 3.4.3. Màn hình pop-up cảnh báo Thời gian thực hiện (ngày) → Hiển thị cảnh báo ngay dưới trường: Giá trị không hợp lệ Không đóng màn hình pop-up Thêm mới hợp đồng	Thể hiện nút cho phép lưu thông tin hợp đồng.
26	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 để hủy bỏ thao tác thêm mới đơn 1 hợp đồng. - Khi nhấn, màn hình pop-up "Thêm mới hợp đồng" đóng lại và hệ thống điều hướng về màn hình "Danh sách hợp đồng. - Màn hình "Danh sách hợp đồng: Tham chiếu mục 3.4.1. Màn hình "Danh sách hợp đồng.	Thể hiện nút Hủy để để hủy bỏ thao tác thêm mới đơn 1 hợp đồng.

3.4.1.3. Màn hình pop-up "Chỉnh sửa hợp đồng"

3.4.1.3.1. Màn hình pop-up "Chỉnh sửa hợp đồng" - Tab "Thông tin chi tiết" với mã quy định HĐ NGOÀI quy trình BPM

	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Đ ngoài quy trình BPM	Toggle Nút chức năng (Button)	Bắt buộc	- Khi mở màn hình “Thêm mới hợp đồng”, công tắc được hiển thị mặc định ở trạng thái Bật (ON) và người dùng không được phép thay đổi trạng thái này trong bước tạo mới. Công tắc Bật (ON): Hợp đồng này được xử lý ngoài luồng quy trình BPM.	Thể hiện công tắc phân loại các hợp đồng có hoặc không được sử dụng trong luồng quy trình BPM.
2	Trạng thái hợp đồng	Lựa chọn (Select)	Bắt buộc	- Cho phép người dùng nhấn để chỉnh sửa trạng thái hợp đồng từ danh sách thả xuống của trường: - Gía trị của trường Chờ thống nhất Đang thực hiện Đã quyết toán Hủy - Không được để trống	Thể hiện trạng thái của hợp đồng khi thêm mới đơn 1 hợp đồng.
3	Số hợp đồng	Văn bản (Text)	Bắt buộc	- Cho phép người dùng chỉnh sửa thông tin số hợp đồng. - Số hợp đồng là giá trị duy nhất, không được trùng với bất kỳ số hợp đồng nào đã tồn tại. - Không được để trống.	Thể hiện số hợp đồng
4	Loại hợp đồng	Lựa chọn (Droplist)	Bắt buộc	- Cho phép chỉnh sửa loại hợp đồng với trạng thái đang hoạt động từ danh mục loại hợp đồng. - Sau khi người dùng chỉnh sửa giá trị loại hợp đồng, giá trị này sẽ được hiển thị trực tiếp trong trường "Loại hợp đồng". - Không được để trống.	Thể hiện loại hợp đồng
5	Tên hợp đồng/ gói thầu	Văn bản (Text)	Bắt buộc	Cho phép chỉnh sửa tên hợp đồng/gói thầu	Thông tin tên hợp đồng/ gói thầu
6	Dự án	Văn bản (Text)	Bắt buộc	- Cho phép chỉnh sửa dự án với trạng thái đang hoạt động từ danh mục loại hợp đồng. - Sau khi người dùng chỉnh sửa giá trị dự án, giá trị này sẽ được hiển thị trực tiếp trong trường "Dự án". - Không được để trống.	Thể hiện tên dự án gói thầu
7	Nhà cung cấp	Văn bản (Text)	Bắt buộc	- Cho phép chỉnh sửa dự án với trạng thái đang hoạt động từ danh mục NT/NCC. - Sau khi người dùng chỉnh sửa giá trị trong trường “Nhà cung cấp” và tự động hiển thị giá trị trong trường Mã số thuế (số thứ tự 8) tương ứng. - Không được để trống.	Thể hiện tên nhà cung cấp
8	Mã số thuế (NT)	Văn bản (Text)	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). - Sau khi người dùng chọn giá trị trong trường “Nhà cung cấp”, hệ thống tự động hiển thị giá trị trong trường Mã số thuế tương ứng.	Thể hiện mã số thuế nhà thầu
9	Phòng ban thực hiện	Lựa chọn (Droplist)	Không bắt buộc	- Cho phép chỉnh sửa phòng ban thực hiện -Dữ liệu được lấy thông tin từ danh mục "Quản lý người dùng/ Cài đặt cơ sở/ Danh sách phòng ban) - Sau khi người dùng chỉnh sửa giá trị phòng ban thực hiện, giá trị này sẽ được hiển thị trực tiếp trong trường "Phòng ban thực hiện". - Không được để trống.	Cho phép chỉnh sửa thông tin phòng ban thực hiện dự án
10	Ngày ký hợp đồng	Thời gian (Date )	Bắt buộc	- Cho phép người dùng nhấn để chỉnh sửa giá trị ngày ký của hợp đồng. - Sau khi người dùng chỉnh sửa ngày và lưu, giá trị ngày được hiển thị trực tiếp trong trường "Ngày ký hợp đồng". - Không được để trống.	Thể hiện ngày ký hợp đồng
11	Ngày dự kiến hoàn thành	Thời gian (Date )	Bắt buộc	- Cho phép người dùng nhấn để chỉnh sửa giá trị ngày dự kiến hoàn thành của hợp đồng. - Không được để trống	Thể hiện ngày dự kiến hoàn thành triển khai hợp đồng
12	Thời gian thực hiện	Số (Number)	Bắt buộc	- Cho phép chỉnh sửa số ngày thực hiện công việc - Sau khi người dùng nhập số ngày thực hiện công việc, giá trị ngày được hiển thị trực tiếp trong trường "Thời gian thực hiện".	Thông tin thời gian số ngày triển khai thực hiện hợp đồng
13	Ngày hết hạn bảo hành	Thời gian (Date )	Bắt buộc	- Cho phép chỉnh sửa ngày hết hạn bảo hành - Sau khi người dùng chỉnh sửa số ngày thực hiện công việc, giá trị ngày được hiển thị trực tiếp trong trường "Thời gian thực hiện" - Không được để trống	Thông tin thời gian hết hạn bảo hành
14	Đơn vị chủ đầu tư ký hợp đồng	Lựa chọn (Droplist)	Bắt buộc	- Cho phép chỉnh sửa tên đơn vị chủ đầu tư ký hợp đồng với trạng thái đang hoạt động ký hợp đồng từ danh mục quản lý người dùng/cài đặt cơ sở/danh sách chi nhánh - Sau khi người dùng chỉnh sửa tên đơn vị chủ đầu tư ký hợp đồng, giá trị ngày được hiển thị trực tiếp trong trường "Tên đơn vị chủ đầu tư ký hợp đồng".	Thông tin đơn vị chủ đầu tư ký hợp đồng
15	Giá trị HĐ trước thuế	Số (Number)	Bắt buộc	- Cho phép chỉnh sửa giá trị hợp đồng trước thuế - Sau khi người dùng chỉnh sửa giá trị hợp đồng trước thuế, giá trị ngày được hiển thị trực tiếp trong trường "Giá trị hợp đồng trước thuế". - Không được để trống	Thể hiện giá trị hợp đồng trước thuế
16	Giá trị HĐ sau thuế	Số (Number)	Bắt buộc	- Cho phép người dùng chỉnh sửa giá trị hợp đồng sau thuế. - Sau khi người dùng chỉnh sửa giá trị hợp đồng sau thuế, giá trị ngày được hiển thị trực tiếp trong trường "Giá trị hợp đồng sau thuế.". - Không được để trống	Thể hiện giá trị hợp đồng sau thuế
17	Giá trị HĐ trước thuế sau điều chỉnh	Số (Number)	Không bắt buộc	- Cho phép nhập giá trị hợp đồng trước thuế sau điều chỉnh. - Sau khi người dùng nhập giá trị hợp đồng trước thuế sau điều chỉnh, giá trị ngày được hiển thị trực tiếp trong trường "Giá trị HĐ trước thuế sau điều chỉnh".	Thể hiện giá trị hợp đồng trước thuế khi bổ sung phụ lục
18	Giá trị HĐ sau thuế sau điều chỉnh	Số (Number)	Không bắt buộc	- Cho phép chỉnh sửa giá trị giá trị hợp đồng sau thuế sau điều chỉnh. - Sau khi người dùng chỉnh sửa giá trị hợp đồng sau thuế sau điều chỉnh, giá trị ngày được hiển thị trực tiếp trong trường "Giá trị HĐ sau thuế sau điều chỉnh".	Thể hiện giá trị hợp đồng sau thuế khi bổ sung phụ lục
19	Đơn vị tiền tệ	Văn bản (Text)	Không bắt buộc	- Cho phép chọn chỉnh sửa đơn vị tiền tệ trạng thái hoạt động từ danh mục đơn vị tiền tệ - Sau khi người dùng chỉnh sửa đơn vị tiền tệ, giá trị ngày được hiển thị trực tiếp trong trường "Đơn vị tiền tệ". - Không được để trống	Thể hiện đơn vị tiền tệ sử dụng cho hợp đồng
20	Tỉ giá tương ứng	Văn bản (Text)	Không bắt buộc	- Cho phép chỉnh sửa tỷ giá tương đương với đơn vị tệ tương ứng - Sau khi người dùng chỉnh sửa tỷ giá tương đương với đơn vị tệ tương ứng, giá trị ngày được hiển thị trực tiếp trong trường "Tỉ giá tương ứng". - Không được để trống	Thể hiện tỷ giá quy đổi của ngoại tệ (nếu có)
21	Rủi ro	Văn bản (Text) area	Không bắt buộc	- Cho phép chỉnh sửa rủi ro hợp đồng - Sau khi người dùng chỉnh sửa thông tin rủi ro, giá trị ngày được hiển thị trực tiếp trong trường "Rủi ro". - Không được để trống	Thể hiện tỷ giá quy đổi của ngoại tệ (nếu có)
22	File hợp đồng đính kèm	Nút chức năng (Button)	Không bắt buộc	- Cho phép chỉnh sửa dữ liệu - Cho phép người dùng xem lại tài liệu đính kèm - Cho phép người dùng tải về tài liệu đính kèm -Cho phép người dùng up file dữ liệu lên	Thể hiện file hợp đồng được ký kết
23	File phụ lục đính kèm	Nút chức năng (Button)	Không bắt buộc	- Cho phép chỉnh sửa dữ liệu - Cho phép người dùng xem lại tài liệu đính kèm - Cho phép người dùng tải về tài liệu đính kèm -Cho phép người dùng up file dữ liệu lên	Thể hiện file phụ lục hợp đồng được ký kết
24	Nút đóng "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 chỉnh sửa đơn 1 hợp đồng. - Khi nhấn, màn hình pop-up "Thêm mới hợp đồng" đóng lại và hệ thống điều hướng về màn hình "Danh sách hợp đồng. - Màn hình "Danh sách hợp đồng: Tham chiếu mục 3.4.1. Màn hình "Danh sách hợp đồng.	Thể hiện nút đóng cho phép hủy bỏ thao tác chỉnh sửa đơn 1 hợp đồng.
25	Nút "Áp dụng"	Nút chức năng (Button)	Không bắt buộc	- Cho phép nhấn để lưu thông tin chỉnh sửa đơn 1 hợp đồng - Trong mỗi trường hợp, hệ thống xử lý như sau: Trường hợp 1: Nhập dữ liệu chỉnh sửa dữ liệu hợp lệ: Điều kiện: Tất cả các trường bắt buộc được nhập đầy đủ. Ngày dự kiến hoàn thành > Ngày hợp đồng Ngày hết hạn bảo hành > Ngày dự kiến hoàn thành Số hợp đồng không trùng với bất kỳ bản ghi nào đang có trong hệ thống. Hành vi hệ thống: Hợp đồng được thêm mới hiển thị với giá trị trạng thái mặc định là "Hoạt động". Hệ thống hiển thị thông báo thành công. Tiêu đề thông báo: Thành công Nội dung thông báo: Thêm mới hợp đồng thành công Trường hợp 2: Nhập dữ liệu chỉnh sửa dữ liệu không hợp lệ: Điều kiện: Trường bắt buộc KHÔNG được nhập đầy đủ Trường đặc thù được nhập dữ liệu KHÔNG HỢP LỆ gồm: Ngày dự kiến hoàn thành < Ngày ký hợp đồng Ngày hết hạn bảo hành < Ngày dự kiến hoàn thành Số hợp đồng không trùng với bản ghi sẵn có trong hệ thống. Thời gian thực hiện (ngày): Nhập dấu phẩy “,” hoặc dấu chấm “.” nhưng không phải số hợp lệ (ví dụ: , ; . ; 1..2) Nhập số âm ( -5, -10 ) Nhập số bằng 0 Hành vi hệ thống: Kiểm tra dữ liệu tại dòng (inline validation) và hiển thị cảnh báo ngay dưới trường nhập chưa đầy đủ/không hợp lệ hoặc hiển thị pop-up cảnh báo như sau: Ngày dự kiến hoàn thành < Ngày ký hợp đồng → Hiển thị pop-up cảnh báo: Tham chiếu mục 3.4.3. Màn hình pop-up cảnh báo Ngày hết hạn bảo hành < Ngày dự kiến hoàn thành → Hiển thị pop-up cảnh báo: Tham chiếu mục 3.4.3. Màn hình pop-up cảnh báo Thời gian thực hiện (ngày) → Hiển thị cảnh báo ngay dưới trường: Giá trị không hợp lệ Không đóng màn hình pop-up Thêm mới hợp đồng	Thể hiện nút đóng cho phép lưu thông tin hợp đồng.
26	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 để hủy bỏ thao tác chỉnh sửa đơn 1 hợp đồng. - Khi nhấn, màn hình pop-up "Thêm mới hợp đồng" đóng lại và hệ thống điều hướng về màn hình "Danh sách hợp đồng. - Màn hình "Danh sách hợp đồng: Tham chiếu mục 3.4.1. Màn hình "Danh sách hợp đồng.	Thể hiện nút "Hủy" để hủy bỏ thao tác chỉnh sửa đơn 1 hợp đồng.
27	Tab "Thông tin chi tiết"	Tab điều hướng (Navigation Tab)	Không bắt buộc	- Cho phép người dùng nhấn để truy cập màn hình "Chỉnh sửa hợp đồng" - Tab "Thông tin chi tiết" - Khi nhấn, hệ thống mở pop-up “Chỉnh sửa hợp đồng” - Tab “Thông tin chi tiết” để người dùng xem thông tin hợp đồng.	Thể hiện toàn bộ thông tin chi tiết của hợp đồng ở dạng chỉ xem.
28	Tab "Lịch sử chỉnh sửa"	Tab điều hướng (Navigation Tab)	Không bắt buộc	- Cho phép người dùng nhấn để truy cập màn hình "Chỉnh sửa hợp đồng" - Tab "Lịch sử chỉnh sửa" - Khi nhấn, hệ thống mở pop-up “Chỉnh sửa hợp đồng” - Tab “Lịch sử chỉnh sửa” để người dùng xem thông tin lịch sử chỉnh sửa.	Thể hiện danh sách các lần chỉnh sửa hợp đồng kèm thời gian, người thực hiện và chi tiết thay đổi.

3.4.1.3.3. Màn hình pop-up "Chỉnh sửa hợp đồng" - Tab "Lịch sử chỉnh sửa"

	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	Màn hình lịch sửa chỉnh sửa				Khi chưa có lịch sử chỉnh sửa hợp đồng, hệ thống hiển thị màn hình trống kèm văn bản: "Ở đây chưa có gì cả"
2	Thời gian	Thời gian (Date - Time)	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).	Thể hiện thời điểm hệ thống ghi nhận hành động được thực hiện
3	Người thực hiệ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).	Thể hiện tên nhân sự đã thực hiện thao tác trên thông tin chi tiết hợp đồng
4	Chi tiết thay đổi	Đường dẫn (Hyperlink)	Không bắt buộc	- Cho phép người dùng nhấn để truy cập màn hình "Chỉnh sửa hợp đồng" - Tab "Lịch sử chỉnh sửa" - Khi nhấn, hệ thống hiển thị màn hình "Xem chi tiết lịch sử". - Màn hình "Xem chi tiết hợp đồng": tham chiếu mục 3.4.1.3.4. Màn hình pop-up "Xem chi tiết hợp đồng".	Thông tin chi tiết thay đổi lịch sử chỉnh sửa hệ thống
5	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 xem thông tin chung về lịch sử chỉnh sửa - Khi nhấn, màn hình pop-up "Chỉnh sửa hợp đồng" đóng lại và hệ thống điều hướng về màn hình "Xem chi tiết hợp đồng - Tab Thông tin chi tiết.	Thể hiện nút đóng cho phép hủy bỏ thao tác xem thông tin chung về lịch sử chỉnh sửa.

3.4.1.3.4. Màn hình pop-up "Chỉnh sửa hợp đồng" - Tab "Lịch sử chỉnh sửa" - Chi tiết lịch sử chỉnh sửa

	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	Màn hình lịch sửa chỉnh sửa				Khi chưa có lịch sử chỉnh sửa hợp đồng, hệ thống hiển thị màn hình trống kèm văn bản: "Ở đây chưa có gì cả"
2	Thời gian chỉnh sửa	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).	Thể hiện thời điểm thực hiện chỉnh sửa hợp đồng.
3	Người thực hiệ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).	Thể hiện tên người đã thực hiện chỉnh sửa.
4	Trường bị thay đổ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).	Thể hiện tên trường thông tin đã bị chỉnh sửa.
5	Thông tin trước thay đổ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).	Thể hiện giá trị cũ trước khi chỉnh sửa.
6	Thông tin sau thay đổ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).	Thể hiện giá trị mới sau khi chỉnh sửa.
7	Nút quay lại	Nút chức năng (Button)	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).	Thể hiện nút "Quay lại" để điều hướng "Xem chi tiết hợp đồng - Tab Thông tin chi tiết.
8	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 xem thông tin chi tiết lịch sử chỉnh sửa. - Khi nhấn, màn hình pop-up "Chỉnh sửa hợp đồng" đóng lại và hệ thống điều hướng về màn hình "Xem chi tiết hợp đồng - Tab Thông tin chi tiết.	Thể hiện nút đóng cho phép hủy bỏ thao tác xem thông tin chi tiết lịch sử chỉnh sửa.
9	Chi tiết lịch sử chỉnh sửa	Nút chức năng (Button)	Không bắt buộc	- Cho phép người dùng nhấn để quay về màn hình "Xem chi tiết hợp đồng - Tab Thông tin chi tiết. - Khi nhấn, màn hình pop-up "Chỉnh sửa hợp đồng" đóng lại và hệ thống điều hướng về màn hình "Xem chi tiết hợp đồng - Tab Thông tin chi tiết.	Thể hiện nút đóng cho phép quay về màn hình "Xem chi tiết hợp đồng - Tab Thông tin chi tiết.

3.4.2. Màn hình "Xem chi tiết hợp đồng" - Tab Thông tin chi tiết"

	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Đ ngoài quy trình BPM	Toggle Nút chức năng (Button)	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).	Thể hiện thông tin quy định với các hợp đồng thực hiện bên trong luồng quy trình BPM
2	Số hợp đồng	Văn bản (Text)	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).	Thể hiện số hợp đồng
3	Loại hợp đồng	Văn bản (Text)	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).	Thể hiện loại hợp đồng
4	Tên hợp đồng/ gói thầu	Văn bản (Text)	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).	Thông tin tên hợp đồng/ gói thầu
5	Dự án	Văn bản (Text)	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).	Thể hiện tên dự án gói thầu
6	Nhà cung cấp	Văn bản (Text)	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).	Thể hiện tên nhà cung cấp
7	Mã số thuế (NT)	Văn bản (Text)	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).	Thể hiện mã số thuế nhà thầu
8	Phòng ban thực hiện	Lựa chọn (Droplist)	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). - Nguồn dữ liệu: Không cho phép người dùng thao tác tương tác (nhấn/chọn/sửa).	Thông tin phòng ban quản lý dự án
9	Ngày ký hợp đồng	Thời gian (Date )	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).	Thể hiện ngày ký hợp đồng
10	Ngày dự kiến hoàn thành	Thời gian (Date )	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).	Thể hiện ngày dự kiến hoàn thành triển khai hợp đồng
11	Thời gian thực hiện	Số (Number)	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).	Thông tin thời gian số ngày triển khai thực hiện hợp đồng
12	Ngày hết hạn bảo hành	Thời gian (Date )	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).	Thông tin thời gian hết hạn bảo hành
13	Đơn vị chủ đầu tư ký hợp đồng	Lựa chọn (Droplist)	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).	Thông tin đơn vị chủ đầu tư ký hợp đồng - Dữ liệu được lấy theo trường Đơn vị ký hợp đồng trước thuế từ 2442 - User Story - Nhân viên kế hoạch - tổng hợp soạn thảo hợp đồng
14	Giá trị HĐ trước thuế	Số (Number)	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).	Thể hiện giá trị hợp đồng trước thuế
15	Giá trị HĐ 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).	Thể hiện giá trị hợp đồng sau thuế
16	Giá trị HĐ 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).	Thể hiện giá trị hợp đồng trước thuế khi bổ sung phụ lục
17	Giá trị HĐ 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).	Thể hiện giá trị hợp đồng sau thuế khi bổ sung phụ lục
18	Đơn vị tiền tệ	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).	Thể hiện đơn vị tiền tệ sử dụng cho hợp đồng
19	Tỉ giá tương ứ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).	Thể hiện tỷ giá quy đổi của ngoại tệ (nếu có)
20	Trạng thá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). - Trạng thái hợp đồng với HĐ TRONG quy trình BPM thể hiện theo: Chờ thống nhất Đang thực hiện Đã quyết toán: để sẵn chờ tích hợp ERP Hủy	Thể hiện trạng thái của hợp đồng
21	Rủi ro	Văn bản (Text) area	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).	Thể hiện thông tin rủi ro
22	File HĐ/PL đính kèm	Nút chức năng (Button)	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).	Thể hiện file hợp đồng được ký kết
23	Tab "Thông tin chi tiết"	Tab điều hướng (Navigation Tab)	Không bắt buộc	- Cho phép người dùng nhấn để truy cập màn hình "Chỉnh sửa hợp đồng" - Tab "Thông tin chi tiết" - Khi nhấn, hệ thống mở pop-up “Chỉnh sửa hợp đồng” - Tab “Thông tin chi tiết” để người dùng xem thông tin hợp đồng.	Thể hiện toàn bộ thông tin chi tiết của hợp đồng ở dạng chỉ xem.
24	Tab "Lịch sử chỉnh sửa"	Tab điều hướng (Navigation Tab)	Không bắt buộc	- Cho phép người dùng nhấn để truy cập màn hình "Chỉnh sửa hợp đồng" - Tab "Lịch sử chỉnh sửa" - Khi nhấn, hệ thống mở pop-up “Chỉnh sửa hợp đồng” - Tab “Lịch sử chỉnh sửa” để người dùng xem thông tin lịch sử chỉnh sửa.	Thể hiện danh sách các lần chỉnh sửa hợp đồng kèm thời gian, người thực hiện và chi tiết thay đổi.
25	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 xem thông tin chi tiết hợp đồng. - Khi nhấn, màn hình pop-up "Xem chi tiết hợp đồng" đóng lại và hệ thống điều hướng về màn hình "Danh sách hợp đồng. - Màn hình "Danh sách hợp đồng: Tham chiếu mục 3.4.1. Màn hình "Danh sách hợp đồng.	Thể hiện nút đóng cho phép hủy bỏ thao tác xem thông tin chi tiết hợp đồng.
26	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 để hủy bỏ thao tác xem thông tin chi tiết hợp đồng. - Khi nhấn, màn hình pop-up "Xem chi tiết hợp đồng" đóng lại và hệ thống điều hướng về màn hình "Danh sách hợp đồng. - Màn hình "Danh sách hợp đồng: Tham chiếu mục 3.4.1. Màn hình "Danh sách hợp đồng.	Thể hiện nút "Hủy" để thực hiện hủy bỏ thao tác xem thông tin chi tiết hợp đồng.

3.4.3. Màn hình "Pop-up cảnh báo"

3.4.5. Màn hình pop-up "Nhập file excel"

...

Page tree

Page History

Versions Compared

Old Version 29

New Version 30

Key

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)

3.1 UIUX:

3.1.1. Màn hình "Danh sách hợp đồng"

3.1.1.1. Màn hình kết quả tìm kiếm khi: Không có kết quả tìm kiếm/Danh sách trống

3.1.1.2. Màn hình pop-up "bộ lọc"

Image Modified

3.1.1.3. Màn hình pop-up "Tải tài liệu"

3.1.1.4. Màn hình pop-up "Thêm mới hợp đồng"

3.1.1.5. Màn hình pop-up "Chỉnh sửa hợp đồng"

3.1.1.5.1. Màn hình pop-up "Chỉnh sửa hợp đồng" với mã quy định HĐ NGOÀI quy trình BPM :

3.1.1.5.2. Màn hình pop-up "Chỉnh sửa hợp đồng" với mã quy định HĐ TRONG quy trình BPM :

3.1.1.6. Màn hình pop-up "Xem chi tiết hợp đồng"

3.1.1.7. Màn hình pop-up "Cảnh báo"

3.1.1.7. Màn hình pop-up "Cảnh báo trùng"

3.1.1.7. Màn hình pop-up "Cảnh báo điều kiện ngày hoàn thành (ngày hoàn thành nhỏ hơn ngày hợp đồng)

3.1.1.7. Màn hình pop-up "Cảnh báo ngày hết hạn bảo hành (ngày hết hạn bảo hành nhỏ hơn ngày dự kiến hoàn thành/ngày hợp đồng/ngày hiệu lực)"

3.1.1.8. Màn hình pop-up "Nhập file excel"

3.1.1.8. Màn hình pop-up "Xuất file excel"

3.1.1.8. Màn hình pop-up "Lỗi nhập file excel"

3.1.1.9. Màn hình pop-up "Thông báo"

3.1.1.9.1. Màn hình toast Nhập dữ liệu thành công

3.1.1.9.2. Màn hình toast Xuất dữ liệu thành công

3.1.1.9.3. Màn hình toast Không thành công

3.1.1.9.4. Màn hình toast Thành công

3.2 Luồng:

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

1. Headers

2. Param

3. Response / Incoming Data Specification

1. Headers

2. Param

3. Response / Incoming Data Specification

1. Headers

2. Param

3. Response / Incoming Data Specification

1. Headers

2. Param

3. Response / Incoming Data Specification

1. Headers

2. Param

3. Response / Incoming Data Specification

1. Headers

2. Param

3. Response / Incoming Data Specification

1. Headers

2. Param

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.2. Màn hình pop-up "Thêm mới hợp đồng"

3.4.1.3. Màn hình pop-up "Chỉnh sửa hợp đồng"

3.4.1.3.1. Màn hình pop-up "Chỉnh sửa hợp đồng" - Tab "Thông tin chi tiết" với mã quy định HĐ NGOÀI quy trình BPM

3.4.1.3.3. Màn hình pop-up "Chỉnh sửa hợp đồng" - Tab "Lịch sử chỉnh sửa"

3.4.1.3.4. Màn hình pop-up "Chỉnh sửa hợp đồng" - Tab "Lịch sử chỉnh sửa" - Chi tiết lịch sử chỉnh sửa

3.4.2. Màn hình "Xem chi tiết hợp đồng" - Tab Thông tin chi tiết"

3.4.3. Màn hình "Pop-up cảnh báo"