Close a POS session
POST/pos/sessions/{id}/close
Closes an open cashier session. The cashier declares the actual cash counted in the till; the system computes variance against expected cash, closes the session, and generates a DailySummary record for reporting.
Request
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
id | integer | Yes | The integer ID of the open session to close. Example: |
Request body
Content type application/json (required).
| Field | Type | Required | Description |
|---|---|---|---|
actual_cash | number | Yes | The physical cash amount counted in the till at close. Used to compute the cash variance for the session report. Minimum: 0 |
notes | string | No | Optional handover or variance notes. |
Example
{
"actual_cash": 385.5,
"notes": "Slight short — $1.00 variance, coins missing."
}Responses
302 Redirect to the session detail page on success
400 Session is already closed
404 Session not found
422 Validation error — actual_cash is required
Example request
curl -X POST "https://{tenant}.faciotech.net/api/v1/pos/sessions/{id}/close" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{"actual_cash": 385.5, "notes": "Slight short — $1.00 variance, coins missing."}'