# .NET knižnica

> Požiadavky .NET knižnice NineDigit.eKasa, podporované verzie .NET a operačné systémy, NuGet balíky, aplikácia Portos eKasa Servis a overenie podpisu.

Zdroj: https://ekasa.ninedigit.sk/docs/dotnet

eKasu môžete do svojho softvéru zapojiť cez HTTP API alebo ako .NET knižnicu. Tento článok popisuje integráciu
cez **.NET knižnicu** `NineDigit.eKasa`. Rozdiely oboch možností nájdete v článku
[Možnosti integrácie](https://ekasa.ninedigit.sk/docs/integration-options).

## Požiadavky

Knižnica je zostavená pre .NET Standard 2.0, .NET 6, .NET 9 a .NET 10
([viac o .NET Standard](https://docs.microsoft.com/en-us/dotnet/standard/net-standard)).

### Podporované verzie .NET

- .NET Core 2.0 a novší (.NET Core 3.1, .NET 5, .NET 6 a ďalšie),
- .NET Framework 4.6.1 a novší. Namiesto 4.6.1 dôrazne odporúčame .NET Framework 4.7.2. Pozrite si
  [tabuľku kompatibility .NET](https://docs.microsoft.com/en-us/dotnet/standard/net-standard) na stránke Microsoftu.

### Podporované operačné systémy

Od verzie 5 funguje knižnica na všetkých bežných operačných systémoch: Windows, macOS a Linux. Podporované verzie
a distribúcie nájdete v [dokumentácii .NET](https://docs.microsoft.com/en-us/dotnet/core/install/dependencies).

Verzia 3 a staršie fungujú len vo Windows.

## Aplikácia Portos eKasa Servis

**Portos eKasa Servis** je desktopová aplikácia pre servisných technikov. Poskytuje rozhranie na:

- zobrazenie celkového stavu systému,
- vloženie inicializačného balíka (identifikačných a autentifikačných údajov pokladnice),
- ručné spracovanie fronty nespracovaných registrácií dokladov a miesta predaja,
- tlač nespracovaných registrácií dokladov a miesta predaja,
- nastavenie systému.

Vďaka nej vaša aplikácia nemusí mať vlastnú obrazovku na vloženie inicializačného balíka ani na nastavenia eKasy.

Požiadavky aplikácie Portos eKasa Servis:

- Windows 7 a novší,
- .NET Framework 4.7.2.

## NuGet balíky

### `NineDigit.eKasa`

Hlavný NuGet balík s certifikovaným klientom eKasa. Nájdete ho na
[nuget.org](https://www.nuget.org/packages/NineDigit.eKasa).

Vstupnou triedou je `Client`. Sprístupňuje všetky hlavné funkcie, najmä:

- metódy na registráciu dokladov a miesta predaja,
- službu na správu identifikačných údajov (`IdentityManager`),
- službu na správu autentifikačných údajov (`CertificateManager`),
- službu na prístup k subjektom (`SubjectProvider`); subjekt je dvojica identifikačných a autentifikačných údajov
  pokladnice,
- frontu nespracovaných registrácií (`Queue`) a službu na sledovanie jej spracovania (`QueueMonitor`).

Ako klienta vytvoriť, popisuje článok [Vytvorenie klienta](https://ekasa.ninedigit.sk/docs/dotnet/instantiation).

### `NineDigit.eKasa.Configuration`

Balík na načítanie konfiguračného súboru, ktorý upravuje aplikácia Portos eKasa Servis. Konfiguráciu odporúčame
načítavať práve týmto spôsobom, podrobnosti sú v článku [Konfigurácia](https://ekasa.ninedigit.sk/docs/dotnet/configuration).

Od verzie 8 je konfigurácia súčasťou balíka `NineDigit.eKasa` a samostatný balík `NineDigit.eKasa.Configuration`
odinštalujte (pozri [Migrácia na verziu 8](https://ekasa.ninedigit.sk/docs/migration/v8#1-konfigur%C3%A1cia-je-s%C3%BA%C4%8Das%C5%A5ou-kni%C5%BEnice-ninedigitekasa)).
Pre staršie verzie je balík na [nuget.org](https://www.nuget.org/packages/NineDigit.eKasa.Configuration).

## Overenie digitálneho podpisu

Digitálny podpis knižnice (súboru `.dll`) overíte vo Windows takto:

1. Kliknite pravým tlačidlom myši na súbor `.dll` a zvoľte **Properties** (Vlastnosti).
2. V okne zvoľte záložku **Digital Signatures** (Digitálne podpisy) a v zozname certifikátov vyberte
   **Nine Digit, s.r.o.**
3. Kliknite na **Details** (Podrobnosti).
4. V hornej časti nového okna sa zobrazí text **This digital signature is OK.** (Tento digitálny podpis je v poriadku.)

## Kam ďalej

- [Vytvorenie klienta](https://ekasa.ninedigit.sk/docs/dotnet/instantiation): Konštruktory triedy Client a jedna inštancia počas behu aplikácie.
- [Konfigurácia](https://ekasa.ninedigit.sk/docs/dotnet/configuration): Načítanie nastavení z aplikácie Portos eKasa Servis.
- [Logovanie](https://ekasa.ninedigit.sk/docs/dotnet/logging): Napojenie Serilogu, log4net či Seq cez Microsoft.Extensions.Logging.
