Koski-tietomalli - Ylioppilastutkinnon opiskeluoikeus

Oppija

Oppija Koski-järjestelmässä. Sisältää henkilötiedot ja listan opiskeluoikeuksista, jotka puolestaan sisältävät suorituksia, läsnäolotietoja jne. Henkilötietoja ei tallenneta Koskeen, vaan haetaan/tallennetaan Opintopolun henkilöpalveluun.

Nimi	Lukumäärä	Tyyppi	Kuvaus
henkilö	1	Henkilötiedot ja henkilö-OID Henkilö-OID Täydelliset henkilötiedot Uusi henkilö	Henkilötiedot. Syötettäessä vaaditaan joko oppijanumero `oid` tai kaikki muut kentät, jolloin järjestelmään voidaan tarvittaessa luoda uusi henkilö.
opiskeluoikeudet	0..n	Aikuisten perusopetuksen opiskeluoikeus Ammatillinen opiskeluoikeus DIA-tutkinnon opiskeluoikeus EB-tutkinnon opiskeluoikeus Esiopetuksen opiskeluoikeus European school of helsinki opiskeluoikeus IB-tutkinnon opiskeluoikeus International school opiskeluoikeus Korkeakoulun opiskeluoikeus Lukion opiskeluoikeus Lukioon valmistavan koulutuksen opiskeluoikeus Muun kuin säännellyn koulutuksen opiskeluoikeus Perusopetukseen valmistavan opetuksen opiskeluoikeus Perusopetuksen lisäopetuksen opiskeluoikeus Perusopetuksen opiskeluoikeus Taiteen perusopetuksen opiskeluoikeus Tutkintokoulutukseen valmentavan koulutuksen opiskeluoikeus Vapaan sivistystyön opiskeluoikeus Ylioppilastutkinnon opiskeluoikeus	Lista henkilön opiskeluoikeuksista. Sisältää vain ne opiskeluoikeudet, joihin käyttäjällä on oikeudet. Esimerkiksi ammatilliselle toimijalle ei välttämättä näy henkilön lukio-opintojen tietoja.

Oppija > Henkilötiedot ja henkilö-OID

Henkilötiedot. Syötettäessä vaaditaan joko oppijanumero oid tai kaikki muut kentät, jolloin järjestelmään voidaan tarvittaessa luoda uusi henkilö.

Nimi	Lukumäärä	Tyyppi	Kuvaus
oid	1	merkkijono Oksa: oppijanumero	Oppijanumero 'oid' on oppijan yksilöivä tunniste Opintopolku-palvelussa ja Koskessa.
hetu	0..1	merkkijono	Suomalainen henkilötunnus.
etunimet	1	merkkijono	Henkilön kaikki etunimet. Esimerkiksi Sanna Katariina.
kutsumanimi	1	merkkijono	Kutsumanimi, oltava yksi etunimistä. Esimerkiksi etunimille "Juha-Matti Petteri" kelpaavat joko "Juha-Matti", "Juha", "Matti" tai "Petteri".
sukunimi	1	merkkijono	Henkilön sukunimi. Henkilön sukunimen etuliite tulee osana sukunimeä.

Oppija > Henkilö-OID

Henkilötiedot. Syötettäessä vaaditaan joko oppijanumero oid tai kaikki muut kentät, jolloin järjestelmään voidaan tarvittaessa luoda uusi henkilö.

Henkilö, jonka oppijanumero 'oid' on tiedossa. Tietoja syötettäessä henkilö haetaan henkilöpalvelusta.

Nimi	Lukumäärä	Tyyppi	Kuvaus
oid	1	merkkijono Oksa: oppijanumero	Oppijanumero 'oid' on oppijan yksilöivä tunniste Opintopolku-palvelussa ja Koskessa.

Oppija > Täydelliset henkilötiedot

Henkilötiedot. Syötettäessä vaaditaan joko oppijanumero oid tai kaikki muut kentät, jolloin järjestelmään voidaan tarvittaessa luoda uusi henkilö.

Täydet henkilötiedot. Tietoja haettaessa Koskesta saadaan aina täydet henkilötiedot.

Nimi	Lukumäärä	Tyyppi	Kuvaus
oid	1	merkkijono Oksa: oppijanumero	Oppijanumero 'oid' on oppijan yksilöivä tunniste Opintopolku-palvelussa ja Koskessa.
hetu	0..1	merkkijono	Suomalainen henkilötunnus.
syntymäaika	0..1	päivämäärä	Henkilön syntymäaika. Muoto YYYY-MM-DD.
etunimet	1	merkkijono	Henkilön kaikki etunimet. Esimerkiksi Sanna Katariina.
kutsumanimi	1	merkkijono	Kutsumanimi, oltava yksi etunimistä. Esimerkiksi etunimille "Juha-Matti Petteri" kelpaavat joko "Juha-Matti", "Juha", "Matti" tai "Petteri".
sukunimi	1	merkkijono	Henkilön sukunimi. Henkilön sukunimen etuliite tulee osana sukunimeä.
äidinkieli	0..1	Koodistokoodiviite Koodisto: kieli	Opiskelijan äidinkieli (vrkn mukainen äidinkieli).
kansalaisuus	0..n	Koodistokoodiviite Koodisto: maatjavaltiot2	Opiskelijan kansalaisuudet.
turvakielto	0..1	true/false	Henkilöllä on turvakielto.

Oppija > Uusi henkilö

Henkilötiedot. Syötettäessä vaaditaan joko oppijanumero oid tai kaikki muut kentät, jolloin järjestelmään voidaan tarvittaessa luoda uusi henkilö.

Henkilö, jonka oppijanumero 'oid' ei ole tiedossa. Tietoja syötettäessä luodaan mahdollisesti uusi henkilö Henkilöpalveluun, jolloin henkilölle muodostuu oppijanumero.

Nimi	Lukumäärä	Tyyppi
hetu	1	merkkijono
etunimet	1	merkkijono
kutsumanimi	0..1	merkkijono
sukunimi	1	merkkijono

Oppija > Ylioppilastutkinnon opiskeluoikeus

Nimi	Lukumäärä	Tyyppi	Kuvaus
oid	0..1	merkkijono	Opiskeluoikeuden yksilöivä tunniste, joka generoidaan Koski-järjestelmässä. Tietoja syötettäessä kenttä ei ole pakollinen. Tietoja päivitettäessä Koski tunnistaa opiskeluoikeuden joko tämän oid:n tai muiden kenttien (oppijaOid, organisaatio, opiskeluoikeuden tyyppi, paikallinen id) perusteella.
versionumero	0..1	numero	Versionumero, joka generoidaan Koski-järjestelmässä. Tietoja syötettäessä kenttä ei ole pakollinen. Ensimmäinen tallennettu versio saa versionumeron 1, jonka jälkeen jokainen päivitys aiheuttaa versionumeron noston yhdellä. Jos tietoja päivitettäessä käytetään versionumeroa, pitää sen täsmätä viimeisimpään tallennettuun versioon. Tällä menettelyllä esimerkiksi käyttöliittymässä varmistetaan, ettei tehdä päivityksiä vanhentuneeseen dataan.
lähdejärjestelmänId	0..1	Lähdejärjestelmä-ID	Lähdejärjestelmän tunniste ja opiskeluoikeuden tunniste lähdejärjestelmässä. Käytetään silloin, kun opiskeluoikeus on tuotu Koskeen tiedonsiirrolla ulkoisesta järjestelmästä, eli käytännössä opintohallintojärjestelmästä.
oppilaitos	0..1	Oppilaitos	Oppilaitos, jossa opinnot on suoritettu. Opintopolun organisaatiopalvelusta löytyvä oppilaitos-tyyppinen organisaatio.
koulutustoimija	0..1	Koulutustoimija	Opintopolun organisaatiopalvelusta löytyvä koulutustoimija-tyyppinen, oppilaitoksen ylätasolla oleva organisaatio. Tiedon syötössä tietoa ei tarvita; organisaation tiedot haetaan Organisaatiopalvelusta.
tila	1	Ylioppilastutkinnon opiskeluoikeuden tila	Opiskeluoikeuden tila, joka muodostuu opiskeluoikeusjaksoista. Toistaiseksi vain Kosken sisäisessä käytössä. Sisältö on aina tyhjä lista opiskeluoikeusjaksoja. Kenttä näkyy tietomallissa vain teknisistä syistä.
suoritukset	1	Ylioppilastutkinnon suoritus	Opiskeluoikeuteen liittyvien tutkinto- ja muiden suoritusten tiedot.
tyyppi	1	Koodistokoodiviite Hyväksytty koodiarvo: ylioppilastutkinto Oksa: koulutusmuoto (1) Koodisto: opiskeluoikeudentyyppi	Opiskeluoikeuden tyyppi, jolla erotellaan eri koulutusmuotoihin (perusopetus, lukio, ammatillinen...) liittyvät opiskeluoikeudet.
aikaleima	0..1	päivämäärä	Aikaleima muodostetaan Koski-palvelimella tallennettaessa.
oppilaitosSuorituspäivänä	0..1	Oppilaitos	Toistaiseksi vain Kosken sisäisessä käytössä. Organisaatiopalvelun oppilaitos-OID-tunniste, jossa ylioppilastutkinto on suoritettu. Ei välttämättä ole oppilaitos, jossa henkilöllä on opintooikeus. Opintopolun organisaatiopalvelusta löytyvä oppilaitos-tyyppinen organisaatio.
lisätiedot	0..1	Ylioppilastutkinnon opiskeluoikeuden lisätiedot	Toistaiseksi vain Kosken sisäisessä käytössä.
alkamispäivä	0..1	päivämäärä	Yksikäsitteistä alkamispäivää ei ole, joten alkamispäivä puuttuu aina. Muoto YYYY-MM-DD. Tiedon syötössä tietoa ei tarvita; tieto poimitaan tila-kentän ensimmäisestä opiskeluoikeusjaksosta.
päättymispäivä	0..1	päivämäärä	Toistaiseksi vain Kosken sisäisessä käytössä. Päättymispäiväksi päätellään mahdollinen valmistumispäivä. Samassa opiskeluoikeudessa voi silti olla sitä myöhempien tutkintokertojen YO-kokeen suorituksia, esim. korotuksia. Muoto YYYY-MM-DD. Tiedon syötössä tietoa ei tarvita; tieto poimitaan tila-kentän viimeisestä opiskeluoikeusjaksosta.

Oppija > Ylioppilastutkinnon opiskeluoikeus > Lähdejärjestelmä-ID

Lähdejärjestelmän tunniste ja opiskeluoikeuden tunniste lähdejärjestelmässä. Käytetään silloin, kun opiskeluoikeus on tuotu Koskeen tiedonsiirrolla ulkoisesta järjestelmästä, eli käytännössä opintohallintojärjestelmästä.

Nimi	Lukumäärä	Tyyppi	Kuvaus
id	0..1	merkkijono	Opiskeluoikeuden paikallinen uniikki tunniste lähdejärjestelmässä. Tiedonsiirroissa tarpeellinen, jotta voidaan varmistaa päivitysten osuminen oikeaan opiskeluoikeuteen.
lähdejärjestelmä	1	Koodistokoodiviite Koodisto: lahdejarjestelma	Lähdejärjestelmän yksilöivä tunniste. Tällä tunnistetaan sen järjestelmän tyyppi, josta tiedot on tuotu Koskeen. Yksittäisillä lähdejärjestelmäinstansseilla ei tarvitse olla omaa tunnistetta; tässä identifioidaan vain lähdejärjestelmän tyyppi (esimerkiksi primus, peppi, winha...).

Oppija > Ylioppilastutkinnon opiskeluoikeus > Ylioppilastutkinnon opiskeluoikeuden tila

Nimi	Lukumäärä	Tyyppi	Kuvaus
opiskeluoikeusjaksot	0..n	Ylioppilastutkinnon opiskeluoikeusjakso	Toistaiseksi vain Kosken sisäisessä käytössä. Sisältö on tyhjä lista ellei tutkinto ole valmistunut. Streamaus-API:n osalta lista on aina tyhjä. Opiskeluoikeuden tilahistoria (Läsnä, Eronnut, Valmistunut...) jaksoittain.

Oppija > Ylioppilastutkinnon opiskeluoikeus > Ylioppilastutkinnon opiskeluoikeuden tila > Ylioppilastutkinnon opiskeluoikeusjakso

Opiskeluoikeuden tilahistoria (Läsnä, Eronnut, Valmistunut...) jaksoittain.

Nimi	Lukumäärä	Tyyppi	Kuvaus
alku	1	päivämäärä	Jakson alkamispäivämäärä. Muoto YYYY-MM-DD.
tila	1	Koodistokoodiviite Hyväksytty koodiarvo: valmistunut Koodisto: koskiopiskeluoikeudentila	Opiskeluoikeuden tila (Läsnä, Eronnut, Valmistunut...) jaksottain.

Oppija > Ylioppilastutkinnon opiskeluoikeus > Ylioppilastutkinnon suoritus

Nimi	Lukumäärä	Tyyppi	Kuvaus
koulutusmoduuli	1	Ylioppilastutkinto	Ylioppilastutkinnon tunnistetiedot.
toimipiste	1	Koulutustoimija Organisaatio-OID Oppilaitos Toimipiste Oksa: koulutusorganisaation toimipiste	Oppilaitoksen toimipiste, jossa opinnot on suoritettu. Jos oppilaitoksella ei ole toimipisteitä, syötetään tähän oppilaitoksen tiedot.
vahvistus	0..1	Organisaatiovahvistus	Suorituksen virallinen vahvistus (päivämäärä, henkilöt). Suorituksen vahvistus organisaatiotiedoilla.
pakollisetKokeetSuoritettu	1	true/false
osasuoritukset	0..n	Ylioppilastutkinnon kokeen suoritus	Ylioppilastutkinnon kokeiden suoritukset.
tyyppi	1	Koodistokoodiviite Hyväksytty koodiarvo: ylioppilastutkinto Koodisto: suorituksentyyppi	Suorituksen tyyppi, jolla erotellaan eri koulutusmuotoihin (perusopetus, lukio, ammatillinen...) ja eri tasoihin (tutkinto, tutkinnon osa, kurssi, oppiaine...) liittyvät suoritukset.
koulusivistyskieli	0..n	Koodistokoodiviite Koodisto: kieli Hyväksytty koodiarvo: FI Hyväksytty koodiarvo: SV	Koulusivistyskieli. Tiedon syötössä tietoa ei tarvita; tieto poimitaan osasuorituksista. Koulusivistyskieli päätellään automaattisesti suorituksista.
tila Vanhentunut kenttä	0..1	Koodistokoodiviite Koodisto: suorituksentila	Ei käytössä. Suorituksen tila, ei käytössä. Vanhentunut kenttä: Ei käytössä.

Oppija > Ylioppilastutkinnon opiskeluoikeus > Ylioppilastutkinnon suoritus > Ylioppilastutkinto

Ylioppilastutkinnon tunnistetiedot.

Nimi	Lukumäärä	Tyyppi	Kuvaus
tunniste	1	Koodistokoodiviite Hyväksytty koodiarvo: 301000 Koodisto: koulutus Oksa: tutkinto	Tutkinnon 6-numeroinen tutkintokoodi. Sama kuin tilastokeskuksen koulutuskoodi.
koulutustyyppi	0..1	Koodistokoodiviite Koodisto: koulutustyyppi	Koulutustyypin koodia ei tarvita syöttövaiheessa; Koski päättelee sen automaattisesti. Koski päättelee koulutustyypin automaattisesti koulutuskoodin perusteella.

Oppija > Ylioppilastutkinnon opiskeluoikeus > Ylioppilastutkinnon suoritus > Organisaatiovahvistus

Suorituksen vahvistus organisaatiotiedoilla.

Nimi	Lukumäärä	Tyyppi	Kuvaus
päivä	1	päivämäärä	Tutkinnon tai tutkinnon osan vahvistettu suorituspäivämäärä, eli päivämäärä jolloin suoritus on hyväksyttyä todennettua osaamista. Muoto YYYY-MM-DD.
paikkakunta	1	Koodistokoodiviite Koodisto: kunta	Paikkakunta, jossa suoritus on vahvistettu (allekirjoituksen paikkakunta).
myöntäjäOrganisaatio	1	Koulutustoimija Organisaatio-OID Oppilaitos Toimipiste Tutkintotoimikunta Yritys	Organisaatio, joka on vahvistanut suorituksen.

Oppija > Ylioppilastutkinnon opiskeluoikeus > Ylioppilastutkinnon suoritus > Organisaatiovahvistus > Tutkintotoimikunta

Tutkintotoimikunta.

Nimi	Lukumäärä	Tyyppi	Kuvaus
nimi	1	Englanniksi Suomeksi Ruotsiksi	Lokalisoitu teksti. Vähintään yksi kielistä (fi/sv/en) vaaditaan.
tutkintotoimikunnanNumero	1	merkkijono	Tutkintotoimikunnan numero.

Oppija > Ylioppilastutkinnon opiskeluoikeus > Ylioppilastutkinnon suoritus > Organisaatiovahvistus > Yritys

Yritys, jolla on y-tunnus.

Nimi	Lukumäärä	Tyyppi	Kuvaus
nimi	1	Englanniksi Suomeksi Ruotsiksi	Yrityksen nimi. Lokalisoitu teksti. Vähintään yksi kielistä (fi/sv/en) vaaditaan.
yTunnus	1	merkkijono	Yrityksen Y-tunnus.

Oppija > Ylioppilastutkinnon opiskeluoikeus > Ylioppilastutkinnon suoritus > Ylioppilastutkinnon kokeen suoritus

Nimi	Lukumäärä	Tyyppi	Kuvaus
koulutusmoduuli	1	Ylioppilas tutkinnon koe	Ylioppilastutkinnon kokeen tunnistetiedot.
tutkintokerta	1	Ylioppilastutkinnon tutkintokerta
arviointi	0..n	Ylioppilaskokeen arviointi	Arviointi. Jos listalla useampi arviointi, tulkitaan myöhemmät arvioinnit arvosanan korotuksiksi edellisiin samalla listalla oleviin arviointeihin. Jos aiempaa, esimerkiksi väärin kirjattua, arviota korjataan, ei listalle tule uutta arviota.
tyyppi	1	Koodistokoodiviite Hyväksytty koodiarvo: ylioppilastutkinnonkoe Koodisto: suorituksentyyppi	Suorituksen tyyppi, jolla erotellaan eri koulutusmuotoihin (perusopetus, lukio, ammatillinen...) ja eri tasoihin (tutkinto, tutkinnon osa, kurssi, oppiaine...) liittyvät suoritukset.
tutkintokokonaisuudenTunniste	0..1	numero	Toistaiseksi vain Kosken sisäisessä käytössä. Viittaa päätason lisätiedoissa määriteltyyn listaan tutkintokokonaisuuksia.
keskeytynyt	0..1	true/false	Toistaiseksi vain Kosken sisäisessä käytössä. Kertoo, onko kyseessä ylioppilastutkinnosta annetun lain (502/2019) 14 § tai 15 § mukaisesti keskeytetty koe.
maksuton	0..1	true/false	Toistaiseksi vain Kosken sisäisessä käytössä. Kertoo, onko kyseessä ylioppilastutkinnosta annetun lain (502/2019) 20 § mukaisesti koe, johon osallistumisesta ei peritä maksua.
tila Vanhentunut kenttä	0..1	Koodistokoodiviite Koodisto: suorituksentila	Ei käytössä. Suorituksen tila, ei käytössä. Vanhentunut kenttä: Ei käytössä.

Oppija > Ylioppilastutkinnon opiskeluoikeus > Ylioppilastutkinnon suoritus > Ylioppilastutkinnon kokeen suoritus > Ylioppilaskokeen arviointi

Nimi	Lukumäärä	Tyyppi	Kuvaus
arvosana	1	Koodistokoodiviite Koodisto: koskiyoarvosanat	Arvosana. Kullekin arviointiasteikolle löytyy oma koodistonsa.
pisteet	0..1	numero
hyväksytty	0..1	true/false	Onko arviointi hyväksytty. Tiedon syötössä arvoa ei tarvita, eikä syötettyä arvoa käsitellä; arvo päätellään arvosanasta.

Oppija > Ylioppilastutkinnon opiskeluoikeus > Ylioppilastutkinnon opiskeluoikeuden lisätiedot

Nimi	Lukumäärä	Tyyppi	Kuvaus
tutkintokokonaisuudet	0..n	Ylioppilastutkinnon tutkintokokonaisuuden lisätiedot	Toistaiseksi vain Kosken sisäisessä käytössä.

Oppija > Ylioppilastutkinnon opiskeluoikeus > Ylioppilastutkinnon opiskeluoikeuden lisätiedot > Ylioppilastutkinnon tutkintokokonaisuuden lisätiedot

Nimi	Lukumäärä	Tyyppi	Kuvaus
tunniste	1	numero	Keinotekoinen tutkintokokonaisuuden tunniste johon viitataan YlioppilastutkinnonKokeenSuoritus-luokasta.
tyyppi	0..1	Koodistokoodiviite Koodisto: ytrtutkintokokonaisuudentyyppi
tila	0..1	Koodistokoodiviite Koodisto: ytrtutkintokokonaisuudentila
suorituskieli	0..1	Koodistokoodiviite Koodisto: kieli
tutkintokerrat	0..n	Ylioppilastutkinnon tutkintokerran lisätiedot
aiemminSuoritetutKokeet	0..n	Ylioppilastutkinnon sisältyvä koe	Tiedot aiemmin suoritetusta kokeesta, joka on sisällytetty uuteen ylioppilastutkintoon.

Oppija > Ylioppilastutkinnon opiskeluoikeus > Ylioppilastutkinnon opiskeluoikeuden lisätiedot > Ylioppilastutkinnon tutkintokokonaisuuden lisätiedot > Ylioppilastutkinnon tutkintokerran lisätiedot

Nimi	Lukumäärä	Tyyppi	Kuvaus
tutkintokerta	1	Ylioppilastutkinnon tutkintokerta
koulutustausta	0..1	Koodistokoodiviite Koodisto: ytrkoulutustausta	Toistaiseksi vain Kosken sisäisessä käytössä. YTL:lle ilmoitettu henkilön koulutustausta, jonka perusteella hän osallistuu tutkintoon kyseisellä tutkintokerralla.
oppilaitos	0..1	Oppilaitos	Toistaiseksi vain Kosken sisäisessä käytössä. Organisaatiopalvelusta saatu oppilaitos, johon kokelas on ilmoittautunut. Ei välttämättä ole oppilaitos, jossa henkilöllä on opinto-oikeus. Opintopolun organisaatiopalvelusta löytyvä oppilaitos-tyyppinen organisaatio.

Oppija > Ylioppilastutkinnon opiskeluoikeus > Ylioppilastutkinnon opiskeluoikeuden lisätiedot > Ylioppilastutkinnon tutkintokokonaisuuden lisätiedot > Ylioppilastutkinnon sisältyvä koe

Tiedot aiemmin suoritetusta kokeesta, joka on sisällytetty uuteen ylioppilastutkintoon.

Nimi	Lukumäärä	Tyyppi	Kuvaus
koulutusmoduuli	1	Ylioppilas tutkinnon koe	Ylioppilastutkinnon kokeen tunnistetiedot.
tutkintokerta	1	Ylioppilastutkinnon tutkintokerta

Englanniksi

Lokalisoitu teksti. Vähintään yksi kielistä (fi/sv/en) vaaditaan.

Lokalisoitu teksti, jossa mukana englanti.

Nimi	Lukumäärä	Tyyppi	Kuvaus
en	1	merkkijono

Suomeksi

Lokalisoitu teksti. Vähintään yksi kielistä (fi/sv/en) vaaditaan.

Lokalisoitu teksti, jossa mukana suomi.

Nimi	Lukumäärä	Tyyppi
fi	1	merkkijono
sv	0..1	merkkijono
en	0..1	merkkijono

Ruotsiksi

Lokalisoitu teksti. Vähintään yksi kielistä (fi/sv/en) vaaditaan.

Lokalisoitu teksti, jossa mukana ruotsi.

Nimi	Lukumäärä	Tyyppi	Kuvaus
sv	1	merkkijono
en	0..1	merkkijono

Koodistokoodiviite

Nimi	Lukumäärä	Tyyppi	Kuvaus
koodiarvo	1	merkkijono	Koodin tunniste koodistossa.
nimi	0..1	Englanniksi Suomeksi Ruotsiksi	Tiedon syötössä kuvausta ei tarvita; kuvaus haetaan Koodistopalvelusta. Koodin selväkielinen, kielistetty nimi. Lokalisoitu teksti. Vähintään yksi kielistä (fi/sv/en) vaaditaan.
lyhytNimi	0..1	Englanniksi Suomeksi Ruotsiksi	Tiedon syötössä kuvausta ei tarvita; kuvaus haetaan Koodistopalvelusta. Koodin selväkielinen, kielistetty lyhennetty nimi. Lokalisoitu teksti. Vähintään yksi kielistä (fi/sv/en) vaaditaan.
koodistoUri	1	merkkijono	Käytetyn koodiston tunniste.
koodistoVersio	0..1	numero	Käytetyn koodiston versio. Jos versiota ei määritellä, käytetään uusinta versiota.

Koulutustoimija

Opintopolun organisaatiopalvelusta löytyvä koulutustoimija-tyyppinen, oppilaitoksen ylätasolla oleva organisaatio. Tiedon syötössä tietoa ei tarvita; organisaation tiedot haetaan Organisaatiopalvelusta.

Nimi	Lukumäärä	Tyyppi	Kuvaus
oid	1	merkkijono	Organisaation tunniste Opintopolku-palvelussa. Oid numero, joka on kaikilla organisaatiotasoilla: toimipisteen oid, koulun oid, koulutuksen järjestäjän oid.
nimi	0..1	Englanniksi Suomeksi Ruotsiksi	Tiedon syötössä nimeä ei tarvita; kuvaus haetaan Organisaatiopalvelusta. Organisaation (kielistetty) nimi. Lokalisoitu teksti. Vähintään yksi kielistä (fi/sv/en) vaaditaan.
yTunnus	0..1	merkkijono	Koulutustoimijan Y-tunnus.
kotipaikka	0..1	Koodistokoodiviite Koodisto: kunta	Koulutustoimijan kotipaikka.

Oppilaitos

Opintopolun organisaatiopalvelusta löytyvä oppilaitos-tyyppinen organisaatio.

Nimi	Lukumäärä	Tyyppi	Kuvaus
oid	1	merkkijono	Organisaation tunniste Opintopolku-palvelussa. Oid numero, joka on kaikilla organisaatiotasoilla: toimipisteen oid, koulun oid, koulutuksen järjestäjän oid.
oppilaitosnumero	0..1	Koodistokoodiviite Koodisto: oppilaitosnumero	Tiedon syötössä oppilaitosnumeroa ei tarvita; numero haetaan Organisaatiopalvelusta. 5-numeroinen oppilaitosnumero, esimerkiksi 00001.
nimi	0..1	Englanniksi Suomeksi Ruotsiksi	Tiedon syötössä nimeä ei tarvita; kuvaus haetaan Organisaatiopalvelusta. Organisaation (kielistetty) nimi. Lokalisoitu teksti. Vähintään yksi kielistä (fi/sv/en) vaaditaan.
kotipaikka	0..1	Koodistokoodiviite Koodisto: kunta	Oppilaitoksen kotipaikka.

Organisaatio-OID

Opintopolun organisaatiopalvelusta löytyvä organisaatio, jonka OID-tunniste on tiedossa.

Nimi	Lukumäärä	Tyyppi	Kuvaus
oid	1	merkkijono	Organisaation tunniste Opintopolku-palvelussa. Oid numero, joka on kaikilla organisaatiotasoilla: toimipisteen oid, koulun oid, koulutuksen järjestäjän oid.
nimi	0..1	Englanniksi Suomeksi Ruotsiksi	Tiedon syötössä nimeä ei tarvita; kuvaus haetaan Organisaatiopalvelusta. Organisaation (kielistetty) nimi. Lokalisoitu teksti. Vähintään yksi kielistä (fi/sv/en) vaaditaan.
kotipaikka	0..1	Koodistokoodiviite Koodisto: kunta	Organisaation kotipaikka.

Toimipiste

Opintopolun organisaatiopalvelusta löytyvä toimipiste-tyyppinen organisaatio.

Nimi	Lukumäärä	Tyyppi	Kuvaus
oid	1	merkkijono	Organisaation tunniste Opintopolku-palvelussa. Oid numero, joka on kaikilla organisaatiotasoilla: toimipisteen oid, koulun oid, koulutuksen järjestäjän oid.
nimi	0..1	Englanniksi Suomeksi Ruotsiksi	Tiedon syötössä nimeä ei tarvita; kuvaus haetaan Organisaatiopalvelusta. Organisaation (kielistetty) nimi. Lokalisoitu teksti. Vähintään yksi kielistä (fi/sv/en) vaaditaan.
kotipaikka	0..1	Koodistokoodiviite Koodisto: kunta	Toimipisteen kotipaikka.

Ylioppilastutkinnon tutkintokerta

Nimi	Lukumäärä	Tyyppi	Kuvaus
koodiarvo	1	merkkijono
vuosi	1	numero
vuodenaika	1	Englanniksi Suomeksi Ruotsiksi	Lokalisoitu teksti. Vähintään yksi kielistä (fi/sv/en) vaaditaan.

Ylioppilas tutkinnon koe

Ylioppilastutkinnon kokeen tunnistetiedot.

Nimi	Lukumäärä	Tyyppi	Kuvaus
tunniste	1	Koodistokoodiviite Koodisto: koskiyokokeet