Resurssi: workday.nv
HTTP-metodi: POST
Työaikatietojen tuonti Netvisoriin. Työaikaa voidaan tuoda joko tunteina (workdayhour) tai kelloajan mukaan (workdaytime).
Workday.nv -rajapintaresurssilla tehty tuntitietojen tuonti kytkee automaattisesti päälle palkansaajakohtaisesti veloitettavista palveluista Palkat-palvelun.
Työaikatietojen tuonnilla tuodut työaikamerkinnät löytyvät Netvisorista:
Työaika > Työaika > Työajan kirjaus
Työaika > Työaika > Työajan hyväksyntä
Palkat > Palkanlaskenta > Työajan tehohallinta
Tuotavat tiedot lähetetään kutsun mukana oheisen kuvauksen mukaisena xml:nä (POST-data):
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 | Ilmentymiä | Kuvaus | Esimerkki |
Root | root | Aggregaatti | 1 |
|
|
1 | workday | Aggregaatti | 1 |
|
|
2 | date | Päivämäärä | 1 | Päivä jolle tuntikirjaukset tehdään | 2018-10-01 |
Attr. | format | Merkkijono | 1 | Päivämäärän muoto, aina ansi | ansi |
Attr. | method | Merkkijono | 0...1 | Tuonnin tyyppi päivälle, replace tai increment. Oletuksena replace. | replace |
2 | employeeidentifier | Numeerinen | 1 | Palkansaajan linkitystieto | 1407 |
Attr. | type | Merkkijono | 0...1 | Linkitystiedon tyyppi, number tai personalidentificationnumber tai netvisorkey | number |
Attr. | defaultdimensionhandlingtype | Merkkijono | 0...1 | Laskentakohteen hallinnan oletus: | usedefault |
2 | workdayhour | Aggregaatti | 0...n |
|
|
3 | hours | Numeerinen | 1 | Työaikakirjauksen tunnit (* , Netvisor pyöristää kahteen desimaaliin | 7,5 |
3 | collectorratio | Merkkijono | 1 | Kirjauslaji, lajin on löydyttävä Netvisorista | 11 |
Attr. | type | Merkkijono | 0...1 |
| number |
3 | acceptancestatus | Merkkijono | 1 | Työaikakirjausrivin tila, joko confirmed (kuitattu) tai accepted (hyväksytty) | confirmed |
3 | description | Merkkijono | 1 | Työaikakirjausrivin kuvaus | Tavalliset työtehtävät |
3 | crmprocessidentifier | Merkkijono | 0...1 | CRM tehtävän linkitystieto | NV#4321 |
Attr. | billingtype | Merkkijono | 1 | Laskutustyyppi, billable tai unbillable | billable |
3 | invoicingproductidentifier | Merkkijono | 0...1 |
|
|
3 | customeridentifier | Merkkijono | 0...1 | Laskutusasiakas | Testiasiakas |
type | Merkkijono | 1 | Tunnistetiedon tyyppi | netvisor | |
3 | dimension | Aggregaatti | 0...n |
|
|
4 | dimensionname | Merkkijono | 1 | Laskentakohdeotsikko, jos otsikkoa ei löydy, se perustetaan | Projekti |
4 | dimensionitem | Merkkijono | 1 | Laskentakohde, jos kohdetta ei löydy, se perustetaan | Palkanlaskenta |
Attr. | fatherid | Numeerinen | 0..1 |
| 33 |
4 | dimensionitemcode | Merkkijono | 0...1 | Laskentakohteen koodi | DIMC-001 |
4 | dimensionitemname | Merkkijono | 0...1 | Laskentakohteen nimi | Item Name 1 |
3 | contractid | Merkkijono | 0...1 | Mikäli haluat kohdistaa Rakennusalan ilmoitukset -osiossa luodulle urakalle työtunteja, aseta urakan tunniste. Urakan tunniste löytyy urakan muokkausnäkymässä kohdasta: Urakan tunniste (ID). | 3 |
2 | workdaytime | Aggregaatti | 0...n |
|
|
3 | starttimeofday | Numeerinen | 1 | Työaikakirjauksen aloitusaika | 08:00 |
3 | endtimeofday | Numeerinen | 1 | Työaikakirjauksen lopetusaika | 16:00 |
3 | breaktime | Numeerinen | 1 | Taukoaika minuutteina | 30 |
Attr. | type | Merkkijono |
| aina minutes | minutes |
3 | collectorratio | Merkkijono | 1 | Kirjauslajin linkitystiedon tyyppi, aina number | 11 |
Attr. | type | Merkkijono | 0...1 | aina number | number |
3 | acceptancestatus | Merkkijono | 1 | Työaikakirjausrivin tila, joko confirmed (kuitattu) tai accepted (hyväksytty) | confirmed |
3 | description | Merkkijono | 1 | Työaikakirjausrivin kuvaus |
|
3 | invoicingproductidentifier | Merkkijono | 0...1 |
|
|
3 | dimension | Aggregaatti | 0...n |
|
|
4 | dimensionname | Merkkijono | 1 | Laskentakohdeotsikko, jos otsikkoa ei löydy, se perustetaan | Projekti |
4 | dimensionitem | Merkkijono | 1 | Laskentakohde, jos kohdetta ei löydy, se perustetaan | Palkanlaskenta |
4 | dimensionitemcode | Merkkijono | 0...1 | Laskentakohteen koodi | DIMC-001 |
4 | dimensionitemname | Merkkijono | 0...1 | Laskentakohteen nimi | Item Name 1 |
*) Voit tuoda resurssilla myös työaikatietoja, joiden kirjauslajin yksikkö on 'Päivä' kuten lomapäiviä. Tällöin tulee elementille hours antaa arvoksi päivien lukumäärä (esim. 1, jolloin työaikatietoihin kirjataan yksi päivä). Että Netvisorin lomalaskenta toimisi oikein, pitäisi lomapäivät tuoda aina arvolla 1.