# Getting started

A transaction (TX) is a hardbaked, GOBD compliant, legally binding representation of a sale conducted in a electronical cash register (ECR). Only transactions created by any of the Tillhub Clients can be deemed as correct and legally fully compliant. Considering the legal requirements and environments. E.g. you Tillhub ECR must be configured in the right way, for your environment, country/region, etc.

However, Tillhub per se provides legally binding docs per default for the DACH Region.

The model itself might underly regular maintenance and changes due to legislative adjustments.

Transactions are a core of the tillhub system and thus should be thoroughly understood when dealt with.

# The Datamodel

Tillhub divides the TX into sub-models, encoding the business logic of ECRs:

  • Core TX: sums, dependencies to external resources (revenue accounts, tax accounts), and generally speaking top level transaction information
  • cart items: list of items involved in the creation of the transactions, e.g. products, tips, vouchers/gift cards, discounts, and all their commercial parameters
  • payments: list of payments such as cash, card, voucher/giftcard including their processing information

# Immutability of a TX

Transactions are by law binding and you may or may not be audited by you local fiskal authorities. Because of this, transactions are in its nature immutable. Therefore, Tillhub does not provide any means of manipulating transactions via tha API (opens new window). You also may or may not be subject to fiskal signing systems. This means, your transactions might be transmitted to an external cryptographic unit that assures that your transactions are continuously valid, stored, and in itself truthfull. So that audits can be conducted and the journal is proofen to be untampered. More on this topic (for German speaking readers here (opens new window)).

The Transaction is also the technical/digital representation of a receipt. It carries the plaintext receipt printed by the Tillhub ECR or provided as digital representation via E-Mail (PDF).