What moves the safe

Cash Management keeps one balance per safe and currency. It never counts the safe by itself: the balance is the sum of every movement booked into and out of it. A movement comes from one of two places:

• Reconciliation, which reports the cash moving between the drawers and the safe;
• the store staff, who record bank deposits and withdrawals, safe counts and safe audits in Hii InStore or through the API.

Each movement is booked as a transaction with an event type, and published. The balance after each transaction is published with it.

One day in the safe

The example follows the store from Reconciliation's examples: one till, amounts in NOK, on 30 September.

Time	What happened	Event type	Safe
	start of the day		10 000
morning	till 1 opens with a 2 000 float	InitialBalance	8 000
15:30	1 000 is taken from till 1's drawer to the safe	Transfer	9 000
18:05	till 1 is counted: 1 620 goes back into the safe	Reconciliation	10 620
19:40	the manager recounts till 1 and finds 10 more	ReconciliationRecount	10 630
20:10	safe audit: the rest of the safe holds 5 less than expected	Correction	10 625
20:10	safe audit: 2 625 goes into a bank bag	BankDeposit	8 000

The safe audit is described in The safe audit.

Every kind of movement

Event type	Source	What happened	The safe
InitialBalance	Reconciliation	a till audit started with a float	− the float
Transfer	Reconciliation	cash moved between a drawer and the safe during the day: a tender loan or a tender deposit	− a loan, + a deposit
Reconciliation	Reconciliation	a drawer's till audit was completed	+ the counted cash
ReconciliationRecount	Reconciliation	a completed till audit was recounted	+ or − the correction
CashChangerTransfer	Reconciliation	a cash changer's till audit was completed	+ the counted cash
CashChangerRecount	Reconciliation	a cash changer's till audit was recounted	+ or − the correction
BankWithdrawal	store staff	cash was fetched from the bank	+ the amount
BankDeposit	store staff	cash was sent to the bank, by itself or as the bank drop of a safe audit	− the amount
Correction	store staff	the safe was counted, by itself or in a safe audit, and held more or less than expected	+ or − the difference
the id of a customer-defined field	store staff	a safe audit recorded an amount in one of the tenant's own safe-audit fields	+ or − the amount

⚠ The list of event types is open. Each tenant can define its own safe-audit fields, and each field's id becomes an event type. Code that reads the events must handle values it does not recognise. See Receiving the events.

Which tenders and amounts count

• Only cash moves the safe. Cash Management takes the tenders whose type in the tender configuration (che.tender, field classCode) is cash or foreign currency, and ignores cards, vouchers, gift cards and the rest. A tender Cash Management does not know is ignored too. See What Cash Management receives.
• One line per currency. Two cash tenders in the same currency, such as notes and coins set up as separate tenders, are added together into one line.
• A currency with nothing in it is left out. A till audit where a currency was neither expected nor counted adds no line for it.
• A till audit with nothing to count puts its expected amount into the safe, because Reconciliation takes the expected amount as counted.
• A rejected count moves nothing. Only the approved count of a till audit does.
• A cash changer's cash goes into the safe too, as CashChangerTransfer and CashChangerRecount, so it can be told apart from the drawers' cash.

🛑 The store needs a safe. Cash Management books Reconciliation's events into the store's safe. For a store without one, it ignores them, and they are not kept for later. See The safe.

Amounts and precision

Amounts are in the currency's major unit, with two decimals. Each line is booked in one currency only: Cash Management does not convert between currencies, and the safe holds a separate balance for each.

A balance can go below zero when more cash is booked out of the safe than into it, for example a store's first floats before its opening balance has been entered. Nothing is refused; a count, or a correction, brings it back to what is really there.