Actualizar responsáveis del participante (GEN0019)

curl --request POST \
  --url https://spb.sandbox.lerian.net/v1/str/responsibles \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "responsibles": [
    {
      "cpf": "<string>",
      "documentNumber": "<string>",
      "email": "<string>",
      "name": "<string>",
      "phone1": "<string>",
      "type": "<string>",
      "phone2": "<string>",
      "phone3": "<string>"
    }
  ]
}
'

import requests

url = "https://spb.sandbox.lerian.net/v1/str/responsibles"

payload = { "responsibles": [
        {
            "cpf": "<string>",
            "documentNumber": "<string>",
            "email": "<string>",
            "name": "<string>",
            "phone1": "<string>",
            "type": "<string>",
            "phone2": "<string>",
            "phone3": "<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({
    responsibles: [
      {
        cpf: '<string>',
        documentNumber: '<string>',
        email: '<string>',
        name: '<string>',
        phone1: '<string>',
        type: '<string>',
        phone2: '<string>',
        phone3: '<string>'
      }
    ]
  })
};

fetch('https://spb.sandbox.lerian.net/v1/str/responsibles', 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/responsibles",
  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([
    'responsibles' => [
        [
                'cpf' => '<string>',
                'documentNumber' => '<string>',
                'email' => '<string>',
                'name' => '<string>',
                'phone1' => '<string>',
                'type' => '<string>',
                'phone2' => '<string>',
                'phone3' => '<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/responsibles"

	payload := strings.NewReader("{\n  \"responsibles\": [\n    {\n      \"cpf\": \"<string>\",\n      \"documentNumber\": \"<string>\",\n      \"email\": \"<string>\",\n      \"name\": \"<string>\",\n      \"phone1\": \"<string>\",\n      \"type\": \"<string>\",\n      \"phone2\": \"<string>\",\n      \"phone3\": \"<string>\"\n    }\n  ]\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/responsibles")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"responsibles\": [\n    {\n      \"cpf\": \"<string>\",\n      \"documentNumber\": \"<string>\",\n      \"email\": \"<string>\",\n      \"name\": \"<string>\",\n      \"phone1\": \"<string>\",\n      \"type\": \"<string>\",\n      \"phone2\": \"<string>\",\n      \"phone3\": \"<string>\"\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://spb.sandbox.lerian.net/v1/str/responsibles")

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  \"responsibles\": [\n    {\n      \"cpf\": \"<string>\",\n      \"documentNumber\": \"<string>\",\n      \"email\": \"<string>\",\n      \"name\": \"<string>\",\n      \"phone1\": \"<string>\",\n      \"type\": \"<string>\",\n      \"phone2\": \"<string>\",\n      \"phone3\": \"<string>\"\n    }\n  ]\n}"

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

{
  "controlNumber": "<string>",
  "correlationId": "<string>",
  "messageType": "<string>",
  "nuOp": "<string>",
  "responsibleCount": 123,
  "status": "<string>",
  "submittedAt": "2023-11-07T05:31:56Z"
}

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

Actualizar responsáveis del participante (GEN0019)

Envía a BACEN un anuncio GEN0019 “Participante informa atualização de responsáveis”, declarando la lista completa de responsáveis del participante. REEMPLAZO TOTAL: el cuerpo lleva el conjunto entero (1..100 responsáveis), nunca una actualización parcial. El envío se persiste con estado SUBMITTED antes del despacho; el acuse GEN0019R1 de BACEN lo confirma mediante correlación por NUOp. Idempotente: reenviar la misma clave X-Idempotency con el mismo cuerpo devuelve la respuesta en caché.

POST

str

responsibles

curl --request POST \
  --url https://spb.sandbox.lerian.net/v1/str/responsibles \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "responsibles": [
    {
      "cpf": "<string>",
      "documentNumber": "<string>",
      "email": "<string>",
      "name": "<string>",
      "phone1": "<string>",
      "type": "<string>",
      "phone2": "<string>",
      "phone3": "<string>"
    }
  ]
}
'

import requests

url = "https://spb.sandbox.lerian.net/v1/str/responsibles"

payload = { "responsibles": [
        {
            "cpf": "<string>",
            "documentNumber": "<string>",
            "email": "<string>",
            "name": "<string>",
            "phone1": "<string>",
            "type": "<string>",
            "phone2": "<string>",
            "phone3": "<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({
    responsibles: [
      {
        cpf: '<string>',
        documentNumber: '<string>',
        email: '<string>',
        name: '<string>',
        phone1: '<string>',
        type: '<string>',
        phone2: '<string>',
        phone3: '<string>'
      }
    ]
  })
};

fetch('https://spb.sandbox.lerian.net/v1/str/responsibles', 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/responsibles",
  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([
    'responsibles' => [
        [
                'cpf' => '<string>',
                'documentNumber' => '<string>',
                'email' => '<string>',
                'name' => '<string>',
                'phone1' => '<string>',
                'type' => '<string>',
                'phone2' => '<string>',
                'phone3' => '<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/responsibles"

	payload := strings.NewReader("{\n  \"responsibles\": [\n    {\n      \"cpf\": \"<string>\",\n      \"documentNumber\": \"<string>\",\n      \"email\": \"<string>\",\n      \"name\": \"<string>\",\n      \"phone1\": \"<string>\",\n      \"type\": \"<string>\",\n      \"phone2\": \"<string>\",\n      \"phone3\": \"<string>\"\n    }\n  ]\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/responsibles")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"responsibles\": [\n    {\n      \"cpf\": \"<string>\",\n      \"documentNumber\": \"<string>\",\n      \"email\": \"<string>\",\n      \"name\": \"<string>\",\n      \"phone1\": \"<string>\",\n      \"type\": \"<string>\",\n      \"phone2\": \"<string>\",\n      \"phone3\": \"<string>\"\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://spb.sandbox.lerian.net/v1/str/responsibles")

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  \"responsibles\": [\n    {\n      \"cpf\": \"<string>\",\n      \"documentNumber\": \"<string>\",\n      \"email\": \"<string>\",\n      \"name\": \"<string>\",\n      \"phone1\": \"<string>\",\n      \"type\": \"<string>\",\n      \"phone2\": \"<string>\",\n      \"phone3\": \"<string>\"\n    }\n  ]\n}"

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

{
  "controlNumber": "<string>",
  "correlationId": "<string>",
  "messageType": "<string>",
  "nuOp": "<string>",
  "responsibleCount": 123,
  "status": "<string>",
  "submittedAt": "2023-11-07T05:31:56Z"
}

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

X-Idempotency

string

Idempotency key (primary).

X-Idempotency-Key

string

Idempotency key (legacy alias for X-Idempotency).

X-TTL

string

Idempotency key TTL in seconds (overrides the configured default).

Cuerpo

application/json

responsibles

object[]

requerido

Complete responsável roster (full-replacement; no partial update). 1..100 entries per the Catálogo SFN Vol III bound.

Required array length: 1 - 100 elements

Show child attributes

Respuesta

controlNumber

string

requerido

Participant control number assigned to the GEN0019 submission.

Ejemplo:

"20260616000001"

correlationId

string

requerido

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

Ejemplo:

"req-7a3f9c2e"

messageType

string

requerido

STR message code of the submission (always GEN0019 for a responsável update).

Ejemplo:

"GEN0019"

nuOp

string

requerido

BACEN protocol identifier (NUOp) assigned to the GEN0019 submission.

Ejemplo:

"12345678202606160000001"

responsibleCount

integer<int64>

requerido

Number of responsável records carried in the full-replacement roster.

Ejemplo:

3

status

string

requerido

Submission status; always SUBMITTED until BACEN's GEN0019R1 acknowledgment flips it to CONFIRMED.

Ejemplo:

"SUBMITTED"

submittedAt

string<date-time>

requerido

RFC3339 UTC timestamp when the submission was persisted before dispatch.

Ejemplo:

"2026-06-16T18:30: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)

Actualizar responsáveis del participante (GEN0019)

Autorizaciones

Encabezados

Cuerpo

Respuesta