Pular para o conteúdo principal

Liquidação de Ativos

Esta seção documenta as APIs que viabilizam o processo de Liquidação de Ativos para Fundos de Investimento administrados pela QI CTVM. Por meio dessas APIs, é possível registrar pagamentos de parcelas, amortizações, recompras e demais eventos de liquidação dos ativos que compõem a carteira do fundo.

Contexto

A liquidação de ativos descrita nesta seção aplica-se exclusivamente a direitos creditórios (CCBs, duplicatas, contratos, etc.) já encarteirados no fundo. Letras do Tesouro, Debêntures e outros ativos de renda fixa não se aplicam a esse fluxo.

Pré-requisitos
  • 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:
/settlement/fund_class/{fund_class_key}

Fluxo de liquidação​

O diagrama abaixo ilustra as etapas do fluxo:

Passo a passo​

1. Criação do Lote de Pagamento​

Crie um lote de pagamento informando um identificador único (external_id). O lote será o contêiner para todas as liquidações que serão processadas em conjunto.

Acessar documentação da criação do lote

2. Inserção das Liquidações​

Adicione as liquidações ao lote criado. Cada liquidação deve ser inserida individualmente, informando o tipo de ativo, o valor, o tipo de liquidação e os identificadores necessários.

Acessar documentação da inserção de liquidações

3. Encerramento do Lote​

Após inserir todas as liquidações, encerre o lote para que o processamento interno seja iniciado. A conciliação de caixa e a atualização do portfólio de ativos serão realizadas automaticamente.

Acessar documentação do encerramento

4. Acompanhamento via Webhooks​

Acompanhe o progresso através dos webhooks:

Processamento automático

O procedimento de conciliação de caixa e a atualização do portfólio de ativos é feito de forma automática pela API após o encerramento do lote.