Portal do desenvolvedor
AutenticaçãoAPIs
AutenticaçãoAPIs
APIs
APIs
  1. Cessão
  • Informações gerais
  • Operações FIDC
    • Cedente
      • Envia um arquivo de instrução para cadastro de cedente.
      • Envia um arquivo de lastro para cadastro de cedente.
    • Cessão
      • Template - Enviar um arquivo de instrução para Cessão FIDC
      • Envia um arquivo de instrução para Cessão FIDC.
        POST
      • Envia um arquivo de lastro para Cessão FIDC.
        POST
    • Liquidação
      • Envia um arquivo de instrução para Liquidação FIDC.
      • Envia arquivo de lastro para Liquidação FIDC.
    • Pagamento
      • Envia um arquivo de instrução para Pagamento FIDC.
      • Envia arquivo de lastro para Pagamento FIDC.
    • Recompra
      • Envia arquivo de instrução para Recompra FIDC.
      • Envia arquivo de lastro para Recompra FIDC.
  • Relatórios
    • Passivo
      • Obtém a posição atual de um Fundo.
      • Obtém a posição consolidada de um Fundo.
    • Conta corrente
      • Obtém o extrato de contas para um Fundo.
    • Ativo
      • Composição Carteira
      • Composição Carteira Consolidada
      • Exportação XLSX - Composição de carteira
      • Demonstrativo Caixa - Exportar XLSX
      • Demonstrativo Caixa
      • Período da movimentação
      • Posição Anbima - XML
      • Saldo Carteira
      • Rentabilidade Carteira
  • Fundos
    • Consultas
      • Obter Mnemônico
  1. Cessão

Template - Enviar um arquivo de instrução para Cessão FIDC

Exemplo de envio para envio de cessão FIDC

1. Montagem do payload da cessão#

O envio é feito via POST com um corpo JSON descrevendo a cessão. Estrutura mínima:
{
	"$schema": "http://json-schema.org/draft-07/schema#",
	"$id": "https://schemas.brltrust.com.br/json/fidc/v1.2/cessao.schema.json",
	"title": "Cadastro de uma cessão em Fundos de Direitos Creditórios",
	"description": "Descreve o cadastro de uma cessão de um fundo de Direitos Creditórios.",
	"type": "object",
	"examples": [{
		"$schema": "https://schemas.brltrust.com.br/json/fidc/v1.2/cessao.schema.json",
		"description": "Exemplo de ocorrência de remessa",
		"fundo": {
			"identificacao": 90212003000181,
			"nome": "ORDER OF THE PHOENIX FIDC ABERTO MULTISSETORIAL"
		},
		"cessao": {
			"originador": {
				"codigo": "1474",
				"nome": "BANCO DOS BRUXOS GRINGOTES"
			},
			"identificadorCessao": "ID001",
			"recebiveis": [
				{
					"numeroControle": "ID001-01",
					"coobrigacao": true,
					"ocorrencia": 1,
					"tipo": 41,
					"documento": "ID001-1742",
					"termoCessao": "ID001-41-17",
					"sacado": {
						"pessoa": {
							"tipo": "PJ",
							"identificacao": 91798742000160,
							"nome": "MINISTRY OF MAGIC"
						},
						"endereco": {
							"cep": 99988000,
							"logradouro": "Rua Whitewall",
							"numero": "333",
							"complemento": "5 Andar",
							"bairro": "London",
							"municipio": "São Paulo",
							"uf": "SP"
						}
					},
					"cedente": {
						"tipo": "PF",
						"identificacao": 99743552812,
						"nome": "ALBUS PERCIVAL WULFRIC BRIAN DUMBLEDORE"
					},
					"aquisicao": "2020-04-27",
					"emissao": "2019-03-29",
					"vencimento": "2020-11-20",
					"valores": {
						"face": 23605.79,
						"aquisicao": 12211.15
					}
				}
			]
		}
	},{
		"$schema": "https://schemas.brltrust.com.br/json/fidc/v1.2/cessao.schema.json",
		"description": "Exemplo de ocorrência de remessa de título pós-fixado.",
		"fundo": {
			"identificacao": 90212003000181,
			"nome": "ORDER OF THE PHOENIX FIDC ABERTO MULTISSETORIAL"
		},
		"cessao": {
			"originador": {
				"codigo": "1474",
				"nome": "BANCO DOS BRUXOS GRINGOTES"
			},
			"identificadorCessao": "ID001",
			"recebiveis": [
				{
					"numeroControle": "ID001-01",
					"coobrigacao": true,
					"ocorrencia": 1,
					"tipo": 41,
					"documento": "ID001-1742",
					"termoCessao": "ID001-41-17",
					"correcao": {
						"indice": "IPCA"
					},
					"sacado": {
						"pessoa": {
							"tipo": "PJ",
							"identificacao": 91798742000160,
							"nome": "MINISTRY OF MAGIC"
						},
						"endereco": {
							"cep": 99988000,
							"logradouro": "Rua Whitewall",
							"numero": "333",
							"complemento": "5 Andar",
							"bairro": "London",
							"municipio": "São Paulo",
							"uf": "SP"
						}
					},
					"cedente": {
						"tipo": "PF",
						"identificacao": 99743552812,
						"nome": "ALBUS PERCIVAL WULFRIC BRIAN DUMBLEDORE"
					},
					"aquisicao": "2020-04-27",
					"emissao": "2019-03-29",
					"vencimento": "2020-11-20",
					"valores": {
						"face": 23605.79,
						"aquisicao": 12211.15
					}
				}
			]
		}
	},{
		"$schema": "https://schemas.brltrust.com.br/json/fidc/v1.2/cessao.schema.json",
		"description": "Exemplo de ocorrência de remessa com dados adicionais na cessão",
		"fundo": {
			"identificacao": 90212003000181,
			"nome": "ORDER OF THE PHOENIX FIDC ABERTO MULTISSETORIAL"
		},
		"cessao": {
			"originador": {
				"codigo": "1474",
				"nome": "BANCO DOS BRUXOS GRINGOTES"
			},
			"identificadorCessao": "ID001",
			"recebiveis": [
				{
					"numeroControle": "ID001-01",
					"coobrigacao": true,
					"ocorrencia": 1,
					"tipo": 41,
					"documento": "ID001-1742",
					"termoCessao": "ID001-41-17",
					"sacado": {
						"pessoa": {
							"tipo": "PJ",
							"identificacao": 91798742000160,
							"nome": "MINISTRY OF MAGIC"
						},
						"endereco": {
							"cep": 99988000,
							"logradouro": "Rua Whitewall",
							"numero": "333",
							"complemento": "5 Andar",
							"bairro": "London",
							"municipio": "São Paulo",
							"uf": "SP"
						}
					},
					"cedente": {
						"tipo": "PF",
						"identificacao": 99743552812,
						"nome": "ALBUS PERCIVAL WULFRIC BRIAN DUMBLEDORE"
					},
					"aquisicao": "2020-04-27",
					"emissao": "2019-03-29",
					"vencimento": "2020-11-20",
					"valores": {
						"face": 23605.79,
						"aquisicao": 12211.15
					}
				}
			],
			"dados": {
				"rating": "A1",
				"renda": 10500.50,
				"idade": 30
			}
		}
	},{
		"$schema": "https://schemas.brltrust.com.br/json/fidc/v1.2/cessao.schema.json",
		"description": "Exemplo de ocorrência de remessa com dados adicionais no recebível",
		"fundo": {
			"identificacao": 90212003000181,
			"nome": "ORDER OF THE PHOENIX FIDC ABERTO MULTISSETORIAL"
		},
		"cessao": {
			"originador": {
				"codigo": "1474",
				"nome": "BANCO DOS BRUXOS GRINGOTES"
			},
			"identificadorCessao": "ID001",
			"recebiveis": [
				{
					"numeroControle": "ID001-01",
					"coobrigacao": true,
					"ocorrencia": 1,
					"tipo": 41,
					"documento": "ID001-1742",
					"termoCessao": "ID001-41-17",
					"sacado": {
						"pessoa": {
							"tipo": "PJ",
							"identificacao": 91798742000160,
							"nome": "MINISTRY OF MAGIC"
						},
						"endereco": {
							"cep": 99988000,
							"logradouro": "Rua Whitewall",
							"numero": "333",
							"complemento": "5 Andar",
							"bairro": "London",
							"municipio": "São Paulo",
							"uf": "SP"
						}
					},
					"cedente": {
						"tipo": "PF",
						"identificacao": 99743552812,
						"nome": "ALBUS PERCIVAL WULFRIC BRIAN DUMBLEDORE"
					},
					"aquisicao": "2020-04-27",
					"emissao": "2019-03-29",
					"vencimento": "2020-11-20",
					"valores": {
						"face": 23605.79,
						"aquisicao": 12211.15
					},
					"dados": {
						"chassi": "9BW ZZZ377 VT 004251",
						"ano": 1997,
						"contrato": "AL1234"
					}
				}
			]
		}
	},{
		"$schema": "https://schemas.brltrust.com.br/json/fidc/v1.2/cessao.schema.json",
		"description": "Exemplo de ocorrência de liquidação",
		"fundo": {
			"identificacao": 90212003000181,
			"nome": "ORDER OF THE PHOENIX FIDC ABERTO MULTISSETORIAL"
		},
		"cessao": {
			"originador": {
				"codigo": "1474",
				"nome": "BANCO DOS BRUXOS GRINGOTES"
			},
			"identificadorCessao": "ID001",
			"recebiveis": [
				{
					"numeroControle": "ID001-01",
					"coobrigacao": true,
					"ocorrencia": 77,
					"tipo": 41,
					"documento": "ID001-1742",
					"termoCessao": "ID001-41-17",
					"sacado": {
						"pessoa": {
							"tipo": "PJ",
							"identificacao": 91798742000160,
							"nome": "MINISTRY OF MAGIC"
						},
						"endereco": {
							"cep": 99988000,
							"logradouro": "Rua Whitewall",
							"numero": "333",
							"complemento": "5 Andar",
							"bairro": "London",
							"municipio": "São Paulo",
							"uf": "SP"
						}
					},
					"cedente": {
						"tipo": "PF",
						"identificacao": 99743552812,
						"nome": "ALBUS PERCIVAL WULFRIC BRIAN DUMBLEDORE"
					},
					"aquisicao": "2020-04-27",
					"emissao": "2019-03-29",
					"vencimento": "2020-11-20",
					"liquidacao": "2020-11-20",
					"valores": {
						"face": 23605.79,
						"aquisicao": 12211.15,
						"liquidacao": 23605.79
					}
				}
			]
		}
	},{
		"$schema": "https://schemas.brltrust.com.br/json/fidc/v1.2/cessao.schema.json",
		"description": "Exemplo de ocorrência de revisão do fluxo de pagamentos (substituição)",
		"fundo": {
			"identificacao": 90212003000181,
			"nome": "ORDER OF THE PHOENIX FIDC ABERTO MULTISSETORIAL"
		},
		"cessao": {
			"originador": {
				"codigo": "1474",
				"nome": "BANCO DOS BRUXOS GRINGOTES"
			},
			"identificadorCessao": "ID001-R1",
			"recebiveis": [
				{
					"numeroControle": "ID001-01",
					"coobrigacao": true,
					"ocorrencia": 74,
					"tipo": 41,
					"documento": "ID001-1742",
					"termoCessao": "ID001-41-17",
					"sacado": {
						"pessoa": {
							"tipo": "PJ",
							"identificacao": 91798742000160,
							"nome": "MINISTRY OF MAGIC"
						},
						"endereco": {
							"cep": 99988000,
							"logradouro": "Rua Whitewall",
							"numero": "333",
							"complemento": "5 Andar",
							"bairro": "London",
							"municipio": "São Paulo",
							"uf": "SP"
						}
					},
					"cedente": {
						"tipo": "PF",
						"identificacao": 99743552812,
						"nome": "ALBUS PERCIVAL WULFRIC BRIAN DUMBLEDORE"
					},
					"aquisicao": "2020-04-27",
					"emissao": "2019-03-29",
					"vencimento": "2020-11-20",
					"liquidacao": "2020-11-15",
					"valores": {
						"face": 23605.79,
						"aquisicao": 12211.15,
						"liquidacao": 20000.0
					}
				},
				{
					"numeroControle": "ID001-01A",
					"coobrigacao": true,
					"ocorrencia": 84,
					"tipo": 41,
					"documento": "ID001-1742",
					"termoCessao": "ID001-41-17",
					"sacado": {
						"pessoa": {
							"tipo": "PJ",
							"identificacao": 91798742000160,
							"nome": "MINISTRY OF MAGIC"
						},
						"endereco": {
							"cep": 99988000,
							"logradouro": "Rua Whitewall",
							"numero": "333",
							"complemento": "5 Andar",
							"bairro": "London",
							"municipio": "São Paulo",
							"uf": "SP"
						}
					},
					"cedente": {
						"tipo": "PF",
						"identificacao": 99743552812,
						"nome": "ALBUS PERCIVAL WULFRIC BRIAN DUMBLEDORE"
					},
					"aquisicao": "2020-11-15",
					"emissao": "2020-11-15",
					"vencimento": "2020-12-20",
					"valores": {
						"face": 11500.0,
						"aquisicao": 10000
					}
				},
				{
					"numeroControle": "ID001-01B",
					"coobrigacao": true,
					"ocorrencia": 84,
					"tipo": 41,
					"documento": "ID001-1742",
					"termoCessao": "ID001-41-17",
					"sacado": {
						"pessoa": {
							"tipo": "PJ",
							"identificacao": 91798742000160,
							"nome": "MINISTRY OF MAGIC"
						},
						"endereco": {
							"cep": 99988000,
							"logradouro": "Rua Whitewall",
							"numero": "333",
							"complemento": "5 Andar",
							"bairro": "London",
							"municipio": "São Paulo",
							"uf": "SP"
						}
					},
					"cedente": {
						"tipo": "PF",
						"identificacao": 99743552812,
						"nome": "ALBUS PERCIVAL WULFRIC BRIAN DUMBLEDORE"
					},
					"aquisicao": "2020-11-15",
					"emissao": "2020-11-15",
					"vencimento": "2021-01-20",
					"valores": {
						"face": 12500.0,
						"aquisicao": 10000
					}
				}
			]
		}
	},
		{
			"$schema": "https://schemas.brltrust.com.br/json/fidc/v1.2/cessao.schema.json",
			"description": "Exemplo de ocorrência recompra",
			"fundo": {
				"identificacao": 90212003000181,
				"nome": "ORDER OF THE PHOENIX FIDC ABERTO MULTISSETORIAL"
			},
			"cessao": {
				"originador": {
					"codigo": "1474",
					"nome": "BANCO DOS BRUXOS GRINGOTES"
				},
				"identificadorCessao": "ID001-R1",
				"recebiveis": [
					{
						"numeroControle": "ID001-01",
						"coobrigacao": false,
						"ocorrencia": 85,
						"tipo": 1,
						"documento": "ID001-1742",
						"termoCessao": "ID001-41-17",
						"sacado": {
							"pessoa": {
								"tipo": "PJ",
								"identificacao": 91798742000160,
								"nome": "MINISTRY OF MAGIC"
							},
							"endereco": {
								"cep": 99988000,
								"logradouro": "Rua Whitewall",
								"numero": "333",
								"complemento": "5 Andar",
								"bairro": "London",
								"municipio": "São Paulo",
								"uf": "SP"
							}
						},
						"cedente": {
							"tipo": "PF",
							"identificacao": 99743552812,
							"nome": "ALBUS PERCIVAL WULFRIC BRIAN DUMBLEDORE"
						},
						"aquisicao": "2020-11-15",
						"emissao": "2020-11-15",
						"vencimento": "2020-12-20",
						"liquidacao": "2020-11-25",
						"valores": {
							"face": 126009.14,
							"liquidacao": 125009.37,
							"aquisicao": 123034.17
						}
					},
					{
						"numeroControle": "ID001-02",
						"coobrigacao": false,
						"ocorrencia": 85,
						"tipo": 1,
						"documento": "ID001-1742",
						"termoCessao": "ID001-41-17",
						"sacado": {
							"pessoa": {
								"tipo": "PJ",
								"identificacao": 91798742000160,
								"nome": "MINISTRY OF MAGIC"
							},
							"endereco": {
								"cep": 99988000,
								"logradouro": "Rua Whitewall",
								"numero": "333",
								"complemento": "5 Andar",
								"bairro": "London",
								"municipio": "São Paulo",
								"uf": "SP"
							}
						},
						"cedente": {
							"tipo": "PF",
							"identificacao": 99743552812,
							"nome": "ALBUS PERCIVAL WULFRIC BRIAN DUMBLEDORE"
						},
						"aquisicao": "2020-11-15",
						"emissao": "2020-11-15",
						"vencimento": "2021-01-20",
						"liquidacao": "2020-11-25",
						"valores": {
							"face": 11600.0,
							"liquidacao": 10500.39,
							"aquisicao": 10000
						}
					}
				]
			}
		}
	],
	"properties": {
		"$schema": { "type":  "string" },
		"fundo": { "$ref": "https://schemas.brltrust.com.br/json/cadun/v1.2/pessoa.schema.json#/definitions/fundo" },
		"cessao": { "$ref": "#/definitions/cessao" },
		"pagamentos": {
			"description": "Preencher com uma das contas corrente do cedente, previamente cadastrada, caso o pagamento seja realizado em conta diferente da padrão.",
			"type": "array",
			"minItems": 1,
			"items": { "$ref": "#/definitions/pagamento" }
		}
	},
	"required": ["fundo", "cessao"],
	"additionalProperties": false,
	"definitions": {
		"originador": {
			"type": "object",
			"properties": {
				"codigo": {
					"description": "H06 - Código de identificação fornecido pela BRL",
					"type": "string",
					"maxLength": 20
				},
				"nome": {
					"description": "H07 - Nome da consultoria",
					"type": "string",
					"maxLength": 30
				}
			},
			"required": ["codigo", "nome"],
			"additionalProperties": false
		},
		"cessao": {
			"type": "object",
			"properties": {
				"identificadorCessao": {
					"description": "Identificador único da cessão na Consultoria independente dos códigos de ocorrência.",
					"type": "string",
					"maxLength": 50
				},
				"originador": { "$ref": "#/definitions/originador" },
				"recebiveis": {
					"type": "array",
					"minItems": 1,
					"items": { "$ref": "#/definitions/recebivel" }
				},
				"retencao": {
					"description": "H15 - Valor da retencao para cessão",
					"type": "number",
					"inclusiveMinimum": 0,
					"maximum":  99999999.99
				},
				"pagamentos": {
					"description": "Preencher com uma das contas corrente do cedente, previamente cadastrada, caso o pagamento seja realizado em conta diferente da padrão.",
					"type": "array",
					"minItems": 1,
					"items": { "$ref": "#/definitions/pagamento" }
				},
				"dados": {
					"description": "Ponto de extensão para dados adicionais necessários a operação ligados a cessão.",
					"$ref": "#/definitions/dados"
				}
			},
			"required": [ "identificadorCessao", "originador", "recebiveis" ],
			"additionalProperties": false
		},
		"recebivel": {
			"type": "object",
			"properties": {
				"numeroControle": {
					"description": "D10 - Identificador único do título na Consultoria",
					"type": "string",
					"maxLength": 25
				},
				"coobrigacao": {
					"description": "D03 - Verdadeiro (true) com coobrigação, falso (false) caso contrário",
					"type": "boolean"
				},
				"operacao": { "$ref": "#/definitions/operacao" },
				"banco": {
					"description": "D11 - Obrigatório para o tipo de recebivel cheque (51)",
					"$ref": "https://schemas.brltrust.com.br/json/cadun/v1.2/pessoa.schema.json#/definitions/banco"
				},
				"conta": {
					"description": "Informação do banco e conta de pagamento, utilizado somente em caso de liquidação",
					"$ref": "https://schemas.brltrust.com.br/json/cadun/v1.2/pessoa.schema.json#/definitions/conta"
				},
				"ocorrencia": {
					"description": "D23 - Identificação Ocorrência: 01 – Remessa; 02 – Baixa; 03 - Liquidação; 04 – Abatimento (mediante Justificativa); 06 - Alteração De Vencimento (para Efeito De Conciliação. Não Altera O Vencimento Original); 07 - Baixa por Prejuízo; 11 – Aquisição De Contratos Futuros; 12 – Aquisição De Baixa De Contratos Futuros; 14 - Pagamento Parcial; 18 - Aquisição Por Recompra; 20 - Prorrogação Da Data De Vencimento Do Título; 25 - Baixa colateral; 27 - Baixa Parcial Zerada; 33 - Baixa por Execucao de Garantia; 36 - Baixa Por Resolução; 48 - Liquidação Parcial Np; 54 - Baixa Conciliação; 68 - Baixa de Cheque; 71 – Baixa Por Recompra, Baixa Mediante Entrada De Novo Titulo – Com Liquidação  Para A Consultoria (obrigatória Contrapartida 81 No Mesmo Arquivo).; 72 - Recompra Parcial Sem Adiantamento.; 73 - Baixa parcial para/por recomposição de ativo; 74 – Baixa Por Recompra, Baixa Mediante Entrada De Novo Titulo, Com Liquidação Para O Cedente (obrigatório Contrapartida 84 No Mesmo Arquivo); 75 – Baixa Por Depósito Cedente; 76 – Baixa Por Depósito Consultoria; 77 – Baixa Por Depósito Sacado; 79 - Baixa Por Prejuízo; 80 – Remessa (com Liquidação Para A Consultoria).; 81 – Entrada Por Recompra Troca De Títulos, Com Objetivo De Recompra, Com Liquidação Para A Consultoria (obrigatório Contrapartida 71 No Mesmo Arquivo).; 82 - Recompra Parcial de Títulos; 83 - Aquisição para/por recomposição parcial de título; 84 – Entrada Por Recompra Troca De Títulos, Com Liquidação Para O Cedente (obrigatório Contrapartida 74 No Mesmo Arquivo) Se Tiver Recompra Dentro Da Operação Enviar As Entradas Com O Código 84; 85 - Baixa Por Recompra;  86 - Baixa Por Recompra;  87 – Reativação; 95 - Baixa Por Venda; 99 - Recebível Reprovado Por Consultoria Ou Gestor (o Recebível Não Será Adquirido, Não Sendo Enviado Para O Sistema De Custódia)",
					"type": "number",
					"enum": [ 1, 2, 3, 4, 6, 7, 11, 12, 14, 18, 20, 25, 27, 33, 36, 48, 54, 68, 71, 72, 73, 74, 75, 76, 77, 79, 80, 81, 82, 83, 84, 85, 86, 87, 95, 99 ]
				},
				"tipo": {
					"description": "D29 - Tipo do recebivel: 01 - Duplicata; 02 - Nota Promissória; 03 - Nota de Seguro; 06 - Nota Promissória Física; 08 - Assunção de Dívida; 09 - Nota comercial; 11 – Duplicata de Serviço; 14 – Duplicata de Serviço Física; 15 - Cota de consórcio ativa; 16: Cota de consórcio cancelada; 18: Cota de consórcio ativa p/ cancelar; 19 - Consorcio Inativo Reativacao; 24 - Nota de Debito; 25 - CCB EMP PESSOAL DESEMB DIRETO; 26 - CCB EMP PESSOAL DESEMB TERC; 27 - CCB EMP PESSOAL Buy Now Pay Later; 29 - Unidades de recebivel; 31 - DIREITO SOBRE DIVIDENDOS; 41 - CCB Digital; 51 - Cheque; 53 - Precatório Estadual; 54 - Precatório Federal; 55 - Precatório Municipal; 58 - CCB Renegociação; 59 - CCB Digital com Garantia, 60 – Contrato; 61 – Contrato Físico; 62 – Confissão de Divida; 65 – Fatura de Cartão Credito; 67 - Bloqueio agenda pagamento Cartao; 69 - Bloqueio Agenda Pgto Cartao Bx Aut; 70 - CCB PRE DIGITAL; 73 - Home Equity; 74 - Financiamento de imóvel; 75 - Auto Equity; 76 - Financiamento de automóvel; 77 - Financiamento de moto; 78 - CCB Consignado Privado; 79 - Antecipação de salário; 80 - Consignado - Creditas Store; 81 - Previdência; 82 - CCB Consignado Público; 83 - CCB Outros; 95 - FATURA DE CARTAO DE CREDITO - SEM BX AUT; 97 - Ação Judicial",
					"type": "number",
					"enum": [ 1, 2, 3, 6, 8, 9, 11, 14, 15, 16, 18, 19, 24, 25, 26, 27, 29, 31, 41, 51, 53, 54, 55, 58, 59, 60, 61, 62, 65, 67, 69, 70, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 95, 97 ]
				},
				"cobranca": { "$ref": "#/definitions/cobranca" },
				"correcao": { "$ref": "#/definitions/correcao" },
				"documento": {
					"description": "D24 - Número do documento (seu número)",
					"type": "string",
					"maxLength": 10
				},
				"termoCessao": {
					"description": "D36 - Número do Termo de Cessão",
					"type": "string",
					"maxLength": 19
				},
				"sacado": { "$ref": "#/definitions/sacado" },
				"cedente": { "$ref": "https://schemas.brltrust.com.br/json/cadun/v1.2/pessoa.schema.json#/definitions/pessoa" },
				"emissao": {
					"description": "D31 - Data de emissão do título",
					"type": "string",
					"format": "date"
				},
				"aquisicao": {
					"description": "H10 - Data de aquisição da cessão, deve ser a data da gravação do arquivo",
					"type": "string",
					"format": "date"
				},
				"liquidacao": {
					"description": "D18 - Data de liquidação do título. Informar somente para ocorrências de baixa.",
					"type": "string",
					"format": "date"
				},
				"vencimento": {
					"description": "D26 - Data de vencimento do título",
					"type": "string",
					"format": "date"
				},
				"lastro": { "$ref": "#/definitions/lastro" },
				"valores": { "$ref": "#/definitions/valor" },
				"dados": {
					"description": "Ponto de extensão para dados adicionais necessários a operação ligados ao recebível.",
					"$ref": "#/definitions/dados"
				}
			},
			"required": [ "numeroControle", "coobrigacao", "ocorrencia", "tipo", "documento", "sacado", "cedente", "emissao", "aquisicao", "vencimento", "valores"],
			"additionalProperties": false
		},
		"operacao": {
			"type": "object",
			"properties": {
				"caracteristicaEspecial": {
					"description": "D04 - Preencher de acordo com o Anexo 8 do layout SRC3040 do Bacen",
					"type": "string",
					"maxLength": 2
				},
				"modalidade": {
					"description": "D05 - Preencher de acordo com o Anexo 3 do layout SRC3040 do Bacen - preencher o domínio e o sub- domínio",
					"type": "string",
					"maxLength": 4
				},
				"natureza": {
					"description": "D06 - Preencher de acordo com o Anexo 2 do layout SRC3040 do Bacen",
					"type": "string",
					"maxLength": 2
				},
				"origemRecursos": {
					"description": "D07 - Preencher de acordo com o Anexo 4 do layout SRC3040 do Bacen - preencher o domínio e o sub- domínio",
					"type": "string",
					"maxLength": 4
				},
				"classificacaoRisco": {
					"description": "D08 - Preencher de acordo com o Anexo 17 do layout SRC3040 do Bacen",
					"type": "string",
					"enum": [ "AA", "A", "B", "C", "D", "E", "F", "G", "H", "HH" ]
				}
			},
			"additionalProperties": false
		},
		"cobranca": {
			"type": "object",
			"properties": {
				"banco": {
					"description": "D27 - Banco encarregado pela cobrança",
					"$ref": "https://schemas.brltrust.com.br/json/cadun/v1.2/pessoa.schema.json#/definitions/banco"
				},
				"agencia": {
					"description": "D28 - Código da Agência Depositária",
					"type": "string",
					"maxLength": 5
				},
				"emitirPapeletaCobranca": {
					"description": "D16 - Condição para Emissão da Papeleta de Cobrança",
					"type": "boolean"
				}
			},
			"required": [ "banco", "agencia", "emitirPapeletaCobranca" ],
			"additionalProperties": false
		},
		"correcao": {
			"description": "Correção para títulos pós fixados. Atenção: Está funcionalidade precisar estar habilitada para o fundo.",
			"type": "object",
			"properties": {
				"indice": {
					"description": "Indice de correção",
					"type": "string",
				    "enum": ["SEM-CORRECAO", "JUROS-FIXO", "CDI", "IPCA-15", "IPCA", "IPCA-E", "IGPM"]
				},
				"carencia": {
					"description": "A partir de quando será aplicado a correção pós-fixada",
					"type": "string",
					"format": "date"
				},
				"taxa": {
					"description": "Valor em caso de juros fixo ou percentual do indexador definido 9(10,7).",
					"type":  "number"
				}
			},
			"required": ["indice"]
		},
		"sacado": {
			"type": "object",
			"properties": {
				"pessoa": { "$ref": "https://schemas.brltrust.com.br/json/cadun/v1.2/pessoa.schema.json#/definitions/pessoa" },
				"endereco": { "$ref": "https://schemas.brltrust.com.br/json/cadun/v1.2/pessoa.schema.json#/definitions/endereco" }
			},
			"required": [ "pessoa",  "endereco" ],
			"additionalProperties": false
		},
		"valor": {
			"type": "object",
			"properties": {
				"face": {
					"description": "D26 - Valor de face do título",
					"type": "number",
					"multipleOf": 0.01,
					"exclusiveMinimum": 0
				},
				"aquisicao": {
					"description": "D37 - Valor Presente da Parcela (liquido da parcela) – Valor de Aquisição",
					"type": "number",
					"multipleOf": 0.01,
					"inclusiveMinimum": 0
				},
				"abatimento": {
					"description": "D38 - Valor do Abatimento a ser concedido na instrução",
					"type": "number",
					"multipleOf": 0.01,
					"inclusiveMinimum": 0
				},
				"cedente": {
					"description": "Valor a ser pago para o cedente em caso de comissões e taxas usados nos tipos de recebiveis (15, 16, 53, 54, 55)",
					"type":  "number",
					"multipleOf": 0.01,
					"inclusiveMinimum": 0
				},
				"comissoes": {
					"description": "Valor a ser pago pela comissão para os tipos de recebiveis (15, 16, 53, 54, 55)",
					"type": "number",
					"multipleOf": 0.01,
					"inclusiveMinimum": 0
				},
				"liquidacao": {
					"description": "D15 - Valor pago na liquidação/baixa do título. Informar somente para ocorrencias de baixa.",
					"type": "number",
					"multipleOf": 0.01,
					"inclusiveMinimum": 0
				},
				"tributos": {
					"description": "Valor a ser pago pelos tributos para o tipo de recebivel precatório (53, 54, 55)",
					"type": "number",
					"multipleOf": 0.01,
					"inclusiveMinimum": 0
				},
				"despesas": {
					"description": "Valor a ser pago eventual despesas de cartório e outros para o tipo de recebivel precatório (53, 54, 55)",
					"type": "number",
					"multipleOf": 0.01,
					"inclusiveMinimum": 0
				},
				"retencao": {
					"description": "D15 - Valor de retenção",
					"type": "number",
					"multipleOf": 0.01,
					"inclusiveMinimum": 0
				}
			},
			"required": [ "face", "aquisicao" ],
			"additionalProperties": false
		},
		"lastro": {
			"type": "object",
			"properties": {
				"numero": {
					"description": "D43 - Numero da Nota fiscal para tipo de recebível Duplicata (01)",
					"type": "string",
					"maxLength": 9
				},
				"serie": {
					"description": "D44 - Numero da Série da Nota Fiscal para tipo de recebível Duplicata (01)",
					"type": "string",
					"maxLength": 3
				},
				"chave": {
					"description": "D47 - Chave da Nota Fiscal Eletrônica para tipo de recebível Duplicata Mercantil (01); Número do precatório para tipo de recebivel Precatório (53, 54, 55); CMC7 para tipo de recebível cheque (51); ",
					"type": "string",
					"maxLength": 50
				},
				"duplicata": {
					"description": "Número da Duplicata com três caracteres conforme o campo 'cobr/dup/nDup' do xml da nota fiscal.",
					"type":  "string",
					"maxLength": 3
				}
			},
			"required": [ "chave" ],
			"additionalProperties": false
		},
		"pagamento": {
			"type": "object",
			"properties": {
				"tipo": {
					"type": "string",
					"enum": ["CEDENTE", "HONORARIO", "INTERMEDIARIO", "ORIGINADOR", "TRIBUTO", "COMPLEMENTAR"]
				},
				"pagamento": { "$ref": "https://schemas.brltrust.com.br/json/cadun/v1.2/pessoa.schema.json#/definitions/pagamento" }
			},
			"required": ["tipo", "pagamento"],
			"additionalProperties": false
		},
		"dados": {
			"description": "Estrutura livre para inclusão de dados adicionais necessários a operação.",
			"type": "object",
			"additionalProperties": true
		}
	}
}

Campos#

CampoTipoObrigatórioDescrição
fundoobjectSimDados do fundo (ref. cadastro de pessoa).
cessaoobjectSimObjeto principal da cessão.
pagamentos[]arrayNãoContas correntes do cedente para pagamento em conta diferente da padrão.
cessao.identificadorCessaostring (max 50)SimIdentificador único da cessão na Consultoria, independente dos códigos de ocorrência.
cessao.originadorobjectSimDados do originador/consultoria.
cessao.originador.codigostring (max 20)SimH06 – Código de identificação do originador fornecido pela BRL.
cessao.originador.nomestring (max 30)SimH07 – Nome da consultoria.
cessao.recebiveis[]arraySimLista de recebíveis da cessão. Mínimo 1 item.
cessao.retencaonumberNãoH15 – Valor da retenção para a cessão. Máx: 99999999.99.
cessao.dadosobjectNãoPonto de extensão para dados adicionais ligados à cessão. Estrutura livre.
cessao.recebiveis[].numeroControlestring (max 25)SimD10 – Identificador único do título na Consultoria.
cessao.recebiveis[].coobrigacaobooleanSimD03 – true com coobrigação, false caso contrário.
cessao.recebiveis[].ocorrencianumber (enum)SimD23 – Código da ocorrência (ex: 1=Remessa, 77=Baixa por Depósito Sacado, 85=Baixa por Recompra). Ver schema para lista completa.
cessao.recebiveis[].tiponumber (enum)SimD29 – Tipo do recebível (ex: 1=Duplicata, 41=CCB Digital, 51=Cheque). Ver schema para lista completa.
cessao.recebiveis[].documentostring (max 10)SimD24 – Número do documento (seu número).
cessao.recebiveis[].termoCessaostring (max 19)NãoD36 – Número do Termo de Cessão.
cessao.recebiveis[].emissaodate (YYYY-MM-DD)SimD31 – Data de emissão do título.
cessao.recebiveis[].aquisicaodate (YYYY-MM-DD)SimH10 – Data de aquisição da cessão. Deve ser a data de gravação do arquivo.
cessao.recebiveis[].vencimentodate (YYYY-MM-DD)SimD26 – Data de vencimento do título.
cessao.recebiveis[].liquidacaodate (YYYY-MM-DD)NãoD18 – Data de liquidação do título. Informar somente para ocorrências de baixa.
cessao.recebiveis[].sacadoobjectSimDados do sacado (pessoa + endereço).
cessao.recebiveis[].sacado.pessoaobjectSimDados de identificação do sacado (ref. cadastro de pessoa).
cessao.recebiveis[].sacado.enderecoobjectSimEndereço do sacado (ref. cadastro de pessoa).
cessao.recebiveis[].cedenteobjectSimDados do cedente (ref. cadastro de pessoa).
cessao.recebiveis[].valoresobjectSimValores do recebível.
cessao.recebiveis[].valores.facenumberSimD26 – Valor de face do título. Múltiplo de 0.01, exclusivamente maior que 0.
cessao.recebiveis[].valores.aquisicaonumberSimD37 – Valor presente da parcela (líquido) – Valor de Aquisição. Múltiplo de 0.01.
cessao.recebiveis[].valores.liquidacaonumberNãoD15 – Valor pago na liquidação/baixa. Informar somente para ocorrências de baixa.
cessao.recebiveis[].valores.abatimentonumberNãoD38 – Valor do abatimento a ser concedido na instrução.
cessao.recebiveis[].valores.cedentenumberNãoValor a ser pago ao cedente (comissões/taxas). Usados nos tipos 15, 16, 53, 54, 55.
cessao.recebiveis[].valores.comissoesnumberNãoValor de comissão. Usados nos tipos 15, 16, 53, 54, 55.
cessao.recebiveis[].valores.tributosnumberNãoValor de tributos. Usado nos tipos precatório (53, 54, 55).
cessao.recebiveis[].valores.despesasnumberNãoValor de despesas de cartório e outros. Usado nos tipos precatório (53, 54, 55).
cessao.recebiveis[].valores.retencaonumberNãoD15 – Valor de retenção.
cessao.recebiveis[].operacaoobjectNãoDados da operação para conformidade com layout SRC3040 do Bacen.
cessao.recebiveis[].operacao.caracteristicaEspecialstring (max 2)NãoD04 – Conforme Anexo 8 do layout SRC3040 do Bacen.
cessao.recebiveis[].operacao.modalidadestring (max 4)NãoD05 – Conforme Anexo 3 do layout SRC3040 do Bacen (domínio + subdomínio).
cessao.recebiveis[].operacao.naturezastring (max 2)NãoD06 – Conforme Anexo 2 do layout SRC3040 do Bacen.
cessao.recebiveis[].operacao.origemRecursosstring (max 4)NãoD07 – Conforme Anexo 4 do layout SRC3040 do Bacen (domínio + subdomínio).
cessao.recebiveis[].operacao.classificacaoRiscostring (enum)NãoD08 – Classificação de risco: AA, A, B, C, D, E, F, G, H, HH.
cessao.recebiveis[].cobrancaobjectNãoDados do banco encarregado pela cobrança.
cessao.recebiveis[].cobranca.bancoobjectSim*D27 – Banco encarregado pela cobrança (ref. cadastro de pessoa).
cessao.recebiveis[].cobranca.agenciastring (max 5)Sim*D28 – Código da Agência Depositária.
cessao.recebiveis[].cobranca.emitirPapeletaCobrancabooleanSim*D16 – Condição para emissão da papeleta de cobrança.
cessao.recebiveis[].correcaoobjectNãoCorreção para títulos pós-fixados. Requer habilitação no fundo.
cessao.recebiveis[].correcao.indicestring (enum)Sim*Índice de correção: SEM-CORRECAO, JUROS-FIXO, CDI, IPCA-15, IPCA, IPCA-E, IGPM.
cessao.recebiveis[].correcao.carenciadate (YYYY-MM-DD)NãoA partir de quando será aplicada a correção pós-fixada.
cessao.recebiveis[].correcao.taxanumberNãoValor em caso de juros fixo ou percentual do indexador (9(10,7)).
cessao.recebiveis[].lastroobjectNãoDados do lastro do recebível.
cessao.recebiveis[].lastro.chavestring (max 50)Sim*D47 – Chave da NF-e (tipo 01); número do precatório (53/54/55); CMC7 (cheque, tipo 51).
cessao.recebiveis[].lastro.numerostring (max 9)NãoD43 – Número da nota fiscal. Usado para Duplicata (tipo 01).
cessao.recebiveis[].lastro.seriestring (max 3)NãoD44 – Série da nota fiscal. Usado para Duplicata (tipo 01).
cessao.recebiveis[].lastro.duplicatastring (max 3)NãoNúmero da duplicata conforme campo cobr/dup/nDup do XML da NF.
cessao.recebiveis[].bancoobjectNãoD11 – Obrigatório para recebível do tipo Cheque (51).
cessao.recebiveis[].contaobjectNãoBanco e conta de pagamento. Utilizado somente em caso de liquidação.
cessao.recebiveis[].dadosobjectNãoPonto de extensão para dados adicionais ligados ao recebível. Estrutura livre.
pagamentos[].tipostring (enum)Sim*Tipo do pagamento: CEDENTE, HONORARIO, INTERMEDIARIO, ORIGINADOR, TRIBUTO, COMPLEMENTAR.
pagamentos[].pagamentoobjectSim*Dados da conta de pagamento (ref. cadastro de pessoa).
* Obrigatório quando o objeto pai estiver presente.

Erros comuns#

CódigoSignificadoAção recomendada
400Payload inválidoVerifique campos obrigatórios, tipos e formatos. Confira especialmente datas no formato YYYY-MM-DD e números sem máscara.
401Token ausente ou expiradoRefaça a autenticação e utilize o novo token na header Authorization.
404Fundo não encontradoVerifique se o fundo.identificacao (CNPJ) está correto e cadastrado na plataforma.
409Cessão duplicadaConfirme o identificadorCessao — uma cessão com esse identificador já foi enviada.
422Regra de negócio violadaLeia o campo errors[] na resposta para detalhes. Causas comuns: ocorrência inválida para o tipo de recebível, valor de aquisição maior que o valor de face, ou liquidacao ausente em ocorrências de baixa.
500Erro interno do servidorTente novamente após alguns instantes. Se o erro persistir, entre em contato com o suporte informando o identificadorCessao.
Modificado em 2026-05-25 13:56:28
Página anterior
Envia um arquivo de lastro para cadastro de cedente.
Próxima página
Envia um arquivo de instrução para Cessão FIDC.
Built with