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.
| Perfil | Host | Permissão exigida |
|---|---|---|
| Gestora | manager-api | Escrita |
| Consultoria | consultant-api | Criar Aplicações e Resgates |
URL base de cada host: Ambientes (Hosts).
Request
FUND_CLASS_KEY é a chave da sua classe de fundo, a que vai aplicar.
{
"issuance_serie_key": "<issuance_serie_key>",
"amount": 100000.00,
"quotation_date": "2026-10-08",
"payment_method": "wire_transfer"
}
Body params
| Campo | Tipo | Descrição | Obrigatório |
|---|---|---|---|
issuance_serie_key | string | Chave da série de emissão investida (36 caracteres). Veja Consulta paginada de séries de emissão. | Sim |
amount | number | Valor da aplicação, maior que zero e maior ou igual ao minimum_share_capital da série. | Sim |
quotation_date | string | Data 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_key | string | account_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_method | string | wire_transfer (padrão) ou pix. | Não |
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.
{
"status": "pending_payment"
}
| Campo | Tipo | Descrição | Obrigatório |
|---|---|---|---|
status | string | Envie 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
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
| Status | Código | Quando acontece |
|---|---|---|
| 400 | TFQ000023 | amount menor que o mínimo de aplicação da série (minimum_share_capital). |
| 400 | TFQ000033 | A série investida é da própria classe de fundo. |
| 400 | TFQ000039 | quotation_date não enviada numa série quota_value. |
| 400 | TFQ000050 | quotation_date anterior à data contábil da sua classe. |
| 400 | TFQ000055 | Falta um dado exigido pela série (por exemplo, source_account_key em débito automático). |
| 400 | TFQ000056 | source_account_key enviado para uma série que não usa débito automático. |
| 400 | TFQ000058 | A conta de source_account_key não é da instituição financeira da série. |
| 400 | TFQ000061 | A conta de source_account_key não está aberta. |
| 400 | TFQ000108 | Aplicação enviada depois do horário-limite da série. |
| 400 | TFQ000148 | A série de emissão está inativa. |
| 400 | TFQ000187 | A data de pagamento calculada para a quotation_date já passou. |
| 400 | TFQ000207 | A grade de movimentação da série já fechou. |
| 422 | TFQ000198 | A série está bloqueada para aplicações porque o administrador está bloqueado. |
| 422 | TFQ000220 | O fundo investido foi liquidado e não aceita novas aplicações nessa série. |
| 400 | TFQ000052 | Aprovação com status diferente de pending_payment ou aplicação fora de pending_manager_approval. |
| 400 | TFQ000053 | Cancelamento de aplicação que aguarda o distribuidor ou o administrador. |
| 400 | TFQ000073 | Cancelamento não permitido no status atual. |
| 403 | TFQ000054 | A classe de fundo não pertence à sua gestora, ou aprovação de aplicação em pending_external_approval (só o administrador aprova). |
| 404 | TFQ000005 | Classe de fundo não encontrada. |
| 404 | TFQ000011 | Série de emissão não encontrada. |
| 404 | TFQ000013 | Aplicação financeira não encontrada (cancelamento). |
| 404 | TFQ000059 | Aplicação financeira não encontrada (aprovação). |
Erros de autenticação, permissão e host: veja Erros da API.