Recompra e Venda de Ativos
Esta seção documenta as APIs que viabilizam a venda e a recompra de direitos creditórios já encarteirados nos fundos administrados pela QI CTVM. O fluxo abrange desde a criação do lote até a baixa dos ativos da carteira do fundo.
Este serviço apenas baixa os ativos da carteira do fundo. Ele não envia dados para outras administradoras.
Existem dois conceitos fundamentais: o lote (assignment) e o ativo (asset). Um lote é composto por um ou mais ativos, e cada ativo inserido precisa já estar na carteira do fundo.
- Para ter acesso a esses serviços, entre em contato com integracao.dtvm@qitech.com.br para liberação dos ambientes de Homologação (Sandbox) e Produção.
- Você precisará da
fund_class_key(chave do fundo), que compõe a URL base de todos os endpoints desta API, e daassignment_configuration_key(chave da configuração), informada na criação do lote:
/trade_resolve/fund_class/{fund_class_key}
Fluxo de venda/recompra
O diagrama abaixo mostra o caminho principal, as bifurcações e o status resultante de cada etapa. Passe o mouse em um nó para ver o endpoint e clique para abrir a documentação.
Informe um external_id único, a data da operação e a conta que fará o pagamento ao fundo.
/trade_resolve/fund_class/{fund_class_key}/assignmentUma requisição por ativo, identificado pelo mesmo external_id com que foi encarteirado. O ativo precisa estar ativo na carteira.
.../assignment/{external_id}/assetQuando o preço de venda diverge mais de 5% do valor justo contábil, o ativo fica retido e exige confirmação explícita. Endpoint ainda não documentado — alinhe com integracao.dtvm@qitech.com.br.
É necessário ter ao menos um ativo não descartado. Você pode enviar number_of_assets e total_value para a API conferir os totais.
.../assignment/{external_id}O descarte está disponível até o encerramento. Depois que o termo entra em circulação, o lote não pode mais ser descartado.
Termo interno: a QI Tech gera o documento e coleta as assinaturas. Termo externo: o integrador envia o termo já assinado.
Com o termo assinado, a QI Tech registra a expectativa de pagamento na conta do fundo.
Confirmado o crédito, os ativos são baixados um a um. Quando todos concluem, o lote é encerrado.
Passo a passo
1. Criação do Lote
Crie o lote informando um identificador único (external_id), a data da operação e a conta que fará o pagamento ao fundo. O lote nasce em pending_assets_insertion e é o contêiner de todos os ativos que serão baixados.
Acessar documentação da criação do lote
2. Inserção dos Ativos
Insira um ativo por requisição, identificando-o pelo mesmo external_id com que ele foi encarteirado. O ativo precisa estar ativo na carteira do fundo no momento da inserção.
Acessar documentação da inserção de ativos
Se o preço de venda informado divergir em mais de 5% do valor justo contábil do ativo, o ativo não segue automaticamente: ele fica em pending_validation e exige uma confirmação explícita do integrador antes de entrar na baixa. Divergências de até 5% seguem direto para pending_wallet_sale.
O endpoint de confirmação ainda não está documentado nesta seção — se o seu fluxo pode gerar divergências acima de 5%, alinhe o procedimento com integracao.dtvm@qitech.com.br.
3. Encerramento do Lote
Após inserir todos os ativos, encerre o lote. É necessário ter ao menos um ativo não descartado. Opcionalmente, você pode enviar number_of_assets e total_value para que a API confira a quantidade e o valor total consolidados antes de aceitar o encerramento.
O descarte do lote está disponível até esta etapa: depois que o termo entra em circulação, o lote não pode mais ser descartado.
Acessar documentação do encerramento
4. Termo de Recompra
O responsável pela emissão do Termo de Recompra depende da configuração do lote:
- Termo interno — a QI Tech gera o termo e coleta as assinaturas das partes. Nenhuma ação do integrador é necessária.
- Termo externo — o lote passa para
pending_signed_term_submissione o integrador precisa enviar o termo já assinado para que o fluxo prossiga.
Em ambos os casos, com o termo assinado o lote passa a pending_payment, aguardando o crédito na conta do fundo.
5. Pagamento e Baixa dos Ativos
As etapas finais são automatizadas: a QI Tech confirma o crédito na conta do fundo, os ativos são baixados da carteira e, quando todos os ativos são concluídos, o lote é encerrado em completed.