https://github.com/fiskaltrust/middleware-demo-dotnet

Demo applications that demonstrate how to call the fiskaltrust.Middleware from .NET/C#. This repository contains examples using GRPC, WCF and REST using both JSON and XML.
https://github.com/fiskaltrust/middleware-demo-dotnet

csharp demo-application dotnet kassensichv middleware pos-systems rksv

Last synced: about 1 year ago
JSON representation

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

Host: GitHub
URL: https://github.com/fiskaltrust/middleware-demo-dotnet
Owner: fiskaltrust
License: mit
Created: 2020-02-04T16:13:06.000Z (over 6 years ago)
Default Branch: master
Last Pushed: 2023-10-23T10:58:37.000Z (over 2 years ago)
Last Synced: 2025-04-11T00:53:27.468Z (about 1 year ago)
Topics: csharp, demo-application, dotnet, kassensichv, middleware, pos-systems, rksv
Language: C#
Homepage: https://docs.fiskaltrust.cloud
Size: 125 KB
Stars: 3
Watchers: 6
Forks: 6
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS

Awesome Lists containing this project

README

# 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](https://github.com/fiskaltrust/middleware-de-demo-dotnet/releases)
- *The fiskaltrust.Middleware* running on your machine, which can be configured and downloaded via the fiskaltrust.Portal ([AT](https://portal.fiskaltrust.at), [DE](https://portal.fiskaltrust.de), [FR](https://portal.fiskaltrust.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](https://www.nuget.org/profiles/fiskaltrust).

### 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:

```powershell
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](https://github.com/fiskaltrust/interface-doc).

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](https://github.com/fiskaltrust/interface-doc/tree/master/dist/protos).

*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](https://github.com/fiskaltrust/interface-doc/tree/master/dist/WSDL).

#### 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: