Resource: accountingledger.nv
HTTP-method: GET
The resource cannot be called without parameters; one of the following parameters is required: netvisorkey, netvisorkeylist, startdate + enddate, changedsince, lastmodifiedstart or lastmodifiedend
Parameters used in the request:
| Parameter | Occurs | Description | Example |
| netvisorkey | 0...1 | Fetches a single voucher. The voucher identifier in Netvisor. Only the 'showgenerator' parameter is allowed with this. | 1 |
| netvisorkeylist | 0...1 | Fetches multiple vouchers at once. Only the 'showgenerator' parameter is allowed with this. Maximum of 500 Netvisor keys. | 1,2,3 |
| startdate | 1 | Fetches vouchers added after the given date. Requires parameter enddate. | 2024-01-01 |
| enddate | 1 | Fetches vouchers added before the given date. Requires parameter startdate. | 2024-01-01 |
| accountnumberstart | 0...1 | Filters vouchers based on account number. Returns vouchers with account numbers equal to or greater than the given value. | 3000 |
| accountnumberend | 0...1 | Filters vouchers based on account number. Returns vouchers with account numbers equal to or less than the given value. | 3500 |
| changedsince | 0...1 | Fetches new and modified vouchers after the given date (does not require startdate and enddate). | 2024-01-01 |
| lastmodifiedstart | 0...1 | Fetches vouchers modified after the given date. | 2024-01-01 |
| lastmodifiedend | 0...1 | Fetches vouchers modified before the given date. | 2024-01-01 |
| showgenerator | 0...1 | Returns information about who generated the voucher. 0 = Do not add generator (default) 1 = Add generator | 1 |
| voucherstatus | 0...1 | Filters vouchers based on voucher status. 1 = All 2 = Valid (default) 3 = Invalidated and deleted | 1 |
| vouchertype | 0...1 | Filters vouchers according to the voucher type. Uses the value of the voucher type's Netvisokey, which can be obtained from the vouchertypelist.nv resource. Requires the parameter startdate + enddate, lastmodifiedstart or lastmodifiedend. | 1 |
| includetransactionhistory | 0...1 | Include/exclude the history of the voucher transactions 0 = Do not include transaction history 1 = Include transaction history If the voucher count are more than 500 in the request, then the response would have an error too many records | 1 |
| includeattachmentsmetadata | 0...1 | Include/exclude the attachment metadata of voucher transactions. Exact attachment data can be fetch with getvoucherattachments.nv api resource. 0 = Do not include attachment medatada (default) 1 = Include attachment metadata If the voucher count are more than 500 in the request, then the response would have an error too many records | 1 |
Response:
| Level | Element | Type | Occurs | Description | Example |
| root | Root | Aggregate | 1 | ||
| 1 | Vouchers | Aggregate | 1 | ||
| 2 | Voucher | Aggregate | 0...n | ||
| Attr. | status | Text | 0...1 | Status of the voucher | "valid", "invalidated" or "deleted" |
| 3 | NetvisorKey | Numeric | 1 | Netvisor key of the voucher | 5 |
| 3 | NetvisorGuid | Text | 1 | Voucher GUID | 2f251125-bea1-4862-ada7-0196ea0028d9 |
| 3 | VoucherDate | Date | 1 | Date of the voucher | 31.12.2023 |
| 3 | VoucherNumber | Numeric | 1 | Voucher's reference number | 515144 |
| 3 | VoucherDescription | Text | 1 | Free description text | |
| 3 | VoucherClass | Text | 1 | Class of voucher | ML Sales invoice |
| Attr. | netvisorkey | Numeric | 1 | Voucher type's netvisorkey | 1 |
| 3 | LinkedSourceNetvisorKey | Numeric | 1 | Netvisor key of the sales- or purchaseinvoice | 123 |
| Attr. | type | Text | 1 | Invoice type | purchaseinvoice or salesinvoice |
| 3 | VoucherNetvisorUri | Text | 1 | URI to the voucher in Netvisor | |
| 3 | VoucherLine | Aggregate | 0...n | ||
| Attr. | status | Text | 0...1 | Status of the voucher line | "valid" or "invalidated" |
| 4 | NetvisorKey | Numeric | 1 | Netvisor key of the voucher line | 6 |
| 4 | LineSum | Numeric | 1 | Sum of the voucher line | 150,22 |
| 4 | Description | Text | 1 | Free description text | |
| 4 | AccountNumber | Numeric | 1 | Account number | 1701 |
| 4 | VatPercent | Numeric | 1 | VAT percent | 24 |
| 4 | VatCode | Text | 1 | VAT code | |
| 4 | AccountDimension | Text | 0...1 | Follow-up object | Follow-up object 1 |
| Attr. | type | Numeric | 1 | Follow-up object's netvisorkey | 2 |
| 4 | CorporationEventTarget | Aggregate | 0...1 | ||
| 5 | TargetCompany | Text | 1 | Target company of the corporation event | Test company |
| Attr. | organisationidentifier | Text | 1 | Business id of the target company | 123456-7 |
| 5 | EventStatus | Text | 1 | Status of the corporation event | New, Pending or Exported |
| 4 | Dimension | Aggregate | 0...n | ||
| 5 | DimensionName | Text | 1 | Cost object header | |
| 5 | DimensionItem | Text | 1 | Cost object | |
| 3 | VoucherAttachments | Aggregate | 0...1 | Attachments metadata of the vouchers | For retrieving voucher attachments data use API endpoint getvoucherattachments.nv |
| 4 | VoucherAttachment | Aggregate | 0...n | ||
| 5 | NetvisorKey | Numeric | 1 | Netvisor ID of the attachment | 123 |
| 5 | Name | Text | 1 | Name of the attachment file | Testattachment.pdf |
| 5 | Size | Numeric | 1 | File size in bytes | 425229 |
| 3 | TransactionHistory | Aggregate | 1 | ||
| 4 | Transaction | Aggregate | 0...n | ||
| 5 | Comment | Text | 1 | Comments added to the voucher activity | Voucher created |
| 5 | TimeStamp | Date | 1 | Date of the activity | 2025-06-08 12.53.18 |
| Attr. | format | Text | 1 | Date type | ansi |
| 5 | Editor | Text | 1 | Name of the user who performed the activity | User |
Change history
| Date | Change | Description |
| 20.8.2025 | New data in response | New aggregate VoucherAttachments, which returns the metadata of the voucher attachment |
| 20.8.2025 | New parameter includetransactionhistory | New parameter includetransactionhistory returns the voucher processing history |
| 18.6.2025 | New data in the response | New aggregate CorporationEventTarget, which returns possible corporation data of the voucher line |
| 1.11.2024 | New parameters | netvisorkey, netvisorkeylist and vouchertype |
| 1.11.2024 | New data in the response | New element NetvisorGuid and the existing VoucherClass element's netvisorkey attribute |
This article has been translated using an AI-based translation tool. The contents or wording of these instructions may differ from those in other instructions or in the software.
Did you find it helpful? Yes No
Send feedbackSorry we couldn't be helpful. Help us improve this article with your feedback.