Skip to main content

My First Cashbox

summary

After reading this, you can create a CashBox in the Sandbox and have a functioning fiskaltrust.Middleware instance.

As a PosDealer, you have two options to create your first CashBox in the fiskaltrust.Portal:

  • Rollout plans (recommended): the deployment wizards of the Portal. They create, buy and set up CashBoxes and related components for your PosOperators, and you can select several PosOperators and outlets at the same time. For more information, see Rollout plans.
  • Manual configuration: you create the components yourself. First read Architecture to learn which components a CashBox needs, then follow Manual CashBox Creation.

Both options require the legal and commercial preparations described earlier in this documentation. They are summarized under Prerequisites.

tip

Use your Sandbox account to avoid charges on your account.

If you do not have a Sandbox account yet, ask your PosCreator for an invitation or register a new PosDealer Sandbox account yourself.

Flowchart: after Prerequisites and Decision on creation, either Business and Technical Rollout or manual SCU, Helper, Queue and cashbox creation lead to CashBox rebuild, Launcher download and Middleware start

Figure 1. Process flow for creating your first CashBox.

Prerequisites​

Before you roll out a Middleware instance, make sure that the following prerequisites are in place:

  • A working Internet connection. For more information, see Network Requirements.
  • An active PosDealer account in the fiskaltrust.Portal (Sandbox), either by registration or by invitation through your PosCreator. In the PosSystems menu, check that a PosSystemId is available. This menu is not available in PosOperator accounts.
  • Checked master data and at least one outlet. For more information, see Master Data.
  • For a local Middleware installation: a system that meets the hardware and software requirements. For more information, see Supported Environments.
  • Any SSCD components (hardware or SaaS credentials) that the setup requires, unless the setup itself creates them.

Rollout plans​

Business Rollout​

A Business Rollout follows these steps:

  1. Select the product you want to roll out.
  2. Select one or more PosOperators for the rollout.
  3. Select one or more outlets for the rollout.
  4. Create a quote and load it into your shopping cart.
  5. Complete the checkout.

The following example walks through these steps for your own account in the Sandbox.

This example uses a fiskaltrust.Carefree plan. The plan creates a Carefree bundle, including an OnlineSignature SCU, and a CloudCashbox for immediate use. To keep the tutorial short, you roll out the bundle to your own account and outlet instead of to a PosOperator.

  1. Sign in to the Sandbox Portal.
  2. In the left-hand navigation menu, click Rollout management.
  3. On the Business Rollout card (Rolling out products), click Choose.
  4. On the Select Product page, search for CloudCashbox.
  5. On plan 4154-0005, click Choose.
  6. On the Select PosOperators page, select your own account, marked My Account, and click Rollout 1 PosOperators.
  7. On the Select Outlet page, select the outlet where you want to roll out the product and click Rollout 1 outlets.
  8. On the Summary page, check the plan and the outlet, enter a name under Define a name for the quote, and click Create quote & go to basket. Creating the quote takes a few seconds.
  9. In the shopping cart, verify that the items match the selected products and click Checkout.
  10. Click Order bindingly to complete the order.

The order is listed under Shop > Orders. Completing the order can take a few minutes. After that, the following items are active in your account:

ItemLocation in the Portal
A new QueueConfiguration > Queues
A new CashBoxConfiguration > CashBoxes
Two new demo subscriptionsShop > Subscriptions

Table 1. Items created by the Business Rollout.

Start the Middleware​

The CashBox configuration determines how the Middleware runs:

  • CloudCashbox: fiskaltrust operates the Middleware, so you do not download anything. To connect, use the URL in the Queue configuration. For more information, see CloudCashbox.
  • Local Middleware: in Configuration > CashBoxes, click Download in the row of your CashBox to download the Launcher, then start it. The Launcher fetches the CashBox configuration each time it starts, so configuration changes apply after a restart. For more information, see Windows, Linux & macOS and Android.

Running a test request​

After the Middleware is deployed and started, check that it is available and responds to requests.

The Middleware provides an echo request that returns the data it receives. If you get a response, the Middleware is also ready to accept signing requests.

Postman collection

For Postman, you can download a request collection from the GitHub repository.

Request details​

To send an echo request, send a POST request to the path /json/Echo of the configured Middleware URL. The request body is a JSON string that contains the message you want the Middleware to return.

For example, to send Hello fiskaltrust.Middleware!, use the following request body:

"Hello fiskaltrust.Middleware!"

The following HTTP request sends this string to the Middleware:

POST /json/Echo HTTP/1.1
Host: localhost
Content-Length: 31
Content-Type: application/json

"Hello fiskaltrust.Middleware!"

The response has the status code 200 and contains the exact string you sent in the response body.

info

For the full request details, parameters and a curl example, see the Echo request in the Middleware samples.