Web Service interface

The Finnish Tax Administration offers taxpayers the interface to the Web-based checking features. Use it to perform computerized checks on Periodic tax return filings, Employer Payroll Report filings, annual information report filings, withholding information and income tax return filings. The checking feature looks at the technical correctness of your filings. The Web service system uses a SOAP protocol to transmit the files to be checked.

You can only use it to check up the technical compatibility, not for sending off any data. More information on submitting your filings is available at the Tax Administration'sTyvi pages.

WSDL description

Parameters for launching the service and the URL are listed in WSDL.
The attached WSDL description.

Ilmoitus parameter contains information on the tax return or other inbound return to be checked.

Kieli parameter indicates the language used. Permissible values are FI - finnish, SE - swedish and EN - english.

Tyyppi parameter indicates file type of the report. The system will send you a report on checkup results. This parameter always assumes value 1, meaning XML.

Vastaanotto parameter value is always 0.

Reply message

The SOAP response includes the checkup results. Formatted in XML, they are contained in the SOAP body. The relevant XML scheme with a description is shown below.

• XML scheme of checkup results
• Description of the scheme