Tyypillisiä virheitä KOSKI-tiedonsiirroissa

1. Ei oikeutta organisaatioon

• KOSKI-palveluun yritetään viedä opiskeluoikeutta organisaatioon johon siirroissa käytettävällä tunnuksella ei ole oikeutta
• Esimerkki: 

Ei oikeuksia organisaatioon 1.2.246.562.10.87603128528

• • Korjaus: Mikäli tiedonsiirto-oikeudet tulisi olla organisaatioon, ottakaa yhteys KOSKI-palveluosoitteeseen: koski(at)opintopolku.fi

2. Virheellinen diaarinumeroviittaus perusteisiin tai puuttuu kokonaan

• Opiskeluoikeuden pääsuorituksen tasolla perusteen diaarinumero on pakollinen tieto kaikilla koulutusmuodoilla, joten diaarinumeron puuttuessa tai sen ollessa virheellinen, tulee virheilmoitus.
• Ammatillisen tutkinnon osan suorituksella diaarinumero ja tutkintotieto välitetään vain jos tutkinnon osa on toisesta tutkinnosta, joten jos tutkinnon osan tiedoissa tulee sama diaarinumero kuin päätason suorituksella, tulee virheilmoitus.
• Esimerkki, väärä diaarinumero: 

Tutkinnon perustetta ei löydy diaarinumerolla 11/011/2016

• • Korjaus: Varmistetaan että diaarinumero on oikein. Mikäli numero on mielestänne oikein ja saatte edelleen virheviestin, ottakaa yhteys KOSKI-palveluosoiteeseen: koski(at)opintopolku.fi
• Esimerkki, tutkinnon osan tiedoissa tulee sama diaarinumero kuin päätason suorituksella : 

Tutkinnon osalle tutkinnonosat/100168 on merkitty tutkinto, jossa on sama tutkintokoodi koulutus/381304 kuin tutkinnon suorituksessa

• • Korjaus: Poistetaan tutkinnon osalta diaarinumero

3. Siirtotiedosto on rakenteellisesti virheellinen (esimerkiksi "viesti ei ole skeeman mukainen", "badRequest.validation.jsonSchema")

• Johtuu tilanteesta, jossa opintohallintojärjestelmän muodostama tiedonsiirtotiedosto on rakenteeltaan viallinen. Kyseessä voi olla esimerkiksi puuttuva pakollinen kenttä tai väärä koodiarvo.
• Esimerkki, väärä koodiarvo:

"message": [
      {
        "path": "opiskeluoikeudet.0.suoritukset.0.osasuoritukset.0.osasuoritukset.1.koulutusmoduuli.tunniste",
        "value": {
          "koodiarvo": "VEB31",
          "koodistoUri": "lukionkurssit"
        },
        "error": {
          "message": "Koodia lukionkurssit/VEB31 ei löydy koodistosta",
          "errorType": "tuntematonKoodi"
        }
      }
    ]

• • Korjaus: Tarkista oikea koodi tai koodistoUri
• Esimerkki (virhe perusopetuksen vuosiluokan tietojen siirrossa), puuttuva pakollinen kenttä:

"message": [
      {
        "path": "opiskeluoikeudet.0.suoritukset.0.osasuoritukset.0.koulutusmoduuli.kieli",
        "error": {
          "errorType": "missingProperty"
        }
      }
    ]

• • Korjaus: Mikäli perusopetuksen oppiaine on "äidinkieli ja kirjallisuus" tai "vieras tai toinen kotimainen kieli", lisätään tieto oppiaineessa opiskeltavasta kielestä

• Esimerkki (virhe perusopetuksen lisätiedoissa), välitetty rakenne "pidennettyOppivelvollisuus" ilman aloituspäivämäärää:

"message": [
      {
        "path": "opiskeluoikeudet.0.lisätiedot.pidennettyOppivelvollisuus.alku",
        "error": {
          "errorType": "missingProperty"

        }
      }
    ]

• • Korjaus: Lisätään pidennetyn oppivelvollisuuden aloituspäivä. Mikäli kyseessä ei ole oppilas jolla on pidennetty oppivelvollsuus, ei tule välittää lainkaan rakennetta "pidettettyOppivelvollisuus",

• Esimerkki, jokin osio sisältää kentän tai jonkun muun elementin, jota siellä ei pitäisi olla:

 "message": [
      {
        "path": "opiskeluoikeudet.0.pakollinen",
        "value": false,
        "error": {
          "errorType": "unexpectedProperty"
        }
      }
    ]

• • Korjaus: Poistetaan osioon kuulumaton kenttä tai muu elementti.

Joissain tilanteissa tilannetta ei pystytä korjaamaan oppilaitoksessa, olkaa tällöin yhteydessä opintohallintojärjestelmätoimittajaanne ja tarvittaessa KOSKI-palveluosoitteeseen (koski(at)opintopolku.fi).

4. Kirjautumisongelma ("unauthorized.notAuthenticated", "unauthorized.loginFail")

• Esimerkkki, integraatiotunnus tai salasana on väärin:

  401 unauthorized.loginFail, message: Sisäänkirjautuminen epäonnistui
       

• • Korjaus: Tallennetaan opintohallintojärjestelmään oikea integraatiotunnus ja -salasana.

• Esimerkkki, integraatiotunnus on syötetty väärään kohtaan:

  401 unauthorized.loginFail, message: Sisäänkirjautuminen epäonnistui 

• • Korjaus: Tallennetaan integraatiotunnus oikeaan paikkaan.