eHOKS - Täytettävät kentät

eHOKS

Päivitetty viimeksi: 23.4.2026

Ohjeessa on koottuna eHOKS-tiedonsiirrossa tarvittavat keskeiset kentät. Kenttälistaus päivittyy tarpeen mukaan. Kenttälistauksia on myös muissa eHOKS-ohjeissa, linkit ohjeisiin alla. Kaikkia opiskelijan perustietoihin liittyviä kenttiä, jotka joka tapauksessa täytetään aina opiskelijalle, ei ole tässä ohjeessa mainittu erikseen, kuten esimerkiksi opiskelijan nimi- ja yhteystiedot.

Koulun tiedot -rekisteriin tulee olla täytettynä tiedonsiirtoon vaikuttavat lisenssit ja tiedonsiirron tunnistetiedot.

Kenttä Rekisteri Huomioita
eHOKS-tiedonsiirron lisenssi Koulun tiedot Ohjelmapäivityspalvelusta
eHOKS-tiedonsiirron tunnus Koulun tiedot Tehdään eHOKS-palvelussa
eHOKS-tiedonsiirron salasana Koulun tiedot Tehdään eHOKS-palvelussa
Jaksot alkavat* Koulun tiedot Tutkinnon osassa on tämän vuoden valinta ja valinnan jakso
Jaksot päättyvät* Koulun tiedot Tutkinnon osassa on tämän vuoden valinta ja valinnan jakso
Lukuvuosi alkaa* Koulun tiedot Tutkinnon osassa on tämän vuoden valinta, mutta ei valinnan jaksoa
Lukuvuosi päättyy* Koulun tiedot Tutkinnon osassa on tämän vuoden valinta, mutta ei valinnan jaksoa

*Oppilaitosmuotoiset osaamisen hankkimisen jaksot siirretään Koulun tiedot -rekisteriin kirjattujen lukuvuoden ja jaksojen päivämäärien mukaan, jos opiskelijan opsissa ei ole vielä arviointia tutkinnon osassa.

Opiskelijat-rekisteri

 

Kenttä Rekisteri Huomioita
HOKS-tapahtumapvm Opiskelijat Pvm katsotaan taulukosta siltä riviltä, jolta löytyy ensikertainen hyväksyntä. Ensikertaisen hyväksynnän jälkeen siirtyy päivitys päivämäärä siltä riviltä, jolla on HOKS-tapahtumatyyppi-kentässä vaihtoehto "Hyväksyntä", "Päivitys" tai "Päivitys ja hyväksyntä".
HOKS-tapahtumatyyppi Opiskelijat

Joko "Ensikertainen hyväksyntä" tai "Laadinta ja ensikertainen hyväksyntä" -vaihtoehto triggeröi ensimmäisen eHOKS-siirron.

Sen jälkeen käytetään "Hyväksyntä", "Päivitys" tai "Päivitys ja hyväksyntä" vaihtoehtoa.
Tutkinto Opiskelijat

Valitaan Tutkinnot-rekisteristä sen tutkinnon perusteen mukainen tutkinto, jota opiskelija aloittaa opiskelemaan. Huomioi tutkintokoodi, perustekoodi ja diaarinumero.
Osaamisala Opiskelijat Täytä osaamisala sitten, kun se on tiedossa. Jos tieto on jo Koskessa, eHOKS-palvelu hakee sen sieltä.
Tutkintonimike Opiskelijat

Täytä tutkintonimike sitten, kun se on tiedossa. Jos tieto on jo Koskessa, eHOKS-palvelu hakee sen sieltä.
Opintojen laajuus Opiskelijat Tutkinnon/koulutuksen kokonaislaajuus
Opiskeluoikeusjakso alkaa Opiskelijat Opiskelijatyöpäivien laskenta/tuntimäärätaulukon päivämäärä viimeisimmältä riviltä, jossa on Opiskeluoikeuden tila=Läsnä
Aloituspäivä Opiskelijat Jos päiväyksiä ei löydy muualta
Arv.valmistumispäivä Opiskelijat Jos päiväyksiä ei löydy muualta
Eropäivä Opiskelijat Täytetään opiskelijan erotessa kesken opintojen.
Koulu-kenttä Opiskelijat  
eHOKS-siirron virhe Opiskelijat Kenttään tallentuu virheviesti, jos tiedonsiirrossa on virheitä.
Viimeisin eHOKS-data Opiskelijat Tallentuu automaattisesti viimeisen tiedonsiirron tiedot (json).
HOKS tunniste Opiskelijat Opiskelijan eHOKS id palautuu eHOKS-palvelusta ensimmäisessä siirrossa tähän kenttään.
Tutkintokoulutuksen ja muun tarvittavan ammattitaidon hankkimisen tarve Opiskelijat Kyllä/Ei
Sähköpostiosoite Opiskelijat Siirtyy, jos on täytetty.
Sähköpostiosoite 2 Opiskelijat Toissijainen. Siirtyy, jos Sähköpostiosoite-kenttä on tyhjä.
Matkapuhelin Opiskelijat 1.9.2022 alkaen opiskelijan päättökyselylinkkejä voi lähettää tekstiviestinä. Syötä kenttään vain oikeanmuotoinen puhelinnumero, ei tekstiä.
Opintojen tavoite saavutettu Opiskelijat

Pvm siirtyy eHOKS-palveluun ja aktivoi päättökyselylinkin muodostamisen. Täytetään vasta, kun tiedetään, että opiskelija on valmistumassa.
Opiskeluvalmiuksia tukevien opintojen nimi Opiskelijat Ei siirretä enää 1.8.2026 alkaen.
Opiskeluvalmiuksia tukevat opinnot alkaen Opiskelijat Ei siirretä enää 1.8.2026 alkaen.
Opiskeluvalmiuksia tukevat opinnot päättyen Opiskelijat Ei siirretä enää 1.8.2026 alkaen.
Opiskeluvalmiuksia tukevien opintojen kuvaus Opiskelijat Ei siirretä enää 1.8.2026 alkaen.

Opiskelijalajit-rekisteri

Tiedonsiirtoon mukaan haluttaville opiskelijalajeille rastitaan Huomioi eHOKS-siirrossa-kenttä. Tämän voi rastia samoille opiskelijalajeille, joille on täytetty Huomioi KOSKI-siirrossa-kenttä. Tarkista kuitenkin, että kyseisen opiskelijalajin kaikki opiskelijat ovat sellaisia, jotka tulee siirtää eHOKS-palveluun. Testiopiskelijalaji-kenttää ei rastita samalle opiskelijalajille. Se rastitaan ainoastaan, jos teillä on erikseen olemassa testiopiskelijoita varten oma opiskelijalaji ja joita ei siirretä tuotantoympäristöön.

Kenttä Rekisteri Huomioita
Huomioi eHOKS-siirrossa Opiskelijalajit Rastitaan kaikille siirtoon halutuille opiskelijalajeille.
Testiopiskelijalaji Opiskelijalajit Rastitaan opiskelijalajeille, joita ei saa siirtää tuotantoympäristöön (testiopiskelijat).

Pedagogiset asiakirjat -rekisteristä siirtyy eHOKS-palveluun urasuunnitelman tiedot eli opiskelijalle tehdään pedagoginen asiakirja, jonka asiakirjalaji on "Urasuunnitelma".

Kenttä Rekisteri Huomioita
Asiakirjan laatimispäivä Pedagogiset asiakirjat Jos tehdään useampi urasuunnitelma-asiakirja opintojen aikana, päiväykseltään uusin niistä siirtyy eHOKS-palveluun.
Asiakirjalaji Pedagogiset asiakirjat Asiakirjalajina tulee olla "Urasuunnitelma".
Opiskelijan tavoite Pedagogiset asiakirjat Kenttä viittaa Vastausvaihtoehdot-rekisteriin. Valitse joku vastausvaihtoehto, jolle on täytetty eHOKS-koodi. eHOKS-koodit täytetään Vastausvaihtoehdot-rekisteriin.
eHOKS-koodi Vastausvaihtoehdot Täytä eHOKS-koodi-kenttä vastausvaihtoehdoille. Koodit: 0001,0002, 0003, 0005

Urasuunnitelman päämäärät löytyvät eHOKS-palvelun ohjeista.

Opetustarjonta-rekisteri

Opetustarjonta-rekisterissä tulee olla täytettynä tutkinnon/koulutuksen osille ja osa-alueille:

Kenttä Rekisteri Huomioita
Nimi Opetustarjonta Nimi-tieto siirtyy paikallisille tutkinnon osille, joilla ei ole valtakunnallista koodia
Paikallinen tutkinnon osa Opetustarjonta Rastitaan paikallisille tutkinnon osille.
Tutkinnon osan koodi Opetustarjonta Tutkinnon osalle
KOSKI-tunniste Opetustarjonta Yhteisten tutkinnon osien osa-alueille
Tutkinnon osan ryhmä Opetustarjonta Vain "Ammatilliset tutkinnon osat" ja "Yhteiset tutkinnon osat" -otsikolle
Osaamispisteet Opetustarjonta  
Opetuksen ja ohjauksen tuntimäärä Opetustarjonta Kenttään voi laittaa oletusarvon kullekin opinnolle ja sitä voi muuttaa opiskelijakohtaisella kurssimuutoksella tarpeen mukaan.
Ei oppilaitosmuotoista osaamisen hankkimista Opetustarjonta Kenttä tulee rastia opiskelijakohtaisella kurssimuutoksella, jos opiskelija ei tarvitse oppilaitosmuotoista osaamisen hankkimista johonkin tutkinnon osaan vaan menee suoraan näyttöön.
Ammattitaitovaatimus Opetustarjonta Paikallisen tutkinnon osan sisältö
Ammattitaitovaatimukset Opetustarjonta Paikallisen tutkinnon osan sisältö
Tavoitteet Opetustarjonta Paikallisen tutkinnon osan sisältö
Sisältö Opetustarjonta Paikallisen tutkinnon osan sisältö
Tyyppi Opetustarjonta Viittaa Kurssityypit-rekisteriin, jossa täytetään Kurssityypin taso -kenttään "Tutkinnon osa" tai "Jakso" (osa-alueille)

Kurssityypit-rekisteri

Kenttä Rekisteri Huomioita
Nimi Kurssityypit  
Kurssityypin taso Kurssityypit Tutkinnon osien kurssityypeille "Tutkinnon osa" Kurssityypin taso -kentässä ja osa-alueiden kurssityypeille "Jakso".
Hyväksiluku Kurssityypit Jos osaamisen tunnustaminen tehdään vain kurssityyppiä vaihtamalla, täytetään os.tunnustamisen kurssityypille myös tämä kenttä.
Kenttä Rekisteri Huomioita
Arvosana Arvosanamääritykset Numero tai kirjain
Asteikko Arvosanamääritykset Mihin asteikkoon arvosana kuuluu. Asteikot luodaan Arvosana-asteikot-rekisteriin.
KOSKI-arvosana Arvosanamääritykset Kosken koodiston vastaava arvosana
Lasketaan suoritukseksi Arvosanamääritykset Rastitaan arvosanoille, jotka lasketaan suoritukseksi.

Työpaikalla järjestettävästä koulutuksesta (tjk) siirretään eHOKS-palveluun tiedot tutkinnon osa -kohtaisesti, vaikka samalle tjk-rekisterikortille olisi valittu useampi tutkinnon osa.

Kenttä Rekisteri Huomioita
Alkaa TJK-rekisteri Kurssi-taulukon monirivinen kenttä, josta työpaikkajakson alkamispäivä siirtyy ensisijaisesti (tutkinnon osittain rivikohtaisesti)
Päättyy TJK-rekisteri Kurssi-taulukon monirivinen kenttä, josta työpaikkajakson päättymispäivä siirtyy ensisijaisesti (tutkinnon osittain rivikohtaisesti)
Osa-aikaisuusprosentti TJK-rekisteri Kurssi-taulukon monirivinen kenttä, josta työpaikkajakson osa-aikaisuus siirtyy tutkinnon osittain rivikohtaisesti, arvo 1-100
Työssäoppiminen alkaa TJK-rekisteri Siirtyy toissijaisesti, jos Kurssi-taulukon Alkaa-kenttä on tyhjä.
Työssäoppiminen päättyy TJK-rekisteri Siirtyy toissijaisesti, jos Kurssi-taulukon Päättyy-kenttä on tyhjä.
Työpaikalla järjestettävän koulutuksen tyyppi TJK-rekisteri Koulutussopimus/Oppisopimus/Muu
Työssäoppimispaikka TJK-rekisteri Linkki Harjoittelu- ja työssäoppimispaikat -rekisteriin, josta siirtyy Nimi ja Y-tunnus. Toisijaisesti Yritykset-rekisterin Y-tunnus-kenttä.
Työssäoppimispaikka (oppilaitos) TJK-rekisteri Linkki Oppilaitokset-rekisteriin, josta siirtyy Nimi ja Y-tunnus.
Työpaikkaohjaaja TJK-rekisteri Linkki Työpaikkaohjaajat ja -arvioijat -rekisteriin. Siirtyy kentän ensimmäisen rivin työpaikkaohjaajan Sukunimi ja Etunimet ja Sähköpostiosoite sekä Matkapuhelin.
Työtehtävät TJK-rekisteri Kurssi-taulukon siltä riviltä, jossa on Kurssi-kentässä kyseinen siirrettävä tutkinnon osa.
(Työtehtävä TJK-rekisteri Jos Työtehtävät-kenttä on tyhjä)
(Työntekijän työtehtävät TJK-rekisteri Jos Työtehtävät ja Työtehtävä -kentät ovat tyhjät)
Vastuuopettaja TJK-rekisteri Linkki Opettajat-rekisteriin, vastuuopettaja työpaikkajaksolle
Yrittäjän oppisopimuskoulutus TJK-rekisteri Oppisopimuksen perusta -tieto eHOKS:ssa: Jos kenttä on rastittu, siirtyy koodiarvo 2 (yrittäjä). Jos kenttä on tyhjä, siirtyy koodiarvo 1 (työ-, virka- tai palvelussuhde).
Koulu-kenttä TJK-rekisteri Työssäoppimisen Koulu-kentässä olevalta koululta siirtyy Oppilaitoksen tunniste Opintopolkuun.
Älä huomioi eHOKS-siirrossa TJK-rekisteri Rastitaan, jos joku rekisterikortti ei vielä saa siirtyä eHOKS-palveluun.
Keskeytyksen alkamispäivä TJK-rekisteri Työpaikkajakson keskeytymisen alkaminen
Keskeytyksen päättymispäivä TJK-rekisteri Työpaikkajakson keskeytymisen päättyminen
Sopimuksen purkupäivä TJK-rekisteri Myös tämän kentän täyttäminen huomioidaan työpaikkajakson keskeytymistiedon siirtämisessä. Silloin siirretään keskeytyksen alkamiseksi Työssäoppiminen päättyy -kentän päivämäärä, jos Kurssi-taulukon joku tutkinnon osa on meneillään purkupäivänä.
Työpaikkahistoria* TJK-rekisteri Täytä tähän vanhan työpaikan nimi (ennen hyvinvointialuetta)
Työpaikkajakson alkupvm* TJK-rekisteri Sama työpaikkajakson alkupvm kuin Työssäoppiminen alkaa -kentässä
Työpaikkajakson loppupvm* TJK-rekisteri Loppupäiväksi kirjataan 31.12.2022 (ennen hyvinvointialuetta)

* Taulukko liittyy pääasiassa tilanteeseen, jolloin hyvinvointialueet tulivat voimaan ja täytyi erotella vuoden vaihteen yli jatkuvan työssä oppimisen jakson työpaikat.

Osaamisen osoittaminen eli näytöt siirretään allaolevien kenttien perusteella ammatillisista tutkinnon osista. Yhteisten tutkinnon osien osaamisen osoittaminen on ohjeistettu erikseen tässä ohjeessa, ellei sitä ole liitetty ammatillisen tutkinnon osan näyttöön tai tehty rekisterikorttia Näytöt-rekisteriin.

Kenttä Rekisteri Huomioita
Näytön aloituspvm Näytöt Alkupäiväksi siirretään tämä tai Näyttöpvm
Näyttöpvm Näytöt Alkupäiväksi siirretään tämä tai Näytön aloituspvm
Näytön päättymispvm Näytöt Loppupäiväksi siirretään tämä tai Näyttöpvm
Lyhyt kuvaus näytöstä Näytöt  
Suorituspaikka (työpaikka) Näytöt Ensisijainen. Harjoittelu- ja työssäoppimispaikat -rekisteristä Nimi, Y-tunnus ja Näyttöpaikan kuvaus+kieliversiot. Huom. täytä joko työpaikka tai oppilaitos. Toinen näistä on pakollista olla.
Suorituspaikka (oppilaitos) Näytöt Toissijainen. Oppilaitokset-rekisteristä Nimi, Y-tunnus ja Koulun lisätiedot+kieliversiot. Huom. täytä joko työpaikka tai oppilaitos. Toinen näistä on pakollista olla.
Näytön arvioija (opettaja) Näytöt Linkki Opettajat-rekisteriin, siirtyy Sukunimi ja Etunimet
Näytön arvioija 2 (opettaja) Näytöt Linkki Opettajat-rekisteriin, siirtyy Sukunimi ja Etunimet
Koulu-kenttä Näytöt Näytön rekisterikortin Koulu-kentän kautta Oppilaitoksen tunniste Opintopolkuun
Koulu-kenttä Opiskelijat Opiskelijan koululta Oppilaitoksen tunniste Opintopolkuun (jos näytön kortilla ei ole täytetty Koulu-kenttää)
Näytön arvioija (työpaikkaohjaaja) Näytöt Linkki Työpaikkaohjaajat ja -arvioijat -rekisteriin, siirtyy Sukunimi, Etunimet, Työpaikka>Nimi, Työpaikka>Y-tunnus tai Työpaikat-kentän 1.rivin työpaikka ja sen Y-tunnus
Näytön arvioija 2 (työpaikkaohjaaja) Näytöt Linkki Työpaikkaohjaajat ja -arvioijat -rekisteriin, siirtyy Sukunimi, Etunimet, Työpaikka>Nimi, Työpaikka>Y-tunnus tai Työpaikat-kentän 1.rivin työpaikka ja sen Y-tunnus
TA-arvioija Näytöt Työpaikkaohjaajat ja -arvioijat -rekisteristä Sukunimi, Etunimet, Työpaikka>Nimi, Työpaikka>Y-tunnus tai Työpaikat-kentän 1.rivin työpaikka ja sen Y-tunnus
TT-arvioija Näytöt Työpaikkaohjaajat ja -arvioijat -rekisteristä Sukunimi, Etunimet, Työpaikka>Nimi, Työpaikka>Y-tunnus tai Työpaikat-kentän 1.rivin työpaikka ja sen Y-tunnus
Yhteisten tutkinnon osien osa-alueet Näytöt Jos näytössä on näytetty myös jonkin yto osa-alueen osaamista, siirretään ne osa-alueet ja niiden Koski-tunniste, joille löytyy koodiston mukainen Koski-tunniste Opetustarjonta-rekisterissä.
Näytön järjestäjä (jos muu koulutuksen järjestäjä) Näytöt Oppilaitokset-rekisteristä Oppilaitoksen tunniste Opintopolkuun
Älä huomioi eHOKS-siirrossa Näytöt Rastitaan näytön rekisterikortille, jos näytön tiedot ei vielä saa siirtyä eHOKS-plveluun.

Aiemmin hankittu osaaminen eli osaamisen tunnustamiset siirretään seuraavasti Osaamisen tunnustaminen -rekisterin tietojen perusteella. Jos osaamista tunnustetaan pelkästään opinnon kurssityyppiä vaihtamalla, tulee tunnustamisen kurssityypille rastia Hyväksiluku-kenttä.

Kenttä Rekisteri Huomioita
Tutkinnon osan koodi Opetustarjonta Täytetään tutkinnon osille. Tutkinnon osilla Kurssityypit-rekisterin Kurssityypin taso -kentään "Tutkinnon osa".
KOSKI-tunniste Opetustarjonta Yhteisten tutkinnon osien osa-alueille. Osa-alueille Kurssityypit-rekisterissä Kurssityypin taso -kenttään "Jakso".
Tutkinnon osan ryhmä Opetustarjonta Täytetään vain otsikkotasolle. Huom. ei täytetä at- ja eat-tutkintojen opsiin.
Tunnustamisen tyyppi (rekisteristä) Osaamisen tunnustaminen Viittaa Tunnustamisen tyypit -rekisteriin, jonne täytetään kenttä eHOKS-koodi. Huom. eri koodi kuin urasuunnitelmissa.
Lähetetty arvioitavaksi, pvm Osaamisen tunnustaminen Siirtyy, jos Tunnustamisen tyyppi->eHOKS-koodi=2
Kurssin arvioija 1) Osaamisen tunnustaminen Monirivinen kenttä, siirtyy ensisijaisesti arvioijana eHOKS-palveluun. Siirtyy, jos Tunnustamisen tyyppi->eHOKS-koodi=2
Kurssin arvioija 2 1) Osaamisen tunnustaminen Monirivinen kenttä, siirtyy ensisijaisesti arvioijana eHOKS-palveluun. Siirtyy, jos Tunnustamisen tyyppi->eHOKS-koodi=2
Arvioija Osaamisen tunnustaminen Sukunimi ja Etunimet. Siirtyy, jos Tunnustamisen tyyppi->eHOKS-koodi=2. Siirtyy toissijaisesti eHOKS-palveluun, jos Kurssin arvioija-kentät on tyhjät.
Arvioija 2 Osaamisen tunnustaminen Sukunimi ja Etunimet. Siirtyy, jos Tunnustamisen tyyppi->eHOKS-koodi=2. Siirtyy toissijaisesti eHOKS-palveluun, jos Kurssin arvioija-kentät on tyhjät.
Koulu-kenttä Osaamisen tunnustaminen Ensisijaisesti osaamisen tunnustamisen rekisterikortilta Koulu-kentän kautta Oppilaitoksen tunniste Opintopolkuun. Toissijaisesti opiskelijan Koulu-kentän kautta Oppilaitoksen tunniste Opintopolkuun.
Älä huomioi eHOKS-siirrossa Osaamisen tunnustaminen Rastitaan, jos jotain tunnustamista ei saa siirtää eHOKS-palveluun.

Tunnustamisen tyypit -rekisteri

Tunnustamisen tyypit -rekisterissä tulee olla rekisterikortit allaoleville tunnustamisen tyypeille, joille on omat eHOKS-koodit. Oikea vaihtoehto valitaan Osaamisen tunnustaminen -rekisterissä Tunnustamisen tyyppi (rekisteristä) -kenttään.

eHOKS-koodi Selite Aiempi vaihtoehto Primuksessa (HOKS-mallit)
0001 Suoraan Sisällytetty osaksi opiskelijan tutkintoa osaamisen tunnustamisen perusteella.
0002 Arvioijien kautta Toimitettu osaamisen arvioijille osaamisen tunnustamista varten.
0003 Ohjattu näyttöön Ei aiempaa vastaavuutta Primuksessa. Tee uusi rekisterikortti.
- - Muu opiskelijan aiemmin hankkima ja osoittama osaaminen.
Related Topics Link IconAiheeseen liittyvät ohjeet