> ## Documentation Index
> Fetch the complete documentation index at: https://docs.onnucleus.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Teller & Cash Operations

> Till management, cash deposits, cash withdrawals, and maker-checker vault controls.

Teller operations control over-the-counter physical cash handling at the branch level.

## Key Rules

1. **Till Allocation:** A Teller must have an allocated, open cash till tied to their user ID and branch before posting cash transactions.
2. **Four-Eyes Principle on Cash:** Cash withdrawals exceeding the teller's single-transaction ceiling (e.g. > ₦500,000) require on-the-spot checker approval from the **Branch Manager (Role `320007`)** or **Branch Head of Operations**.

***

## 1. Cash Deposit (Cash-In)

```bash theme={null}
POST /nucleus/api/v1/savingsaccounts/12/transactions?command=deposit&tenantIdentifier=pilot-mfb
Content-Type: application/json

{
  "transactionDate": "12 September 2026",
  "transactionAmount": 100000.00,
  "paymentTypeId": 1,
  "dateFormat": "dd MMMM yyyy",
  "locale": "en"
}
```

**GL Accounting Posting:**

* **Debit:** Cash in Hand / Teller Till (`GL 11101`)
* **Credit:** Customer Savings Liability (`GL 21101`)

***

## 2. Cash Withdrawal (Cash-Out)

```bash theme={null}
POST /nucleus/api/v1/savingsaccounts/12/transactions?command=withdrawal&tenantIdentifier=pilot-mfb
Content-Type: application/json

{
  "transactionDate": "12 September 2026",
  "transactionAmount": 50000.00,
  "paymentTypeId": 1,
  "dateFormat": "dd MMMM yyyy",
  "locale": "en"
}
```

***

## 3. End-of-Day Till Balancing

At branch closing, the teller reconciles physical cash against the system balance and submits the till closure:

```bash theme={null}
POST /nucleus/api/v1/cashiers/{cashierId}/settle?tenantIdentifier=pilot-mfb
Content-Type: application/json

{
  "endDate": "12 September 2026",
  "dateFormat": "dd MMMM yyyy",
  "locale": "en"
}
```