Record a contingency schedule change

Records an out-of-band-received Núclea schedule announcement (OP002 §14 = telephone/e-mail) as an operator-entered operational fact, projected verbatim. The câmara’s own wire grids (LDL0024, LDL0023R1) are read at listScheduleGrids; nothing here computes a schedule. The recorded change appends an audit row, raises the single active SCHEDULE_CHANGE alert (deadline_at = effectiveAt), and emits a schedule.change-recorded fact — all atomically. windowSeq 3 records the LBTR close Núclea announces when it extends the grade on a day BACEN declares the STR down (OP002 §14.5): the movement day’s LTR0002, LTR0008 and SLC0004 stay open until it instead of 17h30, and every other code of that day (requests, and queries by their NUOp day) stays open until it instead of midnight. A close recorded after 17h30 reopens nothing the 17h30 close already failed.

POST /api/v1/siloc/schedule/changes

Record a contingency schedule change

cURL

curl --request POST \
  --url https://api.example.com/api/v1/siloc/schedule/changes \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Idempotency: <x-idempotency>' \
  --data '
{
  "effectiveAt": "2023-11-07T05:31:56Z",
  "origin": "<string>",
  "reason": "<string>",
  "windowSeq": 2
}
'

201

{
  "announcedAt": "2023-11-07T05:31:56Z",
  "effectiveAt": "2023-11-07T05:31:56Z",
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "origin": "<string>",
  "reason": "<string>",
  "windowSeq": 123
}

Autorizações

Authorization · string · header · obrigatório

JWT bearer token issued by the identity provider.

Cabeçalhos

X-Idempotency · string · obrigatório

Idempotency key for this state-changing request (required, max 255 characters).

Maximum string length: 255

Corpo

application/json

effectiveAt · string<date-time> · obrigatório

The announced instant the change takes effect (RFC3339); with windowSeq 1 or 2, the announced new deposit close, which moves that window's WINDOW_CLOSING deadline and must fall on the window's São Paulo date, no earlier than it opens (else 422; record a close after midnight without windowSeq); with windowSeq 3, the extended LBTR close, after its movement day's 17h30 and before the next day's 06h40 LBTR open, so a close past midnight extends the day before (else 422).

origin · string · obrigatório

The announcing channel / upstream reference (non-empty, ≤256 chars).

Maximum string length: 256

reason · string · obrigatório

Why the schedule changed (non-empty, ≤500 chars).

Maximum string length: 500

windowSeq · integer<int64>

The affected canonical window's grid sequence (1 or 2, validated against the compiled window grid), or 3 for the card LBTR cycle's close that Núclea announces when it extends the grade on a day BACEN declares the STR down; omit for a non-window-specific note.

Intervalo obrigatório: x >= 1

Resposta

201

application/json

Created

announcedAt · string<date-time> · obrigatório

When the change was recorded (intake instant).

effectiveAt · string<date-time> · obrigatório

The announced instant the change takes effect, recorded verbatim (for a window prorrogação, the announced new close).

id · string<uuid> · obrigatório

Schedule change id.

origin · string · obrigatório

Auditable origin — the announcing channel / upstream reference (e.g. "Núclea e-mail ref X").

reason · string · obrigatório

Why the schedule changed, as recorded by the operator.

windowSeq · integer<int64>

The affected canonical window's grid sequence (1 or 2), or 3 for the LBTR close; omitted for a non-window-specific note.