Resurssi: purchaseinvoicecirculation.nv
HTTP-metodi: POST
Resurssilla voidaan asettaa, muokata tai poistaa ostolaskun asiatarkastus- ja hyväksyntäkierto. Kierto asetetaan joko kiertolistan perusteella tai henkilöittäin.
Kiertoon asetettavien henkilöiden identifiointi tapahtuu sähköpostiosoitteen perusteella. Jos henkilölle on asetettu sähköpostiosoite Netvisorin omissa perusasetuksissa kohdassa Yrityskohtaiset poikkeukset, käytetään kyseistä sähköpostia. Henkilön sähköpostiosoitteen on oltava uniikki yrityksessä.
Kiertoon asetettavalla henkilöllä on oltava Netvisorissa riittävät reskontraoikeudet kyseisessä roolissa toimimiseksi. Lisäksi mahdollinen toimittaja- tai summaraja ei saa olla asettamisen esteenä. HUOM! Rajapintakäyttäjältä vaaditaan kierron asettajan reskontraoikeus.
Rajapintaresurssilla voidaan asettaa useamman ostolaskun kierto samanaikaisesti. Mikäli resurssi palauttaa OK-vastauksen, kaikkien kiertojen asetus on onnistunut. Jos palautetaan virhe, yhtäkään kiertoa ei aseteta. Vastauksessa palautetaan ValidDataIdentifier-elementti jokaiselle laskulle, jolle olisi voitu asettaa kierto ilman virhetilannetta.
Kierron poistaminen tapahtuu jättämällä asiatarkastajat ja hyväksyjä laskulle tuomatta.
Viimeisestä asiatarkastajasta tulee laskun pääasiatarkastaja.
Jos ostolaskulla on jo kierto ja joku kierron henkilöistä on hyväksynyt tai asiatarkastanut laskun, kiertoa ei voi enää muokata rajapinnan kautta.
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 | purchaseinvoicecirculations | Aggregaatti | 1 |
|
|
2 | purchaseinvoicecirculation | Aggregaatti | 1...n | Yhden ostolaskun kierto |
|
3 | invoiceidentifier | Aggregaatti | 1 | Ostolaskun tunniste, joko ID tai laskunumero |
|
4 | netvisorkey | Numeerinen | 0...1 | Ostolaskun ID | 123 |
4 |
| Merkkijono | 0...1 | Laskunumero | 123 |
3 | circulationlistidentifier | Aggregaatti | 0.. | Kiertolistan tunniste. Jos tunniste on asetettu, ei voida tuoda henkilöitä ja päinvastoin. |
|
4 | netvisorkey | Numeerinen | 1 | Kiertolistan ID | 10 |
3 | factualverificator | Aggregaatti | 0...n | Ostolaskun asiatarkastajat |
|
4 | Merkkijono | 1 | Sähköpostiosoite | ||
3 | approver | Aggregaatti | 0...1 | Ostolaskun hyväksyjä |
|
4 | Merkkijono | 1 | Sähköpostiosoite | hannu.hyväksyjä@yritys.com | |
3 | comment | Merkkijono, maks. 250 | 0...1 | Käsittelyhistorian kommentti | Asiatarkastajat ja hyväksyjä asetettu ulkoisen integraation X toimesta. |