Get concept purchase invoices filtered and paged

Prev Next
Post
/api/v1/invoices/conceptpurchaseinvoices/filter

Get a paged list of existing concept purchase invoices , optionally filtered to the given parameters.

Get concept purchase invoices filtered and paged (POST)

This endpoint retrieves a paged, filterable list of concept purchase invoices.

Developers call it to search across concept purchase invoices for an administration, for example to build an overview screen, reconcile invoices against an external system, or find invoices still awaiting approval before they become final purchase invoices.

Paging and sorting can be combined with any of the available filters, and every field is optional, so a request with an empty filter returns every concept purchase invoice, paged according to the paging settings.

This endpoint only returns concept purchase invoices created by the API user making the request. Concept purchase invoices created by other users or other API users in the same Bloxs environment are not returned, even if they exist and are otherwise accessible to that environment. This restriction is intentional. For example, when a supplier uses this endpoint to retrieve its own concept purchase invoices, it cannot see or retrieve concept purchase invoices created by other suppliers or internal users in the same environment.


Request Fields

Field

Type

Required

Description

paging.pageSize

Integer

Optional

Maximum number of concept purchase invoices returned per page. Minimum 1, maximum 1000.

paging.pageNumber

Integer

Optional

Page number to retrieve, starting at 1. Minimum 1, maximum 9999.

sorting.sortBy

String

Optional

Name of the field to sort the results by.

sorting.ascending

Boolean

Optional

Sort direction. True sorts the results in ascending order, false in descending order.

filter.reference

String

Optional

Filters on the internal identifier of the concept purchase invoice.

filter.externalIdentifier

String

Optional

Filters on the external identifier of the invoice, as supplied by the caller on creation.

filter.ownerReference

String

Optional

Filters on the owner, the administration the invoice is booked against.

filter.relationReference

String

Optional

Filters on the relation, the supplier the invoice was received from.

filter.subject

String

Optional

Filters on the subject describing the invoice as a whole.

filter.invoiceDate.from

Datetime (ISO 8601)

Optional

Lower bound of the invoice date range to filter on, inclusive.

filter.invoiceDate.to

Datetime (ISO 8601)

Optional

Upper bound of the invoice date range to filter on, inclusive.

filter.paymentTermName

String

Optional

Filters on the name of the payment term applied to the invoice.

filter.expiryDate.from

Datetime (ISO 8601)

Optional

Lower bound of the expiry date range to filter on, inclusive.

filter.expiryDate.to

Datetime (ISO 8601)

Optional

Upper bound of the expiry date range to filter on, inclusive.

filter.paymentMethod

Integer (enum)

Optional

Filters on how the invoice is settled. Allowed values: 1 = DirectDebit, 2 = BankTransfer, 3 = Withdrawal, 4 = Cash, 5 = iDEAL.

filter.fromBankAccountIban

String

Optional

Filters on the IBAN of the account the payment is made from.

filter.toBankAccountIban

String

Optional

Filters on the IBAN of the account the payment is made to, typically the supplier's account.


Response Fields

Field

Type

Required

Description

paging.pageSize

Integer

Optional

Maximum number of concept purchase invoices returned per page, as applied to this result.

paging.pageNumber

Integer

Optional

Page number returned, as applied to this result.

sorting.sortBy

String

Optional

Name of the field the results are sorted by, as applied to this result.

sorting.ascending

Boolean

Optional

Sort direction applied to this result. True indicates ascending order, false indicates descending order.

purchaseInvoices

Array of objects

Optional

The concept purchase invoices matching the filter, for the requested page.

purchaseInvoices[].reference

String

Optional

Internal identifier of the concept purchase invoice.

purchaseInvoices[].externalIdentifier

String

Optional

External identifier of the invoice, as supplied by the caller on creation.

purchaseInvoices[].ownerReference

String

Optional

Reference to the owner, the administration the invoice is booked against.

purchaseInvoices[].relationReference

String

Optional

Reference to the relation, the supplier the invoice was received from.

purchaseInvoices[].subject

String

Optional

Subject describing the invoice as a whole.

purchaseInvoices[].invoiceDate

Date (ISO 8601, format YYYY-MM-DD)

Optional

Date on the invoice.

purchaseInvoices[].paymentTermName

String

Optional

Name of the payment term applied to the invoice.

purchaseInvoices[].expiryDate

Date (ISO 8601, format YYYY-MM-DD)

Optional

Date by which the invoice is expected to be paid or settled.

purchaseInvoices[].paymentMethod

Integer (enum)

Optional

How the invoice is settled. Allowed values: 1 = DirectDebit, 2 = BankTransfer, 3 = Withdrawal, 4 = Cash, 5 = iDEAL.

purchaseInvoices[].fromBankAccountIban

String

Optional

IBAN of the account the payment is made from.

purchaseInvoices[].toBankAccountIban

String

Optional

IBAN of the account the payment is made to, typically the supplier's account.

Security
Body parameters
Expand All
object
paging
object (PagingInfo)
pageSize
integer (int32) | null
Minimum1
Maximum1000
pageNumber
integer (int32) | null
Minimum1
Maximum9999
sorting
object (SortingInfo)
columnName
string | null
order
integer (int32)

Ascending = 0 Descending = 1

filter
object (ConceptPurchaseInvoiceSearchRequestFilter)
reference
string | null
externalIdentifier
string | null
ownerReference
string | null
relationReference
string | null
subject
string | null
invoiceDate
object (CompareFilterModelDateTime)
from
string (date-time) | null
to
string (date-time) | null
paymentTermName
string | null
expiryDate
object (CompareFilterModelDateTime)
from
string (date-time) | null
to
string (date-time) | null
paymentMethod
integer (int32) | null

DirectDebit = 1 BankTransfer = 2 Withdrawal = 3 Cash = 4 iDEAL = 5

fromBankAccountIban
string | null
toBankAccountIban
string | null
Responses
200

OK

Expand All
object
paging
object (PagingInfo)
pageSize
integer (int32) | null
Minimum1
Maximum1000
pageNumber
integer (int32) | null
Minimum1
Maximum9999
sorting
object (SortingInfo)
columnName
string | null
order
integer (int32)

Ascending = 0 Descending = 1

purchaseInvoices
Array of object (ConceptPurchaseInvoiceSearchResultFilter) | null
object
reference
string | null
externalIdentifier
string | null
ownerReference
string | null
relationReference
string | null
subject
string | null
invoiceDate
string (date) | null
paymentTermName
string | null
expiryDate
string (date) | null
paymentMethod
integer (int32) | null

DirectDebit = 1 BankTransfer = 2 Withdrawal = 3 Cash = 4 iDEAL = 5

fromBankAccountIban
string | null
toBankAccountIban
string | null