Yleistä
Palkansaajien verokortit voidaan noutaa Verohallinnosta Ennakonpidätystietojen nouto -toiminnolla. Näkymä löytyy ohjelman kohdasta Palkat > Ennakonpidätystietojen nouto.
Verokortit voidaan noutaa kahdella tavalla:
Manuaalisesti: Käyttäjä käynnistää noudon itse.
Automaattisesti: Ohjelma noutaa muuttuneet verokortit joka yö.
Ennakonpidätystietojen haulla palkansaajan palkkatietoihin tuodaan:
verokorttityyppi
perus- sekä lisäprosentti
verokortin päivämäärä sekä tallennuspäivämäärä
vuosituloraja
Käyttöoikeudet
Käyttäjät, joilla on käyttöoikeudet palkanlaskentaan sekä ilmoituksiin pääsevät Ennakonpidätystietojen nouto -näkymälle ja noutamaan verokorttitietoja.
Varmenne
Manuaalisessa ja automaattisessa noutotavassa käytetään varmennetta. Manuaalisessa noudossa käytetään noudon käynnistäjän Omat tiedot ja asetukset -kohdassa valittua tulorekisterivarmennetta.
Koska automaattinen nouto käynnistyy ilman käyttäjän toimenpiteitä, varmenteena ei voida käyttää käyttäjän asetuksiin määritettyä varmennetta, vaan automaattinoudossa käytetään yrityksen käyttöasetuksiin määritettyä varmennetta.
Asiakasyritysten ennakonpidätystietoja voi noutaa myös Tilitoimiston tulorekisterivarmenteella.
Verokorttitietojen pyytäminen Verohallinnosta
Ennakonpidätystiedot voi hakea palkansaajille, joilla käytetään palkkaverokorttia tai muuta ansiotuloihin liittyvää verokorttia.
Voit valita, mille tulotyypille verokorttitiedot haetaan. Tämä mahdollistaa esimerkiksi työkorvausten verokorttitietojen haun. Palkansaajalla voi olla käytössä useamman eri tulotyypin mukaisia verokortteja. Ennakonpidätystietojen noudossa käytettävät verokortin tulotyypit määritellään palkansaajan palkkatiedoissa kohdassa Palkat > Palkansaajarekisteri > Palkkatiedot > Verokortti. Huomaathan, että jos Ennakonpidätystietojen noudossa käytettävät verokortin tulotyypit -alasvetovalikossa ei ole tehty valintaa (Ei valintoja), ei palkansaaja nouse mukaan ennakonpidätystietojen noudon hakulistalle.
Verokortin noudon estäminen
Verokortin noudon VeroAPIn kautta voi tarvittaessa estää palkansaajakohtaisesti.
Verokortin noudon estäminen onnistuu palkansaajan Palkkatieto -näkymällä, jonne siirrytään Palkansaajarekisterin kautta. Palkkatiedoissa henkilön tietoihin lisätään valinta kohtaan Palkansaajaa ei sisällytetä Ennakonpidätystiedot maksajille kyselyyn (VeroAPI).
Painiketta Näytä palkansaajat, joiden ennakonpidätystietoja ei noudeta klikkaamalla näytetään palkansaajat, jotka eivät ole mukana verokorttien haussa. Oletuksena näitä palkansaajia ei näytetä.
Automaattinen nouto
Automaattisessa noudossa ohjelma noutaa joka yö ne muuttuneet verokortit, joista Verohallinto on antanut tiedon ennen noudon käynnistymistä ja päivittää muuttuneet verokortit palkansaajille ilman käyttäjän toimenpiteitä.
Automaattinen nouto otetaan käyttöön valitsemalla Salli Ennakonpidätystietojen automaattinen nouto Hallinta > Yrityksen tiedot > Käyttöasetukset-sivun Integraatioasetukset kohdassa. Lisäksi Käytettävä tulorekisterivarmenne -kohdassa valitaan varmenne, jota automaattinouto käyttää.
Automaattinen nouto noutaa vain ne verokortit, joihin on tullut muutoksia automaattisen noudon käyttöönottopäivän jälkeen. Jos verokorttiin on tehty muutoksia ennen käyttöönottopäivää, automaattinen nouto ei hae näitä verokortteja. Suosittelemme siksi, että verokortit noudetaan manuaalisesti automaattisen noudon käyttöönottopäivään asti.
Uusi palkansaaja
Kun uusi palkansaaja lisätään palkansaajarekisteriin, noudetaan palkansaajalle kyseisenä päivänä voimassa oleva verokortti automaattisesti, jos automaattinouto on otettu käyttöön ja palkansaajaa ei ole suljettu pois automaattinoudosta.
Uusimmat automaattisesti haetut verokortit -widget
Etusivun Uusimmat automaattisesti haetut verokortit -widgetissä näytetään automaattisesti haetut verokortit viimeisen viikon ajalta. Widgetissä näytetään aikaleima, palkansaajan nimi sekä noudossa mahdollisesti tullut virhe. Widgetin Ennakonpidätystietojen nouto -painikkeella pääsee helposti siirtymään Ennakonpidätystietojen nouto -näkymälle, jonka Hakuhistoria -välilehdellä näkyy tarkemmat tiedot automaattinoudosta.
Palkansaajarekisteri-painikkeella avautuu palkansaajarekisteri, josta pääsee helposti muuttamaan esimerkiksi palkansaajan Verokortin asetuksia Palkkatiedot-välilehdellä.
Widgetin lisääminen etusivulle
Jos Uusimmat automaattisesti haetut verokortit -widget ei näy etusivulla, voit lisätä sen:
Valitse etusivulla Muokkaa etusivua -painike.
Lisää Uusimmat automaattisesti haetut verokortit -widget näkyville.
Lisätietoa etusivun muokkaamisesta löydät ohjekirjasta.
Manuaalinen nouto
Manuaalisessa noudossa käyttäjä käynnistää noudon itse Ennakonpidätystietojen nouto -toiminnolla ja antaa päivämäärän, jolle verokortit noudetaan, esimerkiksi palkkakauden palkkapäivän.
Verohallinto palauttaa kaikille valituille palkansaajille verokortin, joka on voimassa annettuna päivänä. Noudettu verokortti päivitetään Procountoriin vain, jos se eroaa palkansaajalla olevasta verokortista.
Ennakonpidätystietojen nouto -näkymä vaatii käyttöoikeudet palkanlaskentaan sekä ilmoituksiin.
Luo uusi pyyntö Verohallintoon
Uusi pyyntö - näkymän taulukko listaa oletuksena näkyville kaikki ympäristöön lisätyt palkansaajat tai erikseen hakuehtojen mukaisesti määritellyt palkansaajat. Taulukko kertoo palkansaajakohtaisesti viimeisimmän haetun verokortin tilan.
Henkilö, jota ei sisällytetä verokorttitietojen noutoon, tulee näkyville Ennakonpidätystietojen nouto -näkymän palkansaajalistaukseen, mutta häntä ei pysty valitsemaan listalta. Tällä varmistetaan, että palkansaajalle ei haeta turhaan toista verokorttia käyttöön, mikäli henkilö ei palkkaverokorttia tarvitse.
Painiketta Näytä palkansaajat, joiden ennakonpidätystietoja ei noudeta klikkaamalla näytetään palkansaajat, jotka eivät ole mukana verokorttien haussa. Oletuksena näitä palkansaajia ei näytetä.
Näin haet uudet verokorttitiedot verottajalta
Syötä Maksupäivä -kenttään sen palkkalistan palkanmaksupäivä, jolle verokortteja haetaan. Maksupäivä ei voi olla menneisyydessä.
Valitse listalta palkansaajat, joille verokorttitiedot on tarkoitus hakea. Listauksen ylimmästä ruudusta, ohjelma merkitsee automaattisesti kaikki listan palkansaajat.
Suorita haku Verohallintoon painamalla Lähetä pyyntö -painiketta. Ohjelma ilmoittaa, että pyyntö on lähetetty, joka kuitataan Ok -painikkeella. Verokortin tilaksi tulee Jonossa. Näkymä päivittyy automaattisesti haun lähettämisen jälkeen.
Pyyntö lähetetään 5min sisällä ja vastaus on melkein välitön.
Uudet Verokorttitiedot päivitetään, mikäli verokortin voimaantulopäivä, lisä% tai vuosituloraja on muuttunut. Jos tiedot ovat samat kuin edellisessä verokortissa, uutta verokorttia ei lisätä. Jos esimerkiksi palkansaajan veroprosenttia on muutettu manuaalisesti Palkkatiedot -näkymällä viimeisimmän haetun verokortin jälkeen ja tämän jälkeen palkansaaja sisällytetään uudelleen hakuun, ei verokorttitietoja päivitetä.
Verokortin tilat
Jonossa = Odottaa lähetystä Procountorin puolella (5min lähetysväli).
Käynnissä = Lähetetty Verohallinnolle.
Vastaanotettu, uusi = Uusi verokortti on tallennettu palkansaajan taakse Palkansaajarekisteri / Palkkatiedot -välilehdelle.
Vastaanotettu, ei muutoksia = Verokorttia ei tallennettu, koska se on sama kuin edellinen.
Vastaanotettu, puutteellinen = Verokorttia ei ole saatavilla. Pyydä palkansaajaa hakemaan verokorttia verottajalta.
Ei tietoja/ tyhjä = Ensimmäistä verokortti hakua ei ole vielä tehty.
Epäonnistunut / Virhe= Ennakonpidätystietojen haku epäonnistui jostain syystä. Lisätiedot -sarakkeessa ilmoitetaan virheilmoitus, joka tulee suoraan Verohallinnon palvelusta.
Verohallinnon antamat virheilmoitukset (Jos saat jonkin alla olevista virheilmoituksista, ole yhteydessä Verohallintoon lisäohjeiden saamiseksi):
Arvo | Kuvaus |
1005 | Virhe pyynnön käsittelyssä |
1010 | No data |
1101 | Virheellinen henkilö- tai Y-tunnus |
WHP001 | Missing parameter place holder |
WHP002 | Invalid recipient id requested |
WHP003 | Invalid Payer id requested |
WHP004 | Invalid Payment date requested |
WHP006 | Too many income types are being queried, a maximum of 10 income types can be requested in one call. |
WHP007 | Withholding data not yet available |
Ennakonpidätystietojen noudon historia
Hakuhistoria - näkymä näyttää ennakonpidätystietokyselyn pyyntöhistorian. Taulukosta näkee:
Milloin pyyntö on lähetetty.
Kuka on pyynnön lähettäjä.
Verokorttien määrän (esim. 2 palkansaajan verokorttitiedot noudettu).
Pyynnön tilan (esim. Vastaanotettu ja onnistumissuhdeluku 5/5).
ja mahdolliset lisätiedot.
Myös automaattinoudolla tehdyt noudot näytetään Hakuhistoriassa. Automaattinoudossa pyynnön lähettäjänä näkyy Procountor, Admin.
Aktivoimalla yksittäisen pyynnön rivin ja painamalla Näytä pyyntö -painiketta, pääsee näkymälle, josta näkee pyynnön sisältämät palkansaajat ja verokorttien tilat.
Kaikkien taulukkojen tiedot saa avattua Excel, PDF- tai HTML -muotoon klikkaamalla hiiren kakkospainiketta taulukon rivin kohdalla ja valitsemalla haluttu tiedostomuoto.
Huomiot
Vero API -rajapinnan käyttöoikeus ja varmenteiden uusiminen
Kun Tulorekisterin sähköisessä asiointipalvelussa ennen 24.10.2024 tilattuja varmenteita uusitaan, ne eivät enää toimi Vero API -rajapinnoissa, jos varmenteelta puuttuu Vero API -rajapinnan käyttöoikeus. Ennakonpidätystietojen nouto saattaa esimerkiksi jäädä virheeseen "1005 client certificate validation failed, please check that the VeroAPI interface agreement is valid".
Varmenteen uusimisen jälkeen tulee käydä Verohallinnon varmennepalvelussa tekemässä varmenteelle korvaava rajapintahakemus, jos käytetään Vero API- rajapintoja, esimerkiksi Ennakonpidätystietojen nouto -toimintoa.
Korvaava hakemus tehdään kirjautumalla Verohallinnon varmennepalveluun (Kirjaudu: Tuotantovarmenteet) ja valitsemalla Tee korvaava hakemus sekä lisäämällä valintoihin Vero API -rajapinta. Uutta varmennetta ei tarvitse tilata. Kun Vero API -rajapinnan käyttöoikeus on aktivoitu, Verohallinto ottaa varmenteen automaattisesti käyttöön Vero APIa varten.
Tarkempia ohjeita antaa Verohallinnon asiakaspalvelu.




