Create SILOC operational deposit (LDL0022)

curl --request POST \
  --url https://spb.sandbox.lerian.net/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",
  "amount": "600.10",
  "instructionId": "5f2c1b0a-7e6d-4c3b-8a19-0d9876543210",
  "side": "DEBIT",
  "traceabilityId": "EZQJMC46QP5EWE3T400A"
}
'

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://spb.sandbox.lerian.net/v1/str/operations/ldl-deposits"

	payload := strings.NewReader("{\n  \"advisoryId\": \"7c8b3a2e-9f1d-4a55-9b8e-1e1234567890\",\n  \"amount\": \"600.10\",\n  \"instructionId\": \"5f2c1b0a-7e6d-4c3b-8a19-0d9876543210\",\n  \"side\": \"DEBIT\",\n  \"traceabilityId\": \"EZQJMC46QP5EWE3T400A\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-Idempotency", "<x-idempotency>")
	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

const options = {
  method: 'POST',
  headers: {
    'X-Idempotency': '<x-idempotency>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    advisoryId: '7c8b3a2e-9f1d-4a55-9b8e-1e1234567890',
    amount: '600.10',
    instructionId: '5f2c1b0a-7e6d-4c3b-8a19-0d9876543210',
    side: 'DEBIT',
    traceabilityId: 'EZQJMC46QP5EWE3T400A'
  })
};

fetch('https://spb.sandbox.lerian.net/v1/str/operations/ldl-deposits', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://spb.sandbox.lerian.net/v1/str/operations/ldl-deposits"

payload = {
    "advisoryId": "7c8b3a2e-9f1d-4a55-9b8e-1e1234567890",
    "amount": "600.10",
    "instructionId": "5f2c1b0a-7e6d-4c3b-8a19-0d9876543210",
    "side": "DEBIT",
    "traceabilityId": "EZQJMC46QP5EWE3T400A"
}
headers = {
    "X-Idempotency": "<x-idempotency>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

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

{
  "correlationId": "req-7a3f9c2e",
  "code": "SPB-0001",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "SPB-0001",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "SPB-0001",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "SPB-0001",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "SPB-0001",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "SPB-0001",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "SPB-0001",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "SPB-0001",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "SPB-0001",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "SPB-0001",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "SPB-0001",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "SPB-0001",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

Create SILOC operational deposit (LDL0022)

Commands an outbound LDL0022 operational deposit into the SILOC deferred-net settlement câmara in response to a registered SILOC deposit-required advisory. The client declares the advisory + instruction it settles, the SILOC traceability (echoed as the command NumCtrlIF), the positive money magnitude, and the explicit DEBIT side; the platform SERVER-DERIVES the wire ISPBs (funding IF + SILOC câmara), the OT product, and the movement date — none are client-supplied and none is reconstructed from the advisory. 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. Idempotent — replaying the same X-Idempotency key with the same body returns the cached response. Lerian SPB EMITS the deposit-command fact + correlation and routes settlement; it holds NO SILOC position.

POST

str

operations

ldl-deposits

Create SILOC operational deposit (LDL0022)

curl --request POST \
  --url https://spb.sandbox.lerian.net/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",
  "amount": "600.10",
  "instructionId": "5f2c1b0a-7e6d-4c3b-8a19-0d9876543210",
  "side": "DEBIT",
  "traceabilityId": "EZQJMC46QP5EWE3T400A"
}
'

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://spb.sandbox.lerian.net/v1/str/operations/ldl-deposits"

	payload := strings.NewReader("{\n  \"advisoryId\": \"7c8b3a2e-9f1d-4a55-9b8e-1e1234567890\",\n  \"amount\": \"600.10\",\n  \"instructionId\": \"5f2c1b0a-7e6d-4c3b-8a19-0d9876543210\",\n  \"side\": \"DEBIT\",\n  \"traceabilityId\": \"EZQJMC46QP5EWE3T400A\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-Idempotency", "<x-idempotency>")
	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

const options = {
  method: 'POST',
  headers: {
    'X-Idempotency': '<x-idempotency>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    advisoryId: '7c8b3a2e-9f1d-4a55-9b8e-1e1234567890',
    amount: '600.10',
    instructionId: '5f2c1b0a-7e6d-4c3b-8a19-0d9876543210',
    side: 'DEBIT',
    traceabilityId: 'EZQJMC46QP5EWE3T400A'
  })
};

fetch('https://spb.sandbox.lerian.net/v1/str/operations/ldl-deposits', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://spb.sandbox.lerian.net/v1/str/operations/ldl-deposits"

payload = {
    "advisoryId": "7c8b3a2e-9f1d-4a55-9b8e-1e1234567890",
    "amount": "600.10",
    "instructionId": "5f2c1b0a-7e6d-4c3b-8a19-0d9876543210",
    "side": "DEBIT",
    "traceabilityId": "EZQJMC46QP5EWE3T400A"
}
headers = {
    "X-Idempotency": "<x-idempotency>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

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

{
  "correlationId": "req-7a3f9c2e",
  "code": "SPB-0001",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "SPB-0001",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "SPB-0001",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "SPB-0001",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "SPB-0001",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "SPB-0001",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "SPB-0001",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "SPB-0001",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "SPB-0001",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "SPB-0001",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "SPB-0001",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "correlationId": "req-7a3f9c2e",
  "code": "SPB-0001",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

Autorizações

Authorization

string

header

obrigatório

JWT bearer token issued by the identity provider.

Cabeçalhos

X-Idempotency

string

obrigatório

Idempotency key. Required on every mutation.

X-TTL

string

Idempotency key TTL in seconds.

Corpo

application/json

advisoryId

string<uuid>

obrigatório

ce-id of the registered SILOC deposit-required advisory this deposit responds to. Must exist and link to the declared instruction (else 422). Receipt of the advisory authorizes no money; this authenticated command does.

Exemplo:

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

amount

string

obrigatório

Deposit magnitude as an unsigned, non-zero decimal-reais string (at most two fractional digits). Forwarded verbatim into the LDL0022 VlrLanc — Lerian SPB performs NO arithmetic.

Pattern: ^([1-9][0-9]{0,16}(\.[0-9]{1,2})?|0\.(0[1-9]|[1-9][0-9]?))$

Exemplo:

"600.10"

instructionId

string<uuid>

obrigatório

SILOC settlement-instruction UUID. Must equal the advisory's instruction (else 422).

Exemplo:

"5f2c1b0a-7e6d-4c3b-8a19-0d9876543210"

side

enum<string>

obrigatório

Explicit money direction. An operational deposit is always DEBIT; the direction is never inferred from a sign.

Opções disponíveis:

DEBIT

Exemplo:

"DEBIT"

traceabilityId

string

obrigatório

20-character uppercase-Crockford SILOC traceability, echoed verbatim as the LDL0022 command NumCtrlIF.

Pattern: ^[0-9A-HJKMNP-TV-Z]{20}$

Exemplo:

"EZQJMC46QP5EWE3T400A"

Resposta

Created

advisoryEventId

string

obrigatório

amountRaw

string

obrigatório

commandId

string

obrigatório

correlationId

string

obrigatório

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

Exemplo:

"req-7a3f9c2e"

movementDate

string

obrigatório

numCtrlIF

string

obrigatório

outboundNuOp

string

obrigatório

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

product

string

obrigatório

side

string

obrigatório

status

string

obrigatório

Auditoria

Capacidades

Certificados

Mensagens

Aprovações de emissão

Entregas de eventos

Eventos

Avisos GEN

Governança

Inteligência operacional

Operações

Readiness

Conciliação

Relatórios

Consultas de reserva

Responsáveis

Agendamento

Consultas de agendamento

Configurações

Consultas SME

Webhooks

Tratamento de erros

Create SILOC operational deposit (LDL0022)

Autorizações

Cabeçalhos

Corpo

Resposta