FURS Certificate

Upload and manage the P12/PFX certificate required for FURS fiscalization

Upload FURS certificate

POST/fiscalization/furs/settings/certificate

Upload a P12/PFX certificate for FURS fiscalization. The certificate will be processed to extract expiry date and stored securely. The passphrase will be encrypted before storage. Certificate is entity-specific and required for fiscalizing invoices.

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

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

const sdk = new SpaceInvoices('YOUR_API_KEY');

// Read file as Buffer
const fileBuffer = fs.readFileSync('/path/to/image.png');
const file = new File([fileBuffer], 'image.png', { type: 'image/png' });

const response = await sdk.fursCertificate.uploadFursCertificate({
  file,
  passphrase: "string"
});

console.log(response);

Response

Returns

certificate_expirystring<date-time>

messagestring

json

{
  "certificate_expiry": "2025-12-31T23:59:59.000Z",
  "certificate_cn": "12345678",
  "certificate_issuer": "SIGOV-CA2",
  "uploaded_at": "2025-01-15T10:30:00.000Z",
  "message": "Certificate uploaded and validated successfully"
}

Get certificate metadata

GET/fiscalization/furs/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';

const sdk = new SpaceInvoices('YOUR_API_KEY');

const response = await sdk.fursCertificate.getFursCertificate();

console.log(response);

Response

Returns

certificate_expirystring

certificate_cnstringnullable

certificate_issuerstringnullable

uploaded_atstring

messagestring

json

{
  "certificate_expiry": "2025-12-31T23:59:59.000Z",
  "certificate_cn": "12345678",
  "certificate_issuer": "SIGOV-CA2",
  "uploaded_at": "2025-01-15T10:30:00.000Z",
  "message": "Certificate uploaded and validated successfully"
}

Delete FURS certificate

DELETE/fiscalization/furs/settings/certificate

Delete the FURS certificate for the entity. This will remove both the uploaded file reference and the extracted certificate from the database.

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';

const sdk = new SpaceInvoices('YOUR_API_KEY');

await sdk.fursCertificate.delete();

console.log('Deleted successfully');