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 | ||
Nguyễn Đức Trung | ||||
Tài khoản email/MS team | mimk3 | trungnd3 | ||
trungnd3 | ||||
Chức danh | Business Analyst (BA) | Product Owner (P.O) | ||
Business Analyst Business (BA BIZ) | ||||
Ngày soạn thảo |
| |||
| ||||
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
- Nhận biết phụ lục ký phát sinh so với phụ lục ban đầu
- 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"
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>
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
| STT | Field | Data Type / Length | Description | Note |
|---|---|---|---|---|
| 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 |
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
| STT | Field | Data Type / Length | Description | Note |
|---|---|---|---|---|
| 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 |
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
| STT | Field | Data Type / Length | Description | Note |
|---|---|---|---|---|
| code | Integer | 0: thành công, != 0 thất bại | ||
| message | String | |||
| result | String |
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
STT | Field | Required | Data Type / Length | Description | Note |
|---|---|---|---|---|---|
| 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
| STT | Field | Data Type / Length | Description | Note |
|---|---|---|---|---|
| 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ệ |
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
STT | Field | Required | Data Type / Length | Description | Note |
|---|---|---|---|---|---|
| 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
| STT | Field | Data Type / Length | Description | Note |
|---|---|---|---|---|
| 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 |
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
STT | Field | Required | Data Type / Length | Description | Note |
|---|---|---|---|---|---|
| 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
| STT | Field | Data Type / Length | 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 |
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
STT | Field | Required | Data Type / Length | Description | Note |
|---|---|---|---|---|---|
| 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
| STT | 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.
| 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
- 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 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 | Lựa chọn (Select) | 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 | 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 | Số (Number) | Bắt buộc | - Cho phép nhập 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 - 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" - 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 | Văn bản (Text) | 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. - 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 - Khi nhấn hệ thống tiến hành xác nhận dữ liệu ca làm việc khi thêm mới như sau: Trường hợp 1: Thêm mới dữ liệu hợp lệ:
Trường hợp 2: Thêm mới dữ liệu không hợp lệ:
| 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. - 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.
| 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
- 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 | 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 | 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 | 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. - 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 - Khi nhấn hệ thống tiến hành xác nhận dữ liệu khi chỉnh sửa như sau:
Trường hợp 1: Dữ liệu hợp lệ
| 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. - 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" | 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" | 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" - 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 | 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. | 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 |
| Nút chức năng (Button) | Không bắt buộc | - Cho phép người dùng nhấn | 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 | 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 | 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 | 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:
| 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" | 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" | 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. - 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. - 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"
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 | Tài liệu mẫu | 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 là "Tài liệu mẫu" để hướng dẫn người dùng về file mẫu cần thiết cho việc nhập dữ liệu. |
| 2 | Tải xuống | Nút chức năng (Button) | Không bắt buộc | - Cho phép người dùng nhấn để thực hiện quá trình xuất tệp dữ liệu mẫu (template) ca làm việc.
| Thể hiện nút chức năng cho phép người dùng chọn vị trí lưu trữ và tải tệp dữ liệu xuống máy tính cá nhân. |
| 3 | Tài liệu đính kèm | 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 mục là "Tài liệu đính kèm" để hướng dẫn người dùng về vị trí đính kèm tệp dữ liệu excel sau khi điền thông tin. | |
| 4 | Nút "Nhấn hoặc tả để tải lên" | Nút chức năng (Button) | Không bắt buộc | - Cho phép người dùng nhấn để mở màn hình pop-up chọn tệp của trình duyệt để lựa chọn tệp dữ liệu cần tải lên từ máy tính cá nhân. | Thể hiện nút chức năng cho phép người dùng đính kèm tệp dữ liệu excel sau khi điền thông tin. |
| 5 | 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 xóa. - Khi nhấn, màn hình pop-up đóng lại và bản ghi thông tin hợp đồng không bị xóa. | Thể hiện nút chức năng cho phép hủy bỏ thao tác mà không lưu dữ liệu. |
| 6 | Nút "Áp dụng" | Nút chức năng (Button) | Không bắt buộc | - Cho phép người dùng nhấn để xác nhận tệp dữ liệu ca làm việc sau khi tải lên như sau: Nút chỉ kích hoạt khi người dùng đã thực hiện đính kèm tài liệu
Lỗi 1: Lỗi tệp không đúng mẫu (không đúng template)
Lỗi 2: Lỗi dữ liệu trong file không hợp lệ (data validation error)
Lỗi 3: Lỗi trùng "số hợp đồng"
| Thể hiện nút chức năng cho phép người dùng xác nhận tệp dữ liệu excel sau khi hoàn thành tải lên. |
| 7 | Nút "X" | Nút chức năng (Button) | Bắt buộc | - Cho phép người dùng nhấn để hủy bỏ thao tác - Khi nhấn, màn hình pop-up đóng lại | Thể hiện nút chức năng cho phép hủy bỏ thao tác mà không lưu dữ liệu. |
3.4.6.Màn hình pop-up "Xuất file excel" :
3.4.7. Màn hình pop-up "Lỗi nhập file excel"
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 | Thông báo tóm tắt lỗ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ổng quan về kết quả của quá trình nhập file Excel như sau:
|
| 2 | Bảng "Danh mục lỗi gặp phả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 tiêu đề bảng: Danh mục các lỗi gặp phải |
| 3 | Dòng lỗ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 cột số thứ tự dòng/hàng bị lỗi trong file Excel gốc. - Tiêu đề cột: Dòng lỗi |
| 4 | Tên lỗ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 cột nội dung/mô tả chi tiết lỗi gặp phải tại dòng tương ứng ở mục 2.1. - Tiêu đề cột: Tên lỗi |
| 5 | Nút "Tải xuống" | Nút chức năng (Button) | Không bắt buộc | - Cho phép người dùng nhấn để thực hiện quá trình tải xuống tệp dữ liệu excel bảng "Danh mục các lỗi gặp phải". - Thông tin tệp dữ liệu được xuất ra:
| |
| 6 | - Cho phép người dùng nhấn để hủy bỏ các thay đổi và đóng giao diện hiện tại mà không lưu thông tin. | Thể hiện nút chức năng cho phép hủy bỏ thao tác mà không lưu dữ liệu. | |||
| 7 | Nút "Nhập lại" | Nút chức năng (Button) | Không bắt buộc | - Cho phép người dùng nhấn nút. - Khi nhấn nút, hệ thống đóng pop-up "Lỗi nhập file excel" và điều hướng người dùng quay lại màn hình pop-up "Nhập file excel": tham chiếu mục: 3.4.5. Màn hình pop-up "Nhập file excel" | Thể hiện nút chức năng cho phép người dùng quay lại màn hình pop-up "Nhập file excel" để thực hiện lại quá trình đính kèm tệp dữ liệu. |
| 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ỏ các thay đổi và đóng giao diện hiện tại mà không lưu thông tin. | Thể hiện nút chức năng cho phép hủy bỏ thao tác mà không lưu dữ liệu. |