A valid request URL is required to generate request examples{
"kind": "X",
"chainId": "store-fiscal",
"generatedAt": "2026-07-16T18:00:00.000Z",
"periodDay": null,
"ticketCount": 2,
"salesCount": 2,
"refundsCount": 0,
"turnoverByTender": [
{
"method": "cash",
"grossCents": 7200,
"ticketCount": 2
}
],
"vatBreakdown": [
{
"rate": 20,
"baseCents": 6000,
"vatCents": 1200,
"grossCents": 7200
}
],
"vatTotalCents": 1200,
"grossTotalCents": 7200,
"grandTotalCents": 7200,
"sequenceFrom": 1,
"sequenceTo": 2,
"signatureCount": 2
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123,
"fieldErrors": [
{
"field": "<string>",
"message": "<string>"
}
]
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}Fiscal X (mid-shift read)
The same figures as the Z (turnover by tender, VAT breakdown, counts, perpetual grand total) but mid-shift and NON-closing — this route writes nothing and never closes a session. store (the chain id) is REQUIRED; a missing store or a malformed day 400s. Pass an optional ?day= UTC calendar day to window the period.
A valid request URL is required to generate request examples{
"kind": "X",
"chainId": "store-fiscal",
"generatedAt": "2026-07-16T18:00:00.000Z",
"periodDay": null,
"ticketCount": 2,
"salesCount": 2,
"refundsCount": 0,
"turnoverByTender": [
{
"method": "cash",
"grossCents": 7200,
"ticketCount": 2
}
],
"vatBreakdown": [
{
"rate": 20,
"baseCents": 6000,
"vatCents": 1200,
"grossCents": 7200
}
],
"vatTotalCents": 1200,
"grossTotalCents": 7200,
"grandTotalCents": 7200,
"sequenceFrom": 1,
"sequenceTo": 2,
"signatureCount": 2
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123,
"fieldErrors": [
{
"field": "<string>",
"message": "<string>"
}
]
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}Authorizations
Authorization: Bearer <token>. Accepts EITHER a Keycloak access token (scopes-in-token) OR an opaque POS session token; both resolve to the same pos.* scope vocabulary the route guards enforce.
Query Parameters
REQUIRED — the register chain id (per store). Missing → 400.
Optional UTC calendar day (YYYY-MM-DD) to window the period. Malformed → 400.
Response
The X read figures for the (optionally windowed) period.
The X read figures for the (optionally windowed) period.
Z, X -9007199254740991 <= x <= 9007199254740991-9007199254740991 <= x <= 9007199254740991-9007199254740991 <= x <= 9007199254740991Show child attributes
Show child attributes
Show child attributes
Show child attributes
-9007199254740991 <= x <= 9007199254740991-9007199254740991 <= x <= 9007199254740991-9007199254740991 <= x <= 9007199254740991-9007199254740991 <= x <= 9007199254740991-9007199254740991 <= x <= 9007199254740991-9007199254740991 <= x <= 9007199254740991