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"
  }
}

Autorizaciones

Authorization

string

header

requerido

JWT bearer token issued by the identity provider.

Encabezados

X-Idempotency

string

requerido

Idempotency key. Required on every mutation.

X-TTL

string

Idempotency key TTL in seconds.

Cuerpo

application/json

advisoryId

string<uuid>

requerido

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.

Ejemplo:

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

amount

string

requerido

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]?))$

Ejemplo:

"600.10"

instructionId

string<uuid>

requerido

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

Ejemplo:

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

side

enum<string>

requerido

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

Opciones disponibles:

DEBIT

Ejemplo:

"DEBIT"

traceabilityId

string

requerido

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

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

Ejemplo:

"EZQJMC46QP5EWE3T400A"

Respuesta

Created

advisoryEventId

string

requerido

amountRaw

string

requerido

commandId

string

requerido

correlationId

string

requerido

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

Ejemplo:

"req-7a3f9c2e"

movementDate

string

requerido

numCtrlIF

string

requerido

outboundNuOp

string

requerido

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

product

string

requerido

side

string

requerido

status

string

requerido

Auditoría

Capacidades

Certificados

Mensajes

Aprobaciones de emisión

Entregas de eventos

Eventos

Avisos GEN

Gobernanza

Inteligencia operativa

Operaciones

Readiness

Conciliación

Informes

Consultas de reserva

Responsables

Programación

Consultas de programación

Configuración

Consultas SME

Webhooks

Manejo de errores

Create SILOC operational deposit (LDL0022)

Autorizaciones

Encabezados

Cuerpo

Respuesta