Skip to main content

First steps with fiscal service

DEVELOPMENT
  • Updated

The RetailForce fiscalisation service is a fiscalisation middleware based on .net for Germany and all other countries.

Installation

You can download a copy of the fiscal service for windows using the following link:

http://www.retailforce.cloud/downloads

Please download the most recent version of the software.

The setup can be easily installed, there is not more information needed.

After the setup the service exists as an REST-WebService (Json) on port number 7678 (HTTPS) on localhost.

Alternatives

As an alternative to the REST web service installation, the RetailForce Fiskal Middleware is also available as:

Information on these installation / integration variants can be found in the following articles:

Sample Application

You’ll also find a sample application in the download directory above in the subfolder Samples (Fiscal Service Client Sample). In this sample application the whole source code for simple booking and signing in c# is included.

For using the sample-application you can use following client-guid:

{c1062c55-57c4-4ed2-9c53-aff1762326a4}

You can use this client guid for your first tests without a problem. For further tests also with cloud integration you’ve to create your own test client with RetailForce cloud.

If you encounter problems with missing DLL’s please take a look at the bin/debug folder of the project in the sample application.

Document validation

To help you integrating your software we’ve done so far a function to validate the document object model you’ll send to the fiscalisation module.

When you call the ValidateDocument method on a created TrustedFiscalModule or at the fiscalisation webservice (depending on your integration), you’ll get all the errors (and warnings) of the document at once. So it is much more easier to adapt the calling procedure to finish up the integration process.

Additional information

Integration of middleware can be done in the following ways

 

  • Integration via web service (windows, REST)
  • Integration via web service (with Fiskalclient in .net standard, nuget)
  • Integration via web service (with Fiskalclient in .net Framework 2.0, nuget)
  • Integration via web service (as COM-DLL/Active X, available on request)
  • Integration as AAR package on android device (for java) (availability depending on Microsoft's plans)

Some additional information about technical aspects

  • The whole development is done as test driven development
  • All tests are driven during build process when creating a new version
  • Deployment of solution via nuget packages or also via download of windows setup.

Operating systems

The RetailForce Fiscal Middleware has been tested on the following operating systems so far:

  • Windows 7
  • Windows 10
  • Android (from version 8) (as nuget package integration)
  • Linux (for the service)

Please refer also to security system documentation if the choosen security system (tse, hsm, etc.) in the appropiate country supports your operating system.

At the moment not tested and supported, but should work:

  • iOs (as nuget package integration)

Fiscal client management

From our experience managing fiscal clients can sometime be time consuming and a hazzle.

Therefore we’ve created the following additional services:

  • Automatic client configuration via RetailForce cloud for no maintenance of the installed fiscal client
  • RetailForce cloud management api for managing additional companies, stores and terminals and all the other masterdata you’ll need.

Additional documentation / service documentation

You will find additional documentation here:

Complete service description for the webservice

Complete documentation (object model) of the fiscal service

Folder documentation at download sub folder of installation files (link of chapter installation)

This documentation will be available soon at http://docs.retailforce.cloud.

Country characteristics (FiscalCountryProperties)

Related articles

Comments

0 comments

Please sign in to leave a comment.

Powered by Zendesk