Relatórios DTVM

Os relatórios DTVM fornecem uma visão detalhada das operações e posições financeiras dos fundos de investimento administrados pela QI CTVM. Eles são destinados a gestores e analistas que precisam acompanhar a composição da carteira, as aquisições e liquidações de ativos, e a movimentação de caixa do fundo em cada data de referência.

Exemplos de relatórios

Baixe exemplos de todos os relatórios disponíveis: example_reports.zip

O pacote contém um arquivo de cada relatório, gerado pelo mesmo código que produz os arquivos em produção, com dados fictícios. Os exemplos são consistentes entre si: descrevem o mesmo fundo (FUNDO EXEMPLO FIDC RESPONSABILIDADE LIMITADA), na mesma data de referência (2026-07-29), e fecham entre si — o patrimônio líquido, o saldo de caixa e a posição por classe de ativo são os mesmos em todos os arquivos que trazem esses números.

Nomenclatura dos arquivos

Todos os arquivos seguem o padrão {nome_resumido_fundo}_{modelo}_{data_de_referência}.{extensão}, onde:

• nome resumido do fundo é derivado do nome curto cadastrado para a classe de fundo, em minúsculas, sem acentos e com espaços convertidos em _ (nos exemplos, example_name);
• modelo é o nome do relatório, conforme a coluna "Modelo" da tabela abaixo;
• data de referência está no formato AAAA-MM-DD.

O prefixo vem do cadastro da classe, não da configuração da entrega, e não muda depois. Se você precisa de um prefixo diferente, fale com o time de integração.

Há três exceções ao padrão: o wallet_composition_by_composition é entregue como wallet_composition (sem o sufixo do modelo); o assignment_assets_wallet_composition acrescenta o identificador da cessão ao final do nome; e o assignment_documents coloca o identificador da cessão antes da data, que nele é a data de geração do arquivo.

Relatórios de período

quota_mec, balance_report e accounting_ledger são gerados a partir de um intervalo (start_date / end_date), e não de uma única data. Nesses casos, a data no nome do arquivo é a data de referência da entrega.

Convenções dos arquivos CSV

Valem para todos os relatórios em CSV:

Atributo	Padrão
Encoding	UTF-8, sem BOM
Delimitador	, (vírgula)
Separador decimal	. (ponto)
Fim de linha	CRLF (\r\n)
Cabeçalho	sempre presente, na primeira linha, com os nomes das colunas em minúsculas

Delimitador e separador decimal são configuráveis

Se o seu processo exigir ; como delimitador ou , como separador decimal, a QI CTVM pode configurar isso por fundo na entrega. Sem configuração específica, valem os padrões da tabela acima. A exceção é o quota_mec em CSV, que usa ; por definição do relatório.

Como os relatórios são entregues

A entrega é organizada em rotinas, configuradas por fundo. Cada rotina define três coisas: quais relatórios entram, com qual periodicidade, e para qual destino.

Elemento	Opções
Periodicidade	diária · semanal (primeiro dia útil da semana) · mensal (último dia útil do mês)
Destino	SFTP · e-mail

Um mesmo fundo pode ter mais de uma rotina — por exemplo, uma diária em SFTP e uma mensal por e-mail. Para incluir ou remover um relatório, mudar a periodicidade ou o destino, entre em contato com o time de integração.

Quando a rotina é disparada

O gatilho é o fechamento do dia daquele fundo, e não um horário fixo. O fechamento acontece somente em dia útil, e dispara os relatórios em três momentos distintos:

Momento	Contém
Pré-cota	Relatórios apurados antes do cálculo da cota do dia.
Fechamento	Relatórios da posição consolidada do dia, com a cota de fechamento.
Abertura	Relatórios apurados sobre a cota de abertura.

Cada relatório é entregue no momento previsto na configuração da rotina do fundo — é por isso que os arquivos de um mesmo dia não chegam todos juntos. Uma rotina semanal ou mensal só materializa arquivos na data em que a periodicidade dela cai; nos outros dias o fechamento roda e ela não produz nada.

Relatórios fora da rotina

Dois relatórios não seguem a periodicidade da rotina, porque não são do dia do fundo e sim de uma operação: a Composição de Ativos da Cessão e os Lastros da Cessão. Os dois são gerados quando a cessão entra na etapa de aprovação, desde que estejam habilitados na configuração de cessão, e são gravados na mesma pasta de SFTP do fundo.

Eles não emitem o Webhook de Entrega — o acompanhamento é pelo webhook de status do lote de cessão.

Entrega via SFTP

Cada arquivo é gravado na pasta configurada para o fundo, com exatamente o nome descrito acima. Para instruções de conexão, credenciais e exemplos de código para download, consulte a documentação de integração SFTP.

Você pode ser avisado a cada entrega concluída

Em vez de varrer a pasta em intervalos fixos, configure o Webhook de Entrega: ao fim de cada entrega, a QI CTVM notifica a sua aplicação com a lista de arquivos gravados e o status de cada relatório.

Relatórios disponíveis

Relatório	Descrição	Modelo	Formato do arquivo
Composição de Carteira de Ativos	Posição completa de todos os ativos que compõem o estoque do fundo em uma data de referência, ativo a ativo.	assets_wallet_composition	CSV
Composição de Ativos da Cessão	Ativos de uma cessão específica, no mesmo formato da composição de carteira. Gerado por cessão, fora da rotina diária.	assignment_assets_wallet_composition	CSV
Lastros da Cessão	Documentos comprobatórios dos ativos de uma cessão, com link de download por arquivo. Gerado por cessão, fora da rotina diária.	assignment_documents	CSV
Composição da Carteira	Carteira consolidada do fundo ao fim do dia, por classe de ativo, com séries de emissão, valores a pagar e a receber, caixa, rentabilidade e resultado.	wallet_composition_by_composition	XLSX
Aquisição Consolidada de Direitos Creditórios	Direitos creditórios adquiridos em um dia — operações de crédito por parcela e direitos creditórios descontados por ativo, no mesmo arquivo.	consolidated_credit_rights_acquisition_assets	CSV
Conciliação Consolidada de Direitos Creditórios	Eventos de pagamento dos direitos creditórios em uma data contábil, com o efeito de cada pagamento sobre o valor do ativo.	consolidated_credit_rights_conciliation_assets	CSV
Demonstrativo de Caixa	Extrato diário das movimentações e saldos das contas bancárias do fundo.	cash_account_demonstrative	XLSX
Movimentações de Caixa	Mesma movimentação do demonstrativo de caixa em formato tabular, transação a transação, para conciliação automatizada.	cash_account_demonstrative_movements	CSV
Cotas MEC	Evolução diária de cotas, patrimônio e rentabilidade das séries de emissão.	quota_mec	XLSX ou CSV
Relatório de Balanço	Balanço contábil consolidado do fundo com saldos e movimentações por conta.	balance_report	XLSX
Razão Contábil	Razão contábil detalhado com todos os lançamentos por conta no período.	accounting_ledger	XLSX
XML ANBIMA (tipos 5 e 401)	Arquivos de posição no padrão ANBIMA, gerados a partir da composição da carteira.	xml_5_by_composition xml_401_by_composition	XML