Enviar consulta de extrato de cuenta de reservas STR0014 (modo mensaje)

curl --request POST \
  --url https://spb.sandbox.lerian.net/v1/str/reserve-statement-queries \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "ispbIfLdl": "<string>",
  "dtHrFim": "<string>",
  "dtHrIni": "<string>"
}
'

import requests

url = "https://spb.sandbox.lerian.net/v1/str/reserve-statement-queries"

payload = {
    "ispbIfLdl": "<string>",
    "dtHrFim": "<string>",
    "dtHrIni": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({ispbIfLdl: '<string>', dtHrFim: '<string>', dtHrIni: '<string>'})
};

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

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://spb.sandbox.lerian.net/v1/str/reserve-statement-queries",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'ispbIfLdl' => '<string>',
    'dtHrFim' => '<string>',
    'dtHrIni' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://spb.sandbox.lerian.net/v1/str/reserve-statement-queries"

	payload := strings.NewReader("{\n  \"ispbIfLdl\": \"<string>\",\n  \"dtHrFim\": \"<string>\",\n  \"dtHrIni\": \"<string>\"\n}")

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

	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))

}

HttpResponse<String> response = Unirest.post("https://spb.sandbox.lerian.net/v1/str/reserve-statement-queries")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"ispbIfLdl\": \"<string>\",\n  \"dtHrFim\": \"<string>\",\n  \"dtHrIni\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://spb.sandbox.lerian.net/v1/str/reserve-statement-queries")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"ispbIfLdl\": \"<string>\",\n  \"dtHrFim\": \"<string>\",\n  \"dtHrIni\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "correlationId": "<string>",
  "id": "<string>",
  "ispbIfLdl": "<string>",
  "status": "<string>",
  "submittedAt": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "about:blank"
}

Enviar consulta de extrato de cuenta de reservas STR0014 (modo mensaje)

Envía a BACEN una consulta de extrato de cuenta de reservas STR0014 de parte única en MODO-MENSAJE (TpRet=M) y devuelve un id de correlación más un estado PENDING. La respuesta (STR0014R1, que lleva los saldos de apertura/cierre y hasta 200 asientos liquidados) llega de forma asíncrona y se lee mediante GET /v1/str/reserve-statement-queries/. Si BACEN encamina el extrato a un archivo (TamArq/IdentdArq) o la ventana excede el tope de 200 asientos del modo mensaje, el endpoint de lectura devuelve un error explícito; la recuperación por archivo (TpRet=P/X) queda fuera de alcance. Lerian SPB proyecta el extrato que envía BACEN; nunca calcula una posición.

POST

str

reserve-statement-queries

curl --request POST \
  --url https://spb.sandbox.lerian.net/v1/str/reserve-statement-queries \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "ispbIfLdl": "<string>",
  "dtHrFim": "<string>",
  "dtHrIni": "<string>"
}
'

import requests

url = "https://spb.sandbox.lerian.net/v1/str/reserve-statement-queries"

payload = {
    "ispbIfLdl": "<string>",
    "dtHrFim": "<string>",
    "dtHrIni": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({ispbIfLdl: '<string>', dtHrFim: '<string>', dtHrIni: '<string>'})
};

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

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://spb.sandbox.lerian.net/v1/str/reserve-statement-queries",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'ispbIfLdl' => '<string>',
    'dtHrFim' => '<string>',
    'dtHrIni' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://spb.sandbox.lerian.net/v1/str/reserve-statement-queries"

	payload := strings.NewReader("{\n  \"ispbIfLdl\": \"<string>\",\n  \"dtHrFim\": \"<string>\",\n  \"dtHrIni\": \"<string>\"\n}")

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

	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))

}

HttpResponse<String> response = Unirest.post("https://spb.sandbox.lerian.net/v1/str/reserve-statement-queries")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"ispbIfLdl\": \"<string>\",\n  \"dtHrFim\": \"<string>\",\n  \"dtHrIni\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://spb.sandbox.lerian.net/v1/str/reserve-statement-queries")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"ispbIfLdl\": \"<string>\",\n  \"dtHrFim\": \"<string>\",\n  \"dtHrIni\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "correlationId": "<string>",
  "id": "<string>",
  "ispbIfLdl": "<string>",
  "status": "<string>",
  "submittedAt": "<string>"
}

{
  "code": "<string>",
  "detail": "<string>",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "<string>",
  "status": 123,
  "title": "<string>",
  "type": "about:blank"
}

Autorizaciones

Authorization

string

header

requerido

JWT bearer token issued by the identity provider.

Encabezados

Authorization

string

Bearer JWT token.

X-Idempotency

string

Idempotency key (canonical; legacy alias X-Idempotency-Key).

X-Idempotency-Key

string

Idempotency key (legacy alias).

X-TTL

string

Idempotency key TTL in seconds.

Cuerpo

application/json

ispbIfLdl

string

requerido

ISPB of the requesting financial institution / clearing house (8 numeric digits).

Ejemplo:

"12345678"

dtHrFim

string

Optional statement-window end (DtHrFim).

Ejemplo:

"2026-06-15T23:59:59"

dtHrIni

string

Optional statement-window start (DtHrIni).

Ejemplo:

"2026-06-15T00:00:00"

Respuesta

Accepted

correlationId

string

requerido

Request-scoped correlation identifier echoing X-Request-ID.

Ejemplo:

"req-7a3f9c2e"

string

requerido

Correlation id (the outbound STR0014 NUOp). Poll GET /v1/str/reserve-statement-queries/{id} for the answer.

Ejemplo:

"12345678202606150000014"

ispbIfLdl

string

requerido

ISPB of the requesting financial institution / clearing house.

Ejemplo:

"12345678"

status

string

requerido

Projection state: PENDING until the STR0014R1 answer arrives and is projected.

Ejemplo:

"PENDING"

submittedAt

string

requerido

RFC3339 UTC timestamp the STR0014 query was persisted before send.

Ejemplo:

"2026-06-15T12:00:00Z"

⌘I

Pix — Lerian SPI (mensajería nativa)

Pix — JD (interfaz, directo)

Pix — BTG (interfaz, indirecto)

TED — Lerian SPB (mensajería nativa)

TED — JD (interfaz)

Boletos — BTG (interfaz)

Lerian SILOC (mensajería nativa)

Lerian SLC (mensajería nativa)

Lerian STA (mensajería nativa)

Lerian SISBAJUD (mensajería nativa)

Lerian Consignado (mensajería nativa)

Enviar consulta de extrato de cuenta de reservas STR0014 (modo mensaje)

Autorizaciones

Encabezados

Cuerpo

Respuesta