Process claim deadlines

Internal endpoint that processes expired claim deadlines. Intended for cron/scheduler invocation.

POST /api/v1/dict/internal/claims/process-deadlines

Process claim deadlines

cURL

curl --request POST \
  --url https://spi.sandbox.lerian.net/api/v1/dict/internal/claims/process-deadlines \
  --header 'Authorization: Bearer <token>'

200

{
  "batchSaturated": false,
  "cancelledCount": 2,
  "completedCount": 1,
  "confirmedCount": 1,
  "deferredCount": 0,
  "errors": [],
  "processedCount": 3,
  "reconciledCount": 1,
  "skippedCount": 1
}

Authorizations

Authorization · string · header · required

JWT bearer token issued by the identity provider.

Response

200

application/json

OK

Counts of claims processed, cancelled, and completed during the deadline sweep, plus any per-claim errors

batchSaturated · boolean · required

True when this sweep's read of expired claims came back FULL, so claims already past their deadline exist that it never looked at — every count above then describes only the window, not the expired set. Nothing advances the deadline of a claim the sweep may not drive, so the residue keeps the head of the oldest-first ordering: a true here means the later claims' regulated duties are going unserved. The same condition increments brspi_dict_claim_deadline_window_truncated_total

Example:

false

cancelledCount · integer<int64> · required

Number of claims cancelled because their deadline expired

Example:

2

completedCount · integer<int64> · required

Number of claims auto-completed during the sweep

Example:

1

confirmedCount · integer<int64> · required

Number of claims standing at CONFIRMED at the end of the sweep, from either of two shapes: a possession claim the donor confirmed because its BACEN resolution period ended and the key owner never answered (a duty the DICT manual states as mandatory), or a confirm BACEN already held that the local row adopted with no verb sent — the adopted ones are counted in reconciledCount too. Not counted in processedCount: a confirmed claim is not resolved yet, the claimer still owes its completion

Example:

1

deferredCount · integer<int64> · required

Number of expired claims left undecided by a transient infrastructure failure (scope capability or BACEN unreachable); the next sweep retries them

Example:

0

errors · string[] · required

Per-claim error messages encountered during the sweep; empty when all claims processed cleanly

Example:

[]

processedCount · integer<int64> · required

Number of expired claims the sweep actually drove to a terminal outcome

Example:

3

reconciledCount · integer<int64> · required

Number of expired claims whose local row adopted BACEN's own status instead of sending a verb BACEN would refuse — an ending BACEN had already produced, or the CONFIRMED BACEN already held, which ends nothing and is counted in confirmedCount as well

Example:

1

skippedCount · integer<int64> · required

Number of expired claims left in place because the only outcome BACEN permits belongs to the other institution, or the BACEN period it requires has not elapsed

Example:

1