Možnosti integrácie

Integrujem cez

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.

Vzorové projekty

Kam ďalej

Esc

↑↓ výberEnter otvoriťEsc zavrieť

Chýba vám niečo v dokumentácii?

Napíšte nám, s čím potrebujete pomôcť. Ozveme sa do pár hodín.

Údaje použijeme len na odpoveď. Viac v ochrane osobných údajov.