Daily closing of the cash register

In many countries, the cash register must be closed at the end of the day with a closing report (Z-report, end-of-day report, daily closing report,...). The daily cash closing can be done in different ways with RetailForce Middleware.

• Z-report calculated by cash register system,
• semi-automatic cashpoint closing,
• automatic cashpoint closing.

General information on the implementation of the business case "end of day" can be found in the article: Implementation End of Day.

Z-report by cash register

In this case, the (software) POS system calculates and generates the end-of-day report (Z-report). In order to store the report in the journal of the fiscal middleware, which is necessary if the daily closing report is required by law in the respective country, the POS system must convert the Z-report into the JSON structure of the middleware interface after its generation, transfer it to the middleware and store it (storeDocument, documentType: [99] = endOfDayDocument)..

Semi-automatic cashpoint closing

Alternatively, the middleware can be used to generate the end-of-day report. The following steps are necessary for this:

• GET /api/v1/closing/{clientId}/endofdayDocument returns a daily closing document to the POS system as a response. This is calculated by the middleware on the basis of the documents transmitted since the last daily closing (!). It should be ensured that a daily closing is carried out! If the last daily closing was carried out a long time ago, the calculation may take a longer period of time.
• The POS system must then save the received document in the journal of the middleware: POST /api/v1/transactions/storeDocument

Automatic cashpoint closing

The daily closing can also be carried out fully automatically by the middleware.

• POST /api/v1/closing/{clientId}/cashpointClose - closes the cash register with a closing document. The Z-report is automatically calculated based on the documents transferred to the middleware since the last daily closing. 

In order to be able to carry out the cash register closing correctly, other information such as deposits and withdrawals, cash balance at cash register opening, etc. must be transmitted in addition to sales documents. You can find more information on this in the following articles:

• Simple cashpoint closing
• Daily closing - cashpointClose

Country-specific information

• Z-report Gemany