Ohjelmistokehittäjien tietoon - 4/2025

Ilmoitin.fi-palvelusta on julkaistu uusi versio 23.9.2025

Keskeiset muutokset:

• Voit tarkastaa ja lähettää henkilöyritysten (2, 2Y, 2C, 5, 6A, 7K) tuloveroilmoituksia verovuodelle 2025.
• Vuoden 2026 ennakkoperinnän suorasiirrot:
  • Voit tarkastaa ja lähettää
    • Yleisesti verovelvollisten eläkkeensaajien suorasiirtoja (VKESSELE),
    • Rajoitetusti verovelvollisten eläkkeensaajien suorasiirtoja (RVKSSELE),
    • Palkkojen ennakonpidätystietojen suorasiirtoja (VKESSPAE) sekä
      YEL ja MYEL työtulotietoja (VKTYOSVA) vuoden 2026 ennakkoperintää varten.
  • Esimerkkiaineistot on päivitetty Ilmoitin/kehittäjät -sivustolle
• Aineiston tarkastus -toiminto ja suurten tiedostojen tarkastus
  • Aineiston tarkastus -toiminto on siirretty kirjautumisen taakse, joten tarkastus vaatii Suomi.fi -tunnistautumisen. Muuten tarkastus toimii kuten aiemmin, joten esim. valtuutusta ei vaadita ja tarkastettua tiedostoa ei lähetetä eteenpäin.
  • Suurien tiedostojen osalta (tuotannossa yli 10 Mt) tarkastus tehdään jatkossa aina taustakäsittelyssä, joten niiden heti tarkastusta ei voi enää tehdä.
• Kela / eSARA
  • Ilmoitin.fi-palvelun kautta lähetettävien eSARA-tiedostojen käyttö päättyy 30.9.2025.
  • Kela suosittelee, että eSARA-tiedostoilla etuuksia hakevat isot työnantajat siirtyisivät pian hakemaan etuuksia tulorekisterissä ja pienet joko tulorekisterissä tai Työnantajan päiväraha- ja korvauspalvelussa.
  • Lue lisää siirtymästä
• FATCA / AccountHolder/Individual/TIN ja SubstantialOwner/Individual/TIN -tietojen issuedBy-arvoksi sallitaan US:n lisäksi myös muut maakoodit vuoden 2025 ilmoituksista alkaen (tulee voimaan 1.1.2026)
• Testiympäristö vaihtuu lokakuun puolivälissä.
  • Testaukseen tästä ei aiheudu katkoa, eikä aiheuta asiakkailla toimenpiteitä.
  • Testiympäristön tietokanta tyhjennetään vaihdon yhteydessä, joten aiemmin lähetettyjä testitiedostoja ei näy enää Arkistossa. (tämä puuttuu vielä kieliversioisa).
• Alustavasti on suunniteltu, että Tuotantoympäristö vaihtuu marras-joulukuun vaihteessa.
  • Tästä aiheutuu viikonlopun yli kestävä käyttökatko – Aikataulu tarkentuu syyskuun aikana.
• Marraskuussa ei julkaista Ilmoittimesta uutta versiota, koska silloin valmistaudutaan tuotantoympäristön päivitykseen.

Vero API ajankohtaista

Vero API header-tiedot

Vero API header-tietojen pakollisuus on astunut voimaan 17.9.2025. Jokaisessa Vero API kutsussa täytyy olla seuraavat yleiset header-tiedot User-Agent, Content-Type ja Accept

Muutoksen myötä rajapinnat palauttavat virhevastauksen puuttuvasta headerista, esim. ErrorCode:1005, ErrorText: Missing http Header: User-Agent

Lue lisää: Vero API -rajapintojen tekniset linjaukset - vero.fi

Verokorttien kysely notifikaatiopalvelulla

Notifikaatiopalveluun on julkaistu 17.9 laajennus, joka mahdollista verokorttien notifikaatioiden tilauksen. Jatkossa verokorttien notifikaatiot voi saada ohjelmistoon myös push-ilmoituksina.

Laajennuksen tarkoitus on tehostaa verokorttitietojen käsittelyä ohjelmistoissa. Laajennuksen avulla palkanlaskentaa hoitavat tahot, kuten yritykset ja tilitoimistot, voivat tilata notifikaatio-ilmoituksia palkansaajien uusista verokorteista ja reagoida niihin automaattisesti hakemalla ne verokorttien kysely -rajapinnalla. Tämä poistaa tarpeen jatkuvalle tietojen kyselylle ja mahdollistaa reaaliaikaisen reagoinnin vain silloin, kun verokorttitiedot muuttuvat.

Palvelun hyödyt ovat merkittäviä: se vähentää rajapintakutsujen määrää, nopeuttaa prosessointia, säästää resursseja ja parantaa tietojen ajantasaisuutta.

Lue lisää aiheesta Verohallinnon sivuilta: Verokorttien kysely notifikaatiopalvelulla

17.11.2025 tulossa muutoksia seuraaviin Vero API-rajapintoihin

• Maksamisen uudistuksen muutokset Saldotietojen kysely- ja Verolajikohtaisten viitenumeroiden kysely -rajapintaan
• Uusi liitetiedosto API
• Ajoneuvokohtainen autoveroilmoitus

Näiden rajapintojen dokumentaatiot päivitetään API -portaaliin 17.11.2025.

Ohjelmistokehityksen yhteistyö

Olethan huomannut, että ohjelmistokehittäjät voivat ilmoittautua mukaan Verohallinnon ohjelmistokehityksen yhteistyöhön vero.fi-sivuston kautta?

Sivun kautta voi ilmoittaa ja päivittää yhteystietoja mahdollista yhteistyötä varten. Yhteystietoja hyödynnetään ohjelmistokehittäjille suunnatussa neuvonnassa ja muussa viestinnässä.

Käy ilmoittamassa yhteystietosi: Ohjelmistokehityksen yhteistyö

Ohjelmistokehittäjille suunnatut tilaisuudet

Teams -klinikat

Seuraava ohjelmistokehittäjien Teams-klinikka järjestetään perjantaina 3.10.2025 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

Syksyn yhteistyöpäivä järjestetään tiistaina 25.11.2025.

Ilmoittaudu tilaisuuteen

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: ”Syksyn ohjelmistotalopäivä”.

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