Move collateral between holders or purposes

curl --request POST \
  --url https://siloc.sandbox.lerian.net/api/v1/siloc/outbound/collateral-movements \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Idempotency: <x-idempotency>' \
  --data '
{
  "CNPJEntRespons1_2": "<string>",
  "DtMovto": "<string>",
  "ISPBLDL": "<string>",
  "TpAtv": "<string>",
  "CodSubTitlarDest": "<string>",
  "CodSubTitlarOrigem": "<string>",
  "CodTitlarDest": "<string>",
  "CodTitlarOrigem": "<string>",
  "DtVenc": "<string>",
  "FinlddCobDest": "<string>",
  "FinlddCobOrigem": "<string>",
  "NumAtv": "<string>",
  "NumCtrlLDLOr": "<string>",
  "TpSubTitlarDest": "<string>",
  "TpSubTitlarOrigem": "<string>",
  "TpTitlarDest": "<string>",
  "TpTitlarOrigem": "<string>"
}
'

package main

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

func main() {

	url := "https://siloc.sandbox.lerian.net/api/v1/siloc/outbound/collateral-movements"

	payload := strings.NewReader("{\n  \"CNPJEntRespons1_2\": \"<string>\",\n  \"DtMovto\": \"<string>\",\n  \"ISPBLDL\": \"<string>\",\n  \"TpAtv\": \"<string>\",\n  \"CodSubTitlarDest\": \"<string>\",\n  \"CodSubTitlarOrigem\": \"<string>\",\n  \"CodTitlarDest\": \"<string>\",\n  \"CodTitlarOrigem\": \"<string>\",\n  \"DtVenc\": \"<string>\",\n  \"FinlddCobDest\": \"<string>\",\n  \"FinlddCobOrigem\": \"<string>\",\n  \"NumAtv\": \"<string>\",\n  \"NumCtrlLDLOr\": \"<string>\",\n  \"TpSubTitlarDest\": \"<string>\",\n  \"TpSubTitlarOrigem\": \"<string>\",\n  \"TpTitlarDest\": \"<string>\",\n  \"TpTitlarOrigem\": \"<string>\"\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({
    CNPJEntRespons1_2: '<string>',
    DtMovto: '<string>',
    ISPBLDL: '<string>',
    TpAtv: '<string>',
    CodSubTitlarDest: '<string>',
    CodSubTitlarOrigem: '<string>',
    CodTitlarDest: '<string>',
    CodTitlarOrigem: '<string>',
    DtVenc: '<string>',
    FinlddCobDest: '<string>',
    FinlddCobOrigem: '<string>',
    NumAtv: '<string>',
    NumCtrlLDLOr: '<string>',
    TpSubTitlarDest: '<string>',
    TpSubTitlarOrigem: '<string>',
    TpTitlarDest: '<string>',
    TpTitlarOrigem: '<string>'
  })
};

fetch('https://siloc.sandbox.lerian.net/api/v1/siloc/outbound/collateral-movements', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://siloc.sandbox.lerian.net/api/v1/siloc/outbound/collateral-movements"

payload = {
    "CNPJEntRespons1_2": "<string>",
    "DtMovto": "<string>",
    "ISPBLDL": "<string>",
    "TpAtv": "<string>",
    "CodSubTitlarDest": "<string>",
    "CodSubTitlarOrigem": "<string>",
    "CodTitlarDest": "<string>",
    "CodTitlarOrigem": "<string>",
    "DtVenc": "<string>",
    "FinlddCobDest": "<string>",
    "FinlddCobOrigem": "<string>",
    "NumAtv": "<string>",
    "NumCtrlLDLOr": "<string>",
    "TpSubTitlarDest": "<string>",
    "TpSubTitlarOrigem": "<string>",
    "TpTitlarDest": "<string>",
    "TpTitlarOrigem": "<string>"
}
headers = {
    "X-Idempotency": "<x-idempotency>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

{
  "attempts": 123,
  "codMsg": "<string>",
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "numCtrlIF": "<string>",
  "nuop": "<string>",
  "request": {
    "CNPJEntRespons1_2": "<string>",
    "DtMovto": "<string>",
    "ISPBLDL": "<string>",
    "TpAtv": "<string>",
    "CodSubTitlarDest": "<string>",
    "CodSubTitlarOrigem": "<string>",
    "CodTitlarDest": "<string>",
    "CodTitlarOrigem": "<string>",
    "DtVenc": "<string>",
    "FinlddCobDest": "<string>",
    "FinlddCobOrigem": "<string>",
    "Grupo_LDL1016_CTP": {
      "DtEmsCTP": "<string>",
      "EmissorActtCTP": "<string>",
      "IdentdTitCTP": "<string>",
      "QtdCTP": "<string>",
      "TaxCTP": "<string>",
      "FIRCTP": "<string>"
    },
    "Grupo_LDL1016_Fianc": {
      "CNPJEmissorFianc": "<string>",
      "DtEmsFianc": "<string>",
      "VlrFaceFianc": "<string>"
    },
    "Grupo_LDL1016_ME": {
      "CodMoeda": "<string>",
      "VlrME": "<string>"
    },
    "Grupo_LDL1016_Otr": {
      "IdentdOtrAtv": "<string>",
      "Qtd": "<string>",
      "Vlr": "<string>"
    },
    "Grupo_LDL1016_SEL": {
      "IdentdTitSEL": "<string>",
      "QtdTit": "<string>",
      "CtCed": "<string>",
      "CtCes": "<string>"
    },
    "NumAtv": "<string>",
    "NumCtrlLDLOr": "<string>",
    "TpSubTitlarDest": "<string>",
    "TpSubTitlarOrigem": "<string>",
    "TpTitlarDest": "<string>",
    "TpTitlarOrigem": "<string>"
  },
  "status": "SUBMITTED",
  "submittedAt": "2023-11-07T05:31:56Z",
  "answer": {
    "codMsg": "<string>",
    "details": "<unknown>",
    "movementDate": "2023-12-25",
    "numCtrlLDL": "<string>",
    "camaraAt": "2023-11-07T05:31:56Z"
  },
  "answerAbsent": true,
  "answeredAt": "2023-11-07T05:31:56Z",
  "dispatchedAt": "2023-11-07T05:31:56Z",
  "lastError": "<string>"
}

{
  "code": "<string>",
  "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"
  }
}

{
  "code": "<string>",
  "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"
  }
}

{
  "code": "<string>",
  "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"
  }
}

Move collateral between holders or purposes

Issues a LDL1016 to the Câmara LDL on behalf of an Entidade Responsável (Catálogo de Serviços do SFN v5.13, Vol II). Requests a transfer of collateral or securities between holders, sub-holders or cover purposes within one Entidade Responsável (Vol II, Evento LDL1016 Descrição). RLDL0012: Número Controle LDL Original names the control number of the LDL1001 that required the collateral. The request is minted, built, signed, encrypted and durably recorded BEFORE anything reaches the queue, so this returns 202 with the control number the câmara will echo; the answer (LDL1016R1) arrives asynchronously and is read back with getLDL1016. Every amount and quantity is a decimal STRING carried to the wire exactly as written. A deployment with no send leg configured answers 503 with SILOC-0023; one whose dispatcher is not running answers 503 with SILOC-0024.

POST

api

siloc

outbound

collateral-movements

Move collateral between holders or purposes

curl --request POST \
  --url https://siloc.sandbox.lerian.net/api/v1/siloc/outbound/collateral-movements \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Idempotency: <x-idempotency>' \
  --data '
{
  "CNPJEntRespons1_2": "<string>",
  "DtMovto": "<string>",
  "ISPBLDL": "<string>",
  "TpAtv": "<string>",
  "CodSubTitlarDest": "<string>",
  "CodSubTitlarOrigem": "<string>",
  "CodTitlarDest": "<string>",
  "CodTitlarOrigem": "<string>",
  "DtVenc": "<string>",
  "FinlddCobDest": "<string>",
  "FinlddCobOrigem": "<string>",
  "NumAtv": "<string>",
  "NumCtrlLDLOr": "<string>",
  "TpSubTitlarDest": "<string>",
  "TpSubTitlarOrigem": "<string>",
  "TpTitlarDest": "<string>",
  "TpTitlarOrigem": "<string>"
}
'

package main

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

func main() {

	url := "https://siloc.sandbox.lerian.net/api/v1/siloc/outbound/collateral-movements"

	payload := strings.NewReader("{\n  \"CNPJEntRespons1_2\": \"<string>\",\n  \"DtMovto\": \"<string>\",\n  \"ISPBLDL\": \"<string>\",\n  \"TpAtv\": \"<string>\",\n  \"CodSubTitlarDest\": \"<string>\",\n  \"CodSubTitlarOrigem\": \"<string>\",\n  \"CodTitlarDest\": \"<string>\",\n  \"CodTitlarOrigem\": \"<string>\",\n  \"DtVenc\": \"<string>\",\n  \"FinlddCobDest\": \"<string>\",\n  \"FinlddCobOrigem\": \"<string>\",\n  \"NumAtv\": \"<string>\",\n  \"NumCtrlLDLOr\": \"<string>\",\n  \"TpSubTitlarDest\": \"<string>\",\n  \"TpSubTitlarOrigem\": \"<string>\",\n  \"TpTitlarDest\": \"<string>\",\n  \"TpTitlarOrigem\": \"<string>\"\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({
    CNPJEntRespons1_2: '<string>',
    DtMovto: '<string>',
    ISPBLDL: '<string>',
    TpAtv: '<string>',
    CodSubTitlarDest: '<string>',
    CodSubTitlarOrigem: '<string>',
    CodTitlarDest: '<string>',
    CodTitlarOrigem: '<string>',
    DtVenc: '<string>',
    FinlddCobDest: '<string>',
    FinlddCobOrigem: '<string>',
    NumAtv: '<string>',
    NumCtrlLDLOr: '<string>',
    TpSubTitlarDest: '<string>',
    TpSubTitlarOrigem: '<string>',
    TpTitlarDest: '<string>',
    TpTitlarOrigem: '<string>'
  })
};

fetch('https://siloc.sandbox.lerian.net/api/v1/siloc/outbound/collateral-movements', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://siloc.sandbox.lerian.net/api/v1/siloc/outbound/collateral-movements"

payload = {
    "CNPJEntRespons1_2": "<string>",
    "DtMovto": "<string>",
    "ISPBLDL": "<string>",
    "TpAtv": "<string>",
    "CodSubTitlarDest": "<string>",
    "CodSubTitlarOrigem": "<string>",
    "CodTitlarDest": "<string>",
    "CodTitlarOrigem": "<string>",
    "DtVenc": "<string>",
    "FinlddCobDest": "<string>",
    "FinlddCobOrigem": "<string>",
    "NumAtv": "<string>",
    "NumCtrlLDLOr": "<string>",
    "TpSubTitlarDest": "<string>",
    "TpSubTitlarOrigem": "<string>",
    "TpTitlarDest": "<string>",
    "TpTitlarOrigem": "<string>"
}
headers = {
    "X-Idempotency": "<x-idempotency>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

{
  "attempts": 123,
  "codMsg": "<string>",
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "numCtrlIF": "<string>",
  "nuop": "<string>",
  "request": {
    "CNPJEntRespons1_2": "<string>",
    "DtMovto": "<string>",
    "ISPBLDL": "<string>",
    "TpAtv": "<string>",
    "CodSubTitlarDest": "<string>",
    "CodSubTitlarOrigem": "<string>",
    "CodTitlarDest": "<string>",
    "CodTitlarOrigem": "<string>",
    "DtVenc": "<string>",
    "FinlddCobDest": "<string>",
    "FinlddCobOrigem": "<string>",
    "Grupo_LDL1016_CTP": {
      "DtEmsCTP": "<string>",
      "EmissorActtCTP": "<string>",
      "IdentdTitCTP": "<string>",
      "QtdCTP": "<string>",
      "TaxCTP": "<string>",
      "FIRCTP": "<string>"
    },
    "Grupo_LDL1016_Fianc": {
      "CNPJEmissorFianc": "<string>",
      "DtEmsFianc": "<string>",
      "VlrFaceFianc": "<string>"
    },
    "Grupo_LDL1016_ME": {
      "CodMoeda": "<string>",
      "VlrME": "<string>"
    },
    "Grupo_LDL1016_Otr": {
      "IdentdOtrAtv": "<string>",
      "Qtd": "<string>",
      "Vlr": "<string>"
    },
    "Grupo_LDL1016_SEL": {
      "IdentdTitSEL": "<string>",
      "QtdTit": "<string>",
      "CtCed": "<string>",
      "CtCes": "<string>"
    },
    "NumAtv": "<string>",
    "NumCtrlLDLOr": "<string>",
    "TpSubTitlarDest": "<string>",
    "TpSubTitlarOrigem": "<string>",
    "TpTitlarDest": "<string>",
    "TpTitlarOrigem": "<string>"
  },
  "status": "SUBMITTED",
  "submittedAt": "2023-11-07T05:31:56Z",
  "answer": {
    "codMsg": "<string>",
    "details": "<unknown>",
    "movementDate": "2023-12-25",
    "numCtrlLDL": "<string>",
    "camaraAt": "2023-11-07T05:31:56Z"
  },
  "answerAbsent": true,
  "answeredAt": "2023-11-07T05:31:56Z",
  "dispatchedAt": "2023-11-07T05:31:56Z",
  "lastError": "<string>"
}

{
  "code": "<string>",
  "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"
  }
}

{
  "code": "<string>",
  "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"
  }
}

{
  "code": "<string>",
  "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 for this state-changing request (required, max 255 characters).

Maximum string length: 255

Cuerpo

application/json

CNPJEntRespons1_2

string

requerido

CNPJ Entidade Responsável 1 ou 2 (CNPJ, [1..1]). The responsible entity this institution acts for.

DtMovto

string

requerido

Data Movimento (Data, [1..1]), as YYYY-MM-DD.

ISPBLDL

string

requerido

ISPB LDL: the câmara addressed (ISPB, [1..1]).

TpAtv

string

requerido

Tipo Ativo (TpAtv, [1..1]): the class of the asset being moved.

CodSubTitlarDest

string

Código Subtitular Destino (CodSubTitlar, [0..1]).

CodSubTitlarOrigem

string

Código Subtitular Origem (CodSubTitlar, [0..1]).

CodTitlarDest

string

Código Titular Destino (CodTitlar, [0..1]).

CodTitlarOrigem

string

Código Titular Origem (CodTitlar, [0..1]).

DtVenc

string

Data Vencimento (Data, [0..1]), as YYYY-MM-DD.

FinlddCobDest

string

Finalidade Cobertura Destino (FinlddCob, [0..1]): what the collateral covers on the leg it reaches.

FinlddCobOrigem

string

Finalidade Cobertura Origem (FinlddCob, [0..1]): what the collateral covers on the leg it leaves.

Grupo_LDL1016_CTP

object

Grupo CETIP ([0..1]): the CETIP paper being moved, its rate and its quantity.

Show child attributes

Grupo_LDL1016_Fianc

object

Grupo Fiança ([0..1]): the bank guarantee being moved.

Show child attributes

Grupo_LDL1016_ME

object

Grupo Moeda_Estrangeira ([0..1]): the foreign currency being moved.

Show child attributes

Grupo_LDL1016_Otr

object

Grupo Outros ([0..1]): an asset of no other class, named by the câmara's own identifier.

Show child attributes

Grupo_LDL1016_SEL

object

Grupo Selic ([0..1]): the Selic paper being moved and the accounts it moves between.

Show child attributes

NumAtv

string

Número Ativo (NumAtv, [0..1]): the câmara's own number for the deposited asset being moved.

NumCtrlLDLOr

string

Número Controle LDL Original (ControleIF, [0..1]). RLDL0012: it names the Número Controle of the LDL1001 that required this collateral.

TpSubTitlarDest

string

Tipo Subtitular Destino (TpTitlar, [0..1]).

TpSubTitlarOrigem

string

Tipo Subtitular Origem (TpTitlar, [0..1]).

TpTitlarDest

string

Tipo Titular Destino (TpTitlar, [0..1]).

TpTitlarOrigem

string

Tipo Titular Origem (TpTitlar, [0..1]).

Respuesta

Accepted

attempts

integer<int64>

requerido

Queue-put attempts made so far.

codMsg

string

requerido

The SFN request code this row carries, e.g. LDL1002.

string<uuid>

requerido

Outbound message id.

numCtrlIF

string

requerido

The control number this institution issued (NumCtrlIF). The câmara echoes it on the answer, which is what correlates the two.

nuop

string

requerido

The BCMSG operation number of the frame.

request

object

requerido

The request exactly as it was submitted, projected verbatim.

Show child attributes

status

enum<string>

requerido

Lifecycle state. REFUSED means the câmara received the request and returned its E twin; FAILED means this rail could not deliver it. Both are terminal and they are different facts.

Opciones disponibles:

SUBMITTED,

DISPATCHED,

ANSWERED,

REFUSED,

FAILED

submittedAt

string<date-time>

requerido

When the request was recorded.

answer

object

What the câmara answered; omitted until it has answered.

Show child attributes

answerAbsent

boolean

True only on an ANSWERED message whose answer body this rail does not hold. The câmara did answer; what it wrote is not here, and the missing answer block is that absence, never an empty answer. Omitted otherwise.

answeredAt

string<date-time>

When the câmara's answer was applied; omitted until it is.

dispatchedAt

string<date-time>

When the frame reached the send queue; omitted until it has.

lastError

string

Why the last queue put failed, or — on REFUSED — the CodErro values the câmara marked, verbatim. Omitted when neither applies.

Integración

Conectividad

Homologación

Participantes

Ciclos y liquidación

Transferencias

Garantías

Ruta de tarjetas

Asientos y extractos

Avisos y notificaciones

Alertas y auditoría

Programación

Manejo de errores

Move collateral between holders or purposes

Autorizaciones

Encabezados

Cuerpo

Respuesta