Technical instructions

Download the technical instructions of the Tax Administration’s certificate service:

Tax Administration’s certificate service – a description of the PKI system and APIs

The document describes

• the parts and use of the Tax Administration’s certificate service
• the API services of the certificate service and their data content
• the test bench and its use
• examples to support use, such as example messages for retrieving and renewing certificates and creating signatures (CSR).

Further resources

The technical contact person retrieves the certificate

Certificate-specific CA packages

Packages include a simple README in English, root certificate, intermediate level certificate and publisher certificate.

CA packages for the production environment

Used in the Tax Administration, the Incomes Register and the Positive credit register

• Data providers, reporters, and notifiers (Web Service): DataProvidersIssuingCAv1-chain.cacert.zip, (ZIP)

Used in the Tax Administration and the Incomes Register

• Services of the Incomes Register and the Tax Administration: IRServicesIssuingCAv1-chain.cacert.zip, (ZIP)

Used only in the Incomes Register

• Support services outside the Incomes Register (SFTP): IRExternalDataProvidersSFTPIssuingCAv1-chain.cacert.zip, (ZIP)
• Support services outside the Incomes Register (Web service): IRExternalDataProvidersIssuingCAv1-chain.cacert.zip, (ZIP)
• Data providers (SFTP): DataProvidersSFTPIssuingCAv1-chain.cacert.zip, (ZIP)
• Providers of benefits payment data (SFTP): IRBenefitDataProvidersSFTPIssuingCAv1-chain.cacert.zip, (ZIP)
• Providers of benefits payment data (Web service): IRBenefitDataProvidersIssuingCAv1-chain.cacert.zip, (ZIP)
• Data users (SFTP): IRIncomeDataUsersSFTPIssuingCAv1.cacert.zip, (ZIP)
• Data users (Web service): IRIncomeDataUsersIssuingCAv1-chain.cacert.zip, (ZIP)

Used only in the Positive credit register

• Data users: PCR Credit Data Users Issuing CA v1

CA packages for the testing environment

Used for testing relating to the Tax Administration, the Incomes Register and the Positive credit register:

• Data providers, reporters, and notifiers: DataProvidersTestIssuingCAv1-chain.cacert.zip

Used for testing relating to the Tax Administration and the Incomes Register

• Services of the Incomes Register and the Tax Administration: IRServicesTestIssuingCAv1-chain.cacert.zip

Used only for testing relating to the Incomes Register:

1. Support services outside the Incomes Register (SFTP): IRExternalDataProvidersSFTPTestIssuingCAv1-chain.cacert.zip
2. Support services outside the Incomes Register (Web service): IRExternalDataProvidersTestIssuingCAv1-chain.cacert.zip
3. Data providers (SFTP): DataProvidersSFTPTestIssuingCAv1-chain.cacert.zip
4. Providers of benefits payment data (SFTP): IRBenefitDataProvidersSFTPTestIssuingCAv1-chain.cacert.zip 
5. Providers of benefits payment data (Web service): IRBenefitDataProvidersTestIssuingCAv1-chain.cacert.zip 
6. Data users (SFTP): IRIncomeDataUsersSFTPTestIssuingCAv1.cacert.zip
7. Data users (Web service): IRIncomeDataUsersTestIssuingCAv1-chain.cacert.zip

Used only for testing relating to the Positive credit register:

1. Data users: pcrcreditdatauserstestissuingcav2-chain.cacert.zip