# Registrácia polohy

> Kedy a ako zaregistrovať polohu prenosnej pokladnice: GPS súradnice, adresa alebo voľný text, výsledok registrácie a časté otázky.

Zdroj: https://ekasa.ninedigit.sk/docs/location-registration

**Prenosná pokladnica**, napríklad na trhoch, v taxíku alebo pri predaji z auta, musí mať zaregistrovanú polohu,
kde podnikateľ práve prijíma tržby. Pokladnica na stálej prevádzke polohu neregistruje, jej adresa je
v identifikačných údajoch.

Polohu zadáte jedným z troch formátov. Uprednostnite adresu alebo GPS súradnice, voľný text použite len vtedy, keď
ani jedno nie je k dispozícii.

- [GPS súradnice](#gps-súradnice) (`gps`): Zariadenie pozná svoju polohu.
- [Adresa](#adresa) (`address`): Predaj na mieste so známou adresou.
- [Voľný text](#voľný-text) (`other`): Adresa ani súradnice nie sú, napríklad evidenčné číslo vozidla.

**HTTP API:**

Každý formát má vlastnú adresu: `POST /api/v1/requests/locations/gps`, `…/address` a `…/other`.

**.NET knižnica:**

Všetky formáty registrujete metódou `client.RegisterLocationAsync()`. Formát určí typ polohy: `GeoCoordinates`,
`PhysicalAddress` alebo `CashRegisterOtherLocation`.

## Kedy polohu registrovať

```mermaid
flowchart TD
    A{Je pokladnica prenosná?} -->|nie| B[Polohu neregistrujete]
    A -->|áno| C{Má pokladnica už<br/>zaregistrovanú polohu?}
    C -->|nie| D[Zaregistrujte polohu<br/>pred prvým dokladom]
    C -->|áno| F{Zmenilo sa miesto predaja<br/>od poslednej registrácie?}
    F -->|áno| G[Zaregistrujte novú polohu]
    F -->|nie| E[Poloha platí ďalej]
```

Zákon o evidencii tržieb vyžaduje adresu alebo GPS súradnice predajného miesta (pri predaji z vozidla jeho evidenčné číslo) zaslať do systému eKasa pred
začiatkom predaja; ak to pre výpadok signálu nejde, do 96 hodín
([§ 7 ods. 8 zákona 384/2025](https://www.slov-lex.sk/ezbierky-fe/pravne-predpisy/SK/ZZ/2025/384/20260101#paragraf-7.odsek-8)).
Bez pripojenia sa registrácia uloží do fronty a eKasa ju odošle automaticky. Poloha nemá exspiráciu, platí, kým
nezaregistrujete novú.

## GPS súradnice

Súradnice v systéme WGS 84, na ktorých pokladnica vyhotovuje doklady.

| Vlastnosť | Popis | Pravidlá |
|---|---|---|
| `latitude` | zemepisná šírka (sever – juh) | povinná, −90 až 90, najviac 10 desatinných miest |
| `longitude` | zemepisná dĺžka (východ – západ) | povinná, −180 až 180, najviac 10 desatinných miest |

**HTTP API:**

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

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

**.NET knižnica:**

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

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

## Adresa

| Vlastnosť | Popis | Pravidlá |
|---|---|---|
| `streetName` | ulica. Ak obec nemá ulice, názov obce. | povinná, 1 – 100 znakov |
| `municipality` | obec alebo mesto | povinná, 1 – 100 znakov |
| `buildingNumber` | orientačné číslo alebo názov budovy | nepovinná, 1 – 20 znakov |
| `propertyRegistrationNumber` | súpisné číslo | nepovinná, 1 – 9 999 999 999 |
| `postalCode` | PSČ | nepovinná, presne 5 číslic |

Texty nesmú obsahovať riadiace znaky.

**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 knižnica:**

```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);
```

## Voľný text

Ak adresa ani súradnice nie sú k dispozícii, opíšte polohu textom s dĺžkou 1 až 255 znakov. Typicky ide
o evidenčné číslo vozidla a miesto, napríklad `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 knižnica:**

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

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

## Ochrana pred duplicitou

Aj registrácia polohy sa odosiela do systému eKasa ako dátová správa, preto jej rovnako ako dokladu priraďte
`externalId`. Ak sa odpoveď stratí a registráciu zopakujete s rovnakým `externalId`, eKasa vráti pôvodný výsledok
namiesto novej registrácie. Podrobnosti sú v článku [Ochrana pred duplicitou](https://ekasa.ninedigit.sk/docs/receipt-registration/external-id).

**HTTP API:**

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

**.NET knižnica:**

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

## Výsledok

Registrácia polohy sa do systému eKasa odosiela ako doklad a výsledok má rovnakú štruktúru: `isSuccessful` je
`true` pri online registrácii, `null` pri offline registrácii (poloha čaká vo fronte) a `false`, keď ju systém
eKasa odmietol. Pozri [Výsledok registrácie](https://ekasa.ninedigit.sk/docs/receipt-registration/result).

**HTTP API:**

Aktuálne zaregistrovanú polohu zistíte cez `GET /api/v1/requests/locations/current?cashRegisterCode=…`,
prípadne ju [vyhľadáte](https://ekasa.ninedigit.sk/docs/receipt-lookup) ako ostatné záznamy.

**.NET knižnica:**

Aktuálne zaregistrovanú polohu zistíte metódou `client.FindLatestLocationAsync(cashRegisterCode, cancellationToken)`,
prípadne ju [vyhľadáte](https://ekasa.ninedigit.sk/docs/receipt-lookup) ako ostatné záznamy.

## Časté otázky

**Ktorý formát mám použiť?**

Ideálne adresu alebo GPS súradnice. Voľný text použite pre evidenčné číslo vozidla alebo vtedy, keď adresa nie je
k dispozícii.

**Môžem použiť viac formátov naraz?**

Nie. Každá registrácia nahradí predchádzajúcu, platí len posledná zaregistrovaná poloha.

**Kedy musím polohu zaregistrovať?**

Len pri prenosnej pokladnici: keď ešte nemá zaregistrovanú polohu alebo keď sa od poslednej registrácie zmenilo
miesto predaja.

**Ako často ju musím meniť?**

Vždy, keď zmeníte miesto, kde prijímate tržby.

**Má poloha exspiráciu?**

Nie. Platí, kým nezaregistrujete novú.

**Čo ak polohu nezaregistrujem?**

Finančná správa vie zistiť, že prenosná pokladnica polohu nemá alebo že nezodpovedá miestu predaja. Neoznámenie
polohy je správny delikt ([§ 16 písm. i) zákona 384/2025](https://www.slov-lex.sk/ezbierky-fe/pravne-predpisy/SK/ZZ/2025/384/20260228#paragraf-16.pismeno-i)). Pri prvom zistení vás
daňový alebo colný úrad vyzve na odstránenie nedostatku, pri druhom uloží pokutu od 30 do 200 € a pri každom ďalšom
od 60 do 400 € ([§ 17 ods. 1 písm. c) a ods. 2 písm. c)](https://www.slov-lex.sk/ezbierky-fe/pravne-predpisy/SK/ZZ/2025/384/20260228#paragraf-17.odsek-1.pismeno-c)).

## Kam ďalej

- [Rozsah integrácie](https://ekasa.ninedigit.sk/docs/integration-scope): Kedy registráciu polohy potrebujete vo svojom softvéri.
- [Registrácia dokladu](https://ekasa.ninedigit.sk/docs/receipt-registration): Typy dokladov, položky, platby a výsledok.
- [Vyhľadanie záznamov](https://ekasa.ninedigit.sk/docs/receipt-lookup): Doklady a polohy podľa čísla alebo dátumu.
