Tämä artikkeli kuvaa Työajan API menetelmät kertymien listaamiseksi.
GetAccrualValuesForUser
Hakee henkilön kertymien arvot tietyltä päivämäärältä. Palautettavat kertymät ovat sellaisia, jotka on määritetty laskettavaksi henkilölle.
Osa kertymistä on käytössä oletuksena jokaisella asiakkaalla. Näitä ovat "saldo", "jousto" ja "pankki". Asiakkaat voivat myös määrittää omia kustomoitua kertymiä. Näiden kertymien nimet nähdään kyselyn tuloksista, jos ne ovat käytössä. Kaikki kertymät palautetaan kutsulla. Kertymän arvon lisäksi menetelmä palauttaa myös kyseisen päivän kertymän muutoksen.
Syötettävät parametrit:
- CallerAuthentication - todentamisobjekti (katso CallerAuthentication)
- UserPersonnelNumber - sen henkilön käyttäjätunnus/henkilönumero, jolle kertymien arvot halutaan hakea
- SalaryDate - päivämäärä, jolloin kertymien arvot palautetaan, muoto VVVV-KK-PP esim. "31.12.2016". Huomautus: palauttaa kertymien arvot kaikkien kyseiseen päivään kuuluvien työvuorojen lopuksi.
Palautettavat kentät:
- ResponseCode - numeerinen arvo, joka kuvaa pyynnön onnistumista tai epäonnistumista, katso Response codes
- ResponseString - tekstikuvaus vastauksen onnistumisesta tai epäonnistumisen syystä
- AccrualList - lista Accrual elementeistä, katso Accrual
Accrual
- InternalName -kertymän sisäisen merkkijonon ID tunnus
- Name - kertymän asiakkaalle määritelty/käytössä olevan kielen mukainen nimi
- Amount - kertymän määrä
- ChangeAmount - kertymän muutoksen määrä edellisen päivän arvosta (ei palauteta, jos muutosta ei ole)