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.