BusinessPremise

The BusinessPremise object is designed to work in conjunction with FINA (Croatian Financial Agency) and FURS (Slovenian Financial Administration) real-time reporting systems, allowing organizations to register the locations where invoices are issued. This ensures compliance with the specific fiscal regulations in Croatia and Slovenia, as these countries require businesses to report their invoicing premises for accurate and transparent financial reporting.

Please note that for FINA, the BusinessPremise must also be registered manually on the FINA website. After registering, you will receive an ID for the registered BusinessPremise. This ID (and no other data) should then be added to the BusinessPremise within Space Invoices. This ensures that your BusinessPremise is correctly linked to the appropriate location in both the FINA system and Space Invoices, maintaining compliance with Croatian fiscal regulations.

Endpoints:

  • POST /v1/Organizations/:id/businessPremises
  • GET /v1/Organizations/:id/businessPremises
  • PATCH /v1/BusinessPremises/:id
  • DELETE /v1/BusinessPremises/:id
  • POST /v1/BusinessPremises/:id/electronicDevices

The BusinessPremise object

Parameters

  • id string readonly

  • type string

  • taxNumber string

    Tax number of responsible person on premise

  • businessPremiseId string

  • premiseType string

  • cadastralNumber number

  • buildingNumber number

  • buildingSectionNumber number

  • street string

  • houseNumber string

  • houseNumberAdditional string

  • community string

  • city string

  • postalCode string

  • numbers object

  • provider string

    The fiscalization provider the premise belongs to

  • environment string

  • organizationId string

    • Additional propertiesExpand all 
    
      {
  "type": "string",
  "taxNumber": "string",
  "businessPremiseId": "string",
  "premiseType": "string",
  "cadastralNumber": 42,
  "buildingNumber": 42,
  "buildingSectionNumber": 42,
  "street": "string",
  "houseNumber": "string",
  "houseNumberAdditional": "string",
  "community": "string",
  "city": "string",
  "postalCode": "string",
  "numbers": {},
  "provider": "furs",
  "environment": "production",
  "id": "string",
  "organizationId": "string",
  "createdAt": "2022-04-20T10:10:30+00:00Z",
  "updatedAt": "2022-04-20T10:10:30+00:00Z",
  "custom": {},
  "deletedAt": "2022-04-20T10:10:30+00:00Z",
  "_isDeleted": false,
  "deletedId": "string"
}

Create BusinessPremise

POST /v1/Organizations/:id/businessPremises

Parameters

Path

  • id string required

    Organization id

Properties

  • businessPremiseId string required

  • type string optional

  • taxNumber string optional

    Tax number of responsible person on premise

  • premiseType string optional

  • cadastralNumber number optional

  • buildingNumber number optional

  • buildingSectionNumber number optional

  • street string optional

  • houseNumber string optional

  • houseNumberAdditional string optional

  • community string optional

  • city string optional

  • postalCode string optional

  • numbers object optional

  • provider string optional

    Default is: furs

    The fiscalization provider the premise belongs to

  • environment string optional

    Default is: production

  • organizationId string optional

    • Additional propertiesExpand all 
      
        const response = await fetch('https://api.spaceinvoices.com/v1/Organizations/{id}/businessPremises', {
  method: 'POST',
  headers: {
    'Authorization': 'ACCESS_TOKEN',
    'content-type': 'application/json'
  },
  body: JSON.stringify({
    type: 'string',
    taxNumber: 'string',
    businessPremiseId: 'string',
    premiseType: 'string',
    cadastralNumber: 42,
    buildingNumber: 42,
    buildingSectionNumber: 42,
    street: 'string',
    houseNumber: 'string',
    houseNumberAdditional: 'string',
    community: 'string',
    city: 'string',
    postalCode: 'string',
    numbers: {},
    provider: 'furs',
    environment: 'production',
    organizationId: 'string',
    custom: {}
  })
});

Your access token is displayed in examples.

Prerequisite: npm install node-fetch

        
          curl -X POST https://api.spaceinvoices.com/v1/Organizations/{id}/businessPremises \
  -H 'Authorization: ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "type": "string", \
    "taxNumber": "string", \
    "businessPremiseId": "string", \
    "premiseType": "string", \
    "cadastralNumber": 42, \
    "buildingNumber": 42, \
    "buildingSectionNumber": 42, \
    "street": "string", \
    "houseNumber": "string", \
    "houseNumberAdditional": "string", \
    "community": "string", \
    "city": "string", \
    "postalCode": "string", \
    "numbers": {}, \
    "provider": "furs", \
    "environment": "production", \
    "organizationId": "string", \
    "custom": {}
  }'

Your access token displayed in examples.

        
          import requests
url = 'https://api.spaceinvoices.com/v1/Organizations/{id}/businessPremises'
headers = {
  'Authorization': 'ACCESS_TOKEN',
  'content-type': 'application/json',
}
params = {
  'type': 'string',
  'taxNumber': 'string',
  'businessPremiseId': 'string',
  'premiseType': 'string',
  'cadastralNumber': 42,
  'buildingNumber': 42,
  'buildingSectionNumber': 42,
  'street': 'string',
  'houseNumber': 'string',
  'houseNumberAdditional': 'string',
  'community': 'string',
  'city': 'string',
  'postalCode': 'string',
  'numbers': {},
  'provider': 'furs',
  'environment': 'production',
  'organizationId': 'string',
  'custom': {}
}
response = requests.post(url, json=params, headers=headers)

Your access token displayed in examples.

Response:

    
      {
  "type": "string",
  "taxNumber": "string",
  "businessPremiseId": "string",
  "premiseType": "string",
  "cadastralNumber": 42,
  "buildingNumber": 42,
  "buildingSectionNumber": 42,
  "street": "string",
  "houseNumber": "string",
  "houseNumberAdditional": "string",
  "community": "string",
  "city": "string",
  "postalCode": "string",
  "numbers": {},
  "provider": "furs",
  "environment": "production",
  "id": "string",
  "organizationId": "string",
  "createdAt": "2022-04-20T10:10:30+00:00Z",
  "updatedAt": "2022-04-20T10:10:30+00:00Z",
  "custom": {},
  "deletedAt": "2022-04-20T10:10:30+00:00Z",
  "_isDeleted": false,
  "deletedId": "string"
}

Find BusinessPremises

GET /v1/Organizations/:id/businessPremises

Parameters

Path

  • id string required

    Organization id

Query

  • filter string optional 

      
        const response = await fetch('https://api.spaceinvoices.com/v1/Organizations/{id}/businessPremises', {
  method: 'GET',
  headers: {
    'Authorization': 'ACCESS_TOKEN',
    'content-type': 'application/json'
  }
});

Your access token is displayed in examples.

Prerequisite: npm install node-fetch

        
          curl -X GET https://api.spaceinvoices.com/v1/Organizations/{id}/businessPremises \
  -H 'Authorization: ACCESS_TOKEN' \
  -H 'Content-Type: application/json'

Your access token displayed in examples.

        
          import requests
url = 'https://api.spaceinvoices.com/v1/Organizations/{id}/businessPremises'
headers = {
  'Authorization': 'ACCESS_TOKEN',
  'content-type': 'application/json',
}
response = requests.get(url, params={}, headers=headers)

Your access token displayed in examples.

Response:

    
      [
  {
    "type": "string",
    "taxNumber": "string",
    "businessPremiseId": "string",
    "premiseType": "string",
    "cadastralNumber": 42,
    "buildingNumber": 42,
    "buildingSectionNumber": 42,
    "street": "string",
    "houseNumber": "string",
    "houseNumberAdditional": "string",
    "community": "string",
    "city": "string",
    "postalCode": "string",
    "numbers": {},
    "provider": "furs",
    "environment": "production",
    "id": "string",
    "organizationId": "string",
    "createdAt": "2022-04-20T10:10:30+00:00Z",
    "updatedAt": "2022-04-20T10:10:30+00:00Z",
    "custom": {},
    "deletedAt": "2022-04-20T10:10:30+00:00Z",
    "_isDeleted": false,
    "deletedId": "string"
  }
]

Patch BusinessPremise

PATCH /v1/BusinessPremises/:id

Parameters

Path

  • id string required

    BusinessPremise id

Properties

  • businessPremiseId string required

  • type string optional

  • taxNumber string optional

    Tax number of responsible person on premise

  • premiseType string optional

  • cadastralNumber number optional

  • buildingNumber number optional

  • buildingSectionNumber number optional

  • street string optional

  • houseNumber string optional

  • houseNumberAdditional string optional

  • community string optional

  • city string optional

  • postalCode string optional

  • numbers object optional

  • provider string optional

    Default is: furs

    The fiscalization provider the premise belongs to

  • environment string optional

    Default is: production

  • organizationId string optional

    • Additional propertiesExpand all 
      
        const response = await fetch('https://api.spaceinvoices.com/v1/BusinessPremises/{id}', {
  method: 'PATCH',
  headers: {
    'Authorization': 'ACCESS_TOKEN',
    'content-type': 'application/json'
  },
  body: JSON.stringify({
    type: 'string',
    taxNumber: 'string',
    businessPremiseId: 'string',
    premiseType: 'string',
    cadastralNumber: 42,
    buildingNumber: 42,
    buildingSectionNumber: 42,
    street: 'string',
    houseNumber: 'string',
    houseNumberAdditional: 'string',
    community: 'string',
    city: 'string',
    postalCode: 'string',
    numbers: {},
    provider: 'furs',
    environment: 'production',
    organizationId: 'string',
    custom: {}
  })
});

Your access token is displayed in examples.

Prerequisite: npm install node-fetch

        
          curl -X PATCH https://api.spaceinvoices.com/v1/BusinessPremises/{id} \
  -H 'Authorization: ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "type": "string", \
    "taxNumber": "string", \
    "businessPremiseId": "string", \
    "premiseType": "string", \
    "cadastralNumber": 42, \
    "buildingNumber": 42, \
    "buildingSectionNumber": 42, \
    "street": "string", \
    "houseNumber": "string", \
    "houseNumberAdditional": "string", \
    "community": "string", \
    "city": "string", \
    "postalCode": "string", \
    "numbers": {}, \
    "provider": "furs", \
    "environment": "production", \
    "organizationId": "string", \
    "custom": {}
  }'

Your access token displayed in examples.

        
          import requests
url = 'https://api.spaceinvoices.com/v1/BusinessPremises/{id}'
headers = {
  'Authorization': 'ACCESS_TOKEN',
  'content-type': 'application/json',
}
params = {
  'type': 'string',
  'taxNumber': 'string',
  'businessPremiseId': 'string',
  'premiseType': 'string',
  'cadastralNumber': 42,
  'buildingNumber': 42,
  'buildingSectionNumber': 42,
  'street': 'string',
  'houseNumber': 'string',
  'houseNumberAdditional': 'string',
  'community': 'string',
  'city': 'string',
  'postalCode': 'string',
  'numbers': {},
  'provider': 'furs',
  'environment': 'production',
  'organizationId': 'string',
  'custom': {}
}
response = requests.patch(url, json=params, headers=headers)

Your access token displayed in examples.

Response:

    
      {
  "type": "string",
  "taxNumber": "string",
  "businessPremiseId": "string",
  "premiseType": "string",
  "cadastralNumber": 42,
  "buildingNumber": 42,
  "buildingSectionNumber": 42,
  "street": "string",
  "houseNumber": "string",
  "houseNumberAdditional": "string",
  "community": "string",
  "city": "string",
  "postalCode": "string",
  "numbers": {},
  "provider": "furs",
  "environment": "production",
  "id": "string",
  "organizationId": "string",
  "createdAt": "2022-04-20T10:10:30+00:00Z",
  "updatedAt": "2022-04-20T10:10:30+00:00Z",
  "custom": {},
  "deletedAt": "2022-04-20T10:10:30+00:00Z",
  "_isDeleted": false,
  "deletedId": "string"
}

Delete BusinessPremise

DELETE /v1/BusinessPremises/:id

Parameters

Path

  • id string required

    Model id

      
        const response = await fetch('https://api.spaceinvoices.com/v1/BusinessPremises/{id}', {
  method: 'DELETE',
  headers: {
    'Authorization': 'ACCESS_TOKEN',
    'content-type': 'application/json'
  }
});

Your access token is displayed in examples.

Prerequisite: npm install node-fetch

        
          curl -X DELETE https://api.spaceinvoices.com/v1/BusinessPremises/{id} \
  -H 'Authorization: ACCESS_TOKEN' \
  -H 'Content-Type: application/json'

Your access token displayed in examples.

        
          import requests
url = 'https://api.spaceinvoices.com/v1/BusinessPremises/{id}'
headers = {
  'Authorization': 'ACCESS_TOKEN',
  'content-type': 'application/json',
}
response = requests.delete(url, params={}, headers=headers)

Your access token displayed in examples.

Response:

    
      {
  "count": 1
}

Create BusinessPremise

POST /v1/BusinessPremises/:id/electronicDevices

Parameters

Path

  • id string required

    BusinessPremise id

Properties

  • electronicDeviceId string required

  • numbers object optional

  • provider string optional

    Default is: furs

  • environment string optional

    Default is: production

  • businessPremiseId string optional

  • organizationId string optional

    • Additional propertiesExpand all 
      
        const response = await fetch('https://api.spaceinvoices.com/v1/BusinessPremises/{id}/electronicDevices', {
  method: 'POST',
  headers: {
    'Authorization': 'ACCESS_TOKEN',
    'content-type': 'application/json'
  },
  body: JSON.stringify({
    electronicDeviceId: 'string',
    numbers: {},
    provider: 'furs',
    environment: 'production',
    businessPremiseId: 'string',
    organizationId: 'string',
    custom: {}
  })
});

Your access token is displayed in examples.

Prerequisite: npm install node-fetch

        
          curl -X POST https://api.spaceinvoices.com/v1/BusinessPremises/{id}/electronicDevices \
  -H 'Authorization: ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "electronicDeviceId": "string", \
    "numbers": {}, \
    "provider": "furs", \
    "environment": "production", \
    "businessPremiseId": "string", \
    "organizationId": "string", \
    "custom": {}
  }'

Your access token displayed in examples.

        
          import requests
url = 'https://api.spaceinvoices.com/v1/BusinessPremises/{id}/electronicDevices'
headers = {
  'Authorization': 'ACCESS_TOKEN',
  'content-type': 'application/json',
}
params = {
  'electronicDeviceId': 'string',
  'numbers': {},
  'provider': 'furs',
  'environment': 'production',
  'businessPremiseId': 'string',
  'organizationId': 'string',
  'custom': {}
}
response = requests.post(url, json=params, headers=headers)

Your access token displayed in examples.

Response:

    
      {
  "electronicDeviceId": "string",
  "numbers": {},
  "provider": "furs",
  "environment": "production",
  "id": "string",
  "businessPremiseId": "string",
  "organizationId": "string",
  "createdAt": "2022-04-20T10:10:30+00:00Z",
  "updatedAt": "2022-04-20T10:10:30+00:00Z",
  "custom": {}
}