Pay at Table

Report a tab error

Reports an error from the ePOS for a specific tab (e.g., table not found, bill already settled). The server accepts the rejection and notifies the affected terminal so it can surface the error to the operator.

post/poslink/v1/tabs/{tab_id}/errors

Request

Base URL
https://api.teya.com
Auth
OAuth 2
Authorization codehttps://id.teya.com/oauth/v2/oauth-authorize
Token URLhttps://id.teya.com/oauth/v2/oauth-token
TypeScript
https://skmtc.dev/teya/apis/poslink-api/docs/poslink/v1/tabs/:tab_id/errors/post.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

tab_idstring uuid required

The tab identifier

Request body

terminal_idstring required

The terminal reporting the error

error_code'TABLE_NOT_FOUND' | 'BILL_ALREADY_SETTLED' | 'EPOS_ERROR' | 'REQUEST_REJECTED' required

Error code

messagestring required

Human-readable error message

Example request

{
  "terminal_id": "term-001",
  "error_code": "TABLE_NOT_FOUND",
  "message": "Table 5 was not found in the ePOS system"
}

Response

Rejection accepted and forwarded to the terminal

tab_idstring uuid

Tab identifier

status'OPEN' | 'PAYING' | 'PAUSED' | 'COMPLETED' | 'CLOSED'

Current tab status

Example response

{
  "tab_id": "3f2b6a2e-9d3e-4a1f-8f1e-6b2e5a8c9d01",
  "status": "OPEN"
}

Changes

No recorded changes to this operation across all 1 revision of this API.