Etusivulle Ilmoitin.fi  

Web service -rajapinta

Verohallinto tarjoaa rajapinnan aineiston tarkastuspalveluun, jonka kautta voit tarkastaa kausivero-, vuosi- ja valvontailmoitusten, suorasiirtojen sekä tuloveroilmoitusten muodollisen oikeellisuuden. Palvelu perustuu Web service -teknologiaan, jossa aineisto välitetään tarkastettavaksi SOAP-protokollaa käyttäen.

Palvelu on tarkoitettu vain aineiston muodollisen oikeellisuuden tarkastamiseen, eikä tarkastettavaa aineistoa siirretä eteenpäin. Aineiston siirrosta verohallintoon saat tietoa verohallinnonTYVI-sivuilta.


WSDL-kuvaus

WSDL:ssä on kuvattu palvelun kutsumiseen tarvittavat parametrit ja palvelun osoite.
Ohessa palvelun WSDL-kuvaus.

Ilmoitus parametri sisältää tarkastettavan ilmoituksen tiedot.

Kieli parametri kertoo ilmoituksen kielen. Sallittuja arvoja ovat FI - suomi, SE - ruotsi ja EN - englanti.

Tyyppi parametri kertoo minkä tyyppisenä järjestelmä palauttaa tarkastuksen tuloksen. Parametrin arvo on aina 1 , eli XML.

Vastaanotto parametrin arvo on aina 0.


Vastaussanoma

Vastaussanomassa eli SOAP-responsessa palautetaan aineiston tarkastuksen tulos. Tarkastustulos palautetaan SOAP-bodyssa XML-muodossa. Alla tarkastustuloksen XML-skeema sekä kuvaus skeeman rakenteesta