Renewing a certificate
Many payroll and benefit software products are able to use the Incomes Register API. Check from your software supplier how to renew the certificate in the program you are using. Software products have different practises for maintaining certificates.
A certificate is valid for 2 years, after which it must be renewed. You can check the validity of your organisation’s certificate in the certificate. The organisation's representative can also check the validity of the certificate in the Incomes Register's e-service.
The certificate’s technical contact person will receive an email reminder 60 days before the certificate expires. Keep the contact person’s information updated. You can change the email address in the Incomes Register's e-service.
You can renew a certificate at the earliest 60 days before its expiry. If the certificate expires, the technical interface can no longer be used. Each organisation is responsible for renewing their certificate.
The certificate is renewed in the certificate service’s API
To renew a certificate, use your software to send a service call to the certificate service’s API. Not all software includes this feature. Check your situation from your software supplier.
The certificate service’s API features a separate service for renewing certificates (RenewCertificate). When you want to renew a certificate, do this:
- Create a new key pair.
- Generate a certificate signing request.
- Sign the service call using a key related to the valid certificate and send it.
You cannot renew your certificate in the Incomes Register's e-service.
If renewal of a certificate is not possible, request a new certificate
If your organisation’s certificate cannot be renewed using your software or it expires, request a new certificate for your organisation in the Incomes Register’s e-service. The new certificate is retrieved in the same way as the first certificate.
Submit an interface application ja request a certificate in the Incomes Register's e-service
For further instructions, see the certificate service’s technical documents
Certificate service - General description (pdf)
-
- Life cycle and renewal of certificates: section 3.4
- Requesting a new certificate: section 3.2
Certificate service - Interface description (pdf)
-
- The document describes the technical functionalities and schemas used in requesting, retrieving and renewing the certificate.
- The schemas used in renewing the certificate: section 3.3–
- The schemas used in requesting a new certificate: section 3.1–