Tälle sivulle on koottu Vardan tiedonsiirtojen yleisimpiä virheitä, niiden kuvaukset sekä korjaustavat. Kun tiedot tuodaan Vardaan integraatiolla tulee tarvittavat korjaukset tehdä omassa lähdejärjestelmässä. Tiedonsiirron ongelmissa on hyvä olla ensisijaisesti yhteydessä omaan järjestelmätoimittajaan. 

VirhekoodiVirheen kuvausMilloin virhe syntyy?Korjaus/esimerkki
MI013Tällä lähdejärjestelmä ja tunniste -parilla löytyy jo objekti. Tarkista, että syötetyn tiedon lähdejärjestelmän tuottama tunniste on uniikki.Lähdejärjestelmätunnistetta voi käyttää Vardassa Varda-IDn tai oppijanumeron tavoin tieto-objektin yksilöimiseen. Tämä virhe syntyy, kun uutta tietoa yritetään luoda jo käytössä olevalla lähdejärjestelmätunnisteella.Esim. työntekijän lähdejärjestelmätunnisteen pitää olla uniikki per tallentava lähdejärjestelmä. Samaa tunnistetta voi kyllä käyttää kunhan lähdejärjestelmä on eri, mutta saman lähdejärjestelmän sisällä ei voi käyttää eri vaka-järjestäjillä samaa työntekijän lähdejärjestelmätunnistetta, vaan tunnisteen pitää olla uniikki lähdejärjestelmässä. Virhe on hyvä selvittää järjestelmätoimittajan kanssa, sillä kyseessä on lähdejärjestelmätason virhe.
MI015Kohdetta ei löydy.Yleisimpiä tiedonsiirron virheitä. Virhe syntyy, kun haetaan tietoja, joihin ei ole oikeutta tai tietoa, jota ei ole olemassa.

Tarkasta tiedonsiirrossa käytetyt tunnisteet ja niiden oikeellisuus.

Virhe voi näyttää Tiedonsiirrot -raportilla esimerkiksi seuraavalta:

eli toimipaikkaa ei ole Vardassa tai toimipaikkaan ei ole oikeutta (toimipaikka on esimerkiksi toisen varhaiskasvatustoimijan).

MI007Organisaatio-OIDin tai oppijanumero-OIDin muoto on virheellinen.Virhe syntyy, kun tietokentän (organisaatio-OID/oppijanumero-OID) sisältö on virheellinen.Tarkasta organisaatio-OID/oppijanumeron muoto, esim. mahdolliset ylimääräiset/puuttuvat välilyönnit tai merkit.

1) GE008

2) RF003


1) Epäkelpo hyperlinkki, objektia ei löydy.

2) Vastaavaa objektia ei löydy.

GE008 ja RF003 -virheet ovat samantyyppisiä virheitä. Vardassa on mahdollista viitata objekteihin ID:llä tai sitten OID:n tai tunnisteen avulla, esim. lasta luodessa rajapintakutsu voi näyttää suunnilleen tältä:

{
  "henkilo": "/api/v1/henkilot/1/",
  "henkilo_oid": "1.24....",
  ...
}
  • GE008 viittaa siihen, että tällasta henkilöä ei löydy tai käyttäjällä ei ole henkilöön oikeuksia.
  • RF003 taas kertoo siitä, että on käytetty henkilo_oid-kenttää ja sitäkään kautta ei ole löytynyt henkilöä tai henkilöön ei ole oikeuksia.

Käytännössä molemmat siis tarkoittavat sitä, että on yritetty viitata johonkin objektiin, jota ei ole olemassa tai siihen ei ole käyttäjällä oikeuksia. Objekti voi olla henkilö, lapsi, varhaiskasvatuksenjärjestäjä, toimipaikka, varhaiskasvatuspäätös jne.

Varmista, että rajapintakutsussa on viitattu siihen objektiin, johon on tarkoitettu. Tarkasta viitatun objektin ID:n/OID:n/tunnisteen oikeellisuus ja että kyseinen objekti, johon on viitattu löytyy Vardasta.
MA003Väestötietojärjestelmästä ei löydy lapsen ilmoitettua huoltajaa.Virhe syntyy, mikäli Varda ei saa haettua Oppijanumerorekisterin kautta VTJ:sta tulevaa tietoa lapsen huoltajasta/huoltajista.
  1. Tyypillisin syy lapsen huoltaja- ja maksutiedon tallentamisen epäonnistumiselle on se, että huoltaja- ja maksutietoa yritetään tallentaa heti, kun lapsen tiedot on tallennettu Vardaan. Varda hakee huoltajatiedot lapselle viiveellä. Huoltajatiedot haetaan Vardaan kahden tunnin välein eli mikäli olet juuri tallentanut lapsen tiedot, odota vähintään kaksi tuntia ennen huoltaja- ja maksutietojen tallennusta.
  2. Lapsen tiedoissa on virhe, jonka vuoksi hän ei ole yksilöitynyt, joten lapselle ei ole voitu hakea huoltajatietoja. Ole yhteydessä Vardan asiakaspalveluun.
  3. Varda hakee tiedon huoltajista Oppijanumerorekisterin kautta, joka saa tietonsa VTJ:sta. Joskus näiden kahden järjestelmän välisessä tietojen päivittymisessä on ongelmaa. Ole yhteydessä Vardan asiakaspalveluun, niin päivitämme lapsen huoltajatiedot tarvittaessa.
  4. Kyseessä ei ole lapsen virallinen huoltaja.
  5. Lapsi on tallennettu oppijanumerolla Vardaan, jolloin lapselle ei voida hakea huoltajatietoja. Maksutietoa ei voida tallentaa.
PE006Käyttöoikeudet eivät riitä.

Virhe syntyy, jos toimenpiteen tekemiseksi ei ole tarvittavia käyttöoikeuksia.

  1. Tarkista, että palvelukäyttäjälle on myönnetty siirrettävään tietokokonaisuuteen liittyvät käyttöoikeudet.
  2. Jos virhe tulee PAOS-tietoihin liittyen: tarkista, että Vardan PAOS-hallinnassa on tehty molemminpuolinen linkitys. Jos linkitystä ei ole tai vain toinen osapuoli on tehnyt sen, tietoja ei voi tallentaa.
  3. Jos virhe liittyy PAOS-tietoihin, palvelukäyttäjän käyttöoikeudet ovat kunnossa ja PAOS-linkitys on tehty molemminpuolisesti, virhe voi johtua siitä, että kyseiseen PAOS-toimijaan liittyvät käyttöoikeudet ovat jostain syystä vialliset. Ratkaisuksi kannattaa kokeilla ensin PAOS-hallinnassa tietojen tallentajan muuttamista hetkeksi. Tällöin tähän toimijaan liittyvät käyttöoikeudet alustetaan. Eli kunnan Varda-pääkäyttäjä vaihtaa PAOS-hallinnassa kyseisen toimijan kohdalla tietojen tallentajan ja tallentaa muutoksen. Sitten odotetaan noin 5 minuuttia ja vaihdetaan tallentajaksi uudelleen kunta. Jos tämä toimenpide ei auta, ota yhteys Vardan asiakaspalveluun.
PE007Käyttöoikeuksien tarkistaminen epäonnistui.

Virhe syntyy yleensä silloin, kun autentikointi on epäonnistunut / palvelukäyttäjä ei ole päässyt onnistuneeseen sisäänkirjautumiseen.

  1. Tarkasta palvelukäyttäjälle myönnetyt käyttöoikeudet. Palvelukäyttäjälle kuuluvat käyttöoikeudet tunnistaa "ei henkilöille" -maininnasta. Kunnan Varda-pääkäyttäjä voi tarvittaessa lisätä palvelukäyttäjälle puuttuvat käyttöoikeudet. Esimerkiksi jos integraatiolla siirretään Vardaan työntekijä- ja täydennyskoulutustiedot tulee palvelukäyttäjällä olla seuraavat käyttöoikeudet: Varda-henkilöstö-työntekijätietojen palvelukäyttäjä (ei henkilöille) & Varda-henkilöstö-täydennyskoulutustietojen palvelukäyttäjä (ei henkilöille).

  2. Tarkasta, että palvelukäyttäjätunnus ja salasana ovat asetettuna oikein lähdejärjestelmään. Tarvittaessa kunnan pääkäyttäjä voi vaihtaa salasanan palvelukäyttäjän tiedoissa.

  3. Varmista, että palomuuriavaus on ip-osoitteesta tehty.

  4. Varmista haetaanko api-avain tuotantoympäristöstä: https://backend.varda-db.csc.fi/api/user/apikey/
DY010Syntaksivirhe lähetetyssä JSON-sanomassa: {{}}Virhe syntyy, kun Vardaan lähetetty rajapintakutsu on ollut jollain tapaa virheellinen.Tarkasta lähetetty rajapintakutsu ja korjaa kutsussa olevat mahdolliset virheet. Esimerkiksi rajapintakutsussa saattaa olla ylimääräsiä rivinvaihtoja tai puuttuvia pilkkuja.

1) VP012

2) VS014

1) Lapsella pitää olla vähintään yksi varhaiskasvatuspäätös.

2) Varhaiskasvatuspäätöksellä on oltava vähintään yksi varhaiskasvatussuhde.


1) Virhe syntyy, kun lapsen perustiedot on tallentunut Vardaan, mutta häneltä puuttuu pakollinen varhaiskasvatuspäätös.

2) Virhe syntyy, kun lapsi on tallennettu Vardaan ja hänelle on lisätty varhaiskasvatuspäätös, mutta häneltä puuttuu varhaiskasvatussuhde.

1) Lisää lapselle vähintään yksi varhaiskasvatuspäätös ja päätökselle varhaiskasvatussuhde.

2) Jos näyttää, että lähdejärjestelmässä lapsella on tarvittavat tiedot (varhaiskasvatuspäätös ja -suhde) oikein, kyseessä on luultavasti tiedonsiirroissa syntynyt duplikaatti (tupla), joka tulee poistaa Vardasta. Katsele tietoja -näkymässä näkee jokaisen tiedon ID:n.

Alla olevassa esimerkissä näet Katsele tietoja -näkymässä lapsen Varda-IDn sekä varhaiskasvatuspäätöksen ID:n.

ID:n perusteella tuplana siirtyneisiin lapsiin (tai muihin duplikaattitietoihin) pitäisi päästä käsiksi lähdejärjestelmässä. Suosittelemme olemaan yhteydessä järjestelmätoimittajaan, jotta voidaan varmistaa, että Vardasta poistetaan oikea tieto.

KO003Koodiarvo on virheellinen.Virhe syntyy, kun rajapintakutsussa on jonkin koodin kohdalla käytetty virheellistä koodiarvoa. Toisin sanoen käytetty koodi ei ole Vardan koodistojen mukainen. 

Epäonnistuneissa tiedonsiirroissa voi näkyä esimerkiksi seuraavanlainen virhe:

Virhe on tällöin käytetyssä tutkintokoodissa. Tarkasta käytetty koodiarvo ja varmista, että siinä ei ole virhettä ja se on Vardan tutkintokoodiston mukainen .

eli esimerkiksi jos työntekijällä ei ole varhaiskasvatusalan tutkintoa, koodiarvo on 003 ei varhaiskasvatusalan tutkintoa tai koulutusta.