Skip to content
Space Invoices Documentation

FURS Premises

FURS Premises

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

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

The FURS Premise object

object

Attributes

idstring
Other attributes
entity_idstring
business_premise_namestring
typestring
real_estateobject
movable_premiseobject
is_activeboolean
registered_atstring<date>
closed_atstring<date>
created_atstring<date>
updated_atstring<date>
Devicesarray of objects
Examplejson
{
  "id": "premise_507f1f77bcf86cd799439011",
  "business_premise_name": "Main Office",
  "entity_id": "ent_507f1f77bcf86cd799439011",
  "real_estate": {
    "cadastral_number": 1234,
    "building_number": 5,
    "building_section_number": 1
  },
  "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. Optional - defaults to the first created entity if not provided.

Body parameters

business_premise_namestringrequired

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

real_estateobjectrequired

Real estate (physical location) details

curl -X POST "https://eu.spaceinvoices.com/fiscalization/furs/premises/real-estate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-entity-id: YOUR_ENTITY_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "business_premise_name": "STORE1",
    "numbering_strategy": "C",
    "real_estate": {
      "property_id": "1234-567-1",
      "cadastral_number": "1234",
      "building_number": "567",
      "building_section": "1",
      "street": "Dunajska cesta",
      "house_number": "22",
      "house_number_additional": "A",
      "community": "Ljubljana"
    }
  }'
Example:
Response

Returns

successboolean
messagestring
business_premise_namestring
environmentstring
json
{
  "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. Optional - defaults to the first created entity if not provided.

Body parameters

business_premise_namestringrequired

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

movable_premiseobjectrequired

Movable premise details

curl -X POST "https://eu.spaceinvoices.com/fiscalization/furs/premises/movable" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-entity-id: YOUR_ENTITY_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "business_premise_name": "TRUCK1",
    "numbering_strategy": "B",
    "movable_premise": {
      "premise_type": "A"
    }
  }'
Example:
Response

Returns

successboolean
messagestring
business_premise_namestring
environmentstring
json
{
  "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. Optional - defaults to the first created entity if not provided.

curl "https://eu.spaceinvoices.com/fiscalization/furs/premises" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-entity-id: YOUR_ENTITY_ID"
Response
json
[]

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. Optional - defaults to the first created entity if not provided.

Path parameters

idstringrequired

Business premise ID

curl "https://eu.spaceinvoices.com/fiscalization/furs/premises/{id}" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-entity-id: YOUR_ENTITY_ID"
Response

Returns

idstring
Other parameters
entity_idstring
business_premise_namestring
typestring
real_estateobject
movable_premiseobject
is_activeboolean
registered_atstring<date>
closed_atstring<date>
created_atstring<date>
updated_atstring<date>
Devicesarray of objects
json
{
  "id": "premise_507f1f77bcf86cd799439011",
  "business_premise_name": "Main Office",
  "entity_id": "ent_507f1f77bcf86cd799439011",
  "real_estate": {
    "cadastral_number": 1234,
    "building_number": 5,
    "building_section_number": 1
  },
  "movable_premise": null,
  "created_at": "2025-01-01T00:00:00.000Z",
  "updated_at": "2025-01-01T00: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. Optional - defaults to the first created entity if not provided.

Path parameters

idstringrequired

Business premise ID

curl -X POST "https://eu.spaceinvoices.com/fiscalization/furs/premises/{id}/close" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-entity-id: YOUR_ENTITY_ID"
Response

Returns

successboolean
messagestring
business_premise_namestring
environmentstring
json
{
  "success": true,
  "message": "Business premise closed successfully",
  "business_premise_name": "STORE1",
  "environment": "production"
}