Viikon 34 viikkojulkaisussa julkaistavat muutokset rajapintaan:
Lisäykset olemassaoleviin rajapintaresursseihin:
Tositteen kommentti
Kirjanpitoaineiston tuonti (accounting.nv) ja kirjanpitonaineiston muokkaus (accountingedit.nv) rajapintaresursseille on lisätty mahdollisuus tuoda rajapinnasta kommentti, joka näkyy Netvisorissa tositteen käsittelyhistoriassa.
Esimerkkipyyntö:
<root>
<voucher>
<netvisorkey>435</netvisorkey>
<calculationmode>net</calculationmode>
<voucherdate format="ansi">2025-07-01</voucherdate>
<number>13</number>
<description>Test Oy, invoice 250701-1</description>
<voucherclass>Myyntilasku</voucherclass>
<comment>Test comment</comment>
<voucherline>
<linesum type="net">100.00</linesum>
<description>Some description</description>
<accountnumber>3000</accountnumber>
<vatpercent vatcode="KOMY">25,5</vatpercent>
</voucherline>
</voucher>
</root>
Uusi parametri tositteen käsittelyhistorian noutoon
Kirjanpitoaineiston noutoon (accountingledger.nv) on lisätty uusi parametri includetransactionhistory, jota käytettäessä palautetaan tositteen käsittelyhistoria.
Esimerkkivastaus:
<Voucher Status="valid">
<NetvisorKey>427</NetvisorKey>
<NetvisorGuid>4adbc6fa-258c-4f9b-b35e-f3bba1bc8539</NetvisorGuid>
<VoucherDate>14.8.2025</VoucherDate>
<VoucherNumber>11</VoucherNumber>
<VoucherDescription>Tilapäinen asiakas</VoucherDescription>
<VoucherClass netvisorkey="1">ML Myyntilasku</VoucherClass>
<LinkedSourceNetvisorKey type="salesinvoice">2</LinkedSourceNetvisorKey>
<VoucherNetvisorURI>http://isvapi.netvisor.fi/87116/427</VoucherNetvisorURI>
<VoucherLine Status="valid">
<NetvisorKey>448</NetvisorKey>
<LineSum>-100</LineSum>
<Description>Tilapäinen asiakas - Test2 </Description>
<AccountNumber>3000</AccountNumber>
<VatPercent>25,5</VatPercent>
<VatCode>KOMY</VatCode>
</VoucherLine>
<TransactionHistory>
<Transaction>
<Comment>Tosite luotu automaattisesti laskun perusteella</Comment>
<TimeStampformat="ansi">2025-08-15 11.30.33</TimeStamp>
<Editor>Sukunimi Etunimi</Editor>
</Transaction>
</TransactionHistory>
</Voucher>
Uusi parametri tositteen noudossa
Kirjanpitoaineiston noutoon (acountingledger.nv) on lisätty uusi parametri includeattachmentsmetadata, joka palauttaa tositteen liitteiden metadatan. Tositteen varsinaisen datan saa noudettua uudella rajapintaresurssilla getvoucherattachments.nv.
Esimerkkivastaus:
<Voucher Status="valid">
<NetvisorKey>424</NetvisorKey>
<NetvisorGuid>1fff10fb-fa30-4e79-a65e-6256bf91b203</NetvisorGuid>
<VoucherDate>6.8.2025</VoucherDate>
<VoucherNumber>9</VoucherNumber>
<VoucherDescription>Some description</VoucherDescription>
<VoucherClass netvisorkey="1">ML Myyntilasku</VoucherClass>
<LinkedSourceNetvisorKey type="" />
<VoucherNetvisorURI></VoucherNetvisorURI>
<VoucherLine Status="valid">
<NetvisorKey>462</NetvisorKey>
<LineSum>100,00</LineSum>
<Description>Some description</Description>
<AccountNumber>3000</AccountNumber>
<VatPercent>25,5</VatPercent>
<VatCode>KOMY</VatCode>
</VoucherLine>
<VoucherAttachments>
<VoucherAttachment>
<NetvisorKey>445</NetvisorKey>
<Name>ExampleAttachment.pdf</Name>
<Size>20431511</Size>
</VoucherAttachment>
<VoucherAttachment>
<NetvisorKey>455</NetvisorKey>
<Name>New Text Document.txt</Name>
<Size>5</Size>
</VoucherAttachment>
</VoucherAttachments>
</Voucher>
Uudet rajapintaresurssit:
Pankkitilien nouto getbankaccounts.nv
Kirjanpidon tositteen liitteiden nouto getvoucherattachments.nv
Konsernitapahtumien muokkaus vouchercorporationevent.nv
Week 34 week release changes in API:
New features and improvements:
New element comment to voucher resources
The option to add comments has been added to the api resources importing (accounting.nv) and editing (accountingedit.nv) accounting data. Comments are seen in vouchers processing history in Netvisor.
Example request:
<root>
<voucher>
<netvisorkey>435</netvisorkey>
<calculationmode>net</calculationmode>
<voucherdate format="ansi">2025-07-01</voucherdate>
<number>13</number>
<description>Test Oy, invoice 250701-1</description>
<voucherclass>Myyntilasku</voucherclass>
<comment>Test comment</comment>
<voucherline>
<linesum type="net">100.01</linesum>
<description>Some description</description>
<accountnumber>3000</accountnumber>
<vatpercent vatcode="KOMY">25,5</vatpercent>
</voucherline>
</voucher>
</root>
New parameter in resource get accounting data
The new parameter includetransactionhistory has been added to the fetch accountig data api resource (accountingledger.nv).
Example response:
<Voucher Status="valid">
<NetvisorKey>427</NetvisorKey>
<NetvisorGuid>4adbc6fa-258c-4f9b-b35e-f3bba1bc8539</NetvisorGuid>
<VoucherDate>14.8.2025</VoucherDate>
<VoucherNumber>11</VoucherNumber>
<VoucherDescription>Tilapäinen asiakas</VoucherDescription>
<VoucherClass netvisorkey="1">ML Myyntilasku</VoucherClass>
<LinkedSourceNetvisorKey type="salesinvoice">2</LinkedSourceNetvisorKey>
<VoucherNetvisorURI>http://isvapi.netvisor.fi/87116/427</VoucherNetvisorURI>
<VoucherLine Status="valid">
<NetvisorKey>448</NetvisorKey>
<LineSum>-100</LineSum>
<Description>Tilapäinen asiakas - Test2 </Description>
<AccountNumber>3000</AccountNumber>
<VatPercent>25,5</VatPercent>
<VatCode>KOMY</VatCode>
</VoucherLine>
<TransactionHistory>
<Transaction>
<Comment>Tosite luotu automaattisesti laskun perusteella</Comment>
<TimeStampformat="ansi">2025-08-15 11.30.33</TimeStamp>
<Editor>Sukunimi Etunimi</Editor>
</Transaction>
</TransactionHistory>
</Voucher>
New parameter in resource get accounting data
The new parameter includeattachmentsmetadata has been added to fetch accounting data api resource (acountingledger.nv). The element VoucherAttachments shows metadata of the voucher attachments. The actual data of the attachments can be retrieved with new api resource getvoucherattachments.nv.
Example response:
<Voucher Status="valid">
<NetvisorKey>424</NetvisorKey>
<NetvisorGuid>1fff10fb-fa30-4e79-a65e-6256bf91b203</NetvisorGuid>
<VoucherDate>6.8.2025</VoucherDate>
<VoucherNumber>9</VoucherNumber>
<VoucherDescription>Some description</VoucherDescription>
<VoucherClass netvisorkey="1">ML Myyntilasku</VoucherClass>
<LinkedSourceNetvisorKey type="" />
<VoucherNetvisorURI></VoucherNetvisorURI>
<VoucherLine Status="valid">
<NetvisorKey>462</NetvisorKey>
<LineSum>100,00</LineSum>
<Description>Some description</Description>
<AccountNumber>3000</AccountNumber>
<VatPercent>25,5</VatPercent>
<VatCode>KOMY</VatCode>
</VoucherLine>
<VoucherAttachments>
<VoucherAttachment>
<NetvisorKey>445</NetvisorKey>
<Name>ExampleAttachment.pdf</Name>
<Size>20431511</Size>
</VoucherAttachment>
<VoucherAttachment>
<NetvisorKey>455</NetvisorKey>
<Name>New Text Document.txt</Name>
<Size>5</Size>
</VoucherAttachment>
</VoucherAttachments>
</Voucher>
New API resources:
Get bank accounts getbankaccount.nv
Get voucher attachments getvoucherattachments.nv
Edit corporation vouchers vouchercorporationevent.nv