Tällä sivulla on ohjeita järjestelmätoimittajille henkilöstötietojen siirtoon.

Muutostietojen toimittaminen Vardaan

Palvelussuhteen muutostiedot

Vardaan toimitetaan työntekijän palvelussuhteella tapahtuvat muutokset luomalla uusi palvelussuhde ja työskentelypaikka Vardaan. Eli siinäkin tilanteessa, kun uutta palvelussuhdetta ei tehdä lähdejärjestelmään, toimitetaan muuttuneet tiedot Vardaan uutena palvelussuhteena.

  • Kun työntekijän voimassa olevalla palvelussuhteella ja palvelussuhdetta koskevissa tiedoissa (palvelussuhteen tyyppi; työajan tyyppi; työaika viikossa; tutkintokoodi) tapahtuu muutos, lisätään Vardaan palvelussuhteelle päättymispäivämäärä.
  • Tämän jälkeen Vardaan luodaan työntekijälle uusi palvelussuhde muuttuneilla tiedoilla sekä alkamispäivämäärällä, jolloin muutos on astunut voimaan.

Uuden palvelussuhteen luominen Vardaan on edellytys sille, että Vardaan saadaan tallennettua varhaiskasvatustoimijoilta luotettavaa, yhteismitallista ja vertailukelpoista tietoa myös palvelussuhteilla tapahtuvista muutoksista ja niiden ajankohdista. Näin toimimalla taataan myös niiden hyödyntäminen siten, että kaikkien varhaiskasvatustoimijoiden eri tavoin tallentamat tiedot ovat yhteismitallisia, vertailukelpoisia ja luotettavia. Sama muuttuneiden tietojen tallentamistapa on käytössä varhaiskasvatusjärjestelmien kohdalla lasten ja maksutietojen päivittämisessä. Tämä tarkoittaa, että Vardan henkilöitä koskevien tietojen muokkaus toimii läpi koko Vardan samalla logiikalla.


Esimerkki:

Työntekijä, jolla toistaiseksi voimassa oleva palvelussuhde (alkamispvm. 1.1.2015) viikkotyöajalla 38,25H muuttuu osa-aikaiseksi 1.10.2020 alkaen (viikkotyöaika 30H).

  • Vardaan toimitetaan tiedot:
    • Luodaan 1. palvelussuhde: alkamispvm 1.1.2015. Viikkotyöaika 38,25H. Kokoaikainen (1). Toistaiseksi voimassa oleva (1).
    • Työntekijä aloittaa osa-aikaisena. Lisätään 1. palvelussuhteelle päättymispvm 30.9.2020.
    • Luodaan 2. palvelussuhde alkamispvm. 1.10.2020. Viikkotyöaika 30H. Osa-aikainen (2). Toistaiseksi voimassa oleva (1).

Vastaavasti, jos työntekijällä on pidempi poissaolo, tieto pidemmästä poissaolosta toimitetaan poissaoloa vastaavalle palvelussuhteelle.

Tämä toteutus ei kuitenkaan poissulje sitä, että jos ainoastaan palvelussuhteen kestoon tulee muutos, voidaan alkamis- ja päättymispäivämääriä päivittää olemassa olevalle palvelussuhteelle.

Palvelussuhteen tietoja voidaan päivittää vain virheen korjausta sekä päivämäärien päivittämistä varten.

Poissaolon tallentaminen, kun poissaolo sijoittuu useammalle peräkkäiselle palvelussuhteelle

Työntekijän pidemmät poissaolot, jotka ovat vähintään 60 päivää, tallennetaan työntekijän palvelussuhteelle, mihin poissaolo kohdistuu.

Kun poissaolo kohdistuu työntekijän perättäisille palvelussuhteille, kaikille palvelussuhteille tallennetaan sama poissaolotieto.

Jos poissaolon kesto pidentyy, vain viimeiseksi tallennetun palvelussuhteen ja poissaolon kestoa tarvitsee muokata.


Esimerkki:

Palvelussuhde alkaen 1.1.2015 (38,25h). Poissaolo 1.11.2020-15.02.2021.

  • Työaikamuutokset:
  • 1.12.2020-31.12.2020 työaika 30,00h
  • 1.1.2021 alkaen työaika 38,25h

Vardaan tallennetaan:

  • Palvelussuhde 1.1.2015 - 30.11.2020: (38,25h) ja poissaolo: 1.11.2020-15.2.2021
  • Palvelussuhde 1.12.2020 - 31.12.2020 (30h) ja poissaolo: 1.11.2020-15.2.2021
  • Palvelussuhde 1.1.2021 --> (38,25h) ja poissaolo: 1.11.2020-15.2.2021

Esimerkit henkilöstötietojen siirtoon

Henkilö

  • Endpoint: /api/v1/henkilot/
    • Sallitut metodit: POST

Uuden henkilön voi lisätä käyttäen joko henkilotunnus- tai henkilo_oid-kenttää. Jos kyseinen henkilö on jo luotu Vardaan, vastauksena palautetaan olemassa oleva henkilö statuskoodilla 200. Normaalisti uuden henkilön luonnissa vastauksen statuskoodi on 201.

HUOM! Rooliton henkilö (henkilö ilman lapsen/työntekijän/huoltajan roolia) poistetaan Vardasta automaattisesti 5 kuukauden päästä henkilön syöttöhetkestä.


Esimerkki (POST):

{
  "henkilotunnus": "010612-335C",
  "etunimet": "Erkki",
  "kutsumanimi": "Erkki",
  "sukunimi": "Esimerkki"
}


Esimerkki (POST):

{
  "henkilo_oid": "1.2.246.562.24.47279942111",
  "etunimet": "Erkki",
  "kutsumanimi": "Erkki",
  "sukunimi": "Esimerkki"
}

Työntekijä

  • Endpoint: /api/henkilosto/v1/tyontekijat/
    • Sallitut metodit: POST
  • Endpoint: /api/henkilosto/v1/tyontekijat/{ID tai lähdejärjestelmä:tunniste}/
    • Sallitut metodit: PUT, PATCH, DELETE
  • Endpoint: /api/henkilosto/v1/tyontekijat/{ID tai lähdejärjestelmä:tunniste}/delete-all/
    • Sallitut metodit: DELETE

Työntekijää lisättäessä henkilöön voi viitata henkilo- tai henkilo_oid-kentällä ja varhaiskasvatuksen järjestäjään vakajarjestaja- tai vakajarjestaja_oid-kentällä.


Esimerkki (POST):

{
  "henkilo_oid": "1.2.246.562.24.XXXXXXXXXXX",
  "vakajarjestaja_oid": "1.2.246.562.10.XXXXXXXXXXX",
  "lahdejarjestelma": "10",
  "tunniste": "8ccb8222-e855-441e-821a-371b9c474b4f"
}


Työntekijä-objektin ja kaikki työntekijään liittyvät tiedot (tutkinnot, palvelussuhteet, työskentelypaikat, pidemmät poissaolot, täydennyskoulutukset) voi poistaa yhdellä kutsulla käyttämällä /delete-all/-endpointia.

Esimerkki (DELETE):

  • DELETE /api/henkilosto/v1/tyontekijat/1/delete-all/
  • DELETE /api/henkilosto/v1/tyontekijat/1:tyontekija-tunniste/delete-all/

Tutkinto

  • Endpoint: /api/henkilosto/v1/tutkinnot/
    • Sallitut metodit: POST
  • Endpoint: /api/henkilosto/v1/tutkinnot/{ID}/
    • Sallitut metodit: PUT, PATCH, DELETE
  • Endpoint: /api/henkilosto/v1/tutkinnot/delete/
    • Sallitut metodit: DELETE

Tutkintoa lisättäessä henkilöön voi viitata henkilo- tai henkilo_oid-kentällä ja varhaiskasvatuksen järjestäjään vakajarjestaja- tai vakajarjestaja_oid-kentällä.


Esimerkki (POST):

{
  "henkilo_oid": "1.2.246.562.24.XXXXXXXXXXX",
  "tutkinto_koodi": "371101",
  "vakajarjestaja_oid": "1.2.246.562.10.XXXXXXXXXXX"
}


Tutkinnon poistolle on olemassa myös erillinen endpoint. Poiston yhteydessä tulee ilmoittaa varhaiskasvatuksen järjestäjä, henkilö ja tutkintokoodi. Varhaiskasvatuksen järjestäjään ja henkilöön voi viitata joko OID:lla tai ID:llä.

Esimerkki (DELETE):

  • DELETE /api/henkilosto/v1/tutkinnot/delete/?henkilo_id=1&tutkinto_koodi=002&vakajarjestaja_id=1
  • DELETE /api/henkilosto/v1/tutkinnot/delete/?henkilo_oid=1.2.246.562.24.XXXXXXXXXXX&tutkinto_koodi=002&vakajarjestaja_oid=1.2.246.562.10.XXXXXXXXX
  • DELETE /api/henkilosto/v1/tutkinnot/1/

Palvelussuhde

  • Endpoint: /api/henkilosto/v1/palvelussuhteet/
    • Sallitut metodit: POST
  • Endpoint: /api/henkilosto/v1/palvelussuhteet/{ID tai lähdejärjestelmä:tunniste}/
    • Sallitut metodit: PUT, PATCH, DELETE

Palvelussuhdetta lisättäessä työntekijään voi viitata tyontekija- tai tyontekija_tunniste-kentällä.


Esimerkki (POST):

{
  "tyontekija_tunniste": "8ccb8222-e855-441e-821a-371b9c474b4f",
  "tyosuhde_koodi": "1",
  "tyoaika_koodi": "2",
  "tutkinto_koodi": "371101",
  "tyoaika_viikossa": 15.00,
  "alkamis_pvm": "2020-09-01",
  "paattymis_pvm": null,
  "lahdejarjestelma": "1",
  "tunniste": "5c328df2-2b6c-4ad7-96bc-2f8ed0b29cdf"
}

Työskentelypaikka

  • Endpoint: /api/henkilosto/v1/tyoskentelypaikat/
    • Sallitut metodit: POST
  • Endpoint: /api/henkilosto/v1/tyoskentelypaikat/{ID tai lähdejärjestelmä:tunniste}/
    • Sallitut metodit: PUT, PATCH, DELETE

Työskentelypaikkaa lisättäessä palvelussuhteeseen voi viitata palvelussuhde- tai palvelussuhde_tunniste-kentällä. Toimipaikkaan voi viitata toimipaikka-, toimipaikka_oid-, tai toimipaikka_tunniste-kentällä.


Esimerkki (POST):

{
  "palvelussuhde_tunniste": "5c328df2-2b6c-4ad7-96bc-2f8ed0b29cd",
  "toimipaikka": "/api/v1/toimipaikat/1/",
  "toimipaikka_oid": "1.2.246.562.10.XXXXXXXXXXX",
  "alkamis_pvm": "2020-09-01",
  "paattymis_pvm": null,
  "tehtavanimike_koodi": "64212",
  "kelpoisuus_kytkin": true,
  "kiertava_tyontekija": false,
  "lahdejarjestelma": "10",
  "tunniste": "6af21e06-8bd7-432f-855d-4a7cb2502c63"
}

Pidempi poissaolo

  • Endpoint: /api/henkilosto/v1/pidemmatpoissaolot/
    • Sallitut metodit: POST
  • Endpoint: /api/henkilosto/v1/pidemmatpoissaolot/{ID tai lähdejärjestelmä:tunniste}/
    • Sallitut metodit: PUT, PATCH, DELETE

Pidempää poissaoloa lisättäessä palvelussuhteeseen voi viitata palvelussuhde- tai palvelussuhde_tunniste-kentällä. 


Esimerkki (POST):

{
  "palvelussuhde": "/api/henkilosto/v1/palvelussuhteet/1/",
  "palvelussuhde_tunniste": "5c328df2-2b6c-4ad7-96bc-2f8ed0b29cd",
  "alkamis_pvm": "2021-09-01",
  "paattymis_pvm": "2021-12-01",
  "lahdejarjestelma": "10",
  "tunniste": "8ccb8222-e855-441e-821a-371b9c474b4f"
}

Täydennyskoulutus

  • Endpoint: /api/henkilosto/v1/taydennyskoulutukset/
    • Sallitut metodit: POST
  • Endpoint: /api/henkilosto/v1/taydennyskoulutukset/{ID tai lähdejärjestelmä:tunniste}/
    • Sallitut metodit: PUT, PATCH, DELETE

Yhteen täydennyskoulutukseen voi liittää useita saman varhaiskasvatuksen järjestäjän työntekijöitä. Työntekijät listataan taydennyskoulutus_tyontekijat-kentässä. Työntekijän lisäksi ilmoitetaan täydennyskoulutukseen liittyvä tehtävänimike.

Työntekijään voi viitata tyontekija-kentällä, tunniste- ja lahdejarjestelma-kentillä, tai henkilo_oid- ja vakajarjestaja_oid-kentillä.


Esimerkki (POST):

{
  "taydennyskoulutus_tyontekijat": [
    {
      "tyontekija": "/api/henkilosto/v1/tyontekijat/2/",
      "tehtavanimike_koodi": "39407"
    },
    {
      "tunniste": "8ccb8222-e855-441e-821a-371b9c474b4f",
      "lahdejarjestelma": "10",
      "tehtavanimike_koodi": "39407"
    },
    {
      "henkilo_oid": "1.2.246.562.24.XXXXXXXXXXX",
      "vakajarjestaja_oid": "1.2.246.562.10.XXXXXXXXX",
      "tehtavanimike_koodi": "41712"
    }
  ],
  "nimi": "Johtajien koulutus",
  "suoritus_pvm": "2020-09-09",
  "koulutuspaivia": "3",
  "lahdejarjestelma": "1",
  "tunniste": "d4f78fdc-2ac6-423b-b913-40290b571c63"
}


Täydennyskoulutukseen liittyviä työntekijöitä voi muokata PUT- ja PATCH-kutsuilla. Työntekijät voi korvata kokonaan käyttämällä taydennyskoulutus_tyontekijat-kenttää.

Työntekijöitä voi myös lisätä täydennyskoulutukselle käyttämällä taydennyskoulutus_tyontekijat_add-kenttää tai poistaa käyttämällä taydennyskoulutus_tyontekijat_remove-kenttää.

Esimerkki (PATCH):

{
  "taydennyskoulutus_tyontekijat_add": [
    {
      "tunniste": "8ccb8222-e855-441e-821a-371b9c474b4f",
      "lahdejarjestelma": "10",
      "tehtavanimike_koodi": "41712"
    }
  ],
  "taydennyskoulutus_tyontekijat_remove": [
    {
      "henkilo_oid": "1.2.246.562.24.XXXXXXXXXXX",
      "vakajarjestaja_oid": "1.2.246.562.10.XXXXXXXXX",
      "tehtavanimike_koodi": "41712"
    }
  ]
}

Täydennyskoulutus V2

  • Endpoint: /api/henkilosto/v2/taydennyskoulutukset/
    • Sallitut metodit: POST
  • Endpoint: /api/henkilosto/v2/taydennyskoulutukset/{ID tai lähdejärjestelmä:tunniste}/
    • Sallitut metodit: PUT, PATCH, DELETE

V2 versio sallii sellaisten työntekijöiden syöttämisen taydennyskoulutus_tyontekijat- ja taydennyskoulutus_tyontekijat_add-kentissä, joita ei ole olemassa, tai joilla ei ole annettua tehtävänimikettä. Virheelliset työntekijät listataan POST-, PUT- ja PATCH-kutsujen vastauksissa taydennyskoulutus_tyontekijat_failed-kentässä. Vähintään yksi oikea työntekijätieto vaaditaan, kun kaikki täydennyskoulutuksen työntekijät ilmoitetaan taydennyskoulutus_tyontekijat-kentässä.

Vuokrattu henkilöstö

  • Endpoint: /api/henkilosto/v1/tilapainen-henkilosto/
    • Sallitut metodit: POST
  • Endpoint: /api/henkilosto/v1/tilapainen-henkilosto/{ID tai lähdejärjestelmä:tunniste}/
    • Sallitut metodit: PUT, PATCH, DELETE

Vuokrattua henkilöstöä lisättäessä varhaiskasvatuksen järjestäjään voi viitata vakajarjestaja- tai vakajarjestaja_oid-kentällä.

Kuukausi siirretään YYYY-MM-DD-muodossa, mutta käytännössä vain vuodella ja kuukaudella on väliä.


Esimerkki (POST):

{
  "vakajarjestaja_oid": "1.2.246.562.10.XXXXXXXXXXX",
  "kuukausi": "2019-09-01",
  "tuntimaara": 30,
  "tyontekijamaara": 15,
  "lahdejarjestelma": "10",
  "tunniste": "08382195-7bbc-40e3-bd48-b888ec299c9f"
}

Sivun sisältö

  • No labels