Post
/api/v1/invoices/purchaseinvoices/filter
Get a paged list of existing purchase invoices, optionally filtered to the given parameters.
Description
The endpoint retrieves a paged list of existing purchase invoices from the financial accounting administration, filtered to the given parameters. .
Use Case
The user may retrieve purchase invoices linked to a specific customer or contract in order to display them within a customer portal or during support interactions, enhancing service quality and transparency. Additionally, the API can be used to identify accounts with a high number of overdue purchase invoices, supporting escalation processes such as legal action or transfer to a collection agency.
Request fields
The request contains the following fields:
| Field | Description |
|---|---|
| pageSize | The maximum number of pages to be returned per request. The default number is 100 and the maximum is 1.000. If more results are returned than specified in the PageSize, the remaining pages are dropped based on the reference (number). |
| pageNumber | This allows the requesting party to specify which of the pages they want to receive. |
| columnName | The data field based on which sorting is applied. For example, if the results are sorted based on ascending name, columnName will contain the value 'name'. |
| order | Based on this value, the property defined in 'columnName' is either sorted ascending (a-z) or descending (z-a). |
| reference | This pertains to the reference of the specific payment reminder. This reference can be used to obtain further information regarding the payment reminder through the GET operation. |
| ownerReference | This pertains to the reference of the owner of the object. |
| relationReference | This is the reference of the relation associated with the reminder. It can refer to any relation type within the system and is not necessarily a tenant. For example, it may also refer to an owner who has an outstanding debt with another owner. |
| invoiceDate.from | This is the date on which the next action is required according to Bloxs. For example, if an invoice is due in eight days, this date will reflect the invoice´s due date. Please note: the API does not specify what the next action is, only when it is expected. This defines the lower border of the range. |
| invoiceDate.to | This is the date on which the next action is required according to Bloxs. For example, if an invoice is due in eight days, this date will reflect the invoice´s due date. Please note: the API does not specify what the next action is, only when it is expected. This defines the upper border of the range. |
| paymentTermName | Description of the payment term, for example: "Payment must be made by [date]." |
| dueDate.from | Due date of the purchase invoice. This defines the lower border of the range. |
| dueDate.to | Due date of the purchase invoice. This defines the upper border of the range. |
| totalAmountExcl.from | Total amount excluding VAT. This defines the lower border of the range. |
| totalAmountExcl.to | Total amount excluding VAT. This defines the upper border of the range. |
| totalAmountVAT.from | Total VAT amount. This defines the lower border of the range. |
| totalAmountVAT.to | Total VAT amount. This defines the upper border of the range. |
| totalAmountIncl.from | Total amount including VAT. This defines the lower border of the range. |
| totalAmountIncl.to | Total amount including VAT. This defines the upper border of the range. |
| OutstandingAmount.from | Total outstanding amount for the current month only. This reflects the amount due specifically within the current month and does not include any outstanding balances from previous months. The amount is expressed with two decimals. This defines the lower border of the range. |
| OutstandingAmount.to | Total outstanding amount for the current month only. This reflects the amount due specifically within the current month and does not include any outstanding balances from previous months. The amount is expressed with two decimals. This defines the upper border of the range. |
| OutstandingAmountReacalculateDate.from | The date on which the outstanding debt was last updated. This value is generated by Bloxs. This defines the lower border of the range. |
| OutstandingAmountReacalculateDate.to | The date on which the outstanding debt was last updated. This value is generated by Bloxs. This defines the upper border of the range. |
Security
HTTP
Type Bearer
Please enter a valid token
Body parameters
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)
Valid values[
0,
1
]
filter
object (PurchaseInvoiceSearchRequestFilter)
reference
string | null
ownerReference
string | null
relationReference
string | null
invoiceDate
object (CompareFilterModelDateTime)
from
string (date-time) | null
to
string (date-time) | null
paymentTermName
string | null
dueDate
object (CompareFilterModelDateTime)
from
string (date-time) | null
to
string (date-time) | null
totalAmountExcl
object (CompareFilterModelDecimal)
from
number (double) | null
to
number (double) | null
totalAmountVAT
object (CompareFilterModelDecimal)
from
number (double) | null
to
number (double) | null
totalAmountIncl
object (CompareFilterModelDecimal)
from
number (double) | null
to
number (double) | null
outstandingAmount
object (CompareFilterModelDecimal)
from
number (double) | null
to
number (double) | null
outstandingAmountRecalculateDate
object (CompareFilterModelDateTime)
from
string (date-time) | null
to
string (date-time) | null
Responses
200
OK
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)
Valid values[
0,
1
]
purchaseInvoices
Array of object (PurchaseInvoiceSearchResultFilter) | null
object
reference
string | null
ownerReference
string | null
relationReference
string | null
invoiceDate
string (date)
paymentTermName
string | null
dueDate
string (date)
totalAmountExcl
number (double)
totalAmountVAT
number (double)
totalAmountIncl
number (double)
outstandingAmount
number (double) | null
outstandingAmountRecalculateDate
string (date-time) | null