Skip to main content
POST
Confirm or diverge from an announced settlement result

Autorizações

Authorization
string
header
obrigatório

JWT bearer token issued by the identity provider.

Cabeçalhos

X-Idempotency
string
obrigatório

Required. Scopes this answer so a retry replays the stored response instead of sending a second command for the same result.

Parâmetros de caminho

resultId
string
obrigatório

Announced result id (UUID).

Exemplo:

"018f8a3e-4b2c-7c1a-9e5d-2f6a1b3c4d5e"

Corpo

application/json
announcedAmount
string
obrigatório

The announced amount you are answering for, as a decimal string (e.g. "1234.56"). It must EQUAL the amount the câmara announced or the command is refused with 422: a confirmation that does not say what it confirms is not auditable. Compared as a decimal, so "100.1" and "100.10" are the same money.

Exemplo:

"1234.56"

decision
string
obrigatório

CONFIRM or DIVERGE (case-insensitive). CONFIRM accepts the announced result; DIVERGE disputes it. Both ride the same wire tag; the product words differ because the câmara's own event titles them differently.

Exemplo:

"CONFIRM"

Resposta

Accepted

commandId
string
obrigatório

The command's id (a UUIDv7 minted by this service). It is the key every later fact joins on and the id to read the command back by.

Exemplo:

"0199a2e8-7a1c-7c1a-9e5d-2f6a1b3c4d5e"

messageType
string
obrigatório

The outbound message this command originates: LTR0002 (result answer), LTR0008 (non-liquidante answer) or LTR0009 (position query).

Exemplo:

"LTR0002"

requestedAt
string
obrigatório

When the institution decided (RFC3339, UTC).

Exemplo:

"2026-09-22T13:04:11Z"

sourceAggregateId
string
obrigatório

The announcement this command answers. For a position query it is the command's own id, because a query answers no announcement.

Exemplo:

"018f8a3e-4b2c-7c1a-9e5d-2f6a1b3c4d5e"

sourceAggregateVersion
integer<int64>
obrigatório

The version of the announcement this command was authorised against, kept so a later reader can see which view of it was answered.

Exemplo:

1

status
string
obrigatório

Always REQUESTED here: the command row and its outbound event are committed and nothing has been sent yet. Poll the command to see it reach ACCEPTED, ANSWERED, REFUSED or FAILED.

Exemplo:

"REQUESTED"