API Reference

Daily Closings (Z-Bericht)

Perform end-of-day closings, retrieve the most recent closing, and list historical closings. Each closing generates a Z-Bericht with full VAT breakdown, TSE counters, and receipt statistics. All endpoints require admin privileges.

Immutable Records

Daily closings are append-only and cannot be modified or deleted after creation. This is required for GoBD compliance. Each closing is TSE-signed and receives a sequential closing number.

Perform Daily Closing

Performs the end-of-day closing procedure. Calculates all totals, generates the Z-Bericht, and signs it via TSE. The cash drawer end amount must be provided to calculate any cash difference.

POST/api/closingsAdmin Only

Perform a daily closing (Z-Bericht) and generate the signed summary.

Request Body

Name	Type	Required	Description
`cash_end`	`integer`	Required	Cash drawer end amount in cents. Used to calculate cash difference.
`notes`	`string`	Optional	Optional notes for the closing (e.g. discrepancy explanation).

bash

curl -X POST https://api.possfer.com/api/closings \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "cash_end": 52350,
    "notes": "Abweichung: 2 EUR Trinkgeld nicht eingetragen"
  }'

Response

json

{
  __PH0__: "550e8400-e29b-41d4-a716-446655440000",
  __PH2__: 142,
  __PH3__: "2026-03-20",
  __PH5__: 10000,
  __PH6__: 52350,
  __PH7__: 150,
  __PH8__: 285430,
  __PH9__: 142300,
  __PH10__: 143130,
  __PH11__: 12500,
  __PH12__: 2400,
  __PH13__: 180000,
  __PH14__: 34200,
  __PH15__: 60000,
  __PH16__: 4200,
  __PH17__: 78,
  __PH18__: 78,
  __PH19__: 2,
  __PH20__: 10241,
  __PH21__: 10318,
  __PH22__: "e8a12b...",
  __PH24__: "Abweichung: 2 EUR Trinkgeld nicht eingetragen",
  __PH26__: "550e8400-e29b-41d4-a716-446655440001",
  __PH28__: "2026-03-20T23:15:00Z"
}

Response Fields

Name	Type	Required	Description
`id`	`uuid`	Required	Unique closing identifier.
`closing_number`	`integer`	Required	Sequential closing number (Z-Nummer).
`business_date`	`string`	Required	Business date of the closing (YYYY-MM-DD).
`cash_start`	`integer`	Required	Cash drawer start amount in cents.
`cash_end`	`integer`	Required	Cash drawer end amount in cents.
`cash_difference`	`integer`	Required	Difference between expected and actual cash in cents.
`total_revenue`	`integer`	Required	Total gross revenue in cents.
`total_cash`	`integer`	Required	Total cash payments in cents.
`total_card`	`integer`	Required	Total card payments in cents.
`total_tips`	`integer`	Required	Total tips received in cents.
`total_storno`	`integer`	Required	Total storno (void) amount in cents.
`total_net_19`	`integer`	Required	Net amount at 19% VAT rate in cents.
`total_vat_19`	`integer`	Required	VAT amount at 19% rate in cents.
`total_net_7`	`integer`	Required	Net amount at 7% VAT rate in cents.
`total_vat_7`	`integer`	Required	VAT amount at 7% rate in cents.
`receipt_count`	`integer`	Required	Total receipts issued during the day.
`order_count`	`integer`	Required	Total orders processed during the day.
`storno_count`	`integer`	Required	Number of voided (storno) transactions.
`first_tse_signature_counter`	`integer`	Required	First TSE signature counter value of the day.
`last_tse_signature_counter`	`integer`	Required	Last TSE signature counter value of the day.
`tse_serial_number`	`string`	Required	Serial number of the TSE unit used.

Get Most Recent Closing

GET/api/closings/lastAdmin Only

Returns the most recent daily closing record.

bash

curl https://api.possfer.com/api/closings/last \
  -H "Authorization: Bearer <token>"

Returns the same closing object structure as the POST endpoint above.

List Closings

GET/api/closingsAdmin Only

Returns a list of daily closings, ordered by date descending. Returns the last 30 closings.

bash

curl https://api.possfer.com/api/closings \
  -H "Authorization: Bearer <token>"

json

{
  __PH0__: [
    {
      __PH1__: "550e8400-...",
      __PH3__: 142,
      __PH4__: "2026-03-20",
      __PH6__: 285430,
      __PH7__: 78,
      __PH8__: "2026-03-20T23:15:00Z"
    },
    {
      __PH10__: "550e8401-...",
      __PH12__: 141,
      __PH13__: "2026-03-19",
      __PH15__: 312100,
      __PH16__: 85,
      __PH17__: "2026-03-19T23:30:00Z"
    }
  ],
  __PH19__: 30
}