Viikon 33 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 elementti tositteen noudossa
Kirjanpitnaineiston noutoon (acountingledger.nv) on lisätty uusi elementti, 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
Week 33 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 element in resource get accounting data
The new element has been added to api resource get accounting data (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