Remove Cash From Teller Till

Overview

Removes cash from a teller till for deposit to vault or other purposes.

Command

RemoveCashFromTellerTillCommand

Endpoint

POST /api/bpm/cmd

Request Headers

Authorization: Bearer {access_token}
Content-Type: application/json
X-Tenant-Id: {tenant_id}

Request Body

{
  "cmd": "RemoveCashFromTellerTillCommand",
  "data": {
    "tillId": "TILL-T001",
    "amount": 50000.00,
    "destinationType": "Vault",
    "destinationId": "VLT-001",
    "narration": "End of day till deposit to vault"
  }
}

Request Parameters

Parameter	Type	Required	Description
cmd	string	Yes	Must be "RemoveCashFromTellerTillCommand"
data	object	Yes	Cash removal data
↳ tillId	string	Yes	Unique identifier of the till
↳ amount	decimal	Yes	Amount to remove (must be positive)
↳ destinationType	string	Yes	Destination for cash (Vault, BankTransfer, CashOut)
↳ destinationId	string	No	Identifier of destination (vault ID, etc.)
↳ narration	string	Yes	Description of the cash removal

• Description: Transaction description

Response

Success Response (200 OK)

{
  "success": true,
  "message": "Cash removed from till successfully",
  "data": {
    "transactionId": "string",
    "tillId": "string",
    "amount": "decimal",
    "previousBalance": "decimal",
    "newBalance": "decimal",
    "transactionDate": "datetime"
  }
}

Error Responses

400 Bad Request

{
  "success": false,
  "message": "Validation failed",
  "errors": ["Till ID is required", "Amount must be positive"]
}

409 Conflict

{
  "success": false,
  "message": "Insufficient till balance"
}

Business Rules

1. Till must be in "Open" status
2. Till must have sufficient balance
3. Amount must be positive
4. Creates audit trail entry

Code Example

async function removeCashFromTellerTill(tillId, amount, narration) {
  const response = await fetch('/api/bpm/cmd', {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${accessToken}`,
      'Content-Type': 'application/json',
      'X-Tenant-Id': tenantId
    },
    body: JSON.stringify({
      commandType: 'RemoveCashFromTellerTillCommand',
      data: {
        tillId: tillId,
        amount: amount,
        destinationType: 'Vault',
        narration: narration
      }
    })
  });
  
  return await response.json();
}

Related Commands

• Add Cash To Teller Till - Add cash
• Close Teller Till - Close till

Notes

• Verify till balance before removal
• Document denomination details
• Use for excess cash management during shift