Uutinen ohjelmistokehittäjien tietoon - 3/2025

Ilmoitin.fi-palvelusta on julkaistu uusi versio 3.6.2025

Keskeiset muutokset:

• CRS/DAC2 / Uusia tarkistuksia:
  • Jos itseannettu todistus on saatu (Self-Certification == CRS972) niin syntymäaika on pakollinen (Tarkistus koskee Individual tilinhaltijoita).
  • Jos tili on uusi (AccountTreatment == CRS982) niin tieto itseannetusta todistuksesta on pakollinen (Self-Certification CRS971 tai CRS972).
  • Jos on ilmoitettu dokumentoimaton tili (UndocumentedAccount == true) niin ei voi ilmoittaa, että itse annettu todistus on saatu (Self-Certification == CRS972).
• DPI (DAC7)
  • Uusia tarkistuksia:
    • Ilmoitin tarkistaa, että elementissä ReportableSeller/Entity ei ole annettu tunnusta 0000000-0 tai ReportableSeller/Individual ei ole annettu tunnusta 000000-0000.
    • Ilmoitin tarkistaa, että ReportableSeller-rakenne on annettu, jos MessageTypeIndic on DPI401 tai DPI402.
  • Uusi huomautus, jos ilmoituksessa annetaan tietoja Taxes-elementissä:
    • Olette ilmoittamassa alustaoperaattorin myyjältä perimiä veroja Taxes-elementissä. Varmistakaa, ettei verona ilmoiteta esim. arvonlisäveroa.
• Rakentamisen tiedonantomenettely / urakkatiedot (VSURAKKA)
  • Tiedon 400 nimi muutettu Urakan lajiksi (oli aiemmin Toimeksiannon laji).
• 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ä

Vero API ajankohtaista

Vero API -kutsujen header-vaatimukset:

• 12. toukokuuta 2025 alkaen kaikki Vero API -testirajapinnan (apitest.vero.fi) REST API -kutsut ovat edellyttäneet seuraavia yleisiä header-tietoja: User-Agent, Content-Type ja Accept.
• Tuotantoympäristössä (api.vero.fi) nämä headerit tulevat pakollisiksi 15. syyskuuta 2025. Tämä muutos parantaa turvallisuutta ja yhteensopivuutta. Varmistathan, että ohjelmistosi lähettää nämä headerit kaikissa API-kutsuissa. Tuotantoympäristön header-vaatimukset voi päivittää ohjelmistoon, vaikka heti.
• Hyvä käytäntö olisi sisällyttää seuraavat tiedot User-Agent headeriin:
  • Sovelluksen nimi: Tämä auttaa tunnistamaan, mikä sovellus tekee pyynnön.
  • Versio: Sovelluksen versio, jotta palvelin voi erottaa eri versiot toisistaan.
  • Käyttöjärjestelmä: Tieto siitä, millä käyttöjärjestelmällä sovellus pyörii
  • Esim. User-Agent: MyApp/1.0 (Windows NT 10.0; Win64; x64)

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

Verohallinnon varmennepalvelu

Päivitettyjä ja uusia ohjeita:

• Verohallinnon varmennepalvelu – kuvaus PKI-järjestelmästä ja rajapinnoista (pdf) dokumenttiin tehty teknisiä tarkennuksia RSA-avaimen pituuteen liittyen.
• Pikaopas varmenteen luontiin - tehty teknisiä tarkennuksia RSA-avaimen pituuteen liittyen.
• Esimerkki varmenteen uusimisesta on irroitettu dokumentista erilliseksi alisivuksi Varmennepalvelun sivuille.
• Ulkomaalaisen asiointi varmennepalvelussa
• Tuotantovarmenteen haku ulkomaalaiselle

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