Goods Receipt Line Item

Get A Resource By ID

HTTP Request

GET /api/v1/goods-receipt-line-item/{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

ResponseGoodsReceiptLineItemDto

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/goods-receipt-line-item/{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

GoodsReceiptLineItemDto

true

Request body containing the updated details of the goods receipt line item, including quantity, item description, and associated metadata for inventory management.

Responses

Status

Meaning

Description

Schema

200

OK

OK

ResponseGoodsReceiptLineItemDto

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/goods-receipt-line-item/{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/goods-receipt-line-item/{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 updated details for the specified goods receipt line item, including quantity, status, and any relevant adjustments.

Responses

Status

Meaning

Description

Schema

200

OK

OK

ResponseGoodsReceiptLineItemDto

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/goods-receipt-line-item/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

GoodsReceiptLineItemDto

true

Request body containing a collection of goods receipt line items for bulk creation or update, including relevant details such as item identifiers, quantities, and associated metadata.

Responses

Status

Meaning

Description

Schema

200

OK

OK

ResponseListGoodsReceiptLineItemDto

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/goods-receipt-line-item/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

GoodsReceiptLineItemDto

true

Request body containing the details of the goods receipt line item, including item specifications, quantities, and associated metadata for creation or updating purposes.

Responses

Status

Meaning

Description

Schema

200

OK

OK

ResponseGoodsReceiptLineItemDto

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/goods-receipt-line-item/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

GoodsReceiptLineItemDto

true

Request body containing a collection of goods receipt line items for bulk processing, including relevant details such as item identifiers, quantities, and associated metadata.

Responses

Status

Meaning

Description

Schema

200

OK

OK

ResponseListGoodsReceiptLineItemDto

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/goods-receipt-line-item/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

GoodsReceiptLineItemDto

true

Request body containing a collection of goods receipt line item details, including quantities, item identifiers, and associated metadata for bulk processing.

Responses

Status

Meaning

Description

Schema

200

OK

OK

ResponseListGoodsReceiptLineItemDto

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/goods-receipt-line-item/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 identifiers for the goods receipt line items to be deleted in bulk.

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

Search Resources

HTTP Request

POST /api/v1/goods-receipt-line-item/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

GoodsReceiptLineItemDtoFilter

false

Request body containing search criteria and filters for retrieving specific goods receipt line items relevant to inventory management.

Default Values

Parameter

Default

Type

page

0

query

size

100

query

sort

["createdAt,ASC"]

query

Parameter Constraints

Parameter

Constraints

page

Min: 0

size

Min: 1

Responses

Status

Meaning

Description

Schema

200

OK

OK

PageGoodsReceiptLineItemDto

409

Conflict

Payment amount exceeds remaining invoice balance

InvoicePaymentBalanceConflictDto

502

Bad Gateway

Downstream service call failed

PayableErrorDto

Record Goods Receipt Line Items From Purchase Order Line Items

HTTP Request

POST /api/v1/goods-receipt-line-item/record-goods-receipt-from-purchase-order-line-items

📋 Description: Creates new goods receipt line items pre-populated from the specified purchase order line items. Each DTO specifies the goods receipt, PO line item, and received quantity. The operation is all-or-nothing: the entire batch is validated upfront and rolled back if any item fails.

Parameters

Name

In

Type

Required

Description

body

body

RecordGoodsReceiptFromPOLineItemDto

true

Request body containing the details of goods receipt line items, including associated purchase order line item identifiers and quantities, necessary for accurate inventory and financial reconciliation.

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

[GoodsReceiptLineItemDto]

false

none

[Data transfer object representing a line item within a goods receipt, detailing the specific items received, their quantities, and associated metadata to facilitate inventory management and financial reconciliation.]

» id

integer(int64)

false

none

Unique identifier for the resource

» displayId

string

false

none

Unique identifier for the display

» quantity

integer(int64)

false

none

Quantity value

» invoicedQuantity

integer(int64)

false

none

Quantity of invoiced quantity

» description

string

false

none

Description of the resource

» expenseCategory

ExpenseCategoryLite

false

none

Data transfer object representing a simplified categorization of expenses, enabling efficient tracking and reporting of financial allocations within the organization.

»» id

integer(int64)

false

none

Unique identifier for the resource

»» displayId

string

false

none

Unique identifier for the display

»» status

string

false

none

Status of the resource

»» name

string

false

none

Name of the resource

»» expenseCategoryType

string

false

none

Type of the expense category

» goodsReceiptId

integer(int64)

true

none

Unique identifier for the goods receipt

» goodsReceiptDisplayId

string

false

none

Unique identifier for the goods receipt display

» goodsReceiptState

string

false

none

Indicates the current status of the goods receipt, reflecting its processing stage within the supply chain management system.

» purchaseOrderLineItemId

integer(int64)

false

none

Unique identifier for the purchase order line item

» invoiceLineItemLinks

[InvoiceLineItemToGoodsReceiptLineItemDto]

false

none

Array of links to associated invoice line items, facilitating the tracking and management of goods receipt transactions.

»» id

integer(int64)

false

none

Unique identifier for the resource

»» fromId

integer(int64)

false

none

Unique identifier for the from

»» toId

integer(int64)

false

none

Unique identifier for the to

»» linkedQuantity

integer(int64)

false

none

Quantity of linked quantity

» availableQuantity

integer(int64)

false

read-only

Quantity of available quantity

» allowsSystemGenerateNewId

boolean

false

none

Unique identifier for the allows system generate new

» numberRangeIdentifierValue

string

false

none

Represents a unique identifier for the range of numbers associated with a specific goods receipt line item, facilitating accurate tracking and management of inventory.

» numberRangeIdentifierType

INumberRangeIdentifierType

false

none

Data transfer object representing a numerical range identifier used for categorizing and validating data entries within business processes, ensuring consistency and accuracy in data management.

»» name

string

false

none

Name of the resource

» numberRangeType

INumberRangeType

false

none

Data structure representing a numerical range, utilized for defining limits or thresholds within business processes, ensuring precise data validation and operational efficiency.

»» name

string

true

none

Name of the resource

Enumerated Values

Attribute

Value

expenseCategoryType

CASH_INCENTIVE, CASUALTY, EXPECTED_GRV, INCENTIVE, NON_LEASE, PAYMENT, PURCHASE_OPTION, TERMINATION_OPTION

goodsReceiptState

GOODS_RECEIPT_DRAFT, GOODS_RECEIPT_MATCHED, GOODS_RECEIPT_RECEIVED, GOODS_RECEIPT_REJECTED, INVOICE_PAYMENT_DRAFT, INVOICE_PAYMENT_JOURNALS_GENERATING, INVOICE_PAYMENT_POSTED, INVOICE_PAYMENT_POSTING, INVOICE_PAYMENT_REVIEW, INV_APPROVED, INV_DRAFT, INV_GENERATING_JOURNALS, INV_PAID, INV_POSTED, INV_POSTING, INV_REJECTED, INV_REVIEW, INV_WAITING_FOR_APPROVAL, PURCHASE_ORDER_APPROVED, PURCHASE_ORDER_DRAFT, PURCHASE_ORDER_REJECTED, PURCHASE_ORDER_WAITING_FOR_APPROVAL, PURCHASE_REQUISITION_APPROVED, PURCHASE_REQUISITION_DRAFT, PURCHASE_REQUISITION_REJECTED, PURCHASE_REQUISITION_WAITING_FOR_APPROVAL, VENDOR_REQUEST_APPROVED, VENDOR_REQUEST_DRAFT, VENDOR_REQUEST_PENDING_APPROVAL, VENDOR_REQUEST_REJECTED, WORKSPACE_CLOSED, WORKSPACE_JOURNALS_GENERATING, WORKSPACE_OPEN, WORKSPACE_POSTING, WORKSPACE_REVIEW

status

ACTIVE, CREATED, DECOMMISSIONED, DISABLED

List All Resources

HTTP Request

GET /api/v1/goods-receipt-line-item

📋 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 goods receipt line items should be returned in a paginated format, facilitating efficient data retrieval and management.

Responses

Status

Meaning

Description

Schema

200

OK

OK

PageGoodsReceiptLineItemDto

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/goods-receipt-line-item

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

Parameters

Name

In

Type

Required

Description

body

body

GoodsReceiptLineItemDto

true

Request body containing the details of the goods receipt line item, including item specifications, quantities, and associated metadata for inventory management.

Responses

Status

Meaning

Description

Schema

200

OK

OK

ResponseGoodsReceiptLineItemDto

409

Conflict

Payment amount exceeds remaining invoice balance

InvoicePaymentBalanceConflictDto

502

Bad Gateway

Downstream service call failed

PayableErrorDto