.NET Library

Integrating via

You can connect eKasa to your software through the HTTP API or as a .NET library. This article describes integration through the .NET library NineDigit.eKasa. The differences between the two options are explained in Integration options.

Requirements

The library is built for .NET Standard 2.0, .NET 6, .NET 9 and .NET 10 (more about .NET Standard).

Supported .NET versions

  • .NET Core 2.0 and newer (.NET Core 3.1, .NET 5, .NET 6 and later),
  • .NET Framework 4.6.1 and newer. Instead of 4.6.1 we strongly recommend .NET Framework 4.7.2. See the .NET compatibility table on the Microsoft website.

Supported operating systems

Since version 5 the library works on all common operating systems: Windows, macOS and Linux. Supported versions and distributions are listed in the .NET documentation.

Version 3 and earlier work on Windows only.

Portos eKasa Servis application

Portos eKasa Servis is a desktop application for service technicians. It provides a user interface for:

  • viewing the overall state of the system,
  • inserting the initialization package (identification and authentication data of the cash register),
  • manually processing the queue of unprocessed receipt and location registrations,
  • printing unprocessed receipt and location registrations,
  • configuring the system.

Thanks to it, your application does not need its own screen for inserting the initialization package or for eKasa settings.

Requirements of Portos eKasa Servis:

  • Windows 7 or newer,
  • .NET Framework 4.7.2.

NuGet packages

NineDigit.eKasa

The main NuGet package with the certified eKasa client. It is available at nuget.org.

The entry class is Client. It gives access to all main functions, mainly:

  • methods for registering receipts and the location of sale,
  • the service for managing identification data (IdentityManager),
  • the service for managing authentication data (CertificateManager),
  • the service for accessing subjects (SubjectProvider); a subject is a pair of identification and authentication data of a cash register,
  • the queue of unprocessed registrations (Queue) and the service for observing its processing (QueueMonitor).

How to create the client is described in Library instantiation.

NineDigit.eKasa.Configuration

A package for loading the configuration file edited by the Portos eKasa Servis application. We recommend loading the configuration this way; details are in Configuration.

Since version 8 the configuration is part of the NineDigit.eKasa package; uninstall the separate NineDigit.eKasa.Configuration package (see Migration to version 8). For older versions the package is available at nuget.org.

Digital signature verification

To verify the digital signature of the library (the .dll file) on Windows:

  1. Right-click the .dll file and choose Properties.
  2. In the dialog, open the Digital Signatures tab and select Nine Digit, s.r.o. in the list of certificates.
  3. Click Details.
  4. The upper part of the new window shows the text This digital signature is OK.

Next steps

Esc

↑↓ selectEnter openEsc close

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.