Criar Pedido de Resgate

Cria um pedido de resgate de cotas de um investidor em uma série de emissão. Fundos de condomínio fechado não aceitam pedido de resgate.

Disponível em

Perfil	Host	Permissão exigida
Gestora	manager-api	Escrita

URL base de cada host: Ambientes (Hosts).

Request

ENDPOINT

/quota/investor/INVESTOR_KEY/redemption_request

MÉTODO

POST

STATUS

201

Request Body

{
    "issuance_serie_key": "UUID",
    "redemption_request_type": "gross_redemption_value",
    "gross_redemption_value": 1000.0,
    "payment_method": "regular",
    "disbursement_account_key": "UUID",
    "quotation_date": "2025-01-15"
}

Atenção

O campo redemption_request_type define qual campo de valor deve ser enviado. Envie somente esse campo; mandar um campo de outro tipo devolve QTA000025.

• gross_redemption_value: envie gross_redemption_value.
• remaining_application_value: envie remaining_application_value.
• number_of_quotas: envie number_of_quotas.
• net_value_redemption: envie net_value.

O campo disbursement_account_key indica uma conta específica do investidor para o pagamento. Sem ele, a conta principal do investidor é usada.

Body params

Campo	Tipo	Descrição	Obrigatório
issuance_serie_key	string	Chave única da série de emissão	Sim
redemption_request_type	string	Enumerador de Tipos de Pedido de Resgate	Sim
gross_redemption_value	float	Valor bruto do resgate, sem descontar IR e IOF	Condicional
net_value	float	Valor líquido do resgate, já descontados IR e IOF	Condicional
remaining_application_value	float	Valor restante da aplicação	Condicional
number_of_quotas	float	Quantidade de cotas a resgatar	Condicional
disbursement_account_key	string	Chave da conta bancária do investidor que receberá o pagamento	Não
quotation_date	string	Data de cotização do resgate (yyyy-mm-dd). Precisa ser dia útil e respeitar os prazos da série	Não
payment_method	string	Método de pagamento: regular (default) ou b3	Não
reference_date	string	Data de referência do resgate (yyyy-mm-dd)	Não
redemption_request_key	string	Chave (UUID) a usar no pedido, se você quiser defini-la	Não

Campos fora desta lista são recusados com QIT000001.

Tipos de Pedido de Resgate

Enumerador	Descrição
gross_redemption_value	Resgate por valor bruto
number_of_quotas	Resgate por número de cotas
remaining_application_value	Resgate por posição remanescente
net_value_redemption	Resgate por valor líquido

Response

A resposta traz o pedido de resgate criado, no mesmo formato da consulta por chave. Guarde o redemption_request_key.

Response Body (resumido)

{
    "redemption_request_key": "UUID",
    "redemption_request_type": "gross_redemption_value",
    "status": "pending_quote",
    "quotation_date": "2025-01-15",
    "payment_date": "2025-01-16",
    "payment_method": "regular"
}

Erros

Status	Código	Quando acontece
400	QTA000025	Falta o campo de valor do tipo escolhido, ou foi enviado o campo de outro tipo
400	QTA000190	Resgate por valor líquido de até R$ 10,00 (exceto investidor isento)
400	QTA000241	Já existe um pedido de resgate por valor remanescente no mesmo dia
400	QTA000242	Valor disponível insuficiente por causa de cotas bloqueadas
400	QTA000176	quotation_date não é dia útil
400	QTA000182	quotation_date anterior à data contábil do fundo
400	QTA000186	quotation_date anterior à data mínima de cotização da série
400	QTA000296	Investidor do tipo nominee
400	QIT000004	A gestora não está vinculada ao investidor
404	QTA000015	Série de emissão não encontrada
404	QTA000021	Investidor não encontrado
404	QTA000180	O fundo é de condomínio fechado e não aceita pedido de resgate
404	QTA000239	O patrimônio do investidor não cobre todos os resgates pedidos
404	QTA000243	O investidor não tem aplicação resgatável nessa série
422	QTA000357	Movimentação bloqueada: a série está com valor de cota zerado ou negativo

Erros de autenticação, permissão e host: veja Erros da API.