Resource: purchaseinvoicecirculation.nv
HTTP-method: POST
Resource can be used for setting, editing or deleting purchase invoice circulation.
The identification of circulation users is done using email address. If the user has an email address saved in Netvisor's User settings Company-specific exceptions, this email address is used. Users email address has to be unique in the company.
The user set for circulation has to have sufficient Accounts receivable and accounts payable rights in Netvisor to factually verify and/or accept purchase invoices. In addition there shouldn't be a vendor or sum limit that prevents circulation. Note! The API user must have a right for setting purchase invoice's approval circulation in Accounts receivable and accounts payable rights in Netvisor.
The resource can be used to set multiple circulations at the same time in one message. If API responds with "OK", the circulation for all purchase invoices has been set. If API responds with an error, importing purchase invoice circulation failed for all invoices in the same message. ValidDataIdentifier-element is returned for those purchase invoices where importing purchase invoice circulation would have been successfull without the error.
Deleting purchase invoice circulation is done by not importing factual verificators and approver for the invoice.
The last imported factual verficator will be set as invoice's main factual verificator.
If the purchase invoice already has circulation and a user has accepted or factually verified the invoice, the circulation can not be edited via API.
The following describes the XML message to import (POST) purchase invoice circulation into Netvisor:
| Level | Element | Format | Occurs | Description | Example |
| Root | root | Aggr. | 1 | ||
| 1 | purchaseinvoicecirculations | Aggr. | 1 | ||
| 2 | purchaseinvoicecirculation | Aggr. | 1 | Circulation for one purchase invoice | |
| 3 | invoiceidentifier | Aggr. | 1 | Purchase invoice identifier, NetvisorID or invoice number | |
| 4 | netvisorkey | Numeric | 0...1 | Purchase invoice NetvisorID | 123 |
| 4 | invoicenumber | Numeric | 0...1 | Purchase invoice number | 123 |
| 3 | circulationlistidentifier | Aggr. | 0...n | Circulation list identifier. If circulation list is set, the user (factual verificator and/or approver) cannot be imported and vice versa. | |
| 4 | netvisorkey | Numeric | 1 | Circulation list identifier | 10 |
| 3 | factualverificator | Aggr. | 0...n | Factural verificators | |
| 4 | String | 1 | Email address | verificator@company.com | |
| 3 | approver | Aggr. | 0...1 | Purchase invoice approver | |
| 4 | String | 1 | Email address | approver@company.com | |
| 3 | comment | String, max 250 | 0...1 | Comment for handling history | Verificators and approver set by integration X. |
Did you find it helpful? Yes No
Send feedback