GET /api/v1/management/germany/ {clientId}/tse/listTransactions – RetailForce Software GmbH

With the endpoint

GET /api/v1/management/germany/{clientId}/tse/listTransactions

open TSE transactions are returned.

Open Transactions

Open transactions are those that have been created / started with createDocument (PUT /api/v1/transactions/createDocument), but have not (yet) been closed with a storeDocument (POST /api/v1/transactions/storeDocument), or a cancelDocument (POST /api/v1/transactions/cancelDocument).

These transactions are visible in the DSFinV-K export. In the event of a cash register inspection by the tax authorities, open transactions can lead to further questions and the auditor will demand an explanation for these transactions.

Attention: the number of possible open transactions is limited! The swissbit hardware TSE allows 512, the fiskaly Cloud TSE 2,000 simultaneously open transactions. If a 513th or a 2,001st transaction is opened, the TSE returns an error! See also: Tse connection error.

We recommend closing open transactions and modelling this in the process of the electronic record system that transactions can be parked, but must be closed by the end of the day at the latest.

Open transactions can also be closed via the

DELETE /api/v1/management/germany/{clientId}/tse/listTransactions

endpoint.

Results

Listing of open transactions that have not (yet) been completed

Usage

if required (optional cash register function)

Prerequisites

Endpoint only returns a result if the corresponding client has been configured for use within the scope of the KassenSichV in Germany

Form fields

The following information must be submitted:

Designation	Description	Example
clientId	Unique ID of the client (uniqueClientId)	3fa85f64-5717-4562-b3fc-2c963f66afa6

Response

Possible responses:

Code	Description	Example
200	The client returns a list of open transactions in the response. The number returned is the fiscalDocumentNumber of the open transaction Attention: TSEs will return open transactions only in packets (swissbit hardware TSE: 8, cloud TSEs: 100 open transactions per request)! I.e. if the number of open transactions exceeds this value, the specified transactions must first be closed until more are displayed.	[ 4, 5, 9, 8, 11, 12, 14, 15, 18, 24, 29, 57, 198, 220, 321, 525, 724 ]
422	No clientId was specified in the request. Troubleshooting: Specify the correct clientId	-
500	Internal error - the request could not be processed. Troubleshooting: Contact RetailForce Support	-

Swissbit Hardware TSE

The total number of open transactions at the swissbit hardware TSE can be retrieved via the endpoint GET /api/v1/management/germany/tse.