Confirm or dispute the day's net result

curl --request POST \
  --url https://siloc.sandbox.lerian.net/api/v1/siloc/outbound/net-result-confirmations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Idempotency: <x-idempotency>' \
  --data '
{
  "DtHrIF": "<string>",
  "DtLiquid": "<string>",
  "DtMovto": "<string>",
  "NumCtrlLDLOr": "<string>",
  "TpDeb_Cred": "<string>",
  "VlrLanc": "<string>",
  "Grupo_LDL0003_ResultLiqd": [
    {
      "CNPJNLiqdant": "<string>",
      "TpConf_Divg": "<string>",
      "VlrResultLiqdNLiqdant": "<string>",
      "IdentdPartCamr": "<string>"
    }
  ]
}
'

package main

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

func main() {

	url := "https://siloc.sandbox.lerian.net/api/v1/siloc/outbound/net-result-confirmations"

	payload := strings.NewReader("{\n  \"DtHrIF\": \"<string>\",\n  \"DtLiquid\": \"<string>\",\n  \"DtMovto\": \"<string>\",\n  \"NumCtrlLDLOr\": \"<string>\",\n  \"TpDeb_Cred\": \"<string>\",\n  \"VlrLanc\": \"<string>\",\n  \"Grupo_LDL0003_ResultLiqd\": [\n    {\n      \"CNPJNLiqdant\": \"<string>\",\n      \"TpConf_Divg\": \"<string>\",\n      \"VlrResultLiqdNLiqdant\": \"<string>\",\n      \"IdentdPartCamr\": \"<string>\"\n    }\n  ]\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({
    DtHrIF: '<string>',
    DtLiquid: '<string>',
    DtMovto: '<string>',
    NumCtrlLDLOr: '<string>',
    TpDeb_Cred: '<string>',
    VlrLanc: '<string>',
    Grupo_LDL0003_ResultLiqd: [
      {
        CNPJNLiqdant: '<string>',
        TpConf_Divg: '<string>',
        VlrResultLiqdNLiqdant: '<string>',
        IdentdPartCamr: '<string>'
      }
    ]
  })
};

fetch('https://siloc.sandbox.lerian.net/api/v1/siloc/outbound/net-result-confirmations', 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/net-result-confirmations"

payload = {
    "DtHrIF": "<string>",
    "DtLiquid": "<string>",
    "DtMovto": "<string>",
    "NumCtrlLDLOr": "<string>",
    "TpDeb_Cred": "<string>",
    "VlrLanc": "<string>",
    "Grupo_LDL0003_ResultLiqd": [
        {
            "CNPJNLiqdant": "<string>",
            "TpConf_Divg": "<string>",
            "VlrResultLiqdNLiqdant": "<string>",
            "IdentdPartCamr": "<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": {
    "DtHrIF": "<string>",
    "DtLiquid": "<string>",
    "DtMovto": "<string>",
    "NumCtrlLDLOr": "<string>",
    "TpDeb_Cred": "<string>",
    "VlrLanc": "<string>",
    "Grupo_LDL0003_ResultLiqd": [
      {
        "CNPJNLiqdant": "<string>",
        "TpConf_Divg": "<string>",
        "VlrResultLiqdNLiqdant": "<string>",
        "IdentdPartCamr": "<string>"
      }
    ]
  },
  "status": "SUBMITTED",
  "submittedAt": "2023-11-07T05:31:56Z",
  "answer": {
    "codMsg": "<string>",
    "details": {},
    "movementDate": "2023-12-25",
    "situationAt": "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"
  }
}

Confirm or dispute the day's net result

Issues an LDL0003 “IF informa Resultado líquido de negociações confirmado ou divergente” to the Câmara LDL (Catálogo de Serviços do SFN v5.13, Vol II). It states which of the lançamentos the câmara announced on its LDL0001 this institution accepts, and at what value: a lançamento accepted in part is reported at the value actually recognised, one NOT accepted is reported as ZERO, and one accepted in full at its original value. NumCtrlLDLOr names the LDL0001 being confirmed and is the operator’s to supply, because the câmara sent it and this rail derives no reply of its own. The command 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 (LDL0003R1) arrives asynchronously and is read back with getLDL0003. Every amount 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

net-result-confirmations

Confirm or dispute the day's net result

curl --request POST \
  --url https://siloc.sandbox.lerian.net/api/v1/siloc/outbound/net-result-confirmations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Idempotency: <x-idempotency>' \
  --data '
{
  "DtHrIF": "<string>",
  "DtLiquid": "<string>",
  "DtMovto": "<string>",
  "NumCtrlLDLOr": "<string>",
  "TpDeb_Cred": "<string>",
  "VlrLanc": "<string>",
  "Grupo_LDL0003_ResultLiqd": [
    {
      "CNPJNLiqdant": "<string>",
      "TpConf_Divg": "<string>",
      "VlrResultLiqdNLiqdant": "<string>",
      "IdentdPartCamr": "<string>"
    }
  ]
}
'

package main

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

func main() {

	url := "https://siloc.sandbox.lerian.net/api/v1/siloc/outbound/net-result-confirmations"

	payload := strings.NewReader("{\n  \"DtHrIF\": \"<string>\",\n  \"DtLiquid\": \"<string>\",\n  \"DtMovto\": \"<string>\",\n  \"NumCtrlLDLOr\": \"<string>\",\n  \"TpDeb_Cred\": \"<string>\",\n  \"VlrLanc\": \"<string>\",\n  \"Grupo_LDL0003_ResultLiqd\": [\n    {\n      \"CNPJNLiqdant\": \"<string>\",\n      \"TpConf_Divg\": \"<string>\",\n      \"VlrResultLiqdNLiqdant\": \"<string>\",\n      \"IdentdPartCamr\": \"<string>\"\n    }\n  ]\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({
    DtHrIF: '<string>',
    DtLiquid: '<string>',
    DtMovto: '<string>',
    NumCtrlLDLOr: '<string>',
    TpDeb_Cred: '<string>',
    VlrLanc: '<string>',
    Grupo_LDL0003_ResultLiqd: [
      {
        CNPJNLiqdant: '<string>',
        TpConf_Divg: '<string>',
        VlrResultLiqdNLiqdant: '<string>',
        IdentdPartCamr: '<string>'
      }
    ]
  })
};

fetch('https://siloc.sandbox.lerian.net/api/v1/siloc/outbound/net-result-confirmations', 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/net-result-confirmations"

payload = {
    "DtHrIF": "<string>",
    "DtLiquid": "<string>",
    "DtMovto": "<string>",
    "NumCtrlLDLOr": "<string>",
    "TpDeb_Cred": "<string>",
    "VlrLanc": "<string>",
    "Grupo_LDL0003_ResultLiqd": [
        {
            "CNPJNLiqdant": "<string>",
            "TpConf_Divg": "<string>",
            "VlrResultLiqdNLiqdant": "<string>",
            "IdentdPartCamr": "<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": {
    "DtHrIF": "<string>",
    "DtLiquid": "<string>",
    "DtMovto": "<string>",
    "NumCtrlLDLOr": "<string>",
    "TpDeb_Cred": "<string>",
    "VlrLanc": "<string>",
    "Grupo_LDL0003_ResultLiqd": [
      {
        "CNPJNLiqdant": "<string>",
        "TpConf_Divg": "<string>",
        "VlrResultLiqdNLiqdant": "<string>",
        "IdentdPartCamr": "<string>"
      }
    ]
  },
  "status": "SUBMITTED",
  "submittedAt": "2023-11-07T05:31:56Z",
  "answer": {
    "codMsg": "<string>",
    "details": {},
    "movementDate": "2023-12-25",
    "situationAt": "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"
  }
}

Authorizations

Authorization

string

header

required

JWT bearer token issued by the identity provider.

Headers

X-Idempotency

string

required

Idempotency key for this state-changing request (required, max 255 characters).

Maximum string length: 255

Body

application/json

DtHrIF

string

required

Data Hora IF (xs:dateTime, [1..1]): when this institution decided, written as YYYY-MM-DDTHH:MM:SS exactly as the wire carries it.

DtLiquid

string

required

Data Liquidação (xs:date, [1..1]).

DtMovto

string

required

Data Movimento (xs:date, [1..1]).

NumCtrlLDLOr

string

required

Número Controle LDL Original (ControleIF, [1..1]): the câmara's control number on the LDL0001 this confirms. It is the operator's to supply because the câmara sent it; this rail neither derives it nor answers an LDL0001 on its own.

TpDeb_Cred

string

required

Tipo Débito ou Crédito (TpDebCred, [1..1]): C (Crédito) or D (Débito).

VlrLanc

string

required

Valor Lançamento (Valor, [1..1]): the value this institution accepts for its OWN result. Zero states that the lançamento is not accepted.

Grupo_LDL0003_ResultLiqd

object[] | null

Grupo Resultado Líquido ([0..n]): one repetition per non-settling member whose result this institution is confirming or diverging from. Absent when the message confirms only this institution's own result.

Show child attributes

Response

Accepted

attempts

integer<int64>

required

Queue-put attempts made so far.

codMsg

string

required

The SFN command code this row carries, e.g. LDL0003.

string<uuid>

required

Outbound message id.

numCtrlIF

string

required

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

nuop

string

required

The BCMSG operation number of the frame.

request

object

required

The request exactly as it was submitted, projected verbatim.

Show child attributes

status

enum<string>

required

Lifecycle state. REFUSED means the câmara received the command and returned its E twin; FAILED means this rail could not deliver it. Both are terminal and they are different facts. LDL1019 has no positive answer leg in the Catálogo, so an accepted LDL1019 stays DISPATCHED: delivered, and no reply is owed.

Available options:

SUBMITTED,

DISPATCHED,

ANSWERED,

REFUSED,

FAILED

submittedAt

string<date-time>

required

When the command was recorded.

answer

object

What the câmara answered; omitted until it has answered, and never present for LDL1019, which has no answer leg.

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.

Integration

Connectivity

Homologation

Participants

Cycles and settlement

Transfers

Collateral

Card route

Entries and statements

Advices and notices

Alerts and audit

Schedule

Error handling

Confirm or dispute the day's net result

Authorizations

Headers

Body

Response