Boletador de Títulos Públicos
Registra uma boleta de compra ou venda definitiva, ou de compra compromissada, de título público federal (LFT, LTN, NTN-B, NTN-F) para o fundo. A boleta é registrada no SELIC depois que a gestora a aprova.
| Perfil | Host | Permissão exigida |
|---|---|---|
| Gestora | manager-api | Escrita |
URL base de cada host: Ambientes (Hosts).
Toda boleta nasce em pending_manager_approval, e a API de integração não expõe a aprovação. Para aprovar, acesse o portal da gestora em Ativos › Negociações › Títulos Públicos, abra a operação e clique em Aprovar operação. Na mesma tela é possível cancelar a operação ou, depois do horário de corte, pedir a liberação de horário. Acompanhe o andamento pela consulta da operação ou pela listagem.
A partir das 16:55 (America/Sao_Paulo, inclusive), nada entra no SELIC no mesmo dia:
- o POST só é aceito com
time_exception_reasonpreenchido (sem ele,TTR000054); - a aprovação no portal também é recusada depois do corte. A gestora pode, então, pedir a liberação de horário, e a boleta fica em
pending_time_exception_approvalaté a equipe QI Tech analisar a justificativa e liberar (ou cancelar).
Antes das 16:55, time_exception_reason é ignorado.
Request
Path params
| Parâmetro | Tipo | Descrição |
|---|---|---|
fund_class_key | string | Identificador único do fundo. |
{
"external_id": "a3f1c2e4-7b8d-4e6f-9a0b-1c2d3e4f5a6b",
"operation_date": "2025-12-04",
"payment_date": "2025-12-04",
"operation_part": "assignee",
"operation_type": "outright_operation",
"counterparty": {
"iselic_number": "33444555",
"selic_account_number": "123456789",
"document_number": "33.444.555/0001-81"
},
"treasury_type": "ntn_b",
"unit_price": 1234.567891,
"units": 10,
"maturity_date": "2035-05-15"
}
Atributos do body
| Campo | Tipo | Obrigatoriedade | Descrição |
|---|---|---|---|
external_id | string | opcional | Seu identificador da boleta, único por fundo. Se não informado, será gerado automaticamente (UUID). Máximo de 36 caracteres. Veja Reenvio e duplicidade. |
operation_date | string (date) | obrigatório | Data da operação no formato YYYY-MM-DD. Deve ser um dia útil e igual à accounting_date do fundo. |
payment_date | string (date) | obrigatório | Data de liquidação no formato YYYY-MM-DD. Deve ser >= operation_date. Em operações não-a-prazo (outright_operation, buyback_operation), deve ser igual à operation_date. |
operation_part | string | obrigatório | Papel do fundo na operação: assignee (comprador) ou assignor (vendedor). Em assignor, units não pode passar das unidades deste título na carteira do fundo. |
operation_type | string | obrigatório | Tipo de operação: outright_operation (definitiva) ou buyback_operation (compromissada). buyback_operation exige operation_part == "assignee" e que o fundo esteja habilitado para compromissadas. term_outright_operation ainda não está disponível (TTR000042). |
counterparty | object | obrigatório | Dados da contraparte. Ver objeto abaixo. |
treasury_type | string | obrigatório | Tipo de título: lft, ltn, ntn_b ou ntn_f. |
unit_price | number | obrigatório | Preço unitário do título. Aceita qualquer precisão decimal; o servidor trunca para baixo conforme o tipo: buyback_operation → 8 casas decimais; demais → 6 casas decimais. |
units | integer | obrigatório | Quantidade de títulos (inteiro positivo). |
maturity_date | string (date) | obrigatório | Data de vencimento do título (YYYY-MM-DD). Deve ser estritamente posterior à operation_date. |
yearly_negotiated_rate | number | condicional | Taxa negociada anual, em forma decimal (0.144 = 14,4% a.a.). Obrigatório para buyback_operation. |
return_date | string (date) | condicional | Data de retorno (YYYY-MM-DD). Obrigatório para buyback_operation. Deve ser > operation_date. |
time_exception_reason | string | condicional | Justificativa para boletar fora do horário. Obrigatório a partir das 16:55 (horário de Brasília); ignorado antes disso. Máximo de 500 caracteres. |