Test and develop in the testing environment

You can start developing software based on the interface descriptions.

Software developers must request a testing certificate for the different interfaces of the Vero API. The testing certificate allows you to try submitting and receiving data in the Tax Administration’s testing environment, which gives you static responses. You can access the testing environment by connecting to the interfaces’ test addresses with your testing certificate.

Vero API uses the same testing certificate service as the Incomes Register. If you already have a testing certificate for the Incomes Register WebService, you do not need to request a separate certificate for Tax Administration interfaces. However, the start notification must be completed and the content of the certificate file must be sent to us (you will find address on the start notification).

How to request a testing certificate 

If you want to start testing Vero API with a testing certificate, you must do the following:

  • download and complete the testing start notification 6700 (pdf)
  • by signing the start notification and sending it to ohjelmistotalot(at)vero.fi as a PDF file, you accept the terms and conditions
  • the system starts searching for a testing certificate for you after you have submitted the notification
  • the technical contact person receives an email with instructions on how to retrieve the certificate and a secure email for generating the testing certificate
    • after the testing certificate is retrieved, send the contents of the certificate file to us as a reply to the email with the instructions for retrieval
      • the contents of the testing certificate must be Base64 coded in X.509(.cer) format (not as an attachment file)
    • we will save your testing certificate in our testing environment and inform you when you can use it.

Testing environment

You can find documentation on the interfaces of Vero API and the URL addresses for the testing environment at the following address: https://avoinomavero.vero.fi/APIPortal/

Go back to the Vero API page