Informácie o produkte

Integrujem cez

Informácie o produkte vrátia názov a verziu pokladničného programu (PPEKK), API služby a pripojeného chráneného dátového úložiska, identifikátor SWID a operačný systém. Hodia sa na diagnostiku a na zobrazenie v informáciách o vašom softvéri.

Získanie informácií o produkte

GET {server_address}/api/v1/product/info
EKasaProductInfo productInfo = await client.GetProductInfoAsync(cancellationToken);

Knižnica vracia rovnaké údaje okrem api (verzia API služby).

Príklad odpovede z API služby, ktorá je nasadená na operačnom systéme Android 14:

{
  "vendorName": "Nine Digit, s. r. o.",
  "swid": "d1e080d619fcbecc06d8e3d34cbc736a7b1dad47",
  "api": {
    "name": "Portos eKasa API",
    "version": "9.0.9"
  },
  "ppekk": {
    "name": "Nine Digit eKasa",
    "version": "9.0.9"
  },
  "chdu": {
    "name": "CHDU Lite",
    "version": "v1.0 - v1.5"
  },
  "operatingSystem": {
    "platform": "Android",
    "architecture": "Arm64",
    "description": "Android 14",
    "version": "14"
  }
}

Príklad odpovede z API služby, ktorá je nasadená na 64-bitovom operačnom systéme Windows 10:

{
  "vendorName": "Nine Digit, s. r. o.",
  "swid": "d1e080d619fcbecc06d8e3d34cbc736a7b1dad47",
  "api": {
    "name": "Portos eKasa API",
    "version": "9.0.9"
  },
  "ppekk": {
    "name": "Nine Digit eKasa",
    "version": "9.0.9"
  },
  "chdu": {
    "name": "CHDU Lite",
    "version": "v1.0 - v1.5"
  },
  "operatingSystem": {
    "platform": "Windows",
    "architecture": "X64",
    "description": "Microsoft Windows 10.0.26200",
    "version": "Microsoft Windows NT 10.0.26200.0"
  }
}

Príklad odpovede staršej verzie API služby (9.0.5 a staršej), ktorá vlastnosť operatingSystem ešte neuvádza:

{
  "vendorName": "Nine Digit, s. r. o.",
  "swid": "806c3e0728bb5e0bd096d651d4e65372752d8490",
  "api": {
    "name": "Portos eKasa API",
    "version": "9.0.5"
  },
  "ppekk": {
    "name": "Nine Digit eKasa",
    "version": "9.0.3+256a161235f18034e859989e16795c38410607c0"
  },
  "chdu": {
    "name": "CHDU Lite",
    "version": "v1.0 - v1.5"
  }
}

Vlastnosti odpovede

Vlastnosť Popis
vendorName Názov výrobcu pokladničného programu.
swid Jedinečný identifikátor pokladničného programu (SHA-1). Je odvodený od názvu výrobcu, od názvu a verzie pokladničného programu, od názvu a verzie chráneného dátového úložiska. Týmto identifikátorom sú označené všetky doklady odosielané do systému eKasa Finančnej správy SR.
api Názov a verzia API služby. Ide o vrstvu nad certifikovaným pokladničným programom, ktorý sprístupňuje webové API rozhranie.
ppekk Názov a verzia vstavaného certifikovaného pokladničného programu.
chdu Názov a verzia pripojeného chráneného dátového úložiska.
operatingSystem Popis operačného systému, na ktorom API služba beží.

Verzie api a ppekk sú navzájom nezávislé a nemusia sa zhodovať. API služba pre Android a API služba pre desktop sa vydávajú samostatne, takže rovnaké číslo verzie v api neznamená rovnaké vydanie.

Vlastnosť operatingSystem

Dostupné od verzie 9.0.6.

Popisuje operačný systém zariadenia, na ktorom je API služba nasadená.

operatingSystem.platform

Operačný systém. Ak ide o systém, ktorý API služba nepozná, hodnota nie je uvedená.

Hodnota Popis
Windows Windows.
Linux Linux.
MacOS macOS.
Android Android.
null Systém sa nepodarilo rozpoznať.

operatingSystem.architecture

Architektúra procesu API služby. Uvádza architektúru procesu, nie systému: 32-bitová služba na 64-bitovom systéme uvedie 32-bitovú hodnotu.

Medzi bežné hodnoty patria X86, X64, Arm a Arm64.

operatingSystem.description

Ľudsky čitateľný popis systému, určený na zobrazenie obsluhe a na diagnostiku. Napríklad Microsoft Windows 10.0.26200 alebo Android 14.

Formát popisu nie je fixný a môže sa medzi verziami a platformami líšiť. V prípade ošetrenia správania nadradenej aplikácie odporúčame použiť hodnotu platform.

operatingSystem.version

Verzia systému tak, ako ju uvádza sám systém. Na Androide ide o verziu Androidu (napríklad 14).

V prípade, ak ju systém neposkytne, je uvedená hodnota null.

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.