Resurssi: purchaseinvoicepostingdata.nv
HTTP-metodi: POST
Resurssia voi käyttää ostolaskun hylkäämiseen, asiatarkastamiseen tai hyväksyntään sekä tiliöinnin tekemiseen. Tuonnin yhteydessä voi antaa myös tiliöintirivit uudelleen, eli rivejä voi tätä kautta muokata ja ostolaskurivi voidaan tiliöidä tällä useammaksi tiliöintiriviksi.
Resurssia kutsuttaessa tarkistetaan sanomalla määriteltyjen ohjelmistorajapintatunnusten omistajan tiliöintioikeudet.
Ostolasku jota halutaan asiatarkastaa, hyväksyä tai hylätä pitää olla tilassa avoin tai erääntynyt. Rivitiedot ovat samat kuin ostolaskusanomassakin, tuotavat rivitiedot korvaavat ostolaskulla olevat rivitiedot. Rivitiedoissa olevat summat pitää vastata ostolaskun summaa, muutoin tuonti jää virheeseen.
Ostolaskun tiliöintirivejä voi muokata, lisätä ja poistaa, jos lasku on tilassa: Uusi lasku, Asiatarkastettu, Hyväksytty tai Tiliöity. Jos ostolasku on Hyväksytty-tilassa, ostolaskun muokkaaminen vaatii KP-roolin (kirjanpitäjän roolin). Tiliöitintirivien summa tulee olla sama kuin laskun alkuperäinen summa. Lasku ei saa olla lukitulla kaudella. Ostolaskun voi tiliöidä ilman tilan muuttamista, kun annetaan IsReadyForAccounting-elementtiin 1 ja jätetään Status-elementti pois. Riippuen ostolaskun tilasta, niin tämä joko esitiliöi tai tiliöi laskun, kuten käyttöliittymän kautta. IsReadyForAccounting-elementin voi jättää myös nollaksi, jolloin sanoma muokkaa tiliöintirivejä ilman, että varsinainen tiliöinti tehdään.
Jos ostolasku halutaan asiatarkastaa, hyväksyä tai tiliöidä, tai halutaan muokata ostolaskun tiliöintirivejä, tulee ohjelmistorajapintakäyttäjällä olla tarvittavat oikeudet. Käyttäjällä tulisi olla vähintään Ostoreskontran käyttäjän profiili sekä myynti- ja ostoreskontrien oikeuksissa ostolaskujen asiatarkastus- ja hyväksyntäoikeudet. Kun ostolaskulla on kirjanpidon tosite, tiliöintirivien muokkaus onnistuu ainoastaan KP-roolilla.
Tuotavat tiedot lähetetään kutsun mukana oheisen kuvauksen mukaisena XML:nä (POST-data):
Taso | Elementti | Muoto ja pituus | Ilmentymiä | Kuvaus | Esimerkki |
root | root | Aggregaatti | 1 |
|
|
1 | purchaseinvoicepostingdata | Aggregaatti | 1 |
|
|
2 | purchaseinvoicenetvisorkey | Numeerinen | 1 | Ostolaskun ID | 31646 |
2 | status | Merkkijono | 1 | Ostolaskun tilat (status) missä järjestyksessä ne voidaan antaa: | approved |
2 | eventdate | Päivämäärä | 0...1 | Kirjauspäivä | 2019-01-15 |
Attr. | format | Merkkijono | 1 | Kirjauspäivän muoto, aina ansi | ansi |
2 | isreadyforaccounting | Numeerinen | 1 | Mikäli annetaan arvo 1, niin Netvisor muodostaa tositteen automaattisesti. Jos annetaan arvo 0, tulee varsinainen tiliöinti tehdä manuaalisesti Netvisorissa. | 1 |
2 | comment | Merkkijono, max 3000 merkkiä | 0...1 | Ostolaskun kommentti, näkyy ostolaskun käsittelyhistoriassa | Kommentti |
2 | purchaseinvoicepostingline | Aggregaatti | 0...n |
|
|
3 | purchaseinvoicelinenetvisorkey | Numeerinen | 0...1 | Ostolaskurivin NetvisorID | 12345 |
3 | productcode | Merkkijono | 0...1 | Tuotekoodi | 123 |
3 | productname | Merkkijono | 1 | Tuotteen nimi. Voidaan jättää pois antamalla elementti tyhjänä, mutta jos ostolaskun rivillä on nimike niin tämä ylikirjoittaa arvon tyhjäksi. | Esimerkkituote |
3 | orderedamount | Numeerinen | 0...1 | Tilattujen tuotteiden määrä |
|
3 | deliveredamount | Numeerinen | 1 | Toimitettujen tuotteiden määrä |
|
3 | unitname | Merkkijono | 0...1 | Mittayksikkö | kpl |
3 | unitprice | Numeerinen | 1 | Yksikköhinta |
|
3 | discountpercentage | Numeerinen | 0...1 | Alennusprosentti |
|
3 | vatpercent | Numeerinen | 1 | Alv-prosentti | 24 |
Attr. | vatcode | Merkkijono | 1 | ALV-tunnus, ALV-koodit ja -tunnisteet on listattuna täällä | KOMY |
3 | linesum | Numeerinen | 1 | Pyöristys kahteen desimaaliin |
|
Attr. | type | Merkkijono | 1 | Vain gross = "brutto" | gross |
3 | description | Merkkijono, max 200 merkkiä | 0...1 | Kuvaus |
|
3 | sort | Numeerinen | 0...1 | Tuotavan rivijärjestysnumero | 1 |
3 | accountingsuggestion | Numeerinen | 0...1 | Tiliöintiehdotus, jos ei anneta, käytetään yrityksen oletustiliöintitiliä |
|
3 | dimension | Aggregaatti | 0...n |
|
|
4 | dimensionname | Merkkijono | 1 | Laskentakohdeotsikko |
|
4 | dimensionitem | Merkkijono | 1 | Laskentakohde |
|
5 | dimensionitemcode | Merkkijono | 0...1 | Laskentakohteen koodi | DIMC-001 |
5 | dimensionitemname | Merkkijono | 0...1 | Laskentakohteen nimi | Item Name 1 |