Resurssi: accounting.nv
HTTP-metodi: POST
Tositteen liitteen tuonnista rajapinnan yli peritään transaktiomaksu per tosite(tämä näkyy palvelulaskulla nimellä e-scan veloitus).
Kirjanpitoaineiston tuonnilla voi tuoda tositteita, tositerivejä, rivien laskentakohteita ja tositteiden liitteitä. Tositepyyntö tulee osoittaa Accounting.nv –resurssiin ilman parametreja. Yhdessä pyynnössä kulkee aina vain yksi tosite. Mikäli tositteen numerotietoa ei ole annettu, hakee järjestelmä luodulle tositteelle seuraavan numeron juoksevasti valitulta tositelajilta.
Järjestelmän luomat tositelajit:
Myyntilasku (ML)
Myyntisuoritus (MS)
Pankki (PT)
Kassa (KT)
Tuodut tapahtumat (PUMP)
Automaattiset tilinpäätöskirjaukset (T)
Järjestelmän muodostamat (AT)
Muut (MU)
Ostolasku (OL)
Ostosuoritus (OS)
Jaksotukset (JK)
Palkka (PA)
Tositelaji täytyy tuoda sanomalla koko nimellä, ei tositelajin lyhenteellä. Käyttäjä voi lisätä uusia tositelajeja järjestelmään manuaalisesti.
Tositerivin summan muoto - veroton vai verollinen - valitaan tositekohtaisesti. Mikäli tositteen laskentatyyppi on veroton, ei järjestelmä laske enää itse arvonlisäverorivejä ja pyöristyseroja tositteen loppuun, vaan tositteesta tulee täysin aineistoa vastaava. Bruttolaskennassa alv-rivit ja pyöristyserorivit lasketaan aina automaattisesti järjestelmän toimesta.
Tositeriville valitun tilin tulee löytyä järjestelmästä, muutoin palautetaan INVALID_DATA –virhe selitteineen. Alv-koodi haetaan annetun tilin takaa mikäli sitä ei ole erikseen annettu. Mikäli käyttäjä syöttää alv-koodin, joka on ristiriidassa riville valitun alv-prosentin kanssa, ohjelma palauttaa virheen selitteineen. Katso lista sallituista alv-koodeista täältä.
Tosite tulee tuoda aina kaksipuoleisesti. Positiivinen rivisumma kirjataan debet-puolelle ja negatiivinen kredit-puolelle. Mikäli debet- ja kredit-kirjaukset eivät täsmää, erotus kirjataan automaattisesti pyöristyseroihin mikäli laskentatyyppi on brutto. Netto-laskentatavalla rajapinta kunnioittaa sanomalla tuotavia tietoja, jolloin tositteen debet- ja kredit kirjaukset eivät välttämättä mene tasan. Pyynnön sanomalla tulee varmistaa, että tosite luodaan kirjanpitosäännösten mukaisesti.
Yhteen tositeriviin voi liittyä useita laskentakohteita. Mikäli annetun laskentakohteen otsikko- tai kohdetietoja ei löydy järjestelmästä, rajapinta luo ne uutena. Lisätietoa laskentakohteiden käsittelystä löytyy täältä.
Tositteen tuonnin yhteydessä sille voi tuoda useita liitetiedostoja. Liitteet kuljetetaan xml-sanomassa base64-enkoodattuna. Rajapinta ei tarkista liitteiden kokoa, mutta suurin sallittu liitteiden koko on 2GB.
Tuotavan aineiston tiedot lähetetään kutsun mukana oheisen kuvauksen mukaisena XML:nä (POST-data):
Kutsussa käytettävät parametrit:
Parametri | Ilmentymät | Esimerkki | Kuvaus |
useonlyexistingdimensions | 0...1 | 1 | Estää uusien laskentakohdeotsikkojen ja laskentakohteiden automaattisen luonnin. Palauttaa virheen, jos annettua laskentakohdetta ei ole olemassa. |
Taso | Elementti | Muoto | Ilmentymät | Kuvaus | Esimerkki |
Root | root | Aggregaatti | 1 |
| |
1 | voucher | Aggregaatti | 1 |
|
|
2 | calculationmode | Merkkijono | 1 | Tositteen laskentatapa. Käsitelläänkö tositteen rivejä netto- (net) vai brutto- (gross) käsittelyllä. Nettokäsittelyssä järjestelmä ei laske automaattisesti alv- ja pyöristyserorivejä | net |
2 | voucherdate | Päivämäärä | 1 | Tositteen päiväys | 2023-03-1 |
Attr. | format | Merkkijono | 1 | Päivämäärän muoto, aina ansi | ansi |
2 | number | Numeerinen, max. 9 | 0...1 | Tositenumero. Jos numeroa ei anneta, järjestelmä hakee seuraavan numeron valitulta tositelajilta | 1 |
2 | description | Merkkijono | 0...1 | Tositteen kuvaus. Kentän maksimi merkkimäärä 255 -merkkiä. | Kuvaus |
2 | voucherclass | Merkkijono | 1 | Tositelaji. Katso mahdolliset tositelajit yllä (Netvisoriin voi lisäksi luoda omia tositelajeja). | Myyntilasku |
2 | checked | Merkkijono | 0...1 | Nouseeko tosite tarkastamattomiin tiliöinteihin vai ei. True tai false, oletuksena false. | false |
2 | comment | Merkkijono, max 255 merkkiä | 0...1 | Tositteen kommentti, joka näkyy tositteen käsittelyhistoriassa | Kommentti käsittelyhistoriaan |
2 | voucherline | Aggregaatti | 0...n |
|
|
3 | linesum | Numeerinen | 1 | Rivisumma, Negatiivinen kirjataan kredit-puolelle ja positiivinen debet-puolelle. Summa käsitellään kahden desimaalin tarkkuudella. | -100,00 |
Attr. | type | Merkkijono | 0...1 | Summan tyyppi, net (veroton) gross (verollinen) | net |
3 | description | Merkkijono | 0...1 | Tositerivin kuvaus. Kentän maksimi merkkimäärä 255 -merkkiä. | Kuvausteksti |
3 | accountnumber | Numeerinen | 1 | Kirjanpidon tilinumero (tulee löytyä järjestelmästä) | 1701 |
3 | vatpercent | Numeerinen | 1 | ALV-prosentti, Ei saa olla ristiriidassa valitun alv-koodin kanssa | 24 |
Attr. | vatcode | Merkkijono | 0...1 | ALV-koodi, Jos ei anneta, haetaan ALV-koodi tilinumeron takaa. Jos annetaan, käytetään annettua aina. ALV-koodit ja -tunnisteet löytyvät listattuna täältä. Katsothan myös Arvonlisäveron käsittely ja ALV-tunnisteet | KOMY |
3 | accountdimension | Merkkijono | 0...1 | Tositteen seurantakohde | Seurantakohde 1 |
Attr. | type | Merkkijono | 1 | Seurantokohteen tyyppi, netvisorkey tai name | name |
3 | dimension | Aggregaatti | 0...n |
|
|
4 | dimensionname | Merkkijono, max. 50 | 1 | Laskentakohdeotsikko | Projekti 1 |
4 | dimensionitem | Merkkijono, max. 200 | 1 | Laskentakohde | Palkanlaskenta |
4 | dimensionitemcode | Merkkijono | 0...1 | Laskentakohteen koodi | DIMC-001 |
4 | dimensionitemname | Merkkijono | 0...1 | Laskentakohteen nimi | Item Name 1 |
2 | voucherattachments | Aggregaatti | 0...1 |
|
|
3 | voucherattachment | Aggregaatti | 1...n |
|
|
4 | mimetype | Merkkijono | 1 | Liitteen mime-type | Application/pdf |
4 | attachmentdescription | Merkkijono, max. 100 | 1 | Kuvaus |
|
4 | filename | Merkkijono, max. 255 | 1 | Liitetiedoston nimi | Kuvaus.pdf |
4 | documentdata | Merkkijono | 1 | Liitetiedosto base64-enkoodattuna |
|