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.
API access request and testing certificate
Request API access for testing and a testing certificate in the Testing certificates section of the Tax Administration’s certificate service.
API access request and testing certificate
-
1
Log in to the service
-
The Testing certificates section of the Tax Administration’s certificate service is for requesting API access and testing certificates needed in testing.
Identify yourself with your online banking codes, mobile certificate or certificate card. You do not need a Suomi.fi authorisation.
- When you log in for the first time, enter your email address and telephone number.
- You will receive a message asking you to confirm your email address. You can continue to the service after you have confirmed the address.
-
2
Request API access for testing
-
Select Vero API from the Tax Administration APIs and enter the information requested by the service.
-
3
Request a testing certificate
-
Select “Request a new testing certificate” in the e-service and enter the information requested by the service.
-
4
The testing certificate is retrieved by a technical contact person
-
A technical contact person is responsible for retrieving the certificate and adding the certificate content to the software
Once you have submitted a certificate request, the technical contact person specified in the request will receive the information required to retrieve the certificate. After this, the certificate must be retrieved within 14 days.
- After the testing certificate has been retrieved, send the certificate content to us as a reply to the email message that informed you of the acceptance of your request for API access.
- Send the certificate content to us as text in the form you received it from the certificate service in the <Certificate> tag (as Base64-encoded text, not as an attachment file or a pfx/p12 file).
- Never send anyone your private key – keep it protected.
- We will save your testing certificate in our testing environment and inform you when you can start using it.
-
If the certificate is not retrieved within 14 days, request a new certificate in the Tax Administration’s certificate service and send the content of the testing certificate by email to ohjelmistotalot(at)vero.fi.
Read more:
The Tax Administration's certificate service
Testing certificates
Testing environment
Documentation for Vero APIs and test environment URLs can be found on the Vero API portal.
Instructions for renewing a test certificate
The instructions describe one way to perform the renewal of a certificate issued by the Tax Administration using the web service interface of the Tax Administration's certificate service. Based on the example, certificate renewal can be implemented to your own software.
The renewal of a testing certificate described in the instructions also applies to the renewal of a production certificate.
In the case of production certificates, actual customer data and the certificate service’s production address (URL) must be used.
- The content of the renewed testing certificate must be sent by email to ohjelmistotalot(at)vero.fi in order that the renewed certificate could be use in the testing environment.
- If your testing certificate has expired, you must request a new testing certificate from the Tax Administration’s certificate service. The content of the new testing certificate must be sent by email to ohjelmistotalot(at)vero.fi in order that the new certificate could be used in the testing environment.