Purchase Requisition

Get A Resource By ID

HTTP Request

GET /api/v1/purchase-requisition/{id}

📋 Description: Returns the single resource with the given ID.

Parameters

Name

In

Type

Required

Description

id

path

integer(int64)

true

Resource ID

Responses

Status

Meaning

Description

Schema

200

OK

OK

ResponsePurchaseRequisitionDto

409

Conflict

Payment amount exceeds remaining invoice balance

InvoicePaymentBalanceConflictDto

502

Bad Gateway

Downstream service call failed

PayableErrorDto

Update A Resource

HTTP Request

PUT /api/v1/purchase-requisition/{id}

📋 Description: Fully replaces the resource with the given ID. All fields in the request body are applied.

Parameters

Name

In

Type

Required

Description

id

path

integer(int64)

true

Resource ID

body

body

PurchaseRequisitionDto

true

Request body containing the updated purchase requisition details, including item specifications, quantities, and approval status.

Responses

Status

Meaning

Description

Schema

200

OK

OK

ResponsePurchaseRequisitionDto

409

Conflict

Payment amount exceeds remaining invoice balance

InvoicePaymentBalanceConflictDto

502

Bad Gateway

Downstream service call failed

PayableErrorDto

Delete A Single Resource

HTTP Request

DELETE /api/v1/purchase-requisition/{id}

📋 Description: Permanently deletes the resource with the given ID.

Parameters

Name

In

Type

Required

Description

id

path

integer(int64)

true

Unique identifier for the resource

Responses

Status

Meaning

Description

Schema

200

OK

OK

ResponseVoid

409

Conflict

Payment amount exceeds remaining invoice balance

InvoicePaymentBalanceConflictDto

502

Bad Gateway

Downstream service call failed

PayableErrorDto

Partially Update A Resource (Json Patch)

HTTP Request

PATCH /api/v1/purchase-requisition/{id}

📋 Description: Applies a JSON Patch (RFC 6902) document to the resource with the given ID. Only the fields specified in the patch are modified; all other fields remain unchanged.

Parameters

Name

In

Type

Required

Description

id

path

integer(int64)

true

Unique identifier for the resource

body

body

JsonPatch

true

Request body containing the updated purchase requisition details, including item specifications, quantities, and approval status.

Responses

Status

Meaning

Description

Schema

200

OK

OK

ResponsePurchaseRequisitionDto

409

Conflict

Payment amount exceeds remaining invoice balance

InvoicePaymentBalanceConflictDto

502

Bad Gateway

Downstream service call failed

PayableErrorDto

Bulk Create-Or-Update Resources

HTTP Request

PUT /api/v1/purchase-requisition/createOrUpdate/bulk

📋 Description: Creates or updates multiple resources in a single request. Partial success: each item is processed independently. Items that pass validation are persisted; failed items are recorded in the response errors list. The response body always contains the successfully processed items alongside any per-item errors.

Parameters

Name

In

Type

Required

Description

body

body

PurchaseRequisitionDto

true

Request body containing an array of purchase requisition objects for bulk creation or updates, including relevant details such as item specifications, quantities, and associated metadata.

Responses

Status

Meaning

Description

Schema

200

OK

OK

ResponseListPurchaseRequisitionDto

409

Conflict

Payment amount exceeds remaining invoice balance

InvoicePaymentBalanceConflictDto

502

Bad Gateway

Downstream service call failed

PayableErrorDto

Create Or Update A Resource

HTTP Request

PUT /api/v1/purchase-requisition/createOrUpdate

📋 Description: Creates the resource if no matching record exists, or fully updates it if one is found. Idempotent: safe to call multiple times with the same payload.

Parameters

Name

In

Type

Required

Description

body

body

PurchaseRequisitionDto

true

Request body containing the purchase requisition details, including item specifications, quantities, and associated metadata for creating or updating requisitions.

Responses

Status

Meaning

Description

Schema

200

OK

OK

ResponsePurchaseRequisitionDto

409

Conflict

Payment amount exceeds remaining invoice balance

InvoicePaymentBalanceConflictDto

502

Bad Gateway

Downstream service call failed

PayableErrorDto

Bulk-Update Resources

HTTP Request

PUT /api/v1/purchase-requisition/bulk

📋 Description: Updates multiple resources in a single request. Partial success: each item is processed independently. Items that pass validation are updated; failed items are recorded in the response errors list. The response body always contains the successfully updated items alongside any per-item errors.

Parameters

Name

In

Type

Required

Description

body

body

PurchaseRequisitionDto

true

Request body containing an array of purchase requisition objects, each including details such as item descriptions, quantities, and associated cost centers for bulk processing.

Responses

Status

Meaning

Description

Schema

200

OK

OK

ResponseListPurchaseRequisitionDto

409

Conflict

Payment amount exceeds remaining invoice balance

InvoicePaymentBalanceConflictDto

502

Bad Gateway

Downstream service call failed

PayableErrorDto

Bulk-Create Resources

HTTP Request

POST /api/v1/purchase-requisition/bulk

📋 Description: Creates multiple resources in a single request. Partial success: each item is processed independently. Items that pass validation are persisted; failed items are recorded in the response errors list. The response body always contains the successfully created items alongside any per-item errors.

Parameters

Name

In

Type

Required

Description

body

body

PurchaseRequisitionDto

true

Request body containing an array of purchase requisition objects, each including item details, quantities, and associated cost information for bulk processing.

Responses

Status

Meaning

Description

Schema

200

OK

OK

ResponseListPurchaseRequisitionDto

409

Conflict

Payment amount exceeds remaining invoice balance

InvoicePaymentBalanceConflictDto

502

Bad Gateway

Downstream service call failed

PayableErrorDto

Bulk-Delete Resources

HTTP Request

DELETE /api/v1/purchase-requisition/bulk

📋 Description: Deletes multiple resources by ID in a single request. Partial success: each deletion is attempted independently. If one or more deletions fail (e.g. due to state constraints), the successfully deleted items are NOT rolled back. A ValidationException containing per-item errors is thrown after all items have been attempted, so the caller must inspect the error list to determine which IDs were not deleted.

Parameters

Name

In

Type

Required

Description

body

body

array[integer]

true

Request body containing an array of purchase requisition IDs to be deleted in bulk from the system.

Responses

Status

Meaning

Description

Schema

200

OK

OK

ResponseVoid

409

Conflict

Payment amount exceeds remaining invoice balance

InvoicePaymentBalanceConflictDto

502

Bad Gateway

Downstream service call failed

PayableErrorDto

Purchase Requisition - Remove From Favorite

HTTP Request

POST /api/v1/purchase-requisition/{purchaseRequisitionId}/remove-from-favorite

📋 Description: Removes the specified purchase requisition from the user’s list of favorites, streamlining the management of preferred procurement items.

Parameters

Name

In

Type

Required

Description

purchaseRequisitionId

path

integer(int64)

true

Unique identifier for the purchase requisition

Responses

Status

Meaning

Description

Schema

200

OK

OK

FavouriteModel

409

Conflict

Payment amount exceeds remaining invoice balance

InvoicePaymentBalanceConflictDto

502

Bad Gateway

Downstream service call failed

PayableErrorDto

Purchase Requisition - Add To Favorite

HTTP Request

POST /api/v1/purchase-requisition/{purchaseRequisitionId}/add-to-favorite

📋 Description: Adds a specified purchase requisition to the user’s list of favorites, enabling quick access and streamlined management of frequently referenced requisitions. This operation enhances user efficiency in procurement processes.

Parameters

Name

In

Type

Required

Description

purchaseRequisitionId

path

integer(int64)

true

Unique identifier for the purchase requisition

Responses

Status

Meaning

Description

Schema

200

OK

OK

FavouriteModel

409

Conflict

Payment amount exceeds remaining invoice balance

InvoicePaymentBalanceConflictDto

502

Bad Gateway

Downstream service call failed

PayableErrorDto

Search Resources

HTTP Request

POST /api/v1/purchase-requisition/search

📋 Description: Returns a paginated list of resources matching the given filter criteria. Pass null or an empty body to return all accessible records.

Parameters

Name

In

Type

Required

Description

page

query

integer

false

Zero-based page index (0..N)

size

query

integer

false

The size of the page to be returned

sort

query

array[string]

false

Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported.

body

body

PurchaseRequisitionDtoFilter

false

Request body containing search criteria and filters for retrieving purchase requisition records based on specified parameters.

Default Values

Parameter

Default

Type

page

0

query

size

100

query

sort

["CREATED_AT,ASC"]

query

Parameter Constraints

Parameter

Constraints

page

Min: 0

size

Min: 1

Responses

Status

Meaning

Description

Schema

200

OK

OK

PagePurchaseRequisitionDto

409

Conflict

Payment amount exceeds remaining invoice balance

InvoicePaymentBalanceConflictDto

502

Bad Gateway

Downstream service call failed

PayableErrorDto

Purchase Requisition - Upload Documents

HTTP Request

POST /api/v1/purchase-requisition/document/upload

📋 Description: Uploads purchase requisition documents to the system, facilitating efficient procurement processes and ensuring all necessary documentation is readily accessible for review and approval.

Parameters

Name

In

Type

Required

Description

entityId

query

integer(int64)

true

Unique identifier for the entity

files

query

array[string]

false

An array of files to be uploaded as part of the purchase requisition documentation process.

Responses

Status

Meaning

Description

Schema

200

OK

OK

MultipleUploadResult

409

Conflict

Payment amount exceeds remaining invoice balance

InvoicePaymentBalanceConflictDto

502

Bad Gateway

Downstream service call failed

PayableErrorDto

Purchase Requisition - Search Documents

HTTP Request

POST /api/v1/purchase-requisition/document/search

📋 Description: Submits a search request for purchase requisition documents, enabling users to efficiently locate and retrieve specific requisitions based on defined criteria.

Parameters

Name

In

Type

Required

Description

body

body

object

true

Request body containing search criteria and filters for retrieving purchase requisition documents based on specified parameters.

» filter

body

DocumentReferenceDtoFilter

false

Data transfer object representing the criteria for filtering document references, enabling users to efficiently retrieve and manage relevant documents within the system.

»» idIn

body

[integer]

false

Filter by multiple values of id

»» idEqual

body

integer(int64)

false

Filter by exact match of id

»» idLike

body

string

false

Filter by partial match of id

»» createdAtGreaterThanOrEqual

body

string(date-time)

false

Filter where created at is greater than or equal to specified value

»» createdAtLessThanOrEqual

body

string(date-time)

false

Filter where created at is less than or equal to specified value

»» createdByLike

body

string

false

Filter by partial match of created by

»» createdByEqual

body

string

false

Filter by exact match of created by

»» modifiedAtGreaterThanOrEqual

body

string(date-time)

false

Filter where modified at is greater than or equal to specified value

»» modifiedAtLessThanOrEqual

body

string(date-time)

false

Filter where modified at is less than or equal to specified value

»» modifiedByLike

body

string

false

Filter by partial match of modified by

»» modifiedByEqual

body

string

false

Filter by exact match of modified by

»» documentIdIn

body

[integer]

false

Filter by multiple values of document id

»» documentIdEqual

body

integer(int64)

false

Filter by exact match of document id

»» entityIdIn

body

[integer]

false

Filter by multiple values of entity id

»» entityIdEqual

body

integer(int64)

false

Filter by exact match of entity id

»» entityTypeIn

body

[string]

false

Filter by multiple values of entity type

»» entityTypeEqual

body

string

false

Filter by exact match of entity type

»» filenameLike

body

string

false

Filter by partial match of filename

» pageable

body

Pageable

false

Data transfer object representing a paginated collection of results, enabling efficient navigation and retrieval of large datasets within the API. This schema supports enhanced user experience by facilitating organized data presentation and management.

»» page

body

integer(int32)

false

Page number for pagination

»» size

body

integer(int32)

false

Number of items per page

»» sort

body

[string]

false

Sort order specification

Enumerated Values

Attribute

Value

»» entityTypeEqual

GOODS_RECEIPT, INVOICE, PURCHASE_ORDER, PURCHASE_REQUISITION, WORKSPACE

»» entityTypeIn

GOODS_RECEIPT, INVOICE, PURCHASE_ORDER, PURCHASE_REQUISITION, WORKSPACE

Parameter Constraints

Parameter

Constraints

»» page

Min: 0

»» size

Min: 1

Responses

Status

Meaning

Description

Schema

200

OK

OK

PageDocumentDto

409

Conflict

Payment amount exceeds remaining invoice balance

InvoicePaymentBalanceConflictDto

502

Bad Gateway

Downstream service call failed

PayableErrorDto

List All Resources

HTTP Request

GET /api/v1/purchase-requisition

📋 Description: Returns a paginated list of all accessible resources ordered by ID. Prefer POST /search for filtered queries.

Parameters

Name

In

Type

Required

Description

pageable

query

Pageable

true

Indicates whether the results of the purchase requisition query should be returned in a paginated format, facilitating efficient data retrieval and management.

Responses

Status

Meaning

Description

Schema

200

OK

OK

PagePurchaseRequisitionDto

409

Conflict

Payment amount exceeds remaining invoice balance

InvoicePaymentBalanceConflictDto

502

Bad Gateway

Downstream service call failed

PayableErrorDto

Create A Resource

HTTP Request

POST /api/v1/purchase-requisition

📋 Description: Creates a single resource. Returns the created resource with its generated ID.

Parameters

Name

In

Type

Required

Description

body

body

PurchaseRequisitionDto

true

Request body containing the purchase requisition details, including item descriptions, quantities, and associated cost information for procurement processing.

Responses

Status

Meaning

Description

Schema

200

OK

OK

ResponsePurchaseRequisitionDto

409

Conflict

Payment amount exceeds remaining invoice balance

InvoicePaymentBalanceConflictDto

502

Bad Gateway

Downstream service call failed

PayableErrorDto

Purchase Requisition - Search Purchase Requisition State History

HTTP Request

GET /api/v1/purchase-requisition/{purchaseRequisitionId}/state-history

📋 Description: Retrieves the state history of a specific purchase requisition, allowing users to track its status changes over time for improved procurement oversight.

Parameters

Name

In

Type

Required

Description

purchaseRequisitionId

path

integer(int64)

true

Unique identifier for the purchase requisition

Responses

Status

Meaning

Description

Schema

200

OK

OK

Inline

409

Conflict

Payment amount exceeds remaining invoice balance

InvoicePaymentBalanceConflictDto

502

Bad Gateway

Downstream service call failed

PayableErrorDto

Response Schema

Status Code 200

Name

Type

Required

Restrictions

Description

anonymous

[PurchaseRequisitionStateHistoryDto]

false

none

[Data transfer object representing the historical states of a purchase requisition, capturing key status changes and associated metadata to facilitate tracking and auditing within procurement processes.]

» id

integer(int64)

false

none

Unique identifier for the resource

» success

boolean

false

none

Indicates whether the purchase requisition state change was successful, providing insight into the status of procurement processes.

» failedMessage

string

false

none

Contains the error message associated with a failed purchase requisition, providing insight into the reason for the failure in the requisition process.

» warningMessage

string

false

none

Contains a message indicating any warnings related to the purchase requisition state history, providing users with essential insights for decision-making.

» fromState

string

false

none

Represents the originating state of a purchase requisition within the state history, providing insight into its progression and status changes.

» event

string

false

none

Represents the specific event associated with the state change in the purchase requisition history, providing essential context for tracking procurement activities.

» comment

string

false

none

Textual commentary providing additional context or notes regarding the state changes of a purchase requisition.

» purchaseRequisitionId

integer(int64)

false

none

Unique identifier for the purchase requisition

Purchase Requisition - Is Favorite

HTTP Request

GET /api/v1/purchase-requisition/{purchaseRequisitionId}/is-favorite

📋 Description: Retrieves the favorite status of a specified purchase requisition, allowing users to determine if the requisition is marked as a favorite for quick access and management.

Parameters

Name

In

Type

Required

Description

purchaseRequisitionId

path

integer(int64)

true

Unique identifier for the purchase requisition

Responses

Status

Meaning

Description

Schema

200

OK

OK

boolean

409

Conflict

Payment amount exceeds remaining invoice balance

InvoicePaymentBalanceConflictDto

502

Bad Gateway

Downstream service call failed

PayableErrorDto

Purchase Requisition - Get Recents

HTTP Request

GET /api/v1/purchase-requisition/recents

📋 Description: Retrieves the most recent purchase requisitions submitted within the system, enabling users to quickly access and review pending procurement requests.

Responses

Status

Meaning

Description

Schema

200

OK

OK

Inline

409

Conflict

Payment amount exceeds remaining invoice balance

InvoicePaymentBalanceConflictDto

502

Bad Gateway

Downstream service call failed

PayableErrorDto

Response Schema

Status Code 200

Name

Type

Required

Restrictions

Description

anonymous

[RecentModel]

false

none

[Data transfer object representing the most recent model utilized in predictive analytics, encapsulating key attributes and performance metrics to support informed decision-making in business strategy.]

» internalId

string

false

none

Unique identifier for the internal

» foreignId

string

false

none

Unique identifier for the foreign

» objectType

string

false

none

Type of the object

» recentType

string

false

none

Type of the recent

» username

string

false

none

Represents the unique identifier for a user within the system, facilitating user management and authentication processes.

» lastAccess

string(date-time)

false

none

Timestamp indicating the most recent access to the resource, facilitating tracking of user engagement and system utilization.

Enumerated Values

Attribute

Value

recentType

APPROVED, CLOSED, MODIFIED, VIEWED

Purchase Requisition - Get Favourites

HTTP Request

GET /api/v1/purchase-requisition/favorites

📋 Description: Retrieves a list of favorite purchase requisitions for the authenticated user, enabling quick access to frequently used requests for streamlined procurement processes.

Responses

Status

Meaning

Description

Schema

200

OK

OK

Inline

409

Conflict

Payment amount exceeds remaining invoice balance

InvoicePaymentBalanceConflictDto

502

Bad Gateway

Downstream service call failed

PayableErrorDto

Response Schema

Status Code 200

Name

Type

Required

Restrictions

Description

anonymous

[FavouriteModel]

false

none

[Data transfer object representing a user’s preferred items within the application, facilitating personalized experiences and enhancing user engagement.]

» internalId

string

false

none

Unique identifier for the internal

» foreignId

string

false

none

Unique identifier for the foreign

» objectType

string

false

none

Type of the object

» username

string

false

none

Represents the unique username associated with a user in the system, facilitating user identification and access management.

» sequenceNumber

integer(int32)

false

none

Sequential identifier for the favorite items, ensuring a consistent order within the user’s preferences.

» createdAt

string(date-time)

false

none

Timestamp when this resource was created