Registrar la cesión de un crédito a su fondo atribuido
curl --request PUT \
--url https://consignado.sandbox.lerian.net/v1/consignado/leilao/bid-submissions/cessao \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"fundo_ref": " Fundo: Árvore/Classe A — série № 7 ",
"idempotency_key": "idem-bid-2026-08-12-0001"
}
'import requests
url = "https://consignado.sandbox.lerian.net/v1/consignado/leilao/bid-submissions/cessao"
payload = {
"fundo_ref": " Fundo: Árvore/Classe A — série № 7 ",
"idempotency_key": "idem-bid-2026-08-12-0001"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
fundo_ref: ' Fundo: Árvore/Classe A — série № 7 ',
idempotency_key: 'idem-bid-2026-08-12-0001'
})
};
fetch('https://consignado.sandbox.lerian.net/v1/consignado/leilao/bid-submissions/cessao', 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://consignado.sandbox.lerian.net/v1/consignado/leilao/bid-submissions/cessao",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'fundo_ref' => ' Fundo: Árvore/Classe A — série № 7 ',
'idempotency_key' => 'idem-bid-2026-08-12-0001'
]),
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://consignado.sandbox.lerian.net/v1/consignado/leilao/bid-submissions/cessao"
payload := strings.NewReader("{\n \"fundo_ref\": \" Fundo: Árvore/Classe A — série № 7 \",\n \"idempotency_key\": \"idem-bid-2026-08-12-0001\"\n}")
req, _ := http.NewRequest("PUT", 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.put("https://consignado.sandbox.lerian.net/v1/consignado/leilao/bid-submissions/cessao")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"fundo_ref\": \" Fundo: Árvore/Classe A — série № 7 \",\n \"idempotency_key\": \"idem-bid-2026-08-12-0001\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://consignado.sandbox.lerian.net/v1/consignado/leilao/bid-submissions/cessao")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"fundo_ref\": \" Fundo: Árvore/Classe A — série № 7 \",\n \"idempotency_key\": \"idem-bid-2026-08-12-0001\"\n}"
response = http.request(request)
puts response.read_body{
"cedido": true,
"cedido_at": "2026-08-12T12:00:00Z",
"fundo_ref": "<string>"
}{
"code": "ERR-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"
}
}{
"code": "ERR-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"
}
}{
"code": "ERR-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"
}
}{
"code": "ERR-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"
}
}{
"code": "ERR-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"
}
}{
"code": "ERR-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"
}
}{
"code": "ERR-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"
}
}{
"code": "ERR-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"
}
}{
"code": "ERR-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"
}
}{
"code": "ERR-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"
}
}Registrar la cesión de un crédito a su fondo atribuido
Registra la cessão de un crédito y establece el límite de propiedad del fondo. Una atribución previa al fondo no habilita por sí sola las lecturas con alcance de fondo.
El bancarizador identifica el crédito mediante el idempotency_key usado para la oferta y el fondo que firmó el endosso. El crédito ya debe estar atribuido a ese fondo exacto; se rechaza un crédito sin atribución o atribuido a otro fondo.
La operación es idempotente. Registrar de nuevo el mismo crédito y fondo devuelve el estado duradero en vez de crear una segunda fila o un segundo hecho del feed. cedido comienza en false y solo pasa a true mediante este registro.
PUT
/
v1
/
consignado
/
leilao
/
bid-submissions
/
cessao
Registrar la cesión de un crédito a su fondo atribuido
curl --request PUT \
--url https://consignado.sandbox.lerian.net/v1/consignado/leilao/bid-submissions/cessao \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"fundo_ref": " Fundo: Árvore/Classe A — série № 7 ",
"idempotency_key": "idem-bid-2026-08-12-0001"
}
'import requests
url = "https://consignado.sandbox.lerian.net/v1/consignado/leilao/bid-submissions/cessao"
payload = {
"fundo_ref": " Fundo: Árvore/Classe A — série № 7 ",
"idempotency_key": "idem-bid-2026-08-12-0001"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
fundo_ref: ' Fundo: Árvore/Classe A — série № 7 ',
idempotency_key: 'idem-bid-2026-08-12-0001'
})
};
fetch('https://consignado.sandbox.lerian.net/v1/consignado/leilao/bid-submissions/cessao', 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://consignado.sandbox.lerian.net/v1/consignado/leilao/bid-submissions/cessao",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'fundo_ref' => ' Fundo: Árvore/Classe A — série № 7 ',
'idempotency_key' => 'idem-bid-2026-08-12-0001'
]),
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://consignado.sandbox.lerian.net/v1/consignado/leilao/bid-submissions/cessao"
payload := strings.NewReader("{\n \"fundo_ref\": \" Fundo: Árvore/Classe A — série № 7 \",\n \"idempotency_key\": \"idem-bid-2026-08-12-0001\"\n}")
req, _ := http.NewRequest("PUT", 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.put("https://consignado.sandbox.lerian.net/v1/consignado/leilao/bid-submissions/cessao")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"fundo_ref\": \" Fundo: Árvore/Classe A — série № 7 \",\n \"idempotency_key\": \"idem-bid-2026-08-12-0001\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://consignado.sandbox.lerian.net/v1/consignado/leilao/bid-submissions/cessao")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"fundo_ref\": \" Fundo: Árvore/Classe A — série № 7 \",\n \"idempotency_key\": \"idem-bid-2026-08-12-0001\"\n}"
response = http.request(request)
puts response.read_body{
"cedido": true,
"cedido_at": "2026-08-12T12:00:00Z",
"fundo_ref": "<string>"
}{
"code": "ERR-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"
}
}{
"code": "ERR-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"
}
}{
"code": "ERR-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"
}
}{
"code": "ERR-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"
}
}{
"code": "ERR-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"
}
}{
"code": "ERR-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"
}
}{
"code": "ERR-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"
}
}{
"code": "ERR-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"
}
}{
"code": "ERR-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"
}
}{
"code": "ERR-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
JWT bearer token issued by the identity provider.
Cuerpo
application/json
The fund this credit was ceded to. D-FUND-REF-OPAQUE: matched byte for byte against the credit's own attribution — no trim, case fold, or normalization.
Ejemplo:
" Fundo: Árvore/Classe A — série № 7 "
The credit's own business key — the SAME idempotency_key the bid was submitted and accepted under. Bounded at 128 CHARACTERS, the same unit the bid submission surface and its database CHECK already use — never bytes, which a multibyte key would reach first.
Required string length:
1 - 128Ejemplo:
"idem-bid-2026-08-12-0001"
Respuesta
OK
Always true on a successful response: cedido is fail-closed, and this operation only ever succeeds by making it true.
When the cessão was durably registered, strict RFC 3339 UTC.
Ejemplo:
"2026-08-12T12:00:00Z"
The fund this credit is ceded to.
¿Esta página le ayudó?
⌘I