FINA Settings

Configure CIS (Croatia) fiscalization settings including operator OIB, PDV system, and numbering

Get FINA settings

GET/fiscalization/fina/settings

Retrieve CIS fiscalization settings for the entity, including certificate status and configuration

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.finaSettings.list({
  entity_id: "YOUR_ENTITY_ID"
});

console.log(response);

Response

Returns

json

{
  "enabled": true,
  "operator_oib": "12345678901",
  "operator_label": "Alex Carter",
  "u_sust_pdv": true,
  "numbering_sequence": "P",
  "certificate_expiry": "2026-12-31T23:59:59.000Z",
  "certificate_status": "valid",
  "has_certificate": true
}

Example:

Update FINA settings

PUT/fiscalization/fina/settings

Update CIS fiscalization settings for the entity. Certificate must be uploaded separately via POST /fiscalization/fina/settings/certificate

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

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

const sdk = new SpaceInvoices('YOUR_API_KEY');

const response = await sdk.finaSettings.update({
  enabled: true,
  operator_oib: "12345678901",
  operator_label: "Alex Carter",
  u_sust_pdv: true,
  numbering_sequence: "P"
}, {
  entity_id: "YOUR_ENTITY_ID"
});

console.log(response);

Example:

Response

Returns

json

{
  "enabled": true,
  "operator_oib": "12345678901",
  "operator_label": "Alex Carter",
  "u_sust_pdv": true,
  "numbering_sequence": "P",
  "certificate_expiry": "2026-12-31T23:59:59.000Z",
  "certificate_status": "valid",
  "has_certificate": true
}

Example: