Criar Aplicação Financeira

Cria uma aplicação financeira de um investidor em uma série de emissão.

Disponível em

Perfil	Host	Permissão exigida
Gestora	manager-api	Escrita
Consultoria	consultant-api	Liberada pelo time de integração

URL base de cada host: Ambientes (Hosts).

Request

ENDPOINT

/quota/investor/INVESTOR_KEY/financial_application

MÉTODO

POST

STATUS

201

Request Body

{
    "issuance_serie_key": "UUID",
    "share_capital": 0.00,
    "payment_method": "b3 / regular",
    "central_depositary": "unregistered / cetip",
    "quotation_date": "yyyy-mm-dd"
}

Campos obrigatórios

• issuance_serie_key
• share_capital

Atenção

payment_method e central_depositary são opcionais. Se não forem enviados, a API usa os valores marcados como default na tabela abaixo (regular e unregistered).

• Com central_depositary cetip, o payment_method pode ser regular ou b3. Com unregistered, apenas regular (b3 devolve o erro QTA000359).

Body params

Campo	Tipo	Descrição
issuance_serie_key	string	Chave única de identificação da Série de emissão
share_capital	float	Valor da aplicação financeira (maior ou igual a 0). Se a série tiver valor mínimo de aplicação, o valor precisa atingi-lo
payment_method	string	Método de Pagamento. Valores esperados: • regular: Pix ou TED (default) • b3: Via B3
central_depositary	string	Tipo de depositárias. Valores esperados: • unregistered: Sem registradora (default) • cetip: Registrado na Cetip
quotation_date	string	Data de cotização da aplicação, no formato yyyy-mm-dd (opcional). Precisa ser dia útil e não pode ser anterior à data contábil do fundo. Se omitida, é calculada pela configuração de prazos da série

Response

A resposta traz o objeto da aplicação financeira criada, no mesmo formato da consulta por chave. Guarde o financial_application_key.

Response Body (resumido)

{
    "financial_application_key": "UUID",
    "share_capital": 1000.0,
    "status": "pending_payment",
    "financial_application_type": "primary_market",
    "payment_method": "regular",
    "central_depositary": "unregistered",
    "quotation_date": "2025-01-10"
}

Erros

Status	Código	Quando acontece
400	QIT000001	Corpo inválido: campo obrigatório ausente, tipo errado ou campo não previsto
400	QIT000004	A série não pertence a um fundo da gestora
400	QTA000359	payment_method b3 com central_depositary unregistered
400	QTA000272	share_capital abaixo do valor mínimo de aplicação da série
400	QTA000176	quotation_date não é dia útil
400	QTA000225	quotation_date anterior à data contábil do fundo
400	QTA000264	Valor acima do disponível na oferta ou no boletim de subscrição (fundo fechado)
400	QTA000267	O boletim de subscrição do investidor ainda não está pronto para subscrição (fundo fechado)
400	QTA000269	A aplicação deixaria a subclasse desenquadrada (índice de subordinação)
403	QTA000315	A consultoria não tem permissão no fundo da série
404	QTA000004	Valor inválido em payment_method ou central_depositary
404	QTA000015	issuance_serie_key não encontrada
404	QTA000021	Investidor não encontrado (na manager-api, hoje a resposta vem como QTA000020)
404	QTA000265	O investidor não tem boletim de subscrição (fundo fechado)
404	QTA000266	A série não tem oferta de cotas (fundo fechado)
422	QTA000425	A série de emissão já foi liquidada
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.