# Location registration

> When and how to register the location of a portable cash register: GPS coordinates, an address or free text, the registration result and FAQ.

Source: https://ekasa.ninedigit.sk/en/docs/location-registration

A **portable cash register**, for example at markets, in a taxi or when selling from a car, must have the location
registered where the business is currently taking sales. A cash register at a fixed shop does not register a
location; its address is part of the identification data.

You enter the location in one of three formats. Prefer an address or GPS coordinates; use free text only when
neither is available.

- [GPS coordinates](#gps-coordinates) (`gps`): The device knows its position.
- [Address](#address) (`address`): Selling at a place with a known address.
- [Free text](#free-text) (`other`): Neither an address nor coordinates are available, for example a vehicle registration number.

**HTTP API:**

Each format has its own address: `POST /api/v1/requests/locations/gps`, `…/address` and `…/other`.

**.NET library:**

You register all formats with the `client.RegisterLocationAsync()` method. The location type determines the format:
`GeoCoordinates`, `PhysicalAddress` or `CashRegisterOtherLocation`.

## When to register a location

```mermaid
flowchart TD
    A{Is the cash register portable?} -->|no| B[You do not register a location]
    A -->|yes| C{Does the cash register already<br/>have a registered location?}
    C -->|no| D[Register the location<br/>before the first receipt]
    C -->|yes| F{Has the place of sale changed<br/>since the last registration?}
    F -->|yes| G[Register the new location]
    F -->|no| E[The location stays valid]
```

The Act on recording sales requires the address or GPS coordinates of the place of sale (for sales from a vehicle, its registration number) to be sent to the eKasa
system before sales start; if that is not possible because of a signal outage, within 96 hours
([§ 7(8) of Act 384/2025](https://www.slov-lex.sk/ezbierky-fe/pravne-predpisy/SK/ZZ/2025/384/20260101#paragraf-7.odsek-8)).
Without a connection, the registration is stored in the queue and eKasa sends it automatically. A location does not
expire; it is valid until you register a new one.

## GPS coordinates

WGS 84 coordinates where the cash register issues receipts.

| Property | Description | Rules |
|---|---|---|
| `latitude` | latitude (north – south) | required, −90 to 90, at most 10 decimal places |
| `longitude` | longitude (east – west) | required, −180 to 180, at most 10 decimal places |

**HTTP API:**

```http
POST http://localhost:3010/api/v1/requests/locations/gps
```

```json
{
  "data": {
    "cashRegisterCode": "88812345678900001",
    "location": {
      "latitude": 48.148962,
      "longitude": 17.165377
    }
  }
}
```

**.NET library:**

```csharp
var location = new GeoCoordinates(longitude: 17.165377m, latitude: 48.148962m);

RegisterLocationResult result = await client.RegisterLocationAsync(
    new RegisterLocationRequest(new CashRegisterLocation(cashRegisterCode, location)),
    cancellationToken);
```

## Address

| Property | Description | Rules |
|---|---|---|
| `streetName` | street. If the municipality has no streets, the name of the municipality. | required, 1 – 100 characters |
| `municipality` | municipality or town | required, 1 – 100 characters |
| `buildingNumber` | street number or building name | optional, 1 – 20 characters |
| `propertyRegistrationNumber` | property registration number (súpisné číslo) | optional, 1 – 9,999,999,999 |
| `postalCode` | postcode | optional, exactly 5 digits |

Texts must not contain control characters.

**HTTP API:**

```http
POST http://localhost:3010/api/v1/requests/locations/address
```

```json
{
  "data": {
    "cashRegisterCode": "88812345678900001",
    "location": {
      "streetName": "Kresánkova",
      "buildingNumber": "12",
      "propertyRegistrationNumber": 3597,
      "municipality": "Bratislava",
      "postalCode": "84105"
    }
  }
}
```

**.NET library:**

```csharp
var location = new PhysicalAddress(
    streetName: "Kresánkova",
    municipality: "Bratislava",
    buildingNumber: "12",
    postalCode: "84105",
    propertyRegistrationNumber: 3597);

RegisterLocationResult result = await client.RegisterLocationAsync(
    new RegisterLocationRequest(new CashRegisterLocation(cashRegisterCode, location)),
    cancellationToken);
```

## Free text

If neither an address nor coordinates are available, describe the location in text of 1 to 255 characters. Typically
this is the vehicle registration number and the place, for example `Taxi ABC, EČV BA123AA, odpočívadlo Zeleneč D1`.

**HTTP API:**

```http
POST http://localhost:3010/api/v1/requests/locations/other
```

```json
{
  "data": {
    "cashRegisterCode": "88812345678900001",
    "location": {
      "value": "Taxi ABC, EČV BA123AA"
    }
  }
}
```

**.NET library:**

```csharp
var location = new CashRegisterOtherLocation("Taxi ABC, EČV BA123AA");

RegisterLocationResult result = await client.RegisterLocationAsync(
    new RegisterLocationRequest(new CashRegisterLocation(cashRegisterCode, location)),
    cancellationToken);
```

## Duplicate protection

A location registration is also sent to the eKasa system as a data message, so give it an `externalId` just like a
receipt. If the response is lost and you repeat the registration with the same `externalId`, eKasa returns the
original result instead of registering again. Details are in the article
[Duplicate protection](https://ekasa.ninedigit.sk/en/docs/receipt-registration/external-id).

**HTTP API:**

```json
{
  "data": {
    "cashRegisterCode": "88812345678900001",
    "location": {
      "latitude": 48.148962,
      "longitude": 17.165377
    }
  },
  "externalId": "location-2026-11-19-0800"
}
```

**.NET library:**

```csharp
var request = new RegisterLocationRequest(
    "location-2026-11-19-0800", new CashRegisterLocation(cashRegisterCode, location));
```

## Result

A location registration is sent to the eKasa system like a receipt, and the result has the same structure:
`isSuccessful` is `true` for an online registration, `null` for an offline registration (the location waits in the
queue) and `false` when the eKasa system rejected it. See [Registration result](https://ekasa.ninedigit.sk/en/docs/receipt-registration/result).

**HTTP API:**

You get the currently registered location with `GET /api/v1/requests/locations/current?cashRegisterCode=…`,
or you can [look it up](https://ekasa.ninedigit.sk/en/docs/receipt-lookup) like other records.

**.NET library:**

You get the currently registered location with `client.FindLatestLocationAsync(cashRegisterCode, cancellationToken)`,
or you can [look it up](https://ekasa.ninedigit.sk/en/docs/receipt-lookup) like other records.

## FAQ

**Which format should I use?**

Ideally an address or GPS coordinates. Use free text for a vehicle registration number or when no address is
available.

**Can I use several formats at once?**

No. Each registration replaces the previous one; only the last registered location is valid.

**When do I have to register a location?**

Only for a portable cash register: when it does not have a registered location yet, or when the place of sale has
changed since the last registration.

**How often do I have to change it?**

Whenever you change the place where you take sales.

**Does a location expire?**

No. It is valid until you register a new one.

**What if I do not register a location?**

The Financial Administration can find out that a portable cash register has no location, or that the location does
not match the place of sale. Failing to report the location is an administrative offence
([§ 16(i) of Act 384/2025](https://www.slov-lex.sk/ezbierky-fe/pravne-predpisy/SK/ZZ/2025/384/20260228#paragraf-16.pismeno-i)). On the first finding, the tax or customs office asks you
to remedy it; on the second, it imposes a fine of €30 to €200, and on each further finding €60 to €400
([§ 17(1)(c) and (2)(c)](https://www.slov-lex.sk/ezbierky-fe/pravne-predpisy/SK/ZZ/2025/384/20260228#paragraf-17.odsek-1.pismeno-c)).

## Where next

- [Integration scope](https://ekasa.ninedigit.sk/en/docs/integration-scope): When your software needs location registration.
- [Receipt registration](https://ekasa.ninedigit.sk/en/docs/receipt-registration): Receipt types, items, payments and the result.
- [Record lookup](https://ekasa.ninedigit.sk/en/docs/receipt-lookup): Receipts and locations by number or date.
