Veronumerokysely -rajapinta Raksi-ohjelmistoyhteistyö tilaisuus 15.1.2019
Määritys API - Checking the existence of an entry in the Public Register of Tax Numbers Request - TaxNumberCheckFromRegister Block Format Filers identification code (FilerId) Field YTUNNUS Yes New Birthday of registred (Birthday) Field SYNTAIKA Individual Tax Number (TaxNumber) Field VERONUMER O Yes Filer assures that the request is done based on the New lagistlation Field N1 1Yes Answer - TaxNumberAnswerFromRegister Block Permissible value Mandatory Validation New Information on the existence of an entry in the public register of tax numbers (ExistenceInfo) Field N1 1,2 Tax Number and birthday match (TaxNumberMatchBirthday) Field N1 1 First Name (FirstName) Field AN100 Last Name (LastName) Field AN100 1=Yes 2=No This data is given only when both Birthday and TaxNumber are given in request. FirstName and LastName will be given only if Tax Number and birthday match
Project schedule - Updated 10.12.2018 Project start 22.8.2018 Go-live 1.5.2019 Project end 1.6.2019 2018 2019 7 8 9 10 11 12 1 2 3 4 5 6 Implementation start decision point Security solution decision point Go-live Infra & security design Security build Reverse proxy Infrastructure & security build Ross Kutter & Jake New developer Tax number query API implementation Production pilot customers API support model design Developer portal setup & content creation API support model testing Transfer to Prod Support
Toteutus-projekti pääpaino projektin alussa ollut teknisen valmiuden varmistamisessa sekä rajapinnan määrittelyssä kehittäjä portaalia ja ohjeistusta sekä rajapintojen hallintamallia työstetään
Varmenteet ja käyttöehdot https://www.vero.fi/globalassets/tulorekisteri/verohallinnon-ja-tulorekisterinrajapintapalveluiden-kayttoehdot.pdf (valitettavasti ei löydy englanniksi, I'm sorry, nut this is not (yet) available in English)
Käyttöehtojen roolit Verohallinto Käyttöehdot Käyttäjä (varmenne) Valtuus Asiakas (= lakiin perustuva oikeus tai velvoite)
Valtuus Valtuudella asiakas (henkilö tai yritys) valtuuttaa varmenteen hakeneen käyttäjän (yritys) asioimaan puolestaan Valtuus on tarkoitettu ensisijaiseksi rajapintapalveluiden käyttötavaksi Asiakkaan oma varmenne on poikkeus lähinnä todella suurille yrityksille (ERP integraatio tms) Valtuus ei ketjuunnu, eli käyttäjällä on oltava suora valtuus asiakkaalta Tämä on käyttäjän vastuulla, ei asiakkaan tai kolmannen tahon Jatkossa osa kiinnostavimmista uusista rajapinnoista tulee edellyttämään käyttäjältä asiakkaan antamaa Suomi.fi-valtuutta Valtuusasiakirja-termiä voi tulkita laajasti: se voi olla esimerkiksi lokimerkintä valtuustekstin sisältävien palvelun käyttöehtojen hyväksymisestä, ei siis tarvitse olla paperia, kuulakärkikynäallekirjoituksia tms.
Ohjelmistokehittäjä käyttöehtojen ekosysteemissä Käyttäjänä Hakee oman varmenteen Hakee valtuuden suoraan asiakkaalta Tekee sopimuksen asiakkaan kanssa Tuottaa asiakkaalle sisältöpalvelua ilmoittamiseen tai muuhun veroasioiden hoitoon Vastuu käyttöehtojen mukaisesti Verohallinnolle ja asiakkaalle erillisen sopimuksen mukaan Kolmantena osapuolena Ei hae omaa varmennetta Ei hae valtuutta asiakkaalta Tekee sopimuksen käyttäjän kanssa Tuottaa käyttäjälle hyödyllistä teknistä tukipalvelua Vastuu käyttäjälle erillisen sopimuksen mukaan Katso koko Alpon esitys täältä!
Varmennepalvelun käyttöönotto Ilmoitin.fi ApiTamossa "ApiTamoPKI" Menossa projekti, jonka aikataulu tällä hetkellä on 03.09.2018-30.04.2019 Projektin tehtävänä on linkittää tulorekisterin rakentamisen yhteydessä toteutettu varmennepalvelu ApiTamoon kehittää ohjeistusta varmennepalvelusta niin, että uuden ApiTamon käyttöönotto olisi mahdollisimman helppoa uuden ApiTamo referenssi clientin toteutus varmistaa, että kaikkia tietovirtoja (myös niitä joissa valtuustasot ovat kovemmat) pystytään antamaan uuden ApiTamon kautta Pilotointia suunniteltu ajalle 01.02. - 15.04.2019 ja pilotoijien kontaktointi menossa Tuotantokäyttö pyritään aloittamaan kesällä, jotta siirtymäaika ennen vuoden vaihdetta 2019-2020 olisi riittävän pitkä
Tilaisuudessa esille tulleita asioita/tanjan osuudesta Puhelinnumeroiden kerääminen Raksi-ilmoituksilla ei ole nykypäivää, sähköposti tavoittaa paremmin esim. viesti OmaVeroon, jonne voi kirjautua ja käydä lukemassa viestin juuri näin pyritään tekemään eli tammikuusta 2020 lähtien miksi eräpäivän siirto koskee jo syyskuun ilmoituksia? käyttökatko alkaa ennen kuin syyskuun ilmoitus erääntyy eli marraskuussa. Estettä ei ole antaa ilmoitusta syyskuulta ja lokakuulta jo ennen lokakuussa alkavaa käyttökatkoa jos ulkomaiselle tunnukselle löytyy VH:lta y-tunnus niin pitääkö aineistoa korjata? Ei, jos ulkomainen tunnus, sen tyyppi ja yrityksen kotivaltio ovat oikein. Näissä tapauksissa lähtee ohjeistus, jossa kerrotaan, että ko. yritykselle löytyy suomalainen y-tunnus, mutta ei edellytetä korjaamaan jo annettua ilmoitusta. Hylkääntyykö aineisto, jos aineistossa tulee vanhoja tiedon tunnuksia? Kyllä
Tilaisuudessa esille tulleita asioita/tanjan osuudesta Jos on pelkkiä omia työntekijöitä niin voisiko tulorekisteri ilmoituksella kerätä työntekijä tiedot ja Raksi TA-raportin voisi jättää antamatta? Asiaa on pohdittu, mutta kyseessä ovat eri tiedonantovelvolliset tahot ja rakentamisilmoitukset annetaan siksi, että voidaan valvoa työnantajien verovelvoitteita sivulliselta saatujen tietojen perusteella Aineistojen antaminen ja korjaaminen esim. yritysjärjestely tilanteissa. Miten sulautuneet/jakautuneet ym. yhtiöt voivat antaa ilmoituksia yritysjärjestelyn jälkeen ajalle ennen yritysjärjestelyä? Tästä pyrimme laittamaan teille viestiä erikseen. Vaatii vielä sisäistä tutkintaa. Yrityksen tunnuksena on ilmoitettava se tunnus, jolla se on toiminut ilmoituksen kohdekuukaudella, ei ilmoituksen antamispäivänä. Esim. yritys toiminut tunnuksella 1 kohdekuukaudella 9/2018, sulautuminen 31.12.2018 ja toiminta jatkuu 1.1.2019 alkaen tunnuksella 2. Korjausilmoitus 9/2018 annetaan 5.1.2019 = koska kyse 9/2018 kaudesta, on silloin tunnus 1 oikea. AVI on vaatinut joskus työmaan työntekijöiden työpäivien lkm ja tunti-tietoja. Perustuuko AVI:n omiin vaatimuksiin vai ovatko tulkinneet VH:n raksi-ilmoituksen pakollisia tietoja väärin? Pyydettiin olemaan yhteydessä AVI:n, etteivät vaadi sellaisia tietoja, jotka eivät ole pakollisia kerätä.
Tilaisuudessa esille tulleita asioita/jenni osuudesta Miten käytännössä ohjelmisto vs. asiakas -valtuutus kuvio menee rajapinnoissa? Nykymuotoisessa ilmoittamisessa riittää pelkkä tulorekisteri varmenne eli Katso-valtuuden korvaajaa eli suomi.fivaltuutta ei enää tarvita Ohjelmiston käyttäjä eli asiakas valtuuttaa ohjelmiston Valtuus voi olla mikä tahansa kirjallinen tai koneellinen merkintä valtuudesta, esim. Ohjelmiston käyttöehtojen yhteydessä raksi ruutuun tyyppinen ratkaisu käy Nykyisessä veronumeron rekisteröinti rajapinnassa tarkistetaan TA-rekisteröinti, jos henkilön veronumeroa pyydetään merkitsemään julkiseen rekisteriin. Miksi, koska kaikkien työnantajien ei tarvitse olla TA-rekisterissä? Riittäisikö tässäkin rekisteröintiä pyytävän vakuutus tietovirrassa? Tämä otetaan tutkintaan ja asiasta viestitään kun veronumeron rekisteröinti Apia käsitellään sidosryhmien kanssa
Tilaisuudessa esille tulleita asioita/jenni osuudesta Miten varmenne käytännössä haetaan? Tulorekisterin sivujen kautta eli Suomi.fi-tunnistuksen kautta. Pankkitunnuksen ja Katso- tunnistus käyvät tunnistusvälineinä varmenteen haussa.. Muutosta sähköiseen varmenteiden haku palveluun on ehkä tulossa jolloin "Tulorekisteri" häivytetään asiointipalvelusta, jossa varmennetta haetaan. Käykö tulorekisterin testi-varmenne ApiTamoPKI:n testaamiseen? kyllä Millä y-tunnuksilla voi testata? tämä on vielä selvityksessä ja näitä asioita pyritään ohjeistamaan selkeästi kun dokumentaatiota uudesta ApiTamo rajapinnasta julkaistaan kevään aikana