Skip to content
Space Invoices Documentation

FINA Devices

FINA Devices

Manage electronic devices within business premises

Endpoints
IntroductionGET/fiscalization/fina/devices/{id}DELETE/fiscalization/fina/devices/{id}GET/fiscalization/fina/premises/{id}/devicesPOST/fiscalization/fina/premises/{id}/devices

The FINA Device object

object

Attributes

idstring
Other attributes
premise_idstring
electronic_device_namestring
is_activeboolean
created_atstring<date-time>
updated_atstring<date-time>
Examplejson
{
  "id": "fina_device_507f1f77bcf86cd799439011",
  "premise_id": "fina_premise_507f1f77bcf86cd799439011",
  "electronic_device_name": "1",
  "is_active": true,
  "created_at": "2025-01-01T00:00:00.000Z",
  "updated_at": "2025-01-01T00:00:00.000Z"
}

Get electronic device

GET/fiscalization/fina/devices/{id}

Get a single electronic device 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

Device ID

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

Returns

idstring
is_activeboolean
electronic_device_namestring
Other parameters
premise_idstring
created_atstring<date-time>
updated_atstring<date-time>
json
{
  "id": "fina_device_507f1f77bcf86cd799439011",
  "premise_id": "fina_premise_507f1f77bcf86cd799439011",
  "electronic_device_name": "1",
  "is_active": true,
  "created_at": "2025-01-01T00:00:00.000Z",
  "updated_at": "2025-01-01T00:00:00.000Z"
}

Delete electronic device

DELETE/fiscalization/fina/devices/{id}

Deactivate an electronic device.

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

Device ID

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

Returns

electronic_device_namestring

Name of the registered electronic device

Other parameters
successboolean
messagestring
json
{
  "success": true,
  "message": "Electronic device deactivated successfully",
  "electronic_device_name": "1"
}

List electronic devices

GET/fiscalization/fina/premises/{id}/devices

List all electronic devices for a business 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.

Path parameters

idstringrequired

Premise ID

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

Register electronic device

POST/fiscalization/fina/premises/{id}/devices

Register an electronic device (cash register, POS) for a business premise. Device ID must be digits only.

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

Body parameters

electronic_device_namestringrequired

Electronic device name (OznNapUr), digits only, 1-20 chars

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

Returns

electronic_device_namestring

Name of the registered electronic device

Other parameters
successboolean
messagestring
json
{
  "success": true,
  "message": "Electronic device registered successfully",
  "electronic_device_name": "1"
}