The response to failed request
Error message categories
General instructions when error messages occur


Send one message at a time and wait for Netvisor's Web Service Interface to respond before you send the next message. Overlapping messages to the same customer environment cause different errors. We recommend that the timeout for messages is at least 120 000 ms. This helps in avoiding unnecessary errors.

Log and follow Web Service Interface traffic, including errors. The requests should be recorded transaction based. If the Web Service Interface does not respond it is recommended that you try to send the message a few times and then take a longer break. Controlling errors should be done in the external system and the error description received from Netvisor's Web Service Interface should be saved and shown as it is.

If you need help in interpreting error messages you can contact our partner support in

The response to failed request

If there are errors in handling the request, the Web Service Interface returns <Status>FAILED</Status> in ResponseStatus-element. Here's an example of a response to a failed request:

<Status> AUTHENTICATION_FAILED :: Integration keys are not valid. Please check the keys specific to the user and partner.</Status>
        <TimeStamp>01.01.2018 12:00:00</TimeStamp>

Error message categories

Authentication of the request failed. Check the credentials, HTTP-headers and MAC-calculation.

The sent data is invalid or of wrong size. Check the material and given parameters.

The sent data already exists in Netvisor. Check the material and given parameters.

The transaction ID has already been used. The ID must change in every request.

The accounting period is locked and material can not be imported before opening the period in Netvisor.

No access rights or the application where the material is imported/retreived is not in use.

System is under maintenance. During maintenance requstes can not be made.

Other error caused by a technical error. The response message returns only error category and error identifier without any further explanation. Technical errors should also be logged. Using the error identifier our partner support and maintenance can help in figuring out the error.

General instructions when error messages occur

Please read the more detailed description of the error from the error message.
Make sure the syntax is correct:

  • The given elements are in the same order as in the resource DTD.
  • All compulsory elements are given.
  • All compulsory elements have a value.
  • All tags have a counterpart.

a) Importing working hours:

INVALID_DATA :: Data form incorrect:. Entry type not found with given allocation data. 

An entry type with the same number as the collector ratio number is needed (e.g. <CollectorRatio type="number">123</CollectorRatio> -> add an entry type with number 123). The entry types can be added in Netvisor UI and instructions in Finnish can be found here. When working hours are imported, check the entry types forms so that the hours will appear on the pay slip. This should always be tested in the test environment.

b) Importing sales invoices:

INVALID_DATA :: Data form incorrect:. VAT code cannot be retrieved from posting suggestion because no posting suggestion has been given.

The error appears because VAT code is not given in the invoice row. When the VAT code is not given, the system tries to find VAT code from the account suggested in the element accountingAccountSuggestion. When no account is given in that element, an error is returned. VAT code should always be given in the invoice row. Also note that the VAT percentage should also be given.


AUTHENTICATION_FAILED :: Integraatioavaimet eivät kelpaa. Ole hyvä ja tarkista käyttäjä- ja kumppanikohtaiset avaimet.
AUTHENTICATION_FAILED :: Integration keys are not valid. Please check the keys specific to the user and partner.

a) The user (userID) given in HTTP-header 'X-Netvisor-Authentication-CustomerId' does not exsist or is not active.
b) The partner (partnerID) given in HTTP-header 'X-Netvisor-Authentication-PartnerId' is not found.


SERVICE_ACCESS_ERROR :: Palveluvirhe. Yritys on estänyt pääsyn rajapintaresurssiin: X
SERVICE_ACCESS_ERROR :: Service error. The company has restricted access to the interface resource: X
The API interface resource 'X' mentioned in the error message is not allowed in Netvisor, enable the API interface resource as instructed


TECHNICAL_ERROR :: Error when handling material:. Error identifier: 00001

An error in handling material caused by some other technical error. Contact partner support ( for help in solving the error.

Tunnistautuminen epäonnistui

Company not found or no access granted. See documentation. This error is returned when the user doesn't have access right to target company's Netvisor environment or the company is no longer active in Netvisor. In this case, make sure if the user has access rights to target company's Netvisor environment and if the company is still active in Netvisor.

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.