- Created by Ninni Ojanen, last updated by Aino Röksä on Feb 17, 2026 5 minute read
Tällä sivulla ohjeistamme varhaiskasvatustoimijoita ja järjestelmätoimittajia tilanteessa, jossa nykyisestä lähdejärjestelmä siirrytään uuteen lähdejärjestelmään.
Mitä varhaiskasvatustoimijan tulee huomioida lähdejärjestelmän muuttuessa?
1) Ilmoita muutoksesta Opetushallitukselle
- Lähetä sähköposti osoitteeseen varda@opintopolku.fi
- Kerro:
- suunniteltu aikataulu
- koskeeko muutos henkilöstö- vai varhaiskasvatustietoja
- mihin järjestelmään ollaan siirtymässä
2) Varmista yhteistyö uuden järjestelmätoimittajan kanssa
Käykää yhdessä läpi:
- järjestelmävaihdon ohjeet (varhaiskasvatustiedot / henkilöstötiedot)
- teknisen integraation vaatimukset: Ohjeet järjestelmätoimittajille
- miten järjestelmävaihto toteutetaan (vaihtoehto 1 tai 2)
3) Varmista tiedonsiirron toteutustapa: Vaihtoehto 1 tai 2
- vaihtoehto 1 (suositeltava): Vardaan integroitavaan järjestelmään tallennetaan vanhasta järjestelmästä Vardaan tallennetut tiedot sekä tietojen yksilölliset tunnisteet eli linkitysavaimet.
Kysy järjestelmätoimittajalta onko järjestelmään toteutettu Vardan tietojen hakutoiminnot ja linkitysavainten käsittely
- jos ei, tulee järjestelmävaihto tehdä vaihtoehdon 2 mukaisesti
- vaihtoehto 2: Vanhan järjestelmän kautta päätetään voimassa olevat varhaiskasvatustiedot ja uudesta järjestelmästä siirretään uudet varhaiskasvatustiedot
Tätä käytetään, jos linkitysavaimia ei voida siirtää.
Jos et voi päättää tietoja vanhassa lähdejärjestelmässä → ota yhteys Vardan asiakaspalveluun ja päätä tiedot manuaalisesti Vardassa.
4) Testatkaa integraatio Vardan QA-ympäristössä
- Järjestelmätoimittaja tekee tekniset testit.
- Varmistakaa, että kaikki tietosisällöt siirtyvät oikein.
5) Palvelukäyttäjätunnuksen salasanan vaihtaminen
- Kun integraatio on testattu toimivaksi Vardan testiympäristössä (QA) ja on tarkoitus siirtyä tuotantosiirtoihin, vaihda palvelukäyttäjätunnuksen salasana.
- Tallenna uusi salasana uuteen lähdejärjestelmään järjestelmätoimittajan ohjeiden mukaan.
- Kunnissa salasanan vaihtaa vastuukäyttäjä tai Varda-pääkäyttäjä
- Yksityiset palveluntuottajat ottavat yhteyttä Vardan asiakaspalveluun
6) Tarkista, että kaikki toimii tuotannossa
- tietojen siirtyminen
- uudet tiedot muodostuvat oikein
- ei virheilmoituksia järjestelmässä tai Vardassa
7) Mahdolliset katkokset tiedonsiirrossa
- Ilmoita Vardan asiakaspalveluun, jos siirrossa on yli kuukauden katkos.
- Tiedonsiirron katkokset voivat vaikuttaa Vardan tietojen luovutuksiin, kuten Kelalle viikoittain Vardasta siirtyviin tietoihin.
Yleistä tietojen synkronoinnista järjestelmävaihtotilanteessa
Uudella integroituvalla järjestelmällä ei ole tietoa siitä, mitä tietoja Vardaan on jo tallennettu. Tämän voi ratkaista kahdella vaihtoehtoisella tavalla:
- vaihtoehto (suositeltava): Vardaan integroitavaan järjestelmään tallennetaan vanhasta järjestelmästä Vardaan tallennetut tiedot sekä tietojen yksilölliset tunnisteet eli linkitysavaimet.
- vaihtoehto: Vanhan järjestelmän kautta päätetään voimassa olevat varhaiskasvatustiedot ja uudesta järjestelmästä siirretään uudet varhaiskasvatustiedot
Vardaan integroitavaan järjestelmään tallennetaan vanhasta järjestelmästä Vardaan tallennetut tiedot sekä tietojen yksilölliset tunnisteet eli linkitysavaimet. Vaihtoehto 1: tarvittavat linkitysavaimet Varhaiskasvatuspäätöksen ID Vanhan järjestelmän kautta päätetään voimassa olevat varhaiskasvatustiedot ja uudesta järjestelmästä siirretään uudet varhaiskasvatustiedot Jos tietojen päättäminen vanhan järjestelmän kautta ei onnistu, tulee varhaiskasvatustoimijan päättää tiedot manuaalisesti Vardassa. Tällöin varhaiskasvatustoimijan tulee olla yhteydessä Vardan asiakaspalveluun varda@opintopolku.fi. Uudesta järjestelmästä luodaan varhaiskasvatuksessa jatkaville lapsille uudet varhaiskasvatustiedot päättymispäivää seuraavasta päivästä. Ennen uusien päätösten ja suhteiden tallentamista Vardaan, pitää varhaiskasvatuksenjärjestäjän tallentaa järjestelmäänsä lasten ja toimipaikkojen linkitysavaimet. Vaihtoehto 2: linkitysavaimet Vardaan integroitavaan järjestelmään tallennetaan vanhasta järjestelmästä Vardaan tallennetut tiedot sekä tietojen yksilölliset tunnisteet eli linkitysavaimet Vaihtoehto 1: tarvittavat linkitysavaimet Linkitettävä tieto linkitysavain Tutkinnon-ID Vanhan järjestelmän kautta päätetään voimassa olevien työntekijöiden henkilöstötiedot ja uudesta järjestelmästä siirretään uudet henkilöstötiedot Mikäli työntekijän tiedoissa on pidempi poissaolo, poissaolon päättymispäivämäärää ei muokata, vaan sama poissaolo tallennetaan myös uudelle palvelussuhteelle. Jos tietojen päättäminen vanhan järjestelmän kautta ei onnistu, tulee varhaiskasvatustoimijan päättää tiedot manuaalisesti Vardassa. Tällöin varhaiskasvatustoimijan tulee olla yhteydessä Vardan asiakaspalveluun varda@opintopolku.fi. Uudesta järjestelmästä luodaan varhaiskasvatuksessa jatkaville työntekijöille uudet palvelussuhteet, työskentelypaikat päättymispäivää seuraavasta päivästä. Vaihtoehto 2: linkitysavaimetVarhaiskasvatustietoja Vardaan siirtävän lähdejärjestelmän vaihtaminen
Vaihtoehto 1 (suositeltava)
Henkilö Henkilön ID tai oppijanumero-OID Lapsi Lapsen ID Varhaiskasvatuspäätös Varhaiskasvatussuhde Varhaiskasvatussuhteen ID Maksutieto Maksutiedon ID Toimipaikka Toimipaikan ID tai organisaatio-OID Vaihtoehto 2
Henkilö Henkilön ID tai oppijanumero-OID Lapsi Lapsen ID Toimipaikka Toimipaikan ID tai organisaatio-OID Henkilöstötietoja Vardaan siirtävän lähdejärjestelmän vaihtaminen
Vaihtoehto 1 (suositeltava)
Henkilö Oppijanumero-OID tai henkilön-ID Työntekijä Työntekijän-ID Tutkinto Palvelussuhde Palvelussuhteen-ID Työskentelypaikka Työskentelypaikan-ID Pidempi poissaolo Pidemmän poissaolon-ID Täydennyskoulutus Täydennyskoulutuksen-ID Vaihtoehto 2
Linkitettävä tieto linkitysavain Henkilö Henkilön-ID tai oppijanumero-OID Työntekijä Työntekijän-ID Toimipaikka Toimipaikan-ID tai organisaatio-OID
Vardan tekniset toiminnallisuudet tietojen hakemiseksi lähdejärjestelmään
Varhaiskasvatustoimijan tallentamat tiedot, voidaan myös hakea Vardasta palvelukäyttäjätunnuksen ja Vardan teknisten rajapintojen toiminnallisuuksien kautta.
- Tietojen hakeminen edellyttää, että järjestelmän toimittaja on toteuttanut tiedonhakuun tarkoitetut toiminnallisuudet lähdejärjestelmään.
Varhaiskasvatuksen järjestäjän kannattaa kysyä näiden toiminnallisuuksien käyttämisestä aina uudelta järjestelmäntoimittajalta.
Varhaiskasvatustiedot
| Vardaan tallennettujen lasten tunnisteiden hakeminen (lasten IDt) | /api/v1/lapset/ |
| Vardaan tallennetun lapsen kaikkien tietojen hakeminen | /api/v1/lapset/{lapsi_pk}/kooste/ |
| Vardaan tallennetun lapsen kaikkien maksutietojen hakeminen | /api/v1/lapset/{lapsi_pk}/maksutiedot/ |
| Vardaan tallennettujen toimipaikkojen hakeminen (orgnisaatio-OIDt/Varda-IDt) | /api/ui/toimipaikat/ |
| Varhaiskasvatuksen toimipaikan kaikkien tietojen hakeminen | /api/ui/toimipaikat/{id}/kooste/ |
| Varhaiskasvatustoimijan ostopalvelu- ja palvelusetelitoimijoiden tunnisteiden hakeminen (organisaatio-OIDit) | api/v1/vakajarjestajat/paos-toimijat |
| Varhaiskasvatustoimijan ostopalvelu- ja palvelusetelitoimipaikkojen tunnisteiden hakeminen (organisaatio-OIDit) | /api/v1/vakajarjestajat/{vakajarjestaja_pk}/paos-toimipaikat/ |
Henkilöstötiedot
Tietojen hakuun tarkoitettu ominaisuus | Tekninen rajapinta |
|---|---|
| Vardaan tallennettujen työntekijöiden tunnisteiden hakeminen (oppijanumero-OIDit ja Varda-IDt) | /henkilosto/v1/tyontekijat/ |
| Vardaan tallennetun työntekijän kaikkien tietojen hakeminen | /henkilosto/v1/tyontekijat/{tyontekija_pk}/kooste/henkilosto_v1_tyontekijat_kooste_list |
| Vardaan tallennettujen täydennyskoulutusten hakeminen (täydennyskoulutusten IDt) | /henkilosto/v1/taydennyskoulutukset/ |
| Vardaan tallennettujen toimipaikkojen hakeminen (orgnisaatio-OIDt/Varda-IDt) | /api/ui/toimipaikat/ |