Getting Access
Getting a developer certificate
Vero API uses the same certificate service as the Incomes Register. If you have an Incomes Register data provider test certificate for web service, please proceed to Getting access to the development endpoint section.
Review the service documentation Certificate service – General description
To apply for a developer certificate fill form 6700 (pdf). Pay special attention to the technical contact details. They will be used in an automated process to generate the certificate.
- use the international format for phone numbers (+358)
- select “the artificial Business ID to be used during testing” in section 2
- read the terms and conditions of use (only in Finnish)
- complete the form, sign it, scan it to .pdf-format and email to ohjelmistotalot(at)vero.fi
The technical process instruction are in Chapter 3.1 of the Certificate service – General description. During the registration process, transfer IDs and other communication are sent to the technical contact details provided in the form 6700. You need to use these IDs to fetch the certificates.
If you have questions review, the Certificate service FAQ. If there are further question contact ohjelmistotalot(at)vero.fi
Getting access to the development endpoint
Save the certificate in Base64-encoded X-509 (.cer) -format and send it in the email body (not as an attachment) to ohjelmistotalot(at)vero.fi
You will receive a confirmation email when you have access to the development endpoint. With access you can then make calls to the test endpoints in the API Portal.
Example: How you can call our ValidateTaxNumber API
When you are in that point that you have access to the developer endpoint, here is example how you can call our ValidateTaxNumber API with a standard tool like curl. Curl is available on all platforms.
Example how you can validate access to the API with curl.
curl.exe -k -w "\n%{time_total};%{time_namelookup};%{time_connect};%{time_appconnect};%{time_starttransfer};%{http_code};%{url_effective}" --cert svapidp-ok.crt --key svapidp-ok.keyn--request POST --data "{\"TaxNumber\":\"200000000001\"}" --header "Content-Type: application/json" --header "Vero-SoftwareId:12345678_00 " -s https://pintatesti.vero.fi/FIS/Customer/IDs/Test/ValidateTaxNumber/v1
Before you use this call, please replace red texts as told here:
- svapidp-ok.crt = replace this with your own public key
- svapidp-ok.keyn = replace this with your own private key
- 200000000001 = this is test tax number you can use
- 12345678_00 = your business id and make sure there is also this _00
If you replace the cert & key with your own, you should get the same result as we get here. It also documents what is needed in the header.