Resurssi: accountingledger.nv
HTTP-metodi: GET
Resurssia ei voi kutsua ilman parametrejä, jokin seuraavista parametreistä vaaditaan: netvisorkey, netvisorkeylist, startdate + enddate, changedsince, lastmodifiedstart tai lastmodifiedend
Kutsussa käytettävät parametrit:
| Parametri | Ilmentymiä | Kuvaus | Esimerkki |
| netvisorkey | 0...1 | Hakee yhden tositteen. Tositteen tunniste Netvisorissa. Ainoastaan parametri showgenerator on sallittu tämän kanssa | 1 |
| netvisorkeylist | 0...1 | Hakee monta tositetta kerralla. Ainoastaan parametri showgenerator on sallittu tämän kanssa. max. 500 netvisorkey:tä | 1,2,3 |
| startdate | 1 | Hakee tositteet annetun päivämäärän jälkeen. Vaatii parametrin enddate | 2024-01-01 |
| enddate | 1 | Hakee tositteet ennen annettua päivämäärää. Vaatii parametrin startdate. | 2024-01-01 |
| accountnumberstart | 0...1 | Rajaa tositteet tilinumeron perusteella. Palauttaa tositteet, joiden tilinumero on sama tai suurempi kuin annettu | 3000 |
| accountnumberend | 0...1 | Rajaa tositteet tilinumeron perusteella. Palauttaa tositteet, joiden tilinumero on sama tai pienempi kuin annettu | 3500 |
| changedsince | 0...1 | Hakee uudet ja annetun päivän jälkeen muuttuneet tositteet (tätä käytettäessä ei tarvitse antaa startdate ja enddate) | 2024-01-01 |
| lastmodifiedstart | 0...1 | Hakee tositteet, joita on muutettu annetun päivämäärän jälkeen | 2024-01-01 |
| lastmodifiedend | 0...1 | Hakee tositteet, joita on muutettu ennen annettua päivämäärää | 2024-01-01 |
| showgenerator | 0...1 | Palauttaa tositteelle tiedon kenen toimesta tosite on muodostunut. 0 = Ei lisää muodostajaa (oletus) 1 = Lisää muodostajan | 1 |
| voucherstatus | 0...1 | Rajaa tositteet tositteen tilan mukaan. 1 = kaikki 2 = vain voimassaolevat (oletus) 3 = poistetut ja mitätöidyt | 1 |
| vouchertype | 0...1 | Rajaa tositteet tositelajin mukaan. Käytetään arvona tositelajin Netvisokey:tä, jonka saa vouchertypelist.nv resurssilla. Vaatii parametrin startdata + enddate, lastmodifiedstart tai lastmodifiedend | 1 |
| includetransactionhistory | 0...1 | Palauttaa tositteen käsittelyhistorian 0 =Ei palauta tositteen käsittelyhistoriaa (oletus) 1 = Palauttaa tositteen käsittelyhistorian Jos pyynnössä palautuu yli 500 tositetta, rajapinta palauttaa virheen: Haettaessa useita tapahtumia kerralla, sivulla voi olla tapahtumia maksimissaan: 500 | 1 |
| includeattachmentsmetadata | 0...1 | Palauttaa tositteen liitteiden metadatan. Varsinaiset liitetiedot saa noudettua rajapintaresurssilla getvoucherattachments.nv 0 = Ei palauta tositteen liitteiden metadataa (oletus) 1 = Palauttaa tositteen liitteiden metadatan Jos pyynnössä palautuu yli 500 tositetta, rajapinta palauttaa virheen: Haettaessa useita tapahtumia kerralla, sivulla voi olla tapahtumia maksimissaan: 500 | 1 |
Vastaus:
| Taso | Elementti | Muoto | Ilmentymiä | Kuvaus | Esimerkki |
| root | Root | Aggregaatti | 1 | ||
| 1 | Vouchers | Aggregaatti | 1 | ||
| 2 | Voucher | Aggregaatti | 0...n | ||
| Attr. | status | Merkkijono | 0...1 | Tositteen tila | "valid", "invalidated" tai "deleted" |
| 3 | NetvisorKey | Numeerinen | 1 | Tositteen NetvisorKey | 5 |
| 3 | NetvisorGuid | Merkkijono | 1 | Tositteen GUID | 2f251125-bea1-4862-ada7-0196ea0028d9 |
| 3 | VoucherDate | Päivämäärä | 1 | Tositteen päivämäärä | 31.12.2023 |
| 3 | VoucherNumber | Numeerinen | 1 | Tositenumero | 515144 |
| 3 | VoucherDescription | Merkkijono | 1 | Tositteen kuvaus | |
| 3 | VoucherClass | Merkkijono | 1 | Tositteen laji | ML Myyntilasku |
| Attr. | netvisorkey | Numeerinen | 1 | Tositelajin NetvisorKey | 1 |
| 3 | LinkedSourceNetvisorKey | Numeerinen | 1 | Osto- tai myyntilaskun linkitystieto (laskun Netvisor Key) | 123 |
| Attr. | type | Merkkijono | 1 | Laskun tyyppi | purchaseinvoice tai salesinvoice |
| 3 | VoucherNetvisorUri | Merkkijono | 1 | Linkki tositteeseen Netvisorissa | |
| 3 | VoucherLine | Aggregaatti | 0...n | ||
| Attr. | status | Merkkijono | 0...1 | Tositerivin tila | "valid" tai "invalidated" |
| 4 | NetvisorKey | Numeerinen | 1 | Tositerivin Netvisor-avain | 6 |
| 4 | LineSum | Numeerinen | 1 | Rivin summa | 150,22 |
| 4 | Description | Merkkijono | 1 | Rivin kuvaus | |
| 4 | AccountNumber | Numeerinen | 1 | Kirjanpidon tilinumero | 1701 |
| 4 | VatPercent | Numeerinen | 1 | ALV-prosentti | 24 |
| 4 | VatCode | Merkkijono | 1 | ALV-koodi | |
| 4 | AccountDimension | Merkkijono | 0...1 | Seurantakohde | Seurantakohde 1 |
| Attr. | type | Numeerinen | 1 | Seurantakohteen netvisorkey | 2 |
| 4 | CorporationEventTarget | Aggregaatti | 0...1 | ||
| 5 | TargetCompany | Merkkijono | 1 | Konsernitapahtuman kohdeyritys | Testiyritys |
| Attr. | organisationidentifier | Merkkijono | 1 | Kohdeyrityksen y-tunnus | 123456-7 |
| 5 | EventStatus | Merkkijono | 1 | Konsernitapahtuman tila | New, Pending tai Exported |
| 4 | Dimension | Aggregaatti | 0...n | ||
| 5 | DimensionName | Merkkijono | 1 | Laskentakohdeotsikko | |
| 5 | DimensionItem | Merkkijono | 1 | Laskentakohde | |
| 3 | VoucherAttachments | Aggregaatti | 0...1 | Tositteen liitteiden metadata | Liitteiden datan noutamiseksi käytä rajapintaresurssia getvoucherattachments.nv |
| 4 | VoucherAttachment | Aggregaatti | 0...n | ||
| 5 | NetvisorKey | Numeerinen | 1 | Netvisor ID of the attachment | 123 |
| 5 | Name | Merkkijono | 1 | Name of the attachment file | Testattachment.pdf |
| 5 | Size | Numeerinen | 1 | File size in bytes | 425229 |
| 3 | TransactionHistory | Aggregaatti | 1 | ||
| 4 | Transaction | Aggregaatti | 0...n | ||
| 5 | Comment | Merkkijono | 1 | Comments added to the voucher activity | Voucher created |
| 5 | TimeStamp | Päivämäärä | 1 | Date of the activity | 2025-06-08 12.53.18 |
| Attr. | format | Merkkijono | 1 | Date type | ansi |
| 5 | Editor | Merkkijono | 1 | Name of the user who performed the activity | User |
Muutoshistoria
| Päivämäärä | Muutos | Kuvaus |
| 20.8.2025 | Vastauksen uudet tiedot | Uusi aggregaatti VoucherAttachments, joka palauttaa tositteen liitteiden metadatan |
| 20.8.2025 | Uusi parametri includetransactionhistory | Uusi parametri palauttaa tositteen käsittelyhistorian |
| 18.6.2025 | Vastauksen uudet tiedot | Uusi aggregaatti CorporationEventTarget, jossa palautetaan mahdolliset tositerivin konsernitiedot |
| 1.11.2024 | Uudet parametrit | netvisorkey, netvisorkeylist ja vouchertype |
| 1.11.2024 | Vastauksen uudet tiedot | Uusi elementti NetvisorGuid ja olemassa olevan VoucherClass -elementin netvisorkey attribuutti |
Oliko tästä vastauksesta apua? Kyllä Ei
Send feedbackPahoittelut, että emme voineet auttaa. Anna palautetta, jotta voimme parantaa tätä artikkelia.