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
}

Autorizaciones

Authorization · string · header · requerido

JWT bearer token issued by the identity provider.

Encabezados

X-Idempotency · string · requerido

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

Maximum string length: 255

Cuerpo

application/json

effectiveAt · string<date-time> · requerido

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, and its movement day must be a business day (else 422).

origin · string · requerido

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

Maximum string length: 256

reason · string · requerido

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.

Rango requerido: x >= 1

Respuesta

201

application/json

Created

announcedAt · string<date-time> · requerido

When the change was recorded (intake instant).

effectiveAt · string<date-time> · requerido

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

id · string<uuid> · requerido

Schedule change id.

origin · string · requerido

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

reason · string · requerido

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.