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:
- Right-click the
.dllfile and choose Properties. - In the dialog, open the Digital Signatures tab and select Nine Digit, s.r.o. in the list of certificates.
- Click Details.
- The upper part of the new window shows the text This digital signature is OK.