Registrácia polohy

Polohu je potrebné registrovať pri prenosných online registračných pokladniciach vždy po zmene jej umiestnenia.

K dispozícii sú tri formy definície polohy:

Adresa
GPS poloha
Voľný formát

Registrácia vo forme GPS polohy

GPS súradnice miesta podľa súradnicového systému WGS 84, na ktorom pokladnica vyhotovuje doklady.

Názov vlastnosti	Popis	Validáčnné pravidlá
`longitude`	Zemepisná dĺžka (X). Vyjadruje pozíciu východ – západ na zemeguli podľa systému WGS 84.	- Povinné pole - Typ: `decimal` - Rozsah: -180.0 až 180.0 - Maximálna presnosť: 10 desatinných miest
`latitude`	Zemepisná šírka (Y). Vyjadruje pozíciu sever – juh na zemeguli podľa systému WGS 84.	- Povinné pole - Typ: `decimal` - Rozsah: -90.0 až 90.0 - Maximálna presnosť: 10 desatinných miest

HTTP WEB API
Knižnica

Registrácia dokladu pomocou HTTP WEB API je realizovaná volaním

POST {{server_address}}/api/v1/requests/locations/gps.

Vzorové telo dokumentu:

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

Registrácia dokladu pomocou .NET knižnice je realizovaná volaním metódy client.RegisterLocationAsync().

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

// wrap location to cash register location object, to pair this location with cash register code.
CashRegisterLocation cashRegisterLocation = new CashRegisterLocation(cashRegisterCode, location);

// wrap cashRegisterLocation to request object.
RegisterLocationRequest request = new RegisterLocationRequest(cashRegisterLocation);

// finally, send location registration to eKasa server.
RegisterLocationResult registrationResult = await client
    .RegisterLocationAsync(request, CancellationToken.None)
    .ConfigureAwait(false);

Registrácia vo forme adresy

Názov vlastnosti	Popis	Validáčnné pravidlá
`streetName`	Názov ulice. Ak obec nemá názov ulice, udáva sa tu názov obce.	- Povinné pole - Dĺžka: 1 – 100 znakov - Nesmie obsahovať riadiace znaky
`municipality`	Názov obce. Obcou je územnosprávna jednotka charakterizovaná súvislým domovým osídlením a vlastným názvom. Obcou je aj mesto.	- Povinné pole - Dĺžka: 1 – 100 znakov - Nesmie obsahovať riadiace znaky
`buildingNumber`	(Nepovinné) Názov budovy alebo číslo domu.	- Voliteľné pole - Dĺžka: 1 – 20 znakov (ak je vyplnené) - Nesmie obsahovať riadiace znaky
`postalCode`	(Nepovinné) Poštové smerové číslo – kód, ktorý ustanovili poštové autority za účelom doručovania pošty.	- Voliteľné pole - Formát: presne 5 číslic - regulárny výraz (regex): `[0-9]{5}`
`propertyRegistrationNumber`	(Nepovinné) Súpisné číslo budovy.	- Voliteľné pole - Číselný rozsah: 1 – 9 999 999 999

HTTP WEB API
Knižnica

Registrácia dokladu pomocou HTTP WEB API je realizovaná volaním

POST {{server_address}}/api/v1/requests/locations/address.

Vzorové telo dokumentu:

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

Registrácia dokladu pomocou .NET knižnice je realizovaná volaním metódy client.RegisterLocationAsync().

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

// wrap location to cash register location object, to pair this location with cash register code.
CashRegisterLocation cashRegisterLocation = new CashRegisterLocation(cashRegisterCode, location);

// wrap cashRegisterLocation to request object.
RegisterLocationRequest request = new RegisterLocationRequest(cashRegisterLocation);

// finally, send location registration to eKasa server.
RegisterLocationResult registrationResult = await client
    .RegisterLocationAsync(request, CancellationToken.None)
    .ConfigureAwait(false);

Registrácia vo voľnom foráte

Iný spôsob definovania umiestnenia prenosnej pokladnice, na ktorej podnikateľ v danom čase prijíma tržbu. ORP použije tento typ definovania polohy, ak nie je možné uviesť adresu umiestnenia prenosnej pokladnice alebo GPS súradnice.

Príklad: Taxi ABC ŠPZ=BA 123 AA; odpočívadlo Zeleneč D1

Textový režazec musí byť v dĺžkke 1 až 255 znakov.

HTTP WEB API
Knižnica

Registrácia dokladu pomocou HTTP WEB API je realizovaná volaním

POST {{server_address}}/api/v1/requests/locations/other.

Vzorové telo dokumentu:

{
    "data":
    {
        "location":
        {
            "value": "AA123AA"
        }
    }
}

Registrácia dokladu pomocou .NET knižnice je realizovaná volaním metódy client.RegisterLocationAsync().

CashRegisterOtherLocation location = new CashRegisterOtherLocation("Taxi, EČV: BL-123AA");

// wrap location to cash register location object, to pair this location with cash register code.
CashRegisterLocation cashRegisterLocation = new CashRegisterLocation(cashRegisterCode, location);

// wrap cashRegisterLocation to request object.
RegisterLocationRequest request = new RegisterLocationRequest(cashRegisterLocation);

// finally, send location registration to eKasa server.
RegisterLocationResult registrationResult = await client
    .RegisterLocationAsync(request, CancellationToken.None)
    .ConfigureAwait(false);