.svg){kind=small}
Incoming Invoices
Workflows > Endpoints > Reporting > Incoming Invoices
Purpose: Retrieve general information of incoming supplier invoices and supplier credit notes. Option of query the payment state of the invoices and credit notes.
This endpoint is typically used in cases where retrieving information of incoming supplier invoices and credit notes are important for the integrated application. The endpoint return the general invoice and supplier information with the total amounts (i.e. the information in the "header" of an supplier invoice/credit note). The returned data do not include the cost line details, which might be posted with different dimensions than the header (for instance). If the lines and cost account transactions are needed, they will need to be retrieved using the Account Transactions endpoint.
The returned lightweight object information include the balance state of the invoice/credit note, and information of the last change of the balance state. The balance represent the remaining amount to be paid, meaning that a balance of 0 (zero) usually mean that the supplier invoice is paid. These properties can be used in filtering to query for the general payment state of supplier invoices/credit notes. You can read more about the balance property and its meaning in the supplier ledger description.
.png)
Descriptions
Retreive supplier invoice and credit note information for a given date interval
Use filtering on from date and to date (dates inclusive) to get all supplier invoices and credit notes within the date interval. Use any supplementary filtering as needed.
Check for and retreive new supplier invoice and credit note information
Use filtering on voucher number greater than <the voucher number previously retreived>
This will return only new invoices and credit notes, if any
Check for and retreive new supplier invoice and credit note information, including a lightweight payment state of existing invoices and creditnotes
Use filtering on balance last changed greater than <the timestamp of your previous query>
This will return new invoices and credit notes, or existing invoices and credit notes with a change in balance. A change in balance usually imply a match with a payment transaction
Prerequisites
Access to the IncomingInvoices access privelige
The client need an active subscription of an accounting module of PowerOffice Go
Related workflows:
Accoount Transactions
Supplier Ledger for any detailed payment retreival
Dimension endpoints to supplement information
Contact endpoints to supplement information