Saavutettavuusseloste – API-portaali

Verohallinto pyrkii takaamaan verkkosivustojensa ja asiointipalvelunsa saavutettavuuden Lain digitaalisten palvelujen tarjoamisesta 306/2019 mukaisesti.

Tämä saavutettavuusseloste koskee API-portaalia. Seloste on päivitetty 18.1.2023. Palvelun saavutettavuutta on arvioitu kolmannen osapuolen toimesta ja itsearviointina Verohallinnon toimesta.

Palvelun saavutettavuuden tila

API-portaali täyttää Lain digitaalisten palvelujen tarjoamisesta 306/2019 vaatimukset osittain. 

Palvelun ei-saavutettava sisältö (WCAG 2.1 tasojen A & AA kriteerien mukaan)

Seuraava sisältö ja/tai toiminnot eivät ole vielä vaatimusten mukaisia:

  1. API-portaalista saatavien PDF-dokumenttien sisältöjen lukujärjestys ei ole ruudunlukijakäyttäjille looginen ja voi aiheuttaa hankaluuksia sisällön ymmärtämisessä. Puutteet pyritään korjaamaan lähitulevaisuudessa. Tarvittaessa voit olla yhteydessä asiakaspalveluun, jos sisällön lukeminen aiheuttaa haasteita. (WCAG-ohjeistuksen kriteeri 1.3.2)
  2. API-portaalissa on puutteellinen otsikkohierarkia, ja kaikkia visuaalisia otsikoita ei ole merkitty otsikoiksi ohjelmallisesti. Palvelussa käytetään lähinnä otsikkotasoja H1 ja H3. Puutteellinen otsikkohierarkia toistuu myös PDF-dokumenteissa, esimerkiksi joitain otsikkotasoja puuttuu kokonaan ja osa otsikoista on merkitty H2-tasoksi. (WCAG-ohjeistuksen kriteeri 1.3.1 ja 2.4.6)
  3. Ruudunlukija ei kerro sivun latausindikaattorin tilaa. (WCAG-ohjeistukset kriteeri 4.1.3)
  4. Modaali-ikkunoiden responsiivisuudessa on vielä korjattavaa: Näyttöä zoomatessa sisältöalue voi jäädä kohtuuttoman pieneksi. (WCAG-ohjeistuksen kriteeri 1.4.10)
  5. Näppäimistöselausta käyttämällä sivun kohdistus saattaa hypätä sivun ylälaitaan esimerkiksi, kun taulukoista poistaa rivin. Kohdistus ei myöskään aina siirry sivun alkuun, kun siirrytään sivulta toiselle. (WCAG-ohjeistuksen kriteeri 3.2.2 ja 2.4.3).
  6. Näppäimistökäytössä kohdistusjärjestykseen voi sisältyä kohtia, jotka eivät ole interaktiivisia. (WCAG-ohjeistuksen kriteeri 2.4.3)
  7. Apulinkkien kautta avautuvien ikkunoiden sisältö ei ole mukana sivun kohdistusjärjestyksessä. Tämä tarkoittaa sitä, että ikkunoiden sisällössä olevat linkit tai Sulje-painike eivät ole käytettävissä näppäimistöllä. (WCAG-ohjeistuksen kriteeri 2.1.1 ja 2.4.3)
  8. Ruudunlukija ei automaattisesti lue tilasta kertovia vahvistusviestejä, jotka tulevat visuaalisesti näkyviin, kun esimerkiksi ilmoitus on lähetetty. Ruudunlukija ei myöskään kaikilla ilmoituksilla lue automaattisesti virheviestejä tai ohjeita, jotka visuaalisesti tulevat näkyviin, jos on syöttänyt väärän tiedon kenttään. (WCAG-ohjeistuksen kriteeri 4.1.3)
  9. API-portalalissa on muutamissa kohdissa linkkejä ja painikkeita, joiden ohjelmallinen ja visuaalinen esitystapa eivät vastaa toisiaan. (WCAG-ohjeistuksen kriteeri 4.1.2)
  10. Osaa API-portaalin toiminnoista ei ole nimetty ohjelmallisesti riittävän kattavasti, jolloin esimerkiksi ruudunlukijakäyttäjän voi olla haastava tietää, mihin asiaan toiminto liittyy (esimerkiksi "Passivoi" ja "Aktivoi"). (WCAG-ohjeistuksen kriteeri 1.3.1)
  11. API-portaalin käyttöliittymässä käytetään muutamassa osiossa taulukkorakennetta ulkoasun toteutuksessa ja tämä vaikeuttaa merkityksen ymmärrettävyyttä ruudunlukijakäytössä. (WCAG-ohjeistuksen kriteeri 1.3.1)
  12. Joitain tietoja ei ole riittävästi ryhmitelty ohjelmallisesti. (WCAG-ohjeistuksen kriteeri 1.3.1 ja 3.3.2)
  13. Ruudunlukijakäyttäjille voi ilmetä joitain synkronointiongelmia, jos he ensiksi lukevat sivun ja sen jälkeen navigoivat interaktiiviseen elementtiin. Sivun kohdistus ei välttämättä toimi oikein, ja kohdistus siirtyy väärään kohtaan, kun ruudunlukijan (NVDA) vaihtaa selaustilasta kohdistustilaan. (WCAG-ohjeistuksen kriteeri 2.4.3)
  14. API-portaalissa on joitakin kohtia, joissa välistetty teksti ei asetu kokonaan näkyville. (WCAG-ohjeistuksen kriteeri 1.4.12)
  15. Ruudunlukijalla ei ole mahdollista lukea osaa ohjesisällöistä johtuen ongelmasta niiden ohjelmallisesti selvitettävässä lukemisjärjestyksessä. (WCAG-ohjeistuksen kriteeri 1.3.2)
  16. Joillakin käyttäjän kannalta epäolennaisilla visuaalisilla elementeillä on tarpeettomat tekstivastineet. (WCAG-ohjeistuksen kriteeri 1.1.1)

API-portaalin nykyisten saavutettavuuspuutteiden korjauksia tehdään vuoden 2023 aikana. 

Palaute ja yhteystiedot

Huomasitko saavutettavuuspuutteen? Ilmoita siitä meille! Voit ottaa yhteyttä tämän verkkolomakkeen kautta.

API-portaalin saavutettavuudesta ja palautteiden käsittelystä vastaa Vero API -tiimi.

Täytäntöönpanomenettely

Jos huomaat sivustolla saavutettavuusongelmia, anna ensin palautetta sivuston ylläpitäjälle. Lain ja siirtymäajan puitteissa Verohallinto pyrkii siihen, että palautteisiin vastataan kahden viikon sisällä palautteen antamisesta.

Jos et ole tyytyväinen saamaasi vastaukseen, voit antaa palautteen Etelä-Suomen aluehallintovirastoon. Etelä-Suomen aluehallintoviraston saavutettavuusvaatimukset.fi-sivustolla kerrotaan, miten valituksen voi tehdä ja miten asia käsitellään.

Valvontaviranomaisen yhteystiedot

Etelä-Suomen aluehallintovirasto, Saavutettavuuden valvonnan yksikkö

Sivu on viimeksi päivitetty 17.1.2023