API Reference

Cashbook (Kassenbuch)

Track all cash movements in and out of the register. The Kassenbuch provides a complete audit trail of deposits, withdrawals, and other cash transactions. All endpoints require admin privileges.

GoBD Compliance

Cashbook entries are append-only and immutable. Once created, entries cannot be modified or deleted. To correct an error, create a new compensating entry.

List Entries

GET/api/cashbookAdmin Only

Returns cashbook entries for the specified date.

Query Parameters

Name	Type	Required	Description
`date`	`string`	Optional	Date in YYYY-MM-DD format. Defaults to today if omitted.

bash

curl https://api.possfer.com/api/cashbook?date=2026-03-20 \
  -H "Authorization: Bearer <token>"

json

{
  __PH0__: "2026-03-20",
  __PH2__: [
    {
      __PH3__: "550e8400-e29b-41d4-a716-446655440010",
      __PH5__: "deposit",
      __PH7__: 10000,
      __PH8__: "Wechselgeld Einlage",
      __PH10__: "550e8400-e29b-41d4-a716-446655440000",
      __PH12__: "2026-03-20T09:00:00Z"
    },
    {
      __PH14__: "550e8400-e29b-41d4-a716-446655440011",
      __PH16__: "withdrawal",
      __PH18__: 5000,
      __PH19__: "Einkauf Getraenke",
      __PH21__: "550e8400-e29b-41d4-a716-446655440000",
      __PH23__: "2026-03-20T14:30:00Z"
    }
  ]
}

Daily Summary

GET/api/cashbook/summaryAdmin Only

Returns an aggregated daily summary of all cashbook movements.

Query Parameters

Name	Type	Required	Description
`date`	`string`	Optional	Date in YYYY-MM-DD format. Defaults to today if omitted.

bash

curl https://api.possfer.com/api/cashbook/summary?date=2026-03-20 \
  -H "Authorization: Bearer <token>"

json

{
  __PH0__: "2026-03-20",
  __PH2__: 15000,
  __PH3__: 5000,
  __PH4__: 10000,
  __PH5__: 3
}

Current Balance

GET/api/cashbook/balanceAdmin Only

Returns the current cash balance in the register.

bash

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

json

{
  __PH0__: 52350,
  __PH1__: "2026-03-20T14:30:00Z"
}

Create Entry

Record a new cash movement. Use this for manual deposits, withdrawals, or corrections.

POST/api/cashbookAdmin Only

Create a new cashbook entry.

Request Body

Name	Type	Required	Description
`entry_type`	`string`	Required	Type of entry: "deposit", "withdrawal", or "correction".
`amount`	`integer`	Required	Amount in cents. Must be a positive integer.
`description`	`string`	Required	Description of the cash movement (e.g. reason for deposit or withdrawal).

bash

curl -X POST https://api.possfer.com/api/cashbook \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "entry_type": "deposit",
    "amount": 10000,
    "description": "Wechselgeld Einlage"
  }'

json

{
  __PH0__: "550e8400-e29b-41d4-a716-446655440012",
  __PH2__: "deposit",
  __PH4__: 10000,
  __PH5__: "Wechselgeld Einlage",
  __PH7__: "550e8400-e29b-41d4-a716-446655440000",
  __PH9__: "2026-03-20T09:00:00Z"
}