Versions Compared

Old Version 50

changes.mady.by.user Nguyễn Thanh Vân

Saved on

compared with

New Version Current

changes.mady.by.user datnt9

Saved on

Key

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

...

  1. Tôi muốn quản lý danh sách kế hoạch mua sắm bao gồm các thông tin:
    1. Nguồn dữ liệu: SAP hoặc BPM
    2. Dự án: Mã- Tên dự án
    3. Mã hạng mục
    4. Tên hạng mục
    5. Hạng mục cha: Mã - Tên
    6. Level
    7. Số tiền FS ban đầu
    8. Ngân sách khoán
    9. Số tiền đã dùng
    10. Số tiền còn lại 
    11. Ngày bắt đầu
    12. Ngày kết thúc
  2. Tôi muốn tìm kiếm được theo Mã-Tên hạng mục
  3. Tôi muốn lọc theo:
    1. Dự án
    2. Hạng mục cha
    3. Số tiền FS: Từ- Đến
    4. Ngân sách khoán: Từ- Đến
    5. Ngày bắt đầu: Từ ngày- Đến ngày
    6. Ngày kết thúc: Từ ngày- Đến ngày
  4. Tôi muốn xem được thông tin chi tiết hạng mục ngân sách của các dự án đã được đồng bộ từ SAP về bao gồm các thông tin:
    1. Nguồn dữ liệu: Mặc định "SAP"
    2. Dự án: Mã- Tên dự án
    3. Mã hạng mục
    4. Tên hạng mục
    5. Mã hạng Hạng mục cha
    6. Level
    7. Số tiền FS ban đầu
    8. Ngân sách khoán
    9. Số tiền đã dùng
    10. Số tiền còn lại 
  5. Tôi muốn thông tin không được đồng bộ về sẽ được chỉnh sửa bao gồm:
    1. Ngày bắt đầu
    2. Ngày kết thúc
  6. Tôi muốn Thêm mới/Chỉnh sửa/Xóa/Xem chi tiết được kế hoạch mua sắm chủ động tại BPM chi tiết tại User Story -02- Tạo mới/Điều chỉnh kế hoạch mua sắm dự án
  7. Tôi muốn danh mục được phân quyền theo các chức năng  tương tự các danh mục khác

...

3. Response / Incoming Data Specification

Sample Values
Panel
titleAPI Spec Document

Method

POST

URL

application/procurementPlan/deleteBatch

Description

API xóa batch

Note

API mới

1. Headers

STTSTT 

Field

Source Data Type / Length 

Description

Sample Values

1authorizationStringTokenBearer eyJhbGciOiJIUzI1NiJ9.eyJleHAiOjE3NjYzOTgyNDUsInVzZXIiOiJ7XCJpZFwiOjIwMjAsXCJ1c2VybmFtZVwiOlwiMDM3NDc4ODQwNVwiLFwibmFtZVwiOlwiQ2h1IFRo4buLIExpw6puXCIsXCJyb2xlc1wiOltdLFwibWFwQmVhdXR5U2Fsb25cIjp7XCJicG0ucmVib3JuLnZuXCI6Nn0sXCJlbXBsb3llZUlkXCI6NTMxLFwiYnJhbmNoSWRcIjoyM30ifQ.qRoaRDxjqyWS-3Az_ZqLmR0KAcPTM7jXggW1Ja5wpEc

2.

Body

Request body

STT

Path

Field

Field

Required

Data Type / Length

Description

Note

Sample Values

STT

Field

Data Type / Length

Description

Note

1List<Object>false
danh sách request
2projfalseStringMã SAP dự án
3wbsfalseStringmã kế hoạch mua sắm
4descrpfalseStringtên kế hoạch mua sắm
5

wbs_up

falseStringmã kế hoạch cha
6

level

falseStringlevel
7
costplan
falseString
số tiền FS ban đầu

8
budget
falseString
Ngân sách khoán

9
amount_th
falseString
Số tiền đã dùng

10
amount_cl
falseString
Số tiền còn lại

3. Response / Incoming Data Specification

STT

Field

Data Type / Length

Description

Note

1codeInteger0: thành công, != 0 thất bại
2messageString

Panel
titleAPI Spec Document

Method

POST

URL

application/procurementPlan/sync

Description

API đồng bộ kế hoạch mua sắm

Note

API mới

1. Headers

STT 

Field

Source Data Type / Length 

Description

Sample Values

1authorizationStringTokenBearer eyJhbGciOiJIUzI1NiJ9.eyJleHAiOjE3NjYzOTgyNDUsInVzZXIiOiJ7XCJpZFwiOjIwMjAsXCJ1c2VybmFtZVwiOlwiMDM3NDc4ODQwNVwiLFwibmFtZVwiOlwiQ2h1IFRo4buLIExpw6puXCIsXCJyb2xlc1wiOltdLFwibWFwQmVhdXR5U2Fsb25cIjp7XCJicG0ucmVib3JuLnZuXCI6Nn0sXCJlbXBsb3llZUlkXCI6NTMxLFwiYnJhbmNoSWRcIjoyM30ifQ.qRoaRDxjqyWS-3Az_ZqLmR0KAcPTM7jXggW1Ja5wpEc

2. Request body

STT

Field

Required

Data Type / Length

Description

Note

1List<Object>false
danh sách request
2projfalseStringMã SAP dự án
3wbsfalseStringmã kế hoạch mua sắm
4descrpfalseStringtên kế hoạch mua sắm
5

wbs_up

falseStringmã kế hoạch cha
6

level

falseStringlevel
7
costplan
falseString
số tiền FS ban đầu

8
budget
falseString
Ngân sách khoán

9
amount_th
falseString
Số tiền đã dùng

10
amount_cl
falseString
Số tiền còn lại

3. Response / Incoming Data Specification

STT

Field

Data Type / Length

Description

Note

1codeInteger0: thành công, != 0 thất bại
2messageString

Panel
titleAPI Spec Document

Method

DELETE

URL

application/procurementPlan/delete

Description

API xóa kế hoạch mua sắm

Note

API mới

1. Headers

STT 

Field

Source Data Type / Length 

Description

Sample Values

1authorizationStringTokenBearer eyJhbGciOiJIUzI1NiJ9.eyJleHAiOjE3NjYzOTgyNDUsInVzZXIiOiJ7XCJpZFwiOjIwMjAsXCJ1c2VybmFtZVwiOlwiMDM3NDc4ODQwNVwiLFwibmFtZVwiOlwiQ2h1IFRo4buLIExpw6puXCIsXCJyb2xlc1wiOltdLFwibWFwQmVhdXR5U2Fsb25cIjp7XCJicG0ucmVib3JuLnZuXCI6Nn0sXCJlbXBsb3llZUlkXCI6NTMxLFwiYnJhbmNoSWRcIjoyM30ifQ.qRoaRDxjqyWS-3Az_ZqLmR0KAcPTM7jXggW1Ja5wpEc

2. Request body

STT

Field

Required

Data Type / Length

Description

Note

1

id

falseIntegerid kế hoạch mua sắm

3. Response / Incoming Data Specification

STT

Field

Data Type / Length

Description

Note

1codeInteger0: thành công, != 0 thất bại
2messageString

Panel
titleAPI Spec Document

Method

POST

URL

application/procurementPlan/list

Description

API Lấy danh sách kế hoạch mua sắm

Note

API mới

1. Headers

STT 

Field

Source Data Type / Length 

Description

Sample Values

1authorizationStringTokenBearer eyJhbGciOiJIUzI1NiJ9.eyJleHAiOjE3NjYzOTgyNDUsInVzZXIiOiJ7XCJpZFwiOjIwMjAsXCJ1c2VybmFtZVwiOlwiMDM3NDc4ODQwNVwiLFwibmFtZVwiOlwiQ2h1IFRo4buLIExpw6puXCIsXCJyb2xlc1wiOltdLFwibWFwQmVhdXR5U2Fsb25cIjp7XCJicG0ucmVib3JuLnZuXCI6Nn0sXCJlbXBsb3llZUlkXCI6NTMxLFwiYnJhbmNoSWRcIjoyM30ifQ.qRoaRDxjqyWS-3Az_ZqLmR0KAcPTM7jXggW1Ja5wpEc

2. Request body

STT

Field

Required

Data Type / Length

Description

Note

1keywordfalseStringtên hoặc mã kế hoạch mua sắm
2pagefalseIntegerTrang dữ liệu (phân trang)
3limitfalseIntegerSố bản ghi mỗi trang
4

projectCode

falseStringMã dự án
5

projectId

falseStringid dự án
6

parentCode

falseStringmã kế hoạch cha
7

initialFsAmountFrom

falseIntegerSố tiền FS (từ)
8

initialFsAmountTo

falseIntegerSố tiền FS (đến)
9

allocatedBudgetFrom

falseIntegerNgân sách khoán (từ)
10

allocatedBudgetTo

falseIntegerNgân sách khoán (đến)
11

startDateFromStr

falseStringNgày bắt đầu (từ)Định dạng yyyy-mm-dd
12

startDateToStr

falseStringNgày  bắt đầu (đến)
13

endDateFromStr

falseStringNgày kết thúc (từ)
14

endDateToStr

falseStringNgày kết thúc (đến)
15

onlyLeaf

falseBooleantrue: chỉ lấy các bản ghi không có con

3. Response / Incoming Data Specification

STT

Field

Data Type / Length

Description

Note

1codeInteger0: thành công, != 0 thất bại
2messageString


resultList<Object>


(result) pageIntegertrang bao nhiêu

(result) totalIntegersố lượng bản ghi

(result) itemsList<Object>danh sách bản ghi

(items) idIntegerid 

(items) allocatedBudgetBigDecimalNgân sách khoán

(items) codeString mã kế hoạch

(items) createdTimeTimestampthời gian tạo

(items) employeeIdIntegerngười tạo

(items) endDateTimestampngày kết thúc

(items) initialFsAmountBigDecimalSố tiền fs

(items) levelIntegerlevel

(items) nameString tên

(items) parentCodeString mã kế hoạch cha

(items) parentNameString Tên kế hoạch cha

(items) projectCodeStringmã dự án

(items) projectNameString tên dự án

(items) remainingAmountString số tiền còn lại

(items) sourceString nguồn dữ liệu.

(items) startDateString ngày bắt đầu

(items) updatedTimeString thời gian cập nhật

(items) endDateIntegerngày kết thúc

(items) usedAmountString số tiền đã sử dụng
Panel
titleAPI Spec Document

Method

PUT

URL

application/procurementPlan/update

Description

API cập nhật kế hoạch mua sắm

Note

API mới

1. Headers

STT 

Field

Source Data Type / Length 

Description

Sample Values

1authorizationStringTokenBearer eyJhbGciOiJIUzI1NiJ9.eyJleHAiOjE3NjYzOTgyNDUsInVzZXIiOiJ7XCJpZFwiOjIwMjAsXCJ1c2VybmFtZVwiOlwiMDM3NDc4ODQwNVwiLFwibmFtZVwiOlwiQ2h1IFRo4buLIExpw6puXCIsXCJyb2xlc1wiOltdLFwibWFwQmVhdXR5U2Fsb25cIjp7XCJicG0ucmVib3JuLnZuXCI6Nn0sXCJlbXBsb3llZUlkXCI6NTMxLFwiYnJhbmNoSWRcIjoyM30ifQ.qRoaRDxjqyWS-3Az_ZqLmR0KAcPTM7jXggW1Ja5wpEc

2. Request body

STT

Field

Required

Data Type / Length

Description

Note

1

name

falseStringtên kế hoạch mua sắm
2

code

falseIntegermã kế hoạch
3

source

falseIntegernguồn dữ liệu
4

projectCode

falseStringMã dự án
5

parentCode

falseStringmã kế hoạch cha
6

level

falseIntegerlevel
7

initialFsAmount

falseIntegerSố tiền FS
8

allocatedBudget

falseIntegerNgân sách khoán
9

usedAmount

falseIntegersố tiền đã sử dụng
10

remainingAmount

falseIntegersố tiền còn lại
11

startDate

falseStringNgày bắt đầuĐịnh dạng yyyy-mm-dd
12

endDate

falseStringNgày kết thúc
13

id

trueInteger

3. Response / Incoming Data Specification

STT

Field

Data Type / Length

Description

Note

1codeInteger0: thành công, != 0 thất bại
2messageString



Panel
titleAPI Spec Document

Method

POST

URL

application/procurementPlan/insert

Description

API thêm mới kế hoạch mua sắm

Note

API mới

1. Headers

STT 

Field

Source Data Type / Length 

Description

Sample Values

1authorizationStringTokenBearer eyJhbGciOiJIUzI1NiJ9.eyJleHAiOjE3NjYzOTgyNDUsInVzZXIiOiJ7XCJpZFwiOjIwMjAsXCJ1c2VybmFtZVwiOlwiMDM3NDc4ODQwNVwiLFwibmFtZVwiOlwiQ2h1IFRo4buLIExpw6puXCIsXCJyb2xlc1wiOltdLFwibWFwQmVhdXR5U2Fsb25cIjp7XCJicG0ucmVib3JuLnZuXCI6Nn0sXCJlbXBsb3llZUlkXCI6NTMxLFwiYnJhbmNoSWRcIjoyM30ifQ.qRoaRDxjqyWS-3Az_ZqLmR0KAcPTM7jXggW1Ja5wpEc

2. Request body

STT

Field

Required

Data Type / Length

Description

Note

1

name

falseStringtên kế hoạch mua sắm
2

code

falseIntegermã kế hoạch
3

source

falseIntegernguồn dữ liệu
4

projectCode

falseStringMã dự án
5

parentCode

falseStringmã kế hoạch cha
6

level

falseIntegerlevel
7

initialFsAmount

falseIntegerSố tiền FS
8

allocatedBudget

falseIntegerNgân sách khoán
9

usedAmount

falseIntegersố tiền đã sử dụng
10

remainingAmount

falseIntegersố tiền còn lại
11

startDate

falseStringNgày bắt đầuĐịnh dạng yyyy-mm-dd
12

endDate

falseStringNgày kết thúc

3. Response / Incoming Data Specification

STT

Field

Data Type / Length

Description

Note

1codeInteger0: thành công, != 0 thất bại
2messageString

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

...