.NET knižnica

Integrujem cez

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.

Požiadavky

Knižnica je zostavená pre .NET Standard 2.0, .NET 6, .NET 9 a .NET 10 (viac o .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 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.

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.

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.

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.

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). Pre staršie verzie je balík na nuget.org.

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

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.