Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Panel
titleAPI Spec Document

Method

Get

URL

/application/purchaseRequest/list

1. Headers

STT

Field

Source Data Type / Length 

Description

Sample Values

1authorizationStringTokenBearer eyJhbGciOiJIUzI1NiJ9.eyJleHAiOjE3NjYzOTgyNDUsInVzZXIiOiJ7XCJpZFwiOjIwMjAsXCJ1c2VybmFtZVwiOlwiMDM3NDc4ODQwNVwiLFwibmFtZVwiOlwiQ2h1IFRo4buLIExpw6puXCIsXCJyb2xlc1wiOltdLFwibWFwQmVhdXR5U2Fsb25cIjp7XCJicG0ucmVib3JuLnZuXCI6Nn0sXCJlbXBsb3llZUlkXCI6NTMxLFwiYnJhbmNoSWRcIjoyM30ifQ.qRoaRDxjqyWS-3Az_ZqLmR0KAcPTM7jXggW1Ja5wpEc










2. Param

STT

Field

Required

Data Type / Length

Description

Note

1namefalseStringTên gói thầu
2fieldIdfalseIntegerMã lĩnh vực
3projectIdfalseIntegerMã dự án
4statusfalseIntegerTrạng thái (0: Chưa kích hoạt, 1: Đã thực hiện, 2: Đang chờ thực hiện)
5departmentIdfalseIntegerMã phòng ban
6processCodefalseStringMã quy trình
7limitfalseIntegerSố bản ghi trong trên 1 trang
8pagefalseIntegerSố trang

3. Response / Incoming Data Specification

STT

Field

Data Type / Length

Description

Note

1idIntegerID gói thầu
2codeStringMã gói thầu 
3

name

StringTên gói thầu
4

scheduledStartTime

Timestamp

Ngày bắt đầu dự kiến


5

triggerStatus

IntegerTrạng thái kích hoạt
6

triggerTime

TimestampThời gian kích hoạt
7

pteId

Integer

ID pte (Process Task Executor)


8

fieldId

IntegerID lĩnh vực
9

projectId

IntegerID dự án
10

status

Integer

Trạng thái của yêu cầu (0 - mới tiếp nhận, 1 - đã hoàn thành)


11

employeeId

Integer

Người yêu cầu


12

departmentId

Integer

ID của phòng ban liên quan (Bộ phận yêu cầu)


13

nodeId

String

Mã ID của node


14

potId

Integer

ID của hồ sơ


15

processId

IntegerID của quy trình
16

rootId

IntegerID của quy trình cha
17

priorityLevel

Integer

Mức độ ưu tiên của hồ sơ


18

hasFile

Integer

Có đính kèm file


19

procurementTypeId

Integer

Mã hồ sơ mời thầu


20

requestId

Integer

Mã yêu cầu khởi tạo


21

pteName

StringTên pte (Process Task Executor)UserTask, ServiceTask, ...
22

fieldName

StringTên lĩnh vực
23

projectName

StringTên dự án
24

departmentName

StringTên phòng ban liên quan (Bộ phận yêu cầu)
25

procurementTypeName

StringTên hồ sơ mời thầu
26

nodeName

StringTên của node
27

workId

IntegerMã công việc

3.4. Mô tả các trường dữ liệu trên màn hình danh sách gói thầu (Site đấu thầu):

3.4.1. Màn hình danh sách gói thầu (Site đấu thầu)

3.4.1.1. Phân quyền dữ liệu hệ thống:

Hệ thống cho phép phân quyền hiển thị dữ liệu gói thầu trên màn hình danh sách dựa trên

...

trạng thái công việc của nhân sự liên quan. Nhân sự đã phát sinh công việc (

...

trừ các công việc bị từ chối tiếp nhận)

...

sẽ được phép nhìn thấy gói thầu

...

.

Ví dụ minh họa:

  • Nhân sự có công việc đã phát sinh

    công việc

    được

    Được xem

  • Nhân sự có công việc đã hoàn

    thàn công việc

    thành

    được

    Được xem

  • Nhân sự chỉ có công việc đã từ chối tiếp nhận (không phải

    YCDDC

    yêu cầu điều chỉnh) →

    không

    Không được xem

  • Nhân sự có công việc

    đã

    bị từ chối

    tiếp nhận nhưng đồng thời còn các công việc khác (trạng thái chưa tiếp nhận

    /

    , đã tiếp nhận

    /

    , tạm dừng

    /

    , hoàn thành

    / YCĐC

    hoặc yêu cầu điều chỉnh) →

    được xem

    Được xem

3.4.1.2.  Mô tả các trường dữ liệu trên màn hình danh sách gói thầu (Site đấu thầu):


Trường/Nút chức năng

Kiểu dữ liệu

Điều kiện

Quy định

Mô tả

1Mã gói thầuTextBắt buộcDữ liệu lấy tự động từ nền tảng BPM1, người dùng không được phép chỉnh sửa.

Mã định danh duy nhất của gói thầu.

2Tên gói thầuHyperlinkBắt buộcDữ liệu
  • Tên gói thầu mặc định hiển thị dưới dạng văn bản tĩnh. Khi người dùng di chuột qua (trạng thái hover), trường này sẽ hiển thị dưới dạng hyperlink và cho phép nhấn để điều hướng đến màn hình chi tiết gói thầu.

  • Là trường có dữ liệu được lấy tự động từ nền tảng BPM1
,
  • ; người dùng không được phép chỉnh sửa.
  • Chỉ hiển thị các gói thầu đã hoàn thành phê duyệt.
  • Không hiển thị các gói thầu đang ở trạng thái Lưu nháp.

Tên hiển thị của gói thầu, người dùng có thể nhấn để xem chi tiết.

3Dự ánTextKhông bắt buộcDữ liệu lấy tự động từ nền tảng BPM1, người dùng không được phép chỉnh sửa.

Tên dự án mà gói thầu thuộc về.

4Lĩnh vựcTextKhông bắt buộcDữ liệu lấy tự động từ nền tảng BPM1, người dùng không được phép chỉnh sửa.

Lĩnh vực chuyên môn của gói thầu.

5

Đơn vị thụ hưởng

Text (Dropdown)Không bắt buộcDữ liệu lấy tự động từ nền tảng BPM1, người dùng không được phép chỉnh sửa.

Tên chủ đầu tư của gói thầu.

6

Thời gian bắt đầu

DateBắt buộcDữ liệu lấy tự động từ nền tảng BPM1, người dùng không được phép chỉnh sửa.
  • Thể hiện thời điểm hoàn thành bước khởi tạo YCMS/TT Chủ trương trong bước A1.01 trong quy trình xử lý gói thầu.

  • Không lấy dữ liệu nếu yêu cầu mua sắm đang ở trạng thái lưu nháp.

  • Dữ liệu được ghi nhận cho cả các trường hợp:

    • Tạo thủ công

    • Thêm mới hàng loạt Yêu cầu mua sắm

    • Kích hoạt theo Timer (hẹn giờ)

7

Thời gian kết thúc

DateBắt buộcDữ liệu lấy tự động từ nền tảng BPM1, người dùng không được phép chỉnh sửa.

Ngày kết thúc dự là thời gian kết thúc quy trình

8Trạng tháiEnum / LabelBắt buộc


Trạng thái hiện tại của gói thầu, phản ánh tiến độ xử lý theo quy trình đấu thầu:

  • Đang thực hiện: Gói thầu đang trong quá trình triển khai
  • Hoàn thành: Gói thầu đã được phê duyệt báo cáo thầu 
  • Hủy : Gói thầu bị hủy
9Nút "Tìm kiếm"ButtonKhông bắt buộc
  • Tìm kiếm theo Contains trên Mã gói thầu và Tên gói thầu.
  • Không phân biệt hoa/thường, không phân biệt dấu tiếng Việt.
  • Hỗ trợ multi-keyword: AND giữa các từ (tách từ theo dấu cách).
  • Ví dụ: nhập "Gia Lộc" → trả về các gói có chứa đồng thời "gia" và "loc" (không phân biệt hoa/thường, không phân biệt dấu) trong Mã hoặc Tên gói thầu.
  • Không giới hạn độ dài từ khóa.

Nút cho phép người dùng nhập từ khóa và thực hiện tìm kiếm theo Mã gói thầu hoặc Tên gói thầu.

10Nút "Lọc"ButtonKhông bắt buộc

Khi người nhấn vào nút "Lọc

  • Nút mở bộ lọc để lọc danh sách theo các tiêu chí: Trạng thái, Thời gian, Lĩnh vực, Tên chủ đầu tư.
  • Người dùng có thể chọn 1 hoặc nhiều tiêu chí kết hợp.

...