Reopen Teller Till

Overview

Reopens a previously closed teller till, allowing the teller to continue processing transactions.

Command

ReOpenTellerTillCommand

Endpoint

POST /api/bpm/cmd

Request Headers

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

Request Body

{
  "cmd": "ReOpenTellerTillCommand",
  "data": {
    "tillId": "TILL-T001",
    "reason": "Additional transactions needed for late customer service",
    "approvedBy": "SUPER-001"
  }
}

Request Parameters

Parameter	Type	Required	Description
cmd	string	Yes	Must be "ReOpenTellerTillCommand"
data	object	Yes	Reopen request data
↳ tillId	string	Yes	Unique identifier of the till to reopen
↳ reason	string	Yes	Reason for reopening the till
↳ approvedBy	string	No	Supervisor who approved the reopening

Response

Success Response (200 OK)

{
  "success": true,
  "message": "Teller till reopened successfully",
  "data": {
    "tillId": "string",
    "tellerId": "string",
    "status": "Open",
    "reopenedDate": "datetime",
    "reason": "string",
    "approvedBy": "string"
  }
}

Error Responses

400 Bad Request

{
  "success": false,
  "message": "Validation failed",
  "errors": ["Till ID is required", "Reason is required"]
}

404 Not Found

{
  "success": false,
  "message": "Till not found"
}

409 Conflict

{
  "success": false,
  "message": "Till is already open"
}

Business Rules

1. Only closed tills can be reopened
2. Reason must be provided for audit purposes
3. May require supervisor approval
4. Original till balance is restored
5. Creates audit trail entry

Code Example

async function reopenTellerTill(tillId, reason) {
  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: 'ReOpenTellerTillCommand',
      data: {
        tillId: tillId,
        reason: reason
      }
    })
  });
  
  return await response.json();
}

Related Commands

• Close Teller Till - Close till
• Undo Close Teller Till - Undo closure
• Get Teller Till List - View all tills

Notes

• Document reason clearly for audit compliance
• Verify till balance before reopening
• Notify relevant parties of till reopening
• Review transactions before reopening closed tills