FURS Premises

FURS Premises

Register and manage business premises (physical locations or movable units) for FURS fiscalization

Endpoints

IntroductionPOST/fiscalization/furs/premises/real-estatePOST/fiscalization/furs/premises/movableGET/fiscalization/furs/premisesGET/fiscalization/furs/premises/{id}PATCH/fiscalization/furs/premises/{id}POST/fiscalization/furs/premises/{id}/close

The FURS Premise object

object

Attributes

idstring

business_premise_namestring

typestring

is_activeboolean

real_estateobjectnullableShow child attributes

movable_premiseobjectnullableShow child attributes

Other attributesExpand all

entity_idstring

starting_numberintegernullable

can_update_starting_numberboolean

registered_atstring<date-time>

closed_atstring<date-time>nullable

created_atstring<date-time>

updated_atstring<date-time>

Devicesarray of objectsShow child attributes

Examplejson

Copy

{
  "id": "premise_507f1f77bcf86cd799439011",
  "business_premise_name": "Main Office",
  "entity_id": "ent_507f1f77bcf86cd799439011",
  "real_estate": {
    "cadastral_number": "1234",
    "building_number": "5",
    "building_section": "1",
    "street": "Dunajska cesta",
    "house_number": "22",
    "house_number_additional": "A",
    "community": "Ljubljana",
    "city": "Ljubljana",
    "postal_code": "1000"
  },
  "movable_premise": null,
  "created_at": "2025-01-01T00:00:00.000Z",
  "updated_at": "2025-01-01T00:00:00.000Z"
}

---

Register real estate premise

POST/fiscalization/furs/premises/real-estate

Register a real estate (physical location) business premise with FURS (Slovenia). Required before fiscalizing invoices from this location.

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

business_premise_namestringrequired

Business premise name/identifier (e.g., 'P1', 'TRGOVINA1')

real_estateobjectrequiredShow child attributes

Real estate (physical location) details

Other parametersExpand all

starting_numberintegeroptionalnullable

cURLNode.js SDKFetchPythonGoRubyPHP

Copy

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

const sdk = new SpaceInvoices('YOUR_API_KEY');

const response = await sdk.fursPremises.registerFursRealEstatePremise({
  business_premise_name: "STORE1",
  starting_number: 100,
  real_estate: {
    cadastral_number: "1234",
    building_number: "567",
    building_section: "1",
    street: "Dunajska cesta",
    house_number: "22",
    house_number_additional: "A",
    community: "Ljubljana",
    city: "Ljubljana",
    postal_code: "1000"
  }
});

console.log(response);

Example:

Physical StoreOffice LocationNo house number suffix

Response

Returns

business_premise_namestring

Registered business premise name

Other parametersExpand all

successboolean

messagestring

environmentstring

json

Copy

{
  "success": true,
  "message": "Business premise registered successfully",
  "business_premise_name": "STORE1",
  "environment": "production"
}

---

Register movable premise

POST/fiscalization/furs/premises/movable

Register a movable business premise (vehicle, market stall, vending machine) with FURS (Slovenia). Required before fiscalizing invoices from this premise.

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

business_premise_namestringrequired

Business premise name/identifier (e.g., 'VEHICLE1', 'STALL2')

movable_premiseobjectrequiredShow child attributes

Movable premise details

Other parametersExpand all

starting_numberintegeroptionalnullable

cURLNode.js SDKFetchPythonGoRubyPHP

Copy

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

const sdk = new SpaceInvoices('YOUR_API_KEY');

const response = await sdk.fursPremises.registerFursMovablePremise({
  business_premise_name: "TRUCK1",
  starting_number: 100,
  movable_premise: {
    premise_type: "A"
  }
});

console.log(response);

Example:

Food TruckMarket StallVending MachineMobile service vehicle

Response

Returns

business_premise_namestring

Registered business premise name

Other parametersExpand all

successboolean

messagestring

environmentstring

json

Copy

{
  "success": true,
  "message": "Business premise registered successfully",
  "business_premise_name": "TRUCK1",
  "environment": "production"
}

---

List all business premises

GET/fiscalization/furs/premises

Retrieve all registered business premises for the entity. Each premise represents a physical location or movable unit where invoices are issued.

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.

cURLNode.js SDKFetchPythonGoRubyPHP

Copy

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

const sdk = new SpaceInvoices('YOUR_API_KEY');

const response = await sdk.fursPremises.listFursBusinessPremises();

console.log(response);

Response

json

Copy

[]

---

Get a business premise

GET/fiscalization/furs/premises/{id}

Retrieve details of a specific business premise by ID, including its electronic devices.

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.

Path parameters

idstringrequired

Business premise ID

cURLNode.js SDKFetchPythonGoRubyPHP

Copy

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

const sdk = new SpaceInvoices('YOUR_API_KEY');

const response = await sdk.fursPremises.getFursBusinessPremise("premise_507f1f77bcf86cd799439011");

console.log(response);

Response

Returns

idstring

business_premise_namestring

typestring

is_activeboolean

Other parametersExpand all

entity_idstring

real_estateobjectnullableShow child attributes

movable_premiseobjectnullableShow child attributes

starting_numberintegernullable

can_update_starting_numberboolean

registered_atstring<date-time>

closed_atstring<date-time>nullable

created_atstring<date-time>

updated_atstring<date-time>

Devicesarray of objectsShow child attributes

json

Copy

{
  "id": "premise_507f1f77bcf86cd799439011",
  "business_premise_name": "Main Office",
  "entity_id": "ent_507f1f77bcf86cd799439011",
  "real_estate": {
    "cadastral_number": "1234",
    "building_number": "5",
    "building_section": "1",
    "street": "Dunajska cesta",
    "house_number": "22",
    "house_number_additional": "A",
    "community": "Ljubljana",
    "city": "Ljubljana",
    "postal_code": "1000"
  },
  "movable_premise": null,
  "created_at": "2025-01-01T00:00:00.000Z",
  "updated_at": "2025-01-01T00:00:00.000Z"
}

---

Update a business premise

PATCH/fiscalization/furs/premises/{id}

Update mutable FURS business premise settings. The starting number can only be changed before invoices have been issued for the premise-level sequence.

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.

Path parameters

idstringrequired

Business premise ID

Body parameters

starting_numberintegeroptionalnullable

cURLNode.js SDKFetchPythonGoRubyPHP

Copy

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

const sdk = new SpaceInvoices('YOUR_API_KEY');

const response = await sdk.fursPremises.update("premise_507f1f77bcf86cd799439011", {
  starting_number: 250
});

console.log(response);

Example:

Set starting numberClear starting number

Response

Returns

idstring

business_premise_namestring

typestring

is_activeboolean

Other parametersExpand all

entity_idstring

real_estateobjectnullableShow child attributes

movable_premiseobjectnullableShow child attributes

starting_numberintegernullable

can_update_starting_numberboolean

registered_atstring<date-time>

closed_atstring<date-time>nullable

created_atstring<date-time>

updated_atstring<date-time>

Devicesarray of objectsShow child attributes

json

Copy

{
  "id": "premise_507f1f77bcf86cd799439011",
  "entity_id": "ent_507f1f77bcf86cd799439011",
  "business_premise_name": "STORE1",
  "type": "real_estate",
  "real_estate": null,
  "movable_premise": null,
  "is_active": true,
  "starting_number": 250,
  "registered_at": "2025-01-01T00:00:00.000Z",
  "closed_at": null,
  "created_at": "2025-01-01T00:00:00.000Z",
  "updated_at": "2025-01-02T00:00:00.000Z"
}

---

Close business premise

POST/fiscalization/furs/premises/{id}/close

Close a previously registered business premise with FURS. This should be done when a business location is permanently closed.

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.

Path parameters

idstringrequired

Business premise ID

cURLNode.js SDKFetchPythonGoRubyPHP

Copy

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

const sdk = new SpaceInvoices('YOUR_API_KEY');

const response = await sdk.fursPremises.closeFursBusinessPremise("premise_507f1f77bcf86cd799439011");

console.log(response);

Response

Returns

business_premise_namestring

Registered business premise name

Other parametersExpand all

successboolean

messagestring

environmentstring

json

Copy

{
  "success": true,
  "message": "Business premise closed successfully",
  "business_premise_name": "STORE1",
  "environment": "production"
}

---