Ohjelmistokehittäjien tietoon -6/2025

Uutinen, 24.11.2025

Ilmoitin palvelussa käyttökatko pe 28.11. klo 17:00 - 2.12.2025 klo 8:00

Ilmoittimen tuotantoympäristö vaihtuu ja tämän vuoksi palvelussa on käyttökatko, joka alkaa perjantaina 28.11. kello 17:00 ja päättyy tiistaina 2.12. klo 8:00

Koskee sekä Ilmoitin.fi -palvelua että ApitamoPKI -rajapintaa.
Tyhjentäkää selaimen välimuisti katkon jälkeen.
Ilmoitin.fi:n ApitamoPKI-rajapinta vaatii Veron Varmennepalvelun myöntämän varmenteen. Mikäli tarvitsette myös WSDL-tiedoston (https://apitesti.ilmoitin.fi/wsapp/apitamopki?wsdl), sen haku edellyttää myös varmenteen käyttöä. WSDL-tiedosto löytyy myös ilman varmennetta osoitteesta https://testi.ilmoitin.fi/wsapp/apitamopki?wsdl.
Testiympäristö (testi.ilmoitin.fi) on vaihtunut 22.10.2025 uuteen ympäristöön. Testatkaa ApitamoPKI-rajapinta ja testi.ilmoitin.fi:n toimivuus jo nyt testiympäristössä.

Eläkkeensaajien vuoden 2026 ennakonpidätystietojen suorasiirtojen paluuaineistot (VKESSELE ja RVKESSELE) valmistuvat 27.11. Niiden nouto ei onnistu katkon aikana, joten ne on noudettava joko ennen katkoa tai katkon jälkeen.

Syyskuun lopussa tuotantoon viedyssä versiossa Ilmoitin.fi:n Aineiston tarkastus -toiminnallisuus siirrettiin kirjautumisen taakse. Voitte tehdä Aineiston tarkastuksen joko

kirjautumalla tuotantoympäristöön omilla Suomi.fi -tunnuksilla (esim. pankkitunnukset tai mobiilivarmenne, jne)
tai kirjautumalla testiympäristöön Testitunnistaja -valinnalla ja itse keksityllä henkilötunnuksella, jossa loppuosa alkaa 9-numerolla.
Testitunnuksia käyttäviä pyydetään huomioimaan, että testitunnuksilla lähetetyt ilmoitukset näkyvät Ilmoittimen arkistossa kaikille niille, jotka käyttävät samaa testitunnusta. Älä myöskään lähetä tuotantoaineistoa testiympäristössä!

Vero API ajankohtaista

Seuraavien rajapintojen dokumentaatioita päivitetty:

Viitenumeroiden kysely / GetPaymentReference
Saldotietojen kysely / GetBalanceSpecification
Lähetä liitetiedosto -rajapinta / Send Attachment
Ajoneuvokohtainen autoveroilmoitus / UsedVehicle v3 API
Varainsiirtovero / Transfer Tax

Päivitetyt dokumentaatiot löytyvät Vero API -portaalista.

Ennakkoverorajapinnan kehittäminen elinkeinoharjoittajille

Verohallinto on selvittänyt mahdollisuutta kehittää rajapinta elinkeinoharjoittajien ennakkoverojen hakemiseksi ja muuttamiseksi. Selvityksen perusteella todettiin, ettei tällaiselle rajapinnalle ole tällä hetkellä riittävästi kysyntää tai tunnistettavissa olevia käyttäjiä.

Tämän vuoksi Verohallinto ei etene elinkeinoharjoittajien ennakkoverorajapinnan kehittämisessä. Tilitoimistot voivat jatkossakin hoitaa elinkeinoharjoittajien ennakkoveroasioita nykyisten asiointikanavien kautta, kuten OmaVerossa. Selvityksen yhteydessä tehdyn kyselyn perusteella havaittiin, että tilitoimistot ovat erittäin tyytyväisiä OmaVeroon.

Seuraamme kuitenkin aktiivisesti sidosryhmien tarpeita ja kehitämme palveluitamme niiden mukaisesti. Mikäli tarpeita rajapinnan kehittämiselle ilmenee tulevaisuudessa, olemme valmiita arvioimaan tilannetta uudelleen.

Uusi Suomi.fi-valtuutus käytettävissä Vero API -rajapinnoissa 25. marraskuuta 2025 alkaen

Uuden Suomi.fi-valtuuden nimi: Verotukseen liittyvien tietojen ilmoittaminen, päivittäminen ja hakeminen rajapinnan kautta.

Tämän valtuuden saaja voi valtuuden antajan puolesta ilmoittaa, päivittää ja hakea verotukseen ja verojen maksamiseen liittyviä tietoja rajapintojen kautta. Valtuuden avulla voi asioida niissä Vero API -rajapinnoissa , joissa edellytetään Suomi.fi-valtuutta yrityksen puolesta asiointiin.

Tällä valtuudella ei voi muuttaa yrityksen tilinumeroa.

Valtuuden saaja voi esimerkiksi

antaa veroilmoituksia
hakea verojen maksutietoja
päivittää rekisteröintitietoja.

Valtuuden saaja voi asioida vain ohjelmistojen kautta, jos niistä on rajapinta Verohallintoon (Vero API).

Tämän valtuuden avulla ei voi asioida OmaVerossa, Ilmoitin.fi-palvelussa, asiakaspalvelupisteissä eikä puhelimessa.

Verohallinnon ja ohjelmistotalojen yhteistyöpäivä verkossa

Syksyn yhteistyöpäivä järjestetään tiistaina 25.11.2025 klo 9 alkaen. Voit nyt tarkastella tapahtuman aikataulua sekä ilmoittautua mukaan. Linkki aikatauluun ja ilmoittautumiseen löytyy alta.

Syksyn yhteistyöpäivä

Teams-klinikat

Vuoden viimeinen ohjelmistokehittäjien klinikka 5.12.2025 klo.9

Klinikoissa esitellään ohjelmistokehittäjille ajankohtaisia asioita. Kysymyksiä ja toiveita klinikoiden sisällöstä voi lähettää osoitteeseen ohjelmistotalot(at)vero.fi otsikolla: Klinikka.

Ohjelmistokehittäjille suunnatut Teams-klinikat jatkuvat myös ensi vuonna. Teams-klinikoiden aikataulu päivitetään Tilaisuudet -sivulle.

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