Skip to content
Space Invoices Documentation

FINA Settings

FINA Settings

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

Endpoints
IntroductionGET/fiscalization/fina/settingsPUT/fiscalization/fina/settings

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

const sdk = new SpaceInvoices('YOUR_API_KEY');

const response = await sdk.finaSettings.list();

console.log(response);
Response

Returns

enabledboolean
operator_oibstring
operator_labelstring
u_sust_pdvboolean
numbering_sequencestring
unified_numberingbooleannullable
certificate_expirystring
has_certificateboolean
certificate_statusstring
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

enabledbooleanoptional
operator_oibstringoptional
operator_labelstringoptional
u_sust_pdvbooleanoptional
numbering_sequencestringoptional
unified_numberingbooleanoptionalnullable
import SpaceInvoices from '@spaceinvoices/js-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"
});

console.log(response);
Example:
Response

Returns

enabledboolean
operator_oibstring
operator_labelstring
u_sust_pdvboolean
numbering_sequencestring
unified_numberingbooleannullable
certificate_expirystring
has_certificateboolean
certificate_statusstring
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: