Resurssi: accounting.nv
HTTP-metodi: POST
Tositteen liitteen tuonnista rajapinnan yli peritään transaktiomaksu (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.
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):
| 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 | 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 | Seurantokohde 1 |
| Attr. | type | Merkkijono | 1 | Seurantokohteen tyyppi, netvisorkey tai name Jos annetaan arvo "netvisorkey", tulee elementtiin antaa seurantakohteen ID. ID:tä ei voi noutaa rajapinnan kautta, vaan ID näkyy Netvisorissa. Jos annetaan arvo "name", tulee elementtiin antaa seurantakohteen nimi. Seurantakohde tunnistetaan nimen perusteella kaikista seurantakohteen nimistä. | name |
| 3 | dimension | Aggregaatti | 0...n | ||
| 4 | dimensionname | Merkkijono, max. 50 | 1 | Laskentakohdeotsikko Jos otsikkoa ei löydy järjestelmästä, rajapinta perustaa sen | Projekti 1 |
| 4 | dimensionitem | Merkkijono, max. 200 | 1 | Laskentakohde Jos kohdetta ei löydy järjestelmästä, rajapinta perustaa sen | Palkanlaskenta |
| 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 |
Oliko tästä vastauksesta apua? Kyllä Ei
Send feedback