# Možnosti integrácie

> HTTP API alebo .NET knižnica: ako sa líšia, kedy zvoliť ktorú možnosť, podporované platformy a verzie .NET a vzorové projekty.

Zdroj: https://ekasa.ninedigit.sk/docs/integration-options

eKasu môžete do svojho softvéru zapojiť dvoma spôsobmi: cez **HTTP API** alebo ako **.NET knižnicu**. Obe používajú
rovnaký certifikovaný program, takže doklady, tlač aj výsledky sú rovnaké. Líšia sa tým, kde eKasa beží a ako ju voláte.
Odporúčame [HTTP API](#kedy-zvoliť-http-api).

## Porovnanie

| | HTTP API | .NET knižnica |
|---|---|---|
| **Programovací jazyk** | akýkoľvek (PHP, Java, JavaScript, Python, C#…) | .NET (C#, VB.NET, F#) |
| **Platformy** | Windows, macOS, Linux, Android | Windows, macOS, Linux |
| **Kde eKasa beží** | ako samostatná služba (na Androide aplikácia), váš softvér ju volá cez HTTP z toho istého zariadenia, z lokálnej siete alebo z cloudu | priamo vo vašej aplikácii |
| **Aktualizácia eKasy** | nainštalujete novú verziu služby, váš softvér meniť netreba | vydáte novú verziu svojej aplikácie s novším NuGet balíkom |
| **Viac aplikácií na jednom mieste** | všetky môžu volať tú istú službu | úložisko CHDÚ smie používať len jeden proces |
| **Softvér v cloude alebo prehliadači** | áno, cez [Expose](https://ekasa.ninedigit.sk/docs/security#expose) zabudované v eKase, VPN alebo inú reverse proxy (pozri [Prístup z internetu](https://ekasa.ninedigit.sk/docs/security#pr%C3%ADstup-z-internetu)) | len cez vzdialenú plochu (RDP): aplikácia beží na serveri a úložisko pri pokladnici k nemu pripojíte presmerovaním sériového portu |
| **Nastavenia a inicializačný balík** | webové rozhranie služby (WebAdmin) | aplikácia Portos eKasa Servis (Windows) alebo vlastné rozhranie |

## Kedy zvoliť HTTP API

**Odporúčame HTTP API**, aj keď je váš softvér napísaný v .NET. eKasa beží ako samostatná služba vedľa vášho
softvéru, takže:

- **Menej zodpovednosti na vašej strane.** Úložisko CHDÚ, tlač, offline frontu a aktualizácie eKasy spravuje služba,
  nie vaša aplikácia.
- **Oddelený beh.** eKasa má vlastné behové prostredie a proces. Pád alebo aktualizácia vašej aplikácie ju neovplyvní
  a naopak.
- **Jednoduchšia podpora.** Hranica medzi vaším softvérom a eKasou je jasná: požiadavka a odpoveď. Súbory denníka a stav
  služby sú vo webovom rozhraní, takže problém rýchlo spoločne určíme.
- **Nezávislé aktualizácie.** eKasu aktualizujete bez novej verzie svojej aplikácie.
- **Všetky platformy a nasadenia.** Funguje na Androide (tablet, kiosk, platobný terminál), pre softvér v cloude,
  v prehliadači či na inom zariadení v sieti a pre viac aplikácií na jednom mieste.

Pre PHP je k dispozícii otvorená knižnica klienta HTTP API pod licenciou MIT
([Packagist](https://packagist.org/packages/ninedigit/ekasa-clientphp), [GitHub](https://github.com/ninedigit/ekasa-clientphp)).
Funguje pri lokálnom spojení aj cez Expose.

## Kedy zvoliť .NET knižnicu

Knižnicu zvoľte, ak vyvíjate aplikáciu v .NET (napríklad desktopovú alebo pre Raspberry Pi) a samostatnú službu na mieste predaja nainštalovať
a spravovať nemôžete alebo nechcete. eKasa potom beží vo vašom procese a o jej beh, aktualizácie a prístup
k úložisku sa staráte vy.

Knižnicu `NineDigit.eKasa` nájdete na [nuget.org](https://www.nuget.org/packages/NineDigit.eKasa). Je zostavená pre
.NET Standard 2.0, .NET 6, .NET 9 a .NET 10, funguje teda aj v .NET Framework 4.6.1 a novšom (odporúčame 4.7.2).

Knižnica komunikuje s úložiskom CHDÚ výhradne. Vaša aplikácia preto má mať **jednu inštanciu klienta**
počas celého behu a úložisko nesmie súčasne používať žiadny iný proces. Podrobnosti sú v článku
[Vytvorenie klienta](https://ekasa.ninedigit.sk/docs/dotnet/instantiation).

## Vzorové projekty

- [.NET knižnica](https://github.com/ninedigit/ninedigit-ekasa-quickstart): Projekt ninedigit-ekasa-quickstart s ukážkami pre .NET aj .NET Framework.
- [PHP klient](https://github.com/ninedigit/ekasa-clientphp): Knižnica ekasa-clientphp pre HTTP API, lokálne aj cez Expose.

## Kam ďalej

- [Príprava prostredia](https://ekasa.ninedigit.sk/docs/environment-setup): Integračné prostredie, In-Memory úložisko a inštalácia eKasy.
- [HTTP API](https://ekasa.ninedigit.sk/docs/rest-api): Požiadavky, inštalácia služby a prvé volanie.
- [.NET knižnica](https://ekasa.ninedigit.sk/docs/dotnet): Požiadavky, NuGet balíky a vytvorenie klienta.
