Verokorttien kysely notifikaatiopalvelulla

Käyttäjä on yritys, joka hoitaa palkanlaskennan itse. Käyttäjä voi olla myös palkanlaskenta- ja tilitoimisto, joka hoitaa palkanlaskentaa yritysten puolesta.

Yrityksellä on käytössä taloushallinnan ohjelmisto, johon on rakennettu integraatiot Ennakonpidätystietojen kysely -rajapintaan sekä Push-notifikaatiopalveluun.

Ohjelmistoon on rakennettu automaattinen toimenpiteiden hallinnointi, eli ohjelmisto pystyy vastaanottamaan push-notifikaatioita Verohallinnosta. Ohjelmisto reagoi niihin hakemalla uusimmat verokortit, Ennakonpidätystietojen kysely maksajille -rajapinnalla. Ohjelmistoon on rakennettu myös kirjanpito, että mitkä notifikaatiot ja verokortit on jo käsitelty palkanlaskennassa.

Toimenpiteiden järjestys:

1. Tilaa notifikaatioita -rajapinnassa valitaan henkilöt, joiden verokortteja kysellään palkan tai muun tulon maksua varten. Tilaukseen valitaan verokortin tulotyyppi, esimerkiksi: ’Palkka’, henkilö A:n henkilötunnus sekä asiakastyyppi (henkilöasiakas), jonka uusista verokorteista halutaan vastaanottaa notifikaatioita.
2. Ohjelmistossa on käytössä Push-notifikaatiopalvelu. Ohjelmisto on tehnyt Push-rekisteröinnin ja samaan rekisteröintiin on valittu mukaan verokortti-notifikaatiotilaus, jossa henkilö A on mukana.
3. Henkilölle A luodaan verokortti Omaverossa tai asiakaspalveluna Verohallinnon järjestelmässä, jolloin verokortista muodostetaan notifikaatio asiakkaalle seuraavan vuorokauden sisällä.
4. Notifikaation avaintieto lähetetään automaattisesti Verohallinnosta samaan ohjelmistoon, jolla on aktiivinen Push-rekisteröinti ja verokorttitilaus voimassa. Avaintieto ei pidä vielä sisällään henkilötietoja, vain ainoastaan notifikaatioavaimen, jonka perusteella itse notifikaation tietosisältö voidaan hakea.
5. Ohjelmisto hakee avaintiedon perusteella, GetNotification-rajapinnalla, notifikaation tarkan tietosisällön (verokortin tulotyyppi, henkilö A:n henkilötunnus, asiakastyyppi ja verokortin voimassa alkaen-tiedon)
6. Ohjelmisto hakee notifikaation tarkan tietosisällön perusteella henkilö A:n palkan verokortin, ennakonpidätystietojen kysely -rajapinnalla.
   • Huomiona, että verokorttia ei voi kuitenkaan hakea ennakkoon, vaikka notifikaatio lähetetään ohjelmistoon sen muodostamisen jälkeen. Verokortin voi hakea vasta sitten, kun sen voimassa alkaen -tieto on ajankohtainen.
   • Esimerkiksi: Notifikaatio toimitetaan ohjelmistoon 15.6.2025. Verokortin voimassaolo alkaa vasta 1.7.2025. Verokortin voi hakea vasta 1.7.2025.
7. Ohjelmisto käyttää verokorttia palkanlaskennassa ja ennakonpidätyksen suorittamisessa Verohallinnolle. Henkilöasiakkaan ei tarvitse itse toimittaa verokorttia palkanlaskentaan.

Ohjelmisto ei kysele henkilön A:n verokortteja joka päivä, vaan ainoastaan silloin, kun notifikaatio uudesta verokortista saapuu ohjelmistoon tiedoksi. Samaan notifikaatiotilaukseen voi valita useita henkilöitä. Jokaiselle tilauksen henkilölle voi valita oikean tulotyypin, jonka verokortteja halutaan kysellä. Kaikkien tilaukseen valittujen henkilöiden verokortit haetaan palkanmaksajalle vain silloin, kun uusia muutosverokortteja on luotu.

• Lisäksi ohjelmistoon on rakennettu toiminnallisuus, jonka myötä ohjelmisto kutsuu säännöllisesti ListNotifications-rajapintaa ja tarkistaa, että kaikki notifikaatiot ovat varmasti käsitelty.
• Lisätarkistus on rakennettu ohjelmistoon, koska Verohallinto ei takaa push-notifikaatioiden perillemenoa odottamattomien virheiden takia. Virhetilanteita voivat olla esimerkiksi: huolto- tai tietoliikennekatkot tai Verohallinnon/ohjelmiston satunnaiset virheet toiminnallisuudessa .

Ohjelmisto on tehnyt notifikaatiotilauksen verokorteille. Tilaukseen on valittu henkilöt, joiden verokortteja kysellään palkan tai muun tulon maksua varten.

Yrityksen asiakkaissa tulee muutoksia ja osa henkilöistä, joille maksetaan palkkaa vaihtuvat. Ohjelmiston tulee lopettaa nykyinen verokorttitilaus 'Päätä notifikaatioiden tilaus -rajapinnalla'. Muutokset olemassa olevaan tilaukseen tehdään päättämällä ensin nykyinen tilaus ja tekemällä uusi tilaus haluttujen muutoksien kera.

Jos ohjelmisto on integroitu push-notifikaatiopalveluun, push-rekisteröinti päättyy samalla, kun notifikaatiotilaus päätetään. Ohjelmiston tulee tehdä uusi push-rekisteröinti ja valita rekisteröintiin uuden päivitetyn verokorttitilauksen tunniste. Jos ohjelmistossa on käytössä ainoastaan ListNotifications -rajapinta, vaihdetaan ListNotifications rajapintaan uuden tilauksen tunniste.

Jos notifikaatiopalvelun käyttö halutaan lopettaa kokonaan, tulee ohjelmiston tehdä edellä mainitut toimenpiteet sekä jättää uudet tilaukset tekemättä kokonaan.