Pular para o conteúdo principal

Criar Pedido de Resgate

Cria um pedido de resgate das cotas que a sua classe de fundo tem em outro fundo (série de emissão investida) e permite aprovar ou cancelar o pedido.

Disponível em
PerfilHostPermissão exigida
Gestoramanager-apiEscrita
Consultoriaconsultant-apiCriar Aplicações e Resgates

URL base de cada host: Ambientes (Hosts).

Request​

ENDPOINT
/trade_fund_quota/fund_class/FUND_CLASS_KEY/redemption_request
MÉTODO
POST
STATUS
201

FUND_CLASS_KEY é a chave da sua classe de fundo, a que detém as cotas.

Request Body
{
"issuance_serie_key": "<issuance_serie_key>",
"external_id": "3f1c2a9e-8b7d-4c6e-9a5f-1d2e3c4b5a60",
"amount": 50000.00,
"quotation_date": "2026-10-08"
}

Body params​

CampoTipoDescriçãoObrigatório
issuance_serie_keystringChave da série de emissão investida (36 caracteres). A série precisa ser de condomínio aberto (open_ended).Sim
external_idstringSeu identificador do pedido, com exatamente 36 caracteres (um UUID). Único: um segundo pedido com o mesmo valor é recusado com TFQ000048.Sim
amountnumberValor do resgate, maior que zero. Em séries internal, é tratado como valor líquido. Obrigatório quando redeem_all não é true.Condicional
redeem_allbooleantrue para resgatar a posição inteira; nesse caso amount é dispensado.Não
quotation_datestringData de cotização (YYYY-MM-DD). Obrigatória quando a série tem quota_calculation_method = quota_value; não pode ser anterior à data contábil da sua classe. Em séries internal, é ignorada.Condicional
payment_datestringData de pagamento (YYYY-MM-DD), igual ou posterior a quotation_date. Se omitida, vale quotation_date. Só é usada em séries quota_value.Não
source_account_keystringaccount_key da conta da sua classe na instituição financeira da série. Obrigatória quando o payment_type da série é automatic_debit; não envie quando é transfer.Condicional
Débito automático

Quando o payment_type da série é automatic_debit (normalmente fundos de zeragem), envie source_account_key: a conta precisa estar aberta e ser da mesma instituição financeira da série. Recupere a chave em Recuperando informações da conta.

Reenvio

Em caso de erro, reenvie a requisição: se o pedido já existir, a API devolve TFQ000048 (409) e não cria outro. Nesse caso, confira-o na Consulta paginada de resgates em vez de recriar. Veja Reenvio e duplicidade.

Em séries quota_value, o pedido nasce em pending_manager_approval e precisa ser aprovado (seção abaixo). Em séries internal, ele é aprovado na criação.

Response​

O mesmo objeto é devolvido pela criação, aprovação e cancelamento.

Response Body
{
"redemption_request_key": "<redemption_request_key>",
"external_redemption_request_key": null,
"status": "pending_manager_approval",
"quotation_date": "2026-10-08",
"payment_date": "2026-10-08",
"amount": 50000.0,
"issuance_serie": {
"issuance_serie_key": "<issuance_serie_key>",
"name": "Issuance Serie Name",
"subclass_name": "SUBORDINADA",
"serie": 1,
"quota_calculation_method": "quota_value",
"condominium_type": "open_ended",
"internal_code": "Internal Code",
"fund_class_name": "Fund Class Name",
"fund_class_short_name": "Fund Class Short Name",
"fund_class_document_number": "00.000.000/0000-00",
"minimum_share_capital": 0.0,
"investment_category": "fixed_income",
"asset_type": "fixed_income_fund_quota",
"payment_type": "automatic_debit",
"status": "active",
"financial_institution_code": "329",
"account_data": {
"account_digit": "0",
"account_branch": "0001",
"account_number": "12345",
"financial_institution_code": "329",
"financial_institution_ispb": "00000000"
},
"last_updated_date": "2026-10-07",
"administrator": {
"administrator_key": "<administrator_key>",
"name": "Administrator Name",
"document_number": "00.000.000/0000-00",
"status": "active"
},
"operation_periods": {
"redemption_request": {
"payment": { "days": 1, "type": "until", "calendar_base": "calendar_365" },
"quotation": { "days": 1, "type": "fixed", "calendar_base": "calendar_365" }
},
"financial_application": {
"payment": { "days": 0, "type": "fixed", "calendar_base": "workdays" },
"quotation": { "days": 0, "type": "fixed", "calendar_base": "workdays" }
}
}
},
"fund_class": {
"fund_class_key": "<fund_class_key>",
"name": "Fund Class Name",
"short_name": "Fund Class Short Name",
"document_number": "00.000.000/0000-00",
"accounting_date": "2026-10-07",
"investor_key": "<investor_key>",
"distributor": {
"name": "Distributor Name",
"distributor_key": "<distributor_key>",
"document_number": "00.000.000/0000-00"
},
"manager": {
"manager_key": "<manager_key>",
"manager_name": "Manager Name",
"document_number": "00.000.000/0000-00"
}
}
}

redeem_all aparece (com true) quando o pedido é de resgate total; cash_expectation aparece quando a expectativa de caixa já foi criada. O external_id enviado não é devolvido. A descrição de cada campo está em Consulta paginada de resgates.

Status possíveis: created, pending_manager_approval, pending_distributor_approval, pending_external_approval, pending_quotation, quoted, mismatched_external_data, canceled, confirmed, quotation_reversed.

Aprovar pedido de resgate​

Aprova um pedido em pending_manager_approval. Sem corpo.

ENDPOINT
/trade_fund_quota/fund_class/FUND_CLASS_KEY/redemption_request/REDEMPTION_REQUEST_KEY/approval
MÉTODO
PUT
STATUS
202

A rota PUT /trade_fund_quota/fund_class/FUND_CLASS_KEY/redemption_request/REDEMPTION_REQUEST_KEY, com o corpo {"status": "pending_external_approval"}, faz a mesma aprovação e continua disponível nos mesmos perfis.

A resposta é o objeto de pedido de resgate (veja Response).

Cancelar pedido de resgate​

ENDPOINT
/trade_fund_quota/fund_class/FUND_CLASS_KEY/redemption_request/REDEMPTION_REQUEST_KEY/cancel
MÉTODO
PUT
STATUS
202

Sem corpo. Você pode cancelar o pedido enquanto ele está em pending_manager_approval. Depois da aprovação, o cancelamento é feito pelo administrador, e a API devolve TFQ000053.

A resposta é o objeto de pedido de resgate, com status = canceled.

Erros​

StatusCódigoQuando acontece
409TFQ000048Já existe um pedido de resgate com esse external_id.
400TFQ000039quotation_date não enviada numa série quota_value.
400TFQ000041A sua classe não tem cotas ativas dessa série para resgatar.
400TFQ000046payment_date anterior a quotation_date.
400TFQ000049A série ainda não tem cota calculada (séries internal).
400TFQ000050quotation_date anterior à data contábil da sua classe.
400TFQ000055source_account_key não enviado numa série com débito automático.
400TFQ000056source_account_key enviado numa série com payment_type = transfer.
400TFQ000058A conta de source_account_key não é da instituição financeira da série.
400TFQ000061A conta de source_account_key não está aberta.
400TFQ000067amount não enviado e redeem_all diferente de true.
400TFQ000177A série não aceita resgate (condomínio fechado).
400TFQ000207A grade de movimentação da série já fechou (aprovação).
400TFQ000052Aprovação de pedido fora de pending_manager_approval.
400TFQ000053Cancelamento de pedido fora de pending_manager_approval.
403TFQ000054A classe de fundo não pertence à sua gestora.
404TFQ000005Classe de fundo não encontrada.
404TFQ000011Série de emissão não encontrada.
404TFQ000045Pedido de resgate não encontrado (cancelamento).
404TFQ000060Pedido de resgate não encontrado (aprovação).

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