Skip to content

Location

Method Endpoint Description
GET /api/location/get Get last location
POST /api/location/update Update location

Get last location

GET /api/location/get

Get last location

Responses

200 — Location of the portable cash register.

Media Type Schema
application/json LocationResponse

404 — Location not set

Media Type Schema
application/json ErrorResponse
Examples (application/json)
Location not found

Returned if the recent location is not found in the CHDÚ. Either the CHDÚ isn't indexed (in this case there is a hard search limit) or the location hasn't been set yet.

{
  "resultCode": 506,
  "error": "Location not found"
}

500 — An error occurred (for example CHDU got disconnected)

Media Type Schema
application/json ErrorResponse

Update location

POST /api/location/update

Update cash register location

Request Body

Required.

Location data

Media Type Schema
*/* UpdateLocationRequest

Examples (*/*)

Physical address entry

Updates the current sale location to specific address.

{
  "physicalAddress": {
    "country": "Slovenská Republika",
    "municipality": "Bratislava",
    "street": "Heydukova",
    "buildingNumber": "2155",
    "propertyRegistrationNumber": "6",
    "postalCode": "81108"
  }
}
GPS coordinates entry

Updates the current sale location to a location with specified coordinates.

{
  "gps": {
    "x": 17.112415,
    "y": 48.1467828
  }
}
Text entry

Updates the current sale location by the text entry, for example a taxi licence plate number.

{
  "other": "Taxi SPZ AB12345"
}
Fix a stuck entry

Fixes the last location which wasn't accepted by the SFS.

{
  "fixLocation": {
    "createDate": "03.09.2025 16:56:02",
    "gps": {
      "x": 17.1427408,
      "y": 48.1455817
    },
    "useLastMerchant": true
  }
}

Responses

500 — An error occurred...

default — Standard response

Media Type Schema
application/json LocationResponse