Register a till with the fiscal control system

Creates the till at the fiscal control system in state ACQUIRED. No billing starts here. Requires the FISCAL extension to be active on the tenant and the store, and the store to have a fiscal location id.

Required permissions: TILL

post

/tenants/{tenantUid}/stores/{storeUid}/tills/{tillUid}/fiscal/register

Authorizations

AuthorizationstringRequired

Access token recevied after user login with a deviceToken

Path parameters

tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+

storeUidstringRequired

Reference to a Store.

Pattern: ^[A-Za-z0-9-_]+

tillUidstringRequired

Reference to a till.

Pattern: ^[A-Za-z0-9-_]+

Responses

200

Example response

application/json

cashDrawerstringRequired

createdAtstring · date-timeRequired

lastModifiedAtstring · date-timeRequired

lastOrderUidstringRequiredPattern: ^[A-Za-z0-9-_]+

lastOrderNumberstringRequired

namestringRequired

paymentTerminalstring · enumRequiredPossible values:

statusstring · enumRequired

Current open/closed state of the till. OPEN means a cash-register session is active; CLOSED means none is. For full session details (counted amounts, cash revenue, open/close users) use the till status endpoint.

Possible values:

tillUidstringRequiredPattern: ^[A-Za-z0-9-_]+

tillNumberintegerRequired

400

Bad Request

404

Not Found

post/tenants/{tenantUid}/stores/{storeUid}/tills/{tillUid}/fiscal/register

POST /v2/tenants/{tenantUid}/stores/{storeUid}/tills/{tillUid}/fiscal/register HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "cashDrawer": "text",
  "createdAt": "2026-01-01T00:00:00.000Z",
  "lastModifiedAt": "2026-01-01T00:00:00.000Z",
  "lastOrderUid": "text",
  "lastOrderNumber": "text",
  "name": "text",
  "paymentTerminal": "NONE",
  "settings": [
    {
      "key": "STRIPE_TERMINAL_ID",
      "value": "text"
    }
  ],
  "status": "OPEN",
  "tillUid": "text",
  "tillNumber": 1,
  "device": {
    "deviceUid": "text",
    "identifier": "text",
    "name": "text"
  },
  "fiscal": {
    "registerId": "text",
    "registerState": "",
    "registerDesignation": "text"
  }
}