Invoice Payment

Get A Resource By ID

HTTP Request

GET /api/v1/invoice-payment/{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

ResponseInvoicePaymentDto

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/invoice-payment/{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

InvoicePaymentDto

true

Request body containing the updated invoice payment details, including payment amount, method, and any relevant transaction metadata.

Responses

Status

Meaning

Description

Schema

200

OK

OK

ResponseInvoicePaymentDto

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/invoice-payment/{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/invoice-payment/{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 payment details for the specified invoice, including payment amount and method.

Responses

Status

Meaning

Description

Schema

200

OK

OK

ResponseInvoicePaymentDto

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/invoice-payment/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

InvoicePaymentDto

true

Request body containing the invoice payment details, including payment amount, invoice ID, and customer information for creating or updating payment records.

Responses

Status

Meaning

Description

Schema

200

OK

OK

ResponseInvoicePaymentDto

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/invoice-payment/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

InvoicePaymentDto

true

Request body containing an array of invoice payment records for bulk creation or updates, including relevant payment details and associated metadata.

Responses

Status

Meaning

Description

Schema

200

OK

OK

ResponseListInvoicePaymentDto

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/invoice-payment/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

InvoicePaymentDto

true

Request body containing an array of invoice payment details, including payment amounts and associated invoice identifiers, to facilitate bulk processing of payments.

Responses

Status

Meaning

Description

Schema

200

OK

OK

ResponseListInvoicePaymentDto

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/invoice-payment/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

InvoicePaymentDto

true

Request body containing an array of invoice payment details, including amounts and associated invoice identifiers, for processing multiple payments in a single transaction.

Responses

Status

Meaning

Description

Schema

200

OK

OK

ResponseListInvoicePaymentDto

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/invoice-payment/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 invoice payment IDs to be deleted in bulk, facilitating streamlined financial management.

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

List All Resources

HTTP Request

GET /api/v1/invoice-payment

📋 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 invoice payment retrieval should be paginated for improved data management and user experience.

Responses

Status

Meaning

Description

Schema

200

OK

OK

PageInvoicePaymentDto

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/invoice-payment

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

Parameters

Name

In

Type

Required

Description

body

body

InvoicePaymentDto

true

Request body containing the invoice payment details, including payment amount, invoice ID, and payment method for processing transactions.

Responses

Status

Meaning

Description

Schema

200

OK

OK

ResponseInvoicePaymentDto

409

Conflict

Payment amount exceeds remaining invoice balance

InvoicePaymentBalanceConflictDto

502

Bad Gateway

Downstream service call failed

PayableErrorDto

Search Resources

HTTP Request

POST /api/v1/invoice-payment/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

InvoicePaymentDtoFilter

false

Request body containing the search criteria for invoice payments, including parameters such as invoice number, payment status, and date range.

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

PageInvoicePaymentDto

409

Conflict

Payment amount exceeds remaining invoice balance

InvoicePaymentBalanceConflictDto

502

Bad Gateway

Downstream service call failed

PayableErrorDto

Check Whether Balance Records Exist For An Invoice

HTTP Request

GET /api/v1/invoice-payment/invoice/{invoiceId}/has-balances

📋 Description: Returns true if the invoice has been approved and its line-item balances have been initialised. A false result means no payments can be created against this invoice yet.

Parameters

Name

In

Type

Required

Description

invoiceId

path

integer(int64)

true

Invoice ID

Responses

Status

Meaning

Description

Schema

200

OK

OK

InvoiceBalanceStatusDto

409

Conflict

Payment amount exceeds remaining invoice balance

InvoicePaymentBalanceConflictDto

502

Bad Gateway

Downstream service call failed

PayableErrorDto

Get Remaining Line-Item Balances For An Invoice

HTTP Request

GET /api/v1/invoice-payment/invoice/{invoiceId}/balances

📋 Description: Returns the remaining (unpaid) net and tax amounts per line item for the specified invoice. Balances are initialised when the invoice reaches Approved state. Use this before creating an InvoicePayment to know how much can still be allocated.

Parameters

Name

In

Type

Required

Description

invoiceId

path

integer(int64)

true

Invoice ID

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

[InvoiceLineItemBalanceDto]

false

none

[Data transfer object representing the balance details of an invoice line item, including associated financial metrics and status, essential for accurate billing and financial reconciliation.]

» id

integer(int64)

false

none

Unique identifier for the resource

» displayId

string

false

none

Unique identifier for the display

» invoiceId

integer(int64)

false

none

Unique identifier for the invoice

» invoiceDisplayId

string

false

none

Unique identifier for the invoice display

» invoiceLineItemId

integer(int64)

false

none

Unique identifier for the invoice line item

» invoiceLineItemDisplayId

string

false

none

Unique identifier for the invoice line item display

» invoiceLineItemDescription

string

false

none

Description of the invoice line item

» expenseCategory

ExpenseCategoryBaseId

false

none

Data transfer object representing the foundational identifier for an expense category, facilitating the categorization and management of financial expenditures within the enterprise.

»» id

integer(int64)

false

none

Unique identifier for the resource

»» displayId

string

false

none

Unique identifier for the display

»» name

string

true

none

Name of the resource

» totalNetAmount

number

false

none

Amount of total net

» totalTaxAmount

number

false

none

Amount of total tax

» reservedNetAmount

number

false

none

Amount of reserved net

» reservedTaxAmount

number

false

none

Amount of reserved tax

» remainingTotalAmount

number

false

none

Amount of remaining total

» remainingNetAmount

number

false

none

Amount of remaining net

» remainingTaxAmount

number

false

none

Amount of remaining tax

» allowsSystemGenerateNewId

boolean

false

none

Unique identifier for the allows system generate new

» numberRangeIdentifierValue

string

false

none

Represents a unique value for identifying a range of numbers associated with the invoice line item balance.

» 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