> For the complete documentation index, see [llms.txt](https://docs.flowretail.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flowretail.com/docs/developers/api-documentation/till/commission-a-till-at-the-fiscal-control-system.md).

# Commission a till at the fiscal control system

Moves the till's register from ACQUIRED to COMMISSIONED at the fiscal control system. Billing starts here. Requires the till to already be registered (ACQUIRED) with the fiscal control system.

Required permissions: TILL

```json
{"openapi":"3.0.2","info":{"title":"Flow Retail API version 2","version":"2.0.0"},"tags":[{"name":"Till","description":"Till"}],"servers":[{"description":"Flow Retail Production","url":"https://api.flowretail.com/v2"},{"description":"Flow Retail Stage","url":"https://api.stage.flowretail.com/v2"}],"security":[{"accessToken":[]},{"authToken":[]},{"integrationToken":[]}],"components":{"securitySchemes":{"accessToken":{"description":"Access token recevied after user login with a deviceToken","scheme":"bearer","type":"http"},"authToken":{"description":"Token received from the auth service","scheme":"bearer","type":"http"},"integrationToken":{"scheme":"bearer","type":"http"}},"responses":{"TillResponse":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TillResponseSchema"}}},"description":"Example response"}},"schemas":{"TillResponseSchema":{"title":"TillResponseSchema","type":"object","required":["cashDrawer","createdAt","lastModifiedAt","lastOrderUid","lastOrderNumber","name","paymentTerminal","settings","status","tillUid","tillNumber","device"],"properties":{"cashDrawer":{"type":"string"},"createdAt":{"format":"date-time","type":"string"},"lastModifiedAt":{"format":"date-time","type":"string"},"lastOrderUid":{"$ref":"#/components/schemas/UID"},"lastOrderNumber":{"type":"string"},"name":{"type":"string"},"paymentTerminal":{"$ref":"#/components/schemas/TillPaymentTerminalENUM"},"settings":{"type":"array","items":{"$ref":"#/components/schemas/TillSettingSchema"}},"status":{"$ref":"#/components/schemas/TillOpenStatusENUM","description":"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."},"tillUid":{"$ref":"#/components/schemas/UID"},"tillNumber":{"type":"integer"},"device":{"$ref":"#/components/schemas/TillDeviceResponseSchema"},"fiscal":{"$ref":"#/components/schemas/TillFiscalResponseSchema"}}},"UID":{"title":"UID","type":"string","pattern":"^[A-Za-z0-9-_]+"},"TillPaymentTerminalENUM":{"description":"`PAYEX` is discontinued: a till already on it keeps it, but no till can be put on it.","enum":["NONE","ADYEN","PAYEX","STRIPE","NETS","VERIFONE","SOFTPAY","DINTERO"],"title":"TillPaymentTerminalENUM","type":"string"},"TillSettingSchema":{"description":"Till specific settings","properties":{"key":{"$ref":"#/components/schemas/TillSettingKeyENUM"},"value":{"type":"string"}},"required":["key","value"],"title":"TillSettingSchema","type":"object"},"TillSettingKeyENUM":{"enum":["STRIPE_TERMINAL_ID","ADYEN_POS_TERMINAL_ID","PAYEX_TERMINAL_IP","PAYEX_TERMINAL_PORT","PAYEX_COMMAND_QUEUE","NETS_TERMINAL_ID","VERIFONE_TERMINAL_POI_ID","DINTERO_TERMINAL_ID","SOFTPAY_APP_ID"],"title":"TillSettingKeyENUM","type":"string"},"TillOpenStatusENUM":{"type":"string","title":"TillOpenStatus","description":"Whether the till currently has an open cash-register session. Distinct from TillStatusENUM (the tri-state cash-report status): this collapses CLOSED_NOT_COUNTED into CLOSED.","enum":["OPEN","CLOSED"]},"TillDeviceResponseSchema":{"title":"TillDeviceResponseSchema","type":"object","nullable":true,"required":["deviceUid","identifier","name"],"properties":{"deviceUid":{"$ref":"#/components/schemas/UID"},"identifier":{"type":"string"},"name":{"type":"string"}}},"TillFiscalResponseSchema":{"title":"TillFiscalResponseSchema","type":"object","description":"The till's identity at the fiscal control system, as a cash register\nunder its store's location.\n\nAbsent for a till that has nothing to do with fiscalization. Present\nfrom registration onwards with every field set - a value not yet\nassigned is an empty string, never null. registerDesignation is the\nfield that stays empty the longest: it only arrives at commissioning,\nso a registered but uncommissioned till carries an empty one.\n","required":["registerId","registerState","registerDesignation"],"properties":{"registerId":{"type":"string","description":"Identifier the fiscal control system assigned this till when it was\nregistered. Empty until then.\n"},"registerState":{"description":"Current state of the till's register at the fiscal control system.\nEmpty when the till has never been registered.\n","$ref":"#/components/schemas/FiscalRegisterStateENUM"},"registerDesignation":{"type":"string","description":"The Swedish \"tillverkningsnummer\" the cash register received from\nthe fiscal control system. Shown to the merchant for Skatteverket\nregistration (§15). Empty until the register is commissioned.\n"}}},"FiscalRegisterStateENUM":{"description":"State of a resource at the fiscal control system: an organization's\ntaxpayer, a store's location, or a till's register. The three share\none set of states and are commissioned top down.\n\nThe empty string is a state of its own: the resource has not been\nregistered yet. It exists because the fiscal objects carry no nullable\nfields - an object that is present has every field present, and \"not\nyet\" is the empty value.\n|ENUM | Description |\n| --- | --- |\n|  | Not registered at the fiscal control system |\n| ACQUIRED | Registered, not yet commissioned |\n| COMMISSIONED | Billing has started |\n| DECOMMISSIONED | Permanently retired, cannot be undone |","enum":["","ACQUIRED","COMMISSIONED","DECOMMISSIONED"],"title":"FiscalRegisterState","type":"string"}}},"paths":{"/tenants/{tenantUid}/stores/{storeUid}/tills/{tillUid}/fiscal/commission":{"post":{"summary":"Commission a till at the fiscal control system","description":"Moves the till's register from ACQUIRED to COMMISSIONED at the fiscal\ncontrol system. Billing starts here. Requires the till to already be\nregistered (ACQUIRED) with the fiscal control system.\n\nRequired permissions: TILL\n","operationId":"post-tenants-stores-tills-fiscal-commission","responses":{"200":{"$ref":"#/components/responses/TillResponse"},"400":{"description":"Bad Request"},"404":{"description":"Not Found"}},"tags":["Till"]}}}}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.flowretail.com/docs/developers/api-documentation/till/commission-a-till-at-the-fiscal-control-system.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
