Tämä osio on suunnattu ohjelmistokehittäjille.
Tulorekisterin teknisten rajapintojen avulla voit automatisoida ilmoittamisen ja tietojen hyödyntämisen.
Tulorekisterissä on käyttökatko ke 23.10. klo 18 – to 24.10. klo 01. Katso palvelukatkojen aikataulu.
Tämä osio on suunnattu ohjelmistokehittäjille.
Tulorekisterin teknisten rajapintojen avulla voit automatisoida ilmoittamisen ja tietojen hyödyntämisen.
Tutustu ohjelmistokehittäjien yhteydenottokanaviin, tilaa tuotannon tiedote ja päivitä ohjelmiston yhteyshenkilö.
Tutustu teknisiin ohjeisiimme. Ohjeet koskevat aineistoja, jotka toimitetaan tai jaetaan rajapintojen tai sähköisen asiointipalvelun latauspalvelun kautta.
Tarvitset varmenteen, jos haluat ilmoittaa tai hakea tietoja rajapintojen kautta.
Tee hakemus teknisen rajapinnan käyttöön tulorekisterin sähköisessä asiointipalvelussa
Tuotantovarmenteiden tilaaminen siirtyy 24.10.2024 Verohallinnon varmennepalveluun.
Sidosryhmätestauksessa voit testata sähköistä asiointipalvelua ja ohjelmistosi toimivuutta halutun rajapinnan kanssa.
Rajapinnalla tarkoitetaan eri järjestelmien ja tulorekisterin välille rakennettavaa sähköistä yhteyttä.
Tulorekisterissä on käytössä rajapintoja sekä tietojen ilmoittajille että tietojen käyttäjille. Tulorekisterin teknisten rajapintojen tietoformaatti on XML ja skeemat ovat englanninkielisiä.
Ohjelmistokehittäjien on huolehdittava siitä, että rakennettu palvelu vastaa tulorekisterin teknistä dokumentaatiota ja aikatauluvaatimuksia. Ota seuraavat asiat huomioon:
Tutustu kaikkiin rajapintakäytön suosituksiin sisältökuvauksissa tietojen toimittaminen tulorekisteriin ja tietojen jakelu tulorekisteristä.
Voit käyttää tietojen ilmoittamiseen reaaliaikaista tai viivästettyä Web Service -rajapintaa sekä SFTP-rajapintaa.
Reaaliaikaisessa WS-rajapinnassa ilmoitukset toimitetaan tulorekisteriin yksi kerrallaan. Rajapinta on tarkoitettu pienille ilmoitusmäärille ja tilanteisiin, jossa käsittelypalaute tarvitaan välittömästi.
Jos tulorekisteriin toimitettavia ilmoituksia muodostuu kerralla paljon, kannattaa rajapinnaksi valita viivästetty Web Service -rajapinta tai SFTP-rajapinta. Näissä rajapinnoissa voit toimittaa useamman ilmoituksen samassa aineistossa.
Lue lisää varmenteen hakemisesta
Tulorekisteriin tallennettuja tietoja saavat käyttöönsä vain ne viranomaiset ja muut tahot, joilla on siihen lakisääteinen oikeus.
Tulorekisterin tietojen jakelussa ovat käytössä SFTP-rajapinta ja reaaliaikainen Web Service -rajapinta.
Tiedon käyttäjät tekevät hakemuksen teknisen rajapinnan käyttöönottamiseksi täyttämällä tulorekisterin tiedon käyttäjän ilmoituksen tietolupaa varten. Tietoluvan toimeenpano käynnistää ensimmäisen varmenteen tilauksen.