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.
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 zabudované v eKase, VPN alebo inú reverse proxy (pozri Prístup 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, GitHub). 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. 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.