Create SILOC operational deposit (LDL0022)

Commands the outbound LDL0022 operational deposit of one registered SILOC OT deposit-required advisory, the first time or again after its LDL0022R1 came back rejected or cancelled or the STR refused the frame (LDL0022E). The body names the advisory only: the amount, the side (DEBIT), the NUOps, the NumCtrlLDL and the period come from the advisory, the ISPBs (funding IF + SILOC câmara) and the movement date from the server, and every deposit mints its own NumCtrlIF. The advisory’s traceability reaches the deposit facts. An unknown advisory answers 404; a credit-expected advisory 422; an advisory whose deposit is awaiting, pending or effected at the STR, or that a later LDL0021 of the same cycle (a recálculo round) replaced, answers 409. The command is persisted idempotently and its signed LDL0022 frame is enqueued for STR dispatch in the same transaction. This means dispatch was accepted, not SILOC settlement confirmation; the outcome arrives asynchronously on the LDL0022R1 leg. Above the client’s alçada band the frame parks (status PENDING_APPROVAL) and leaves for the STR only when the quorum signs; a denial or expiry ends it without dispatch. Idempotent — replaying the same X-Idempotency key with the same parsed request (member order and whitespace do not count; any other difference, such as number spelling, null for an absent field, or an unknown member, is another request) returns the cached response. Lerian SPB EMITS the deposit-command fact + correlation and routes settlement; it holds NO SILOC position.

POST /v1/str/operations/ldl-deposits

Create SILOC operational deposit (LDL0022)

cURL

curl --request POST \
  --url https://api.example.com/v1/str/operations/ldl-deposits \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Idempotency: <x-idempotency>' \
  --data '
{
  "advisoryId": "7c8b3a2e-9f1d-4a55-9b8e-1e1234567890"
}
'

201

{
  "advisoryEventId": "<string>",
  "amountRaw": "<string>",
  "commandId": "<string>",
  "correlationId": "req-7a3f9c2e",
  "movementDate": "<string>",
  "numCtrlIF": "<string>",
  "outboundNuOp": "<string>",
  "product": "<string>",
  "side": "<string>",
  "status": "ACCEPTED"
}

Authorizations

Authorization · string · header · required

JWT bearer token issued by the identity provider.

Headers

X-Idempotency · string · required

Idempotency key. Required on every mutation.

X-TTL · string

Seconds the cached response is kept; it may only shorten IDEMPOTENCY_DEFAULT_TTL_SEC.

Body

application/json

advisoryId · string<uuid> · required

ce-id of the registered SILOC deposit-required advisory to deposit; an unknown advisory answers 404, a credit-expected one 422. Receipt of the advisory authorizes no money; this authenticated command does.

Example:

"7c8b3a2e-9f1d-4a55-9b8e-1e1234567890"

Response

201

application/json

Created

advisoryEventId · string · required

amountRaw · string · required

commandId · string · required

correlationId · string · required

Request-scoped correlation identifier echoing X-Request-ID, for pivoting from response to trace.

Example:

"req-7a3f9c2e"

movementDate · string · required

numCtrlIF · string · required

outboundNuOp · string · required

Pattern: ^[0-9A-Z]{8}[0-9]{15}$

product · string · required

side · string · required

status · enum<string> · required

ACCEPTED when the frame was queued for the STR, PENDING_APPROVAL when the alçada band parked it awaiting signatures.

Available options: ACCEPTED, PENDING_APPROVAL