# Informácie o produkte

> Ako zistiť názov a verziu pokladničného programu, API služby, pripojeného úložiska, SWID a operačný systém, na ktorom eKasa beží.

Zdroj: https://ekasa.ninedigit.sk/docs/product-info

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

**HTTP API:**

```http
GET {server_address}/api/v1/product/info
```

**.NET knižnica:**

```csharp
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:

```json
{
  "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:

```json
{
  "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:

```json
{
  "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`.
