Ohjelmistokehittäjien tietoon – 02/2026

Ilmoitin.fi-palvelusta julkaistaan uusi versio 24.3.2026

Versiopäivityksen aikana 24.3.2026 noin klo 7-9 www.ilmoitin.fi ja ohjelmistorajapinnat eivät ole käytettävissä.

Keskeiset muutokset:

• Vuosi-ilmoitukset 2026:
  • Lisätty vuoden 2026 mukaiset tarkistukset.
  • Vuosimuutoksen lisäksi muutoksia tietovirtoihin: VSLAINAE / Velallisten lukumäärä (111) ei salli arvoa 0.
  • Tietuekuvaukset löytyvät vuosi-ilmoitukset - vero.fi -sivulta
• Testiympäristössä muutoksia
  • Arkistossa ei enää saa lähetettyä tiedostoa auki. (Tämä muutos tulee myös Tuotantoon syksyllä).
  • Taustatarkastukseen (Aineiston lähetys ja Aineiston tarkastus) lähetetyn tiedoston virhetiedoston saa auki vain antamalla sama sähköpostiosoite, joka annettiin tiedoston lähettämisen yhteydessä.

---

Vero API ajankohtaista

Valtuus-tokenin voimassaoloajan pidentäminen: Mikä muuttuu?

Token-ratkaisu nykytilassaan ei tuonut toivottuja vaikutuksia kutsujen määriin, on päädytty voimassaoloajan pidentämiseen aiemmasta 60 minuutista 8 tuntiin.
 
Toimintaperiaate sama kuin aiemminkin, mutta puolesta asioinnin aika pidentynyt merkittävästi:

• 1 kutsu GetToken -rajapintaan tarvittaville asiakkaille, jatkossa on 8 tuntia aikaa suorittaa kaikki tarvittavat Vero API-kutsut.
• Kun tokenit vanhenevat, kutsutaan GetToken -rajapintaa taas uudestaan ja haetaan uudet tokenit tilalle seuraavan 8 tunnin ajaksi.
• Ohjelmistoissa on otettava huomioon, että samaa tokenia käytetään koko sen voimassaoloajan (8 tuntia) sen sijaan, että se haettaisiin uudelleen jokaisen API-kutsun yhteydessä.

Muutos on tullut voimaan tuotannossa 5.3.2026 ja rajapinnan dokumentaatio on päivitetty Vero API -portaaliin.
 
Seuraamme muutoksen vaikutuksia ja varmistamme, että siirtyminen 60 minuutista 8 tuntiin toteutuu palveluissa odotetulla tavalla.

---

Verohallinnon varmennepalvelu

Muutoksia Verohallinnon varmennepalvelun IP-osoitteissa, tuotantovarmenteiden osalta muutokset tapahtuvat 25.3.2026.
 
Verohallinnon varmennepalvelussa tehdään muutoksia, jotka vaikuttavat sen käytössä oleviin IP-osoitteisiin. Muutokset löydät sivulta: Ajankohtaista varmennepalvelusta.

Organisaatioissa, joissa Internet-liikennettä varmennepalvelun rajapintoihin tai varmenteiden sulkulistan osoitteisiin on rajoitettu palomuurilla, listatut muutokset voivat edellyttää toimenpiteitä. Jos organisaatio käyttää varmenteiden noutamiseen tai uusimiseen PKI rajapintoja, pyydämme varmistamaan, että organisaation sisäiset palomuuriasetukset sallivat kuvatut yhteydet.
 
Huom. IP-osoitemuutoksilla voi olla vaikutuksia myös Vero API -tuotantoympäristön kutsuihin. Häiriöitä saattaa esiintyä 25.–27.3.2026.

---

Ohjelmistokehittäjille suunnatut tilaisuudet

Teams -klinikat

Seuraava ohjelmistokehittäjien Teams-klinikka järjestetään perjantaina 10.4.2026 klo 9.

Klinikoissa esitellään ohjelmistokehittäjille ajankohtaisia asioita. Kysymyksiä klinikoista voi lähettää osoitteeseen ohjelmistotalot(at)vero.fi otsikolla ”Klinikka”.

Kokouslinkki löytyy Tilaisuudet - vero.fi -sivulta.

Verohallinnon ja ohjelmistotalojen yhteistyöpäivät verkossa

Kevään yhteistyöpäivä järjestetään tiistaina 26.5.2026.

Päivän aikana kuullaan ajankohtaisia esityksiä Verotuksen muutoksista ja niiden vaikutuksista ohjelmistokehitykseen.

Kysymyksiä ja toiveita yhteistyöpäivän sisällöstä voi vielä lähettää osoitteeseen ohjelmistotalot(at)vero.fi otsikolla: ”Kevään ohjelmistotalopäivä”.

Ilmoittaudu tilaisuuteen

---

Yhteydenotot ja kysymykset

ohjelmistotalot(at)vero.fi

Ohjelmistotalojen sähköpostiin voi jatkossa osoittaa myös tulorekisteriin liittyvät ohjelmistotalojen kysymykset. Kysymykset ohjataan Tulorekisteriyksikölle, mutta on hyvä muistaa, että sähköposti on

• tarkoitettu vain ohjelmistotaloille
• neuvontaan kehityksen tueksi
• ei tuotannon virhetilanteiden käsittelyä varten
• teknisestä häiriöstä tai havainnosta tulee edelleen aina tehdä havaintolomake tulorekisterille