Vero API -varmenne: milloin tarvitaan korvaava hakemus?

Miksi tämä koskee osaa asiakkaista?

Mikäli 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.

Tällöin pelkkä voimassa oleva varmenne tai sen uusiminen ei vielä riitä, vaan tarvitaan korvaava varmennehakemus, jossa tehdään erilliset lisävalinnat Verohallinnon palvelussa.

Varmenteen voimassaolopäivä kertoo ainoastaan sen, milloin varmenne vanhenee – ei sitä, mitä toiminnallisuuksia se sisältää.

Korvaava hakemus tulee siis tehdä, mikäli varmenne on alun perin ladattu Maestroon ennen 24.10.2024.

Milloin erityistoimia ei tarvita?

Jos varmenne on haettu Verohallinnosta 24.10.2024 jälkeen, erityistoimia ei tarvita. Tällainen varmenne sisältää jo valmiiksi tarvittavat: 

• Vero API -toiminnallisuudet

• ApitamoPKI-toiminnallisuudet

ja varmenteen uusiminen toimii jatkossakin automaattisesti.

Milloin tarvitaan korvaava hakemus?

Jos yrityksellänne on käytössä ennen 24.10.2024 Tulorekisterin sähköisessä asiointipalvelussa tilattu varmenne, ja:

• varmenne on uusittu automaattisesti

• käytätte Vero API- tai ApitamoPKI-rajapintoja

järjestelmä voi antaa virheilmoituksen:

"Client certificate validation failed"

Tämä johtuu siitä, että 24.10.2024 jälkeen Verohallinto lisäsi näille rajapinnoille omat erilliset valinnat uuden varmennepalvelun myötä. Vanha varmenne ei sisällä näitä valintoja, vaikka se olisi muuten voimassa.

Tällöin tulee tehdä Verohallinnon sivustolla korvaava hakemus ja uusia varmenne.

Näin teet korvaavan hakemuksen

1. Tee korvaava rajapintahakemus Verohallinnon Varmennepalvelussa

👉 Varmennepalvelu: vero.fi

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:

• Valitse näytä tiedot 

• Valitse tee korvaava hakemus

   

• Valitse vähintään

  • ApitamoPKI (Web service)

  • Vero API (Web service)

  • Palkkatiedot (Web service)

3. Poista vanha varmenne ja nouda uusi Maestroon

Kun uusi varmenne on valmis siirry Maestrossa Palkat > Tulorekisteri > Varmenteet:

• Poista vanha varmenne

• Nouda uusi varmenne KATRE-yhteyttä varten.

Kun uusi varmenne on otettu käyttöön:

• Vero API -rajapinnat toimivat normaalisti

• Virheilmoitus poistuu

• Ilmoitukset voidaan lähettää ilman katkoksia

• jatkossa varmenne päivittyy automaattisesti

Palkkalaskelmien lähetys ei onnistu? Tarkista osoitetiedot

Mikäli palkkalaskelmien lähetys jää virheeseen tai laskelmat eivät näy palkansaajille, syynä on usein puutteelliset osoitetiedot.

Varmistathan, että:

Yrityksen perustiedoissa (palkkaa maksavan yrityksen tiedot)
Rekisterit -> Perusrekisterit -> Yrityksen perustiedot
– Kaikki lähettäjän osoitetiedot ovat täytettyinä, huomioi että täytettynä on sekä postinumero että postitoimipaikka.

Palkansaajien osoitetiedot
– Palkansaajien osoitetiedot on täytetty kokonaisuudessaan, jos palkkalaskelmat toimitetaan Ropon välittämänä.

• Osoitetiedot syötetään:
  Palkat → Henkilötiedot → Päivitys → Henkilökortti
• Syötä osoite huolellisesti ilman ylimääräisiä välilyöntejä tai merkkejä.
• Jos osoite puuttuu:
  • palkka maksetaan normaalisti, mutta
  • Ropo ei siirrä palkkalaskelmaa verkkopankkiin palkansaajalle nähtäväksi.

Kun tiedot on päivitetty, palkkalaskelmat voidaan lähettää uudelleen normaalisti.

Ystävällisin terveisin,

Maestro

Yhteystiedot

Asiakaspalvelu 0207 505 700
Myynti 0207 505 777
etunimi.sukunimi@maestro.fi

Toimistot

Pasilanraitio 5, 00240 Helsinki
Brahenkatu 4, 53100 Lappeenranta
Puistokatu 5, 57100 Savonlinna