Skip to content
Space Invoices Documentation

FINA Premises

FINA Premises

Manage business premises for FINA fiscalization

Endpoints
IntroductionPOST/fiscalization/fina/premisesGET/fiscalization/fina/premisesGET/fiscalization/fina/premises/{id}DELETE/fiscalization/fina/premises/{id}

The FINA Premise object

object

Attributes

idstring
Other attributes
entity_idstring
business_premise_namestring
typestring
real_estateobject
movable_premiseobject
is_activeboolean
registered_atstring<date-time>
closed_atstring<date-time>
created_atstring<date-time>
updated_atstring<date-time>
Devicesarray of objects
Examplejson
{
  "id": "fina_premise_507f1f77bcf86cd799439011",
  "entity_id": "ent_507f1f77bcf86cd799439011",
  "business_premise_name": "PP1",
  "type": "premise",
  "real_estate": null,
  "movable_premise": null,
  "is_active": true,
  "registered_at": "2025-01-01T00:00:00.000Z",
  "closed_at": null,
  "created_at": "2025-01-01T00:00:00.000Z",
  "updated_at": "2025-01-01T00:00:00.000Z"
}

Create business premise

POST/fiscalization/fina/premises

Add a business premise for FINA fiscalization. The premise must be registered on ePorezna first. Only the premise ID label is stored.

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 (OznPosPr), alphanumeric, 1-20 chars. Must match the name registered on ePorezna.

curl -X POST "https://eu.spaceinvoices.com/fiscalization/fina/premises" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-entity-id: YOUR_ENTITY_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "business_premise_name": "PP1"
  }'
Example:
Response

Returns

business_premise_namestring

Business premise name

Other parameters
successboolean
messagestring
json
{
  "success": true,
  "message": "Business premise created successfully",
  "business_premise_name": "PP1"
}

List business premises

GET/fiscalization/fina/premises

List all business premises for the entity

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.

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

Get business premise

GET/fiscalization/fina/premises/{id}

Get a single business premise by ID

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

Premise ID

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

Returns

idstring
business_premise_namestring
typestring
is_activeboolean
Other parameters
entity_idstring
real_estateobject
movable_premiseobject
registered_atstring<date-time>
closed_atstring<date-time>
created_atstring<date-time>
updated_atstring<date-time>
Devicesarray of objects
json
{
  "id": "fina_premise_507f1f77bcf86cd799439011",
  "entity_id": "ent_507f1f77bcf86cd799439011",
  "business_premise_name": "PP1",
  "type": "premise",
  "real_estate": null,
  "movable_premise": null,
  "is_active": true,
  "registered_at": "2025-01-01T00:00:00.000Z",
  "closed_at": null,
  "created_at": "2025-01-01T00:00:00.000Z",
  "updated_at": "2025-01-01T00:00:00.000Z"
}

Delete business premise

DELETE/fiscalization/fina/premises/{id}

Deactivate a business premise and all its 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

Premise ID

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

Returns

business_premise_namestring

Business premise name

Other parameters
successboolean
messagestring
json
{
  "success": true,
  "message": "Business premise deactivated successfully",
  "business_premise_name": "PP1"
}