EET Certificate

Upload and manage the P12/PFX PoS certificate required for Czech EET sales registration

Upload EET certificate

POST/fiscalization/eet/settings/certificate

Upload the EET PoS P12/PFX certificate. The certificate subject CN must equal the entity DIČ and its environment (playground or production) must match the entity environment. The expiry date is extracted and the key is stored encrypted.

Request

Header parameters

entity_idstringoptional

Entity ID on which the request is made. Auto-selected when only one entity exists, required when multiple entities exist.

Body parameters

filestring<binary>required

P12/PFX certificate file

passphrasestringrequired

Certificate passphrase (will be encrypted before storage)

import SpaceInvoices from '@spaceinvoices/js-sdk/sdk';
import fs from 'fs';

const sdk = new SpaceInvoices('YOUR_API_KEY');

// Read file as Buffer
const fileBuffer = fs.readFileSync('/path/to/certificate.p12');
const file = new File([fileBuffer], 'certificate.p12', { type: 'application/x-pkcs12' });

const response = await sdk.eetCertificate.uploadEetCertificate({
  file,
  passphrase: "my-secure-passphrase"
}, { entity_id: 'YOUR_ENTITY_ID' });

console.log(response);

Response

Returns

json

{
  "certificate_expiry": "2027-05-14T09:43:39.000Z",
  "certificate_cn": "CZ683555118",
  "certificate_issuer": "CN=EETv2 NCA SubCA RSA 05/2026",
  "uploaded_at": "2026-10-27T10:30:00.000Z",
  "message": "Certificate uploaded and processed successfully"
}

Get certificate metadata

GET/fiscalization/eet/settings/certificate

Retrieve certificate metadata including expiry date and upload time. Does not return the certificate or private key.

Request

Header parameters

entity_idstringoptional

Entity ID on which the request is made. Auto-selected when only one entity exists, required when multiple entities exist.

import SpaceInvoices from '@spaceinvoices/js-sdk/sdk';

const sdk = new SpaceInvoices('YOUR_API_KEY');

const response = await sdk.eetCertificate.getEetCertificate({
  entity_id: "YOUR_ENTITY_ID"
});

console.log(response);

Response

Returns

certificate_expirystring

certificate_cnstringnullable

certificate_issuerstringnullable

uploaded_atstring

messagestring

json

{
  "certificate_expiry": "2027-05-14T09:43:39.000Z",
  "certificate_cn": "CZ683555118",
  "certificate_issuer": "CN=EETv2 NCA SubCA RSA 05/2026",
  "uploaded_at": "2026-10-27T10:30:00.000Z",
  "message": "Certificate uploaded and processed successfully"
}

Delete EET certificate

DELETE/fiscalization/eet/settings/certificate

Delete the EET certificate for the entity. The stored key and certificate are removed and the certificate expiry is cleared from the settings.

Request

Header parameters

entity_idstringoptional

Entity ID on which the request is made. Auto-selected when only one entity exists, required when multiple entities exist.

import SpaceInvoices from '@spaceinvoices/js-sdk/sdk';

const sdk = new SpaceInvoices('YOUR_API_KEY');

await sdk.eetCertificate.delete({
  entity_id: "YOUR_ENTITY_ID"
});

console.log('Deleted successfully');