.NET Library

Your application can integrate Portos eKasa in two ways: HTTP WEB API or the .NET library. This article is deditacted to .NET library integration.

Software Requirements

Portos eKasa .NET library is built on .NET Standard 2.0. More information about .NET standard

Supported .NET Runtimes

• .NET Core 2.0 and newer (.NET Core 3.1, .NET 5.0, .NET 6.0, ...)
• .NET Framework 4.6.1 and newer (it is higly recommended to use .NET Framework 4.7.2, instead 4.6.1), please see .net compatibility table on official microsoft web page.

Supported Operating Systems

Since version 5, Portos eKasa library is compatible with all relevant operating systems - Windows, MacOS and Linux. Click here for more information about supported versions and distributions.

Version 3 and earlier are compatible with Windows operating system only.

Available Applications

Portos eKasa Servis

The Portos eKasa Servis is an desktop application for service technicians that provides user interface for:

• overall status of the system
• initialization package insertion (identification and authentication info for cash register)
• manual processing of queue containing unprocessed receipt or location registrations
• printing unprocessed receipt and location registrations
• configuration of system

With the help of Portos eKasa Servis application, your "parent" application does not need to implement user interface for initialization package insertion nor settings screen containing options for Portos ekasa.

Portos eKasa Servis Software Requirements

• Operating systems: Windows 7 and newer
• .NET Framework 4.7.2

Available NuGet packages

NineDigit.eKasa

The main nuget package containing the certified eKasa Client.

Library is available at nuget.org

The entry class called Client gives you access to all main functionality, primarly:

• methods to register receipts and location.
• service to mantain identification data
• service to mantain autentication data
• service to mantain subjects (subject is combination of identification and authentication data for on-line cash register)
• service to observe queue of unprocessed registrations

NineDigit.eKasa.Configuration

This NuGet package helps you to load configuration file which is used by Portos eKasa servis application. Please see more info in configuration article.

It is highly recommended to use this package to load eKasa configuration.

Library is available at nuget.org

~NineDigit.eKasa.StorageManagement~

The StorageManagement library is no longer mantained.

This NuGet package provides conversion of index table file from older format (compatible with version 3 and older) to new format (compatible with version 5 and newer).

Please see index table migration article for example usage.

Digital signature verification

To verify digital signature of library (the .dll file) you can follow these steps (on OS windows):

1. right click on the .dll file
2. open "properties" tab
3. dialog windows pops up, select "Digital Signatures" tab and choose certificate "Nine Digit, s.r.o." from the list of certificates.
4. Click the "Details" button.
5. Another dialog window is opened, which contains text "This digital signature is OK." in upper part of the window.