Verify the fiscal chain integrity

Verifies a register chain end to end (vérification du chaînage — tamper / sequence-gap / broken-link detection), returning { valid, length } and, on a break, the brokenAt sequence and the reason. store (the chain id) is REQUIRED; without it the route 400s, and a store with no chain yet 404s.

GET /v1/fiscal/verify

Error

A valid request URL is required to generate request examples

200

{
  "valid": true,
  "length": 2
}

Authorizations

Authorization · string · header · required

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

store · string

REQUIRED — the register chain id (per store). Missing → 400.

day · string

Optional UTC calendar day (YYYY-MM-DD) to window the period. Malformed → 400.

Response

200

application/json

The end-to-end integrity verdict for the chain.

The end-to-end integrity verdict for the chain.

valid · boolean · required

length · integer · required

Required range: -9007199254740991 <= x <= 9007199254740991

brokenAt · integer

Required range: -9007199254740991 <= x <= 9007199254740991

reason · enum<string>

Available options: SEQUENCE_GAP, BROKEN_LINK, TAMPERED_VALUE, UNKNOWN_ALGORITHM