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