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 is extracted, then verified with a live probe against the FURS authority for the entity's environment, and is stored securely only after that probe succeeds; the passphrase is encrypted before storage. Responds with 400 when FURS rejects the supplied certificate, and with 500 when FURS, its gateway, or the network cannot complete the verification (including a probe timeout) - retry later in that case. Nothing is persisted on failure. 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/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.fursCertificate.uploadFursCertificate({
  file,
  passphrase: "cert-password"
}, { entity_id: 'YOUR_ENTITY_ID' });

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

const sdk = new SpaceInvoices('YOUR_API_KEY');

const response = await sdk.fursCertificate.getFursCertificate({
  entity_id: "YOUR_ENTITY_ID"
});

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

const sdk = new SpaceInvoices('YOUR_API_KEY');

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

console.log('Deleted successfully');