Registrácia polohy

Integrujem cez

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.

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

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

Kedy polohu registrovať

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). 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
POST http://localhost:3010/api/v1/requests/locations/gps
{
  "data": {
    "cashRegisterCode": "88812345678900001",
    "location": {
      "latitude": 48.148962,
      "longitude": 17.165377
    }
  }
}
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.

POST http://localhost:3010/api/v1/requests/locations/address
{
  "data": {
    "cashRegisterCode": "88812345678900001",
    "location": {
      "streetName": "Kresánkova",
      "buildingNumber": "12",
      "propertyRegistrationNumber": 3597,
      "municipality": "Bratislava",
      "postalCode": "84105"
    }
  }
}
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.

POST http://localhost:3010/api/v1/requests/locations/other
{
  "data": {
    "cashRegisterCode": "88812345678900001",
    "location": {
      "value": "Taxi ABC, EČV BA123AA"
    }
  }
}
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.

{
  "data": {
    "cashRegisterCode": "88812345678900001",
    "location": {
      "latitude": 48.148962,
      "longitude": 17.165377
    }
  },
  "externalId": "poloha-2026-11-19-0800"
}
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.

Aktuálne zaregistrovanú polohu zistíte cez GET /api/v1/requests/locations/current?cashRegisterCode=…, prípadne ju vyhľadáte ako ostatné záznamy.

Aktuálne zaregistrovanú polohu zistíte metódou client.FindLatestLocationAsync(cashRegisterCode, cancellationToken), prípadne ju vyhľadáte 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). 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)).

Kam ďalej

Esc

↑↓ výberEnter otvoriťEsc zavrieť

Chýba vám niečo v dokumentácii?

Napíšte nám, s čím potrebujete pomôcť. Ozveme sa do pár hodín.

Údaje použijeme len na odpoveď. Viac v ochrane osobných údajov.