Vero API -varmenne milloin tarvitaan ja miten uusitaan
Ohjeen tarkoituksena on kertoa, milloin ja miten Vero API -varmenteen korvaava hakemus tulee tehdä sekä mitä toimia se vaatii Maestrossa. Korvaava hakemus tarvitaan, jos varmenne on haettu ennen 24.10.2024 eikä sisällä Vero API -valintaa, tai kun Verohallinto muistuttaa varmenteen vanhenemisesta. Hakemus tehdään Verohallinnon Varmennepalvelussa, jossa valitaan tarvittavat rajapinnat ja tunnistaudutaan nimenkirjoitusoikeudella. Korvaavan hakemuksen jälkeen saadut siirtotunnus ja salasana käytetään tarvittaessa uuden varmenteen noutoon Maestroon. Maestrossa ei yleensä tarvitse tehdä muutoksia, jos nykyinen varmenne on voimassa eikä sitä ole poistettu.
Olemme lähettäneet Maestrosta useita sähköposteja liittyen Vero API-varmenteeseen. Tässä vielä tarkennettu ohjeistus Vero API -varmenteen korvaavan hakemuksen tekemiseen ja siihen milloin korvaava hakemus tarvitaan.
Aikaisempi tarkennus Tarkennus Vero API -varmenteen osalta
Milloin Vero API -varmenteen korvaava hakemus tulee tehdä?
- Mikäli WS-varmenne on alun perin haettu Tulorekisteristä ja ladattu Maestroon ennen 24.10.2024, se ei sisällä Vero API -valintaa, sillä kyseinen toiminnallisuus tuli varmenteille saataville vasta myöhemmin.
- Varmenteen noutopäivän voi tarkistaa Varmennepalvelu: vero.fi
- Kirjaudu tuotantovarmenteet näkymään
- Katso vihreällä näkyvä kohta

- Varmenteen noutopäivän voi tarkistaa Varmennepalvelu: vero.fi
-
Tai kun verohallinto lähettää sinulle automaattisen muistutuksen noin 60 päivää ennen varmenteen vanhenemista. Tulee silloin varmistaa, että Verohallinnon palvelussa on tehty korvaava hakemus (jos alkuperäinen varmenne on haettu ennen 24.10.2024) ja siihen on liitetty Vero API käyttöoikeus.Jos olet epävarma milloin korvaava hakemus tulee tehdä, ei sen tekemisestä ole haittaa. Tee korvaava hakemus kuitenkin noin 60 päivää ennen nykyisen varmenteen vanhenemista (tarkista nykyisen varmenteen voimassaolo Palkat > Tulorekisteri > Varmenteet)
Miten korvaava hakemus tehdään?
1. Tee korvaava rajapintahakemus Verohallinnon Varmennepalvelussa
-
Huomioithan, että:
- Toimenpiteet vaativat nimenkirjoitusoikeudellisen henkilön tunnistautumisen
- Hakemus tehdään Verohallinnon ohjeiden mukaisesti
2. Aktivoi Vero API -rajapinnan käyttöoikeudet uudelle varmenteelle
- Valitse näytä tiedot

-
Valitse tee korvaava hakemus

-
Valitse vähintään
- ApitamoPKI (Web service)
- Vero API (Web service)
- Palkkatiedot (Web service)

Varmennepalvelusta tulee korvaavan hakemuksen tekemisen jälkeen sähköpostiin siirtotunnus ja salasana, näitä ei tarvitse lähettää Maestroon.
3. Mitä tehdään Maestrossa?
Maestron puolella ei tarvitse tehdä muutoksia, jos nykyinen varmenne on voimassa ja nykyiseen varmenteeseen liittyen on tehty ohjeistuksemme mukaan Verohallinnon puolella korvaava hakemus. Jos varmenne on jo ehditty poistaa Maestrosta, on tilalle noudettava uusi varmenne korvaavan hakemuksen kautta.
Jos varmenne on edelleen Maestrossa ja voimassa
-
Älä poista varmennetta Maestrosta (tarkista varmenteen voimassaolo Palkat > Tulorekisteri > Varmenteet)
Jos varmenne on poistettu Maestrosta
-
Nouda uusi varmenne Maestroon korvaavan hakemuksen tekemisen jälkeen saamillasi siirtotunnuksella ja salasanalla
- Maestro:
- Palkat > Tulorekisteri > Varmenteet > Nouda uusi varmenne KATRE -yhteyttä varten

- Palkat > Tulorekisteri > Varmenteet > Nouda uusi varmenne KATRE -yhteyttä varten
Huom! SFTP-varmenne ei liity tähän eikä sille tarvitse tehdä korvaavaa hakemusta, se uusitaan Maestron puolesta, kun varmenne vanhenee.
Avainsanat
- Vero API -varmenne
- korvaava hakemus
- Verohallinto
- Varmennepalvelu
- Tulorekisteri
- Maestro
- siirtotunnus
- salasana
- rajapintahakemus
- ApitamoPKI (Web service)
- Vero API (Web service)
- Palkkatiedot (Web service)