1. Ei oikeutta organisaatioon

• KOSKI-palveluun yritetään viedä opiskeluoikeutta organisaatioon johon siirroissa käytettävällä tunnuksella ei ole oikeutta
• KOSKI-palvelussa on käyttökatko
• 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
  • KOSKI-palvelun suunnitelluista käyttökatkoista tiedotetaan etukäteen, ennakoimista käyttökatkoista lähetetään häiriötiedote. Käyttökatkot on listattu sivulle: KOSKI katko- ja vikailmoitukset
    Kun käyttökatko on ohi, tiedonsiirrot onnistuvat normaalista.

2. Sisäänkirjautuminen epäonnistui ("unauthorized.notAuthenticated", "unauthorized.loginFail")

• KOSKI-palvelukäyttäjätunnus tai salasana on väärin opintohallintojärjestelmässä:

  401 unauthorized.loginFail, message: "Sisäänkirjautuminen epäonnistui, väärä käyttäjätunnus tai salasana."
       

• • Korjaus: Tallennetaan opintohallintojärjestelmään oikea integraatiotunnus ja -salasana.
    
    
• KOSKI-palvelukäyttäjätunnus on syötetty väärään kohtaan opintohallintojärjestelmässä:

  401 unauthorized.loginFail, message: "Sisäänkirjautuminen epäonnistui, väärä käyttäjätunnus tai salasana."

• • Korjaus: Tallennetaan integraatiotunnus oikeaan paikkaan.
    
    
• KOSKI-palvelukäyttäjätunnus on vanhentunut:

  401 unauthorized.loginFail, message: "Sisäänkirjautuminen epäonnistui, väärä käyttäjätunnus tai salasana."

• • Korjaus: Opintohallintojärjestelmään asetettava tunnus on vanhentunut. Vanhentunut KOSKI-palvelukäyttäjätunnus on mennyt lukkoon liian monen automaattisen kirjautumisyrityksen seurauksena. Vanhentunutta tunnusta ei voida enää uusia,
    vaan koulutustoimijan vastuukäyttäjän on luotava uusi KOSKI-palvelukäyttäjätunnus virkailijan opintopolussa.
    Ohjeet tunnuksen luontiin löytyvät: KOSKI-palveluun liittyvä käyttäjähallinta kohdasta "2. Myönnettävät roolit ja niiden kuvaukset, a) KOSKI-palvelukäyttäjä".
    Palvelukäyttäjätunnuksen luonnin jälkeen uusi tunnus ja salasana asetetaan opintohallintojärjestelmään niille varattuihin kenttiin ja tehdään siirto uudestaan.

3. 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

4. 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 opiskeluoikeuden 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 oppilaalla ei ole pidennettyä oppivelvollsuutta, ei tule välittää lainkaan rakennetta "pidennettyOppivelvollisuus",

• 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).