fiskaltrust.Middleware demo (C#)

Demo applications that demonstrate how to call the fiskaltrust.Middleware from .NET/C#. This repository contains examples for GRPC, WCF and REST based communication, using both JSON and XML.

Getting Started

Prerequisites

In order to use this demo application, the following prerequisites are required:

• The demo application: Either clone and run locally, or download the latest binaries from Releases
• The fiskaltrust.Middleware running on your machine, which can be configured and downloaded via the fiskaltrust.Portal (AT, DE, FR). Start it (either by running it as a service, or with the test.cmd file), and let it run in the background to handle your requests.
• Your Cashbox Id is visible in the portal. It is also displayed in the startup console log of the Middleware.

This example uses the fiskaltrust.interface and the fiskaltrust.Middleware communication helper packages, which provide a convenient way to implement the middleware interface from .NET. These packages can be downloaded directly from NuGet.

Running the Demo

The Demo app needs three startup parameters: cashbox-id, url and market. The Middleware logs out all available endpoints (i.e. the URLs) as configured in the portal on startup.

For the HTTP example, further parameters can optionally be provided (the communication type and the access token, with the latter only being required when connecting to SignaturCloud).

Minimal startup example:

fiskaltrust.Middleware.Demo.Grpc.exe --cashbox-id "54c6b434-cd27-442e-b39f-0960c4ad1bda" --url "grpc://localhost:13151"

If a parameter is not passed, the user will be prompted at startup.

1. The demo will show up a list of available demo receipts, pulled from the src/fiskaltrust.Middleware.Demo.Shared/ReceiptExamples folder. Before executing any receipt, make sure that the SCU is initialized, by calling the initial-operation-receipt/the start receipt.
2. To execute a receipt against the middleware, select it by its leading number and press Enter.
3. This will print the example to the command line and send it to the Sign endpoint of the Middleware. After the receipt is processed, the Middleware will return the result back to the demo app, which again prints it to the console.
4. Alternatively, a Journal request can also be executed. This is used to export different types of data from the middleware - system information, processed receipts, etc.
5. To go back to the command list, press enter

Documentation

The full documentation for the interface can be found on https://docs.fiskaltrust.cloud. It is activeliy maintained and developed in our interface-doc repository.

More information is also available after logging into the portal with a user that has the PosCreator role assigned.

Communication

The fiskaltrust.Middleware supports different communication protocols, effectively giving our customers the possibility to use it on all platforms. Hence, different protocols are recommended for different platforms.

gRPC

gRPC is a cross-platform communication protocol and therefore widely supported by operating systems and programming frameworks. For using it with .NET, we provide a "code-first" client on NuGet.

The .proto files (i.e. the interface description) can be used to generate clients for all supported programming languages and downloaded here.

gRPC is not supported for Middleware versions < 1.3.

WCF/SOAP

Our WCF implementation supports multiple communication technologies:

• http
• https
• net.pipe
• net.tcp

Both the middleware and demo automatically detect the communication type for WCF from the given URL. This option is only available when running on Windows.

The WSDL file can be downloaded here.

HTTP/REST

HTTP/REST communication is available via JSON and XML, and probably the easiest approach for multi-platform communication. In Middleware versions < 1.3, the REST helper is required - higher versions automatically support this protocol without any helpers.

User specific protocols

With the helper topology, it is possible to solve every scenario. Please contact our support if you required assistance for a special case scenario.

Contributions

We welcome all kinds of contributions and feedback, e.g. via Issues or Pull Requests.

Related resources

Our latest samples are available for the following programming languages and tools:

                                               

Additionally, other samples (including legacy ones) can be found in our demo repository.