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 organisatioon 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: 
  

  "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

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

• 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": "Koodia lukionkurssit/VEB31 ei löydy koodistosta",
                  "errorType": "tuntematonKoodi"
               },
               "value": {
                  "koodiarvo": "VEB31",
               "koodistoUri": "lukionkurssit"

• • 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", on kieli-tieto pakollinen
• Esimerkki, KOSKI-palveluun välitetään ylimääräinen kenttä jollaista ei ole määritelty tiedonsiirron tietomallissa

Joissain tilanteissa tilannetta ei pystytä korjaamaan oppilaitoksessa, olkaa tällöin yhteydessä opintohallintojärjestelmätoimittajaanne ja tarvittaessa KOSKI-tukeen koski[a]opintopolku.fi Esimerkki (virhe perusopetuksen vuosiluokan tietojen siirrossa), puuttuva pakollinen kenttä :

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

• Iintegraatiotunnus tai salasana on väärin
  • esimerkki: 401 unauthorized.loginFail, message: Sisäänkirjautuminen epäonnistui)
    
• Integraatiotunnus on syötetty väärään kohtaan
  • esimerkki: Yhteysvirhe 401 Unauthorized unauthorized.notAuthenticated, message: Käyttäjä ei ole tunnistautunut.