Error
A valid request URL is required to generate request examples{
"id": "clo-1",
"chainId": "store-close",
"kind": "daily",
"period": "2026-07-16",
"periodStart": "2026-07-16",
"periodEnd": "2026-07-16",
"ticketCount": 2,
"grossTotalCents": 7200,
"grandTotalCents": 7200,
"sequenceNumber": 1,
"closedAt": "2026-07-16T18:00:00.000Z",
"previousValue": "GENESIS",
"algorithm": "hmac-sha256-v2",
"value": "c2f3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2c3"
}{
"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
}
}{
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"statusCode": 123
}
}Fiscal
Get one sealed closure by period
Reads one sealed closure selected by ?kind= + ?period=. store (the chain id) is REQUIRED; without it the route 400s, and a period that is not yet closed 404s.
GET
/
v1
/
fiscal
/
closure
Error
A valid request URL is required to generate request examples{
"id": "clo-1",
"chainId": "store-close",
"kind": "daily",
"period": "2026-07-16",
"periodStart": "2026-07-16",
"periodEnd": "2026-07-16",
"ticketCount": 2,
"grossTotalCents": 7200,
"grandTotalCents": 7200,
"sequenceNumber": 1,
"closedAt": "2026-07-16T18:00:00.000Z",
"previousValue": "GENESIS",
"algorithm": "hmac-sha256-v2",
"value": "c2f3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2c3"
}{
"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
}
}{
"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.
Closure kind: an optional list filter, but REQUIRED to select one closure.
Available options:
daily, monthly, annual Period key matching the kind (YYYY-MM-DD / YYYY-MM / YYYY). REQUIRED to select one closure.
Response
The sealed closure record for the selected period.
The sealed closure record for the selected period.
Available options:
daily, monthly, annual Required range:
-9007199254740991 <= x <= 9007199254740991Required range:
-9007199254740991 <= x <= 9007199254740991Required range:
-9007199254740991 <= x <= 9007199254740991Required range:
-9007199254740991 <= x <= 9007199254740991
