Pular para o conteúdo principal

Criar Aplicação Financeira

Cria uma aplicação da sua classe de fundo em cotas de outro fundo (série de emissão investida) e permite aprovar ou cancelar a aplicação enquanto ela não foi processada.

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/financial_application
MÉTODO
POST
STATUS
201

FUND_CLASS_KEY é a chave da sua classe de fundo, a que vai aplicar.

Request Body
{
"issuance_serie_key": "<issuance_serie_key>",
"amount": 100000.00,
"quotation_date": "2026-10-08",
"payment_method": "wire_transfer"
}

Body params​

CampoTipoDescriçãoObrigatório
issuance_serie_keystringChave da série de emissão investida (36 caracteres). Veja Consulta paginada de séries de emissão.Sim
amountnumberValor da aplicação, maior que zero e maior ou igual ao minimum_share_capital da série.Sim
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; a data de cotização é definida pela plataforma e volta na resposta.Condicional
source_account_keystringaccount_key da conta da sua classe que será debitada. Obrigatória quando a série tem payment_type = automatic_debit; não envie nos demais casos.Condicional
payment_methodstringwire_transfer (padrão) ou pix.Não
Débito automático

Quando a série tem payment_type = 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 (financial_institution_code). Recupere a chave em Recuperando informações da conta.

Em séries quota_value, a aplicação nasce em pending_manager_approval e precisa ser aprovada (seção abaixo). Em séries internal, ela é aprovada na criação e segue para pending_payment.

Response​

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

Response Body
{
"amount": 100000.0,
"financial_application_key": "<financial_application_key>",
"asset_key": null,
"status": "pending_manager_approval",
"quotation_date": "2026-10-08",
"payment_date": "2026-10-08",
"external_financial_application_key": null,
"payment_method": "wire_transfer",
"payment_type": "transfer",
"issuance_serie": {
"issuance_serie_key": "<issuance_serie_key>",
"name": "Invested Issuance Serie Name",
"subclass_name": "Invested Sub Class Name",
"serie": 1,
"quota_calculation_method": "quota_value",
"condominium_type": "open_ended",
"internal_code": "Internal Code",
"fund_class_name": "Invested Fund Class Name",
"fund_class_short_name": "Invested Fund Class Short Name",
"fund_class_document_number": "00.000.000/0000-00",
"minimum_share_capital": 0.0,
"investment_category": "multi_market",
"asset_type": "multi_market_fund_quota",
"payment_type": "transfer",
"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": {
"financial_application": {
"payment": { "days": 0, "type": "fixed", "calendar_base": "workdays" },
"quotation": { "days": 0, "type": "fixed", "calendar_base": "workdays" }
},
"redemption_request": {
"payment": { "days": 1, "type": "until", "calendar_base": "calendar_365" },
"quotation": { "days": 1, "type": "fixed", "calendar_base": "calendar_365" }
}
},
"isin_code": "BR000000000"
},
"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"
}
}
}

asset_key é preenchido na cotização; iof_amount e number_of_quotas aparecem quando já calculados. A descrição de cada campo está em Consulta paginada de aplicações.

Status possíveis: created, pending_manager_approval, pending_distributor_approval, pending_external_approval, pending_payment, pending_payment_confirmation, pending_notify_distributor, pending_quotation, mismatched_external_data, canceled, confirmed.

Aprovar aplicação financeira​

Aprova uma aplicação em pending_manager_approval. A resposta traz pending_payment ou, quando a série depende de aprovação do distribuidor, pending_distributor_approval.

ENDPOINT
/trade_fund_quota/fund_class/FUND_CLASS_KEY/financial_application/FINANCIAL_APPLICATION_KEY
MÉTODO
PUT
STATUS
202
Request Body
{
"status": "pending_payment"
}
CampoTipoDescriçãoObrigatório
statusstringEnvie pending_payment. Outro valor, ou aplicação fora de pending_manager_approval, devolve TFQ000052.Sim

A resposta é o objeto de aplicação financeira (veja Response).

Cancelar aplicação financeira​

ENDPOINT
/trade_fund_quota/fund_class/FUND_CLASS_KEY/financial_application/FINANCIAL_APPLICATION_KEY/cancel
MÉTODO
PUT
STATUS
202

Sem corpo. A aplicação pode ser cancelada nos status pending_manager_approval, pending_payment, pending_payment_confirmation e mismatched_external_data. Em pending_distributor_approval e pending_external_approval, só o administrador cancela (TFQ000053); nos demais status, a API devolve TFQ000073.

A resposta é o objeto de aplicação financeira, com status = canceled.

Erros​

StatusCódigoQuando acontece
400TFQ000023amount menor que o mínimo de aplicação da série (minimum_share_capital).
400TFQ000033A série investida é da própria classe de fundo.
400TFQ000039quotation_date não enviada numa série quota_value.
400TFQ000050quotation_date anterior à data contábil da sua classe.
400TFQ000055Falta um dado exigido pela série (por exemplo, source_account_key em débito automático).
400TFQ000056source_account_key enviado para uma série que não usa débito automático.
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.
400TFQ000108Aplicação enviada depois do horário-limite da série.
400TFQ000148A série de emissão está inativa.
400TFQ000187A data de pagamento calculada para a quotation_date já passou.
400TFQ000207A grade de movimentação da série já fechou.
422TFQ000198A série está bloqueada para aplicações porque o administrador está bloqueado.
422TFQ000220O fundo investido foi liquidado e não aceita novas aplicações nessa série.
400TFQ000052Aprovação com status diferente de pending_payment ou aplicação fora de pending_manager_approval.
400TFQ000053Cancelamento de aplicação que aguarda o distribuidor ou o administrador.
400TFQ000073Cancelamento não permitido no status atual.
403TFQ000054A classe de fundo não pertence à sua gestora, ou aprovação de aplicação em pending_external_approval (só o administrador aprova).
404TFQ000005Classe de fundo não encontrada.
404TFQ000011Série de emissão não encontrada.
404TFQ000013Aplicação financeira não encontrada (cancelamento).
404TFQ000059Aplicação financeira não encontrada (aprovação).

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