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 DTVM. 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, com o mesmo layout dos arquivos gerados em produção e dados fictícios. Todos descrevem o mesmo fundo (FUNDO EXEMPLO FIDC RESPONSABILIDADE LIMITADA) na mesma data de referência (2026-07-29). Os relatórios de posição — composições de carteira, cotas, caixa e XMLs ANBIMA — fecham entre si: patrimônio líquido, saldo de caixa e posição por classe de ativo são os mesmos em todos eles. O balancete e o razão contábil usam um conjunto próprio de lançamentos, só para ilustrar o layout.

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 é o nome-base de relatórios cadastrado para a classe de fundo, em minúsculas e sem acentos (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. Se você precisa de um prefixo diferente, fale com o time de integração. Entregas configuradas em inglês recebem o sufixo _EN antes da extensão.

Há quatro exceções ao padrão: o wallet_composition_by_composition é entregue como wallet_composition (sem o sufixo do modelo); o xml_5_by_composition segue o nome do padrão ANBIMA, FD{CNPJ do fundo, só dígitos}_{AAAAMMDD}.xml; 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 reference_date informada na rotina; quando a rotina não informa reference_date, é a data de geração do arquivo, no horário de Brasília. A Conciliação Consolidada aceita, opcionalmente, um intervalo (reference_date / end_date); o nome do arquivo leva a reference_date, o primeiro dia do intervalo.

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 DTVM pode configurar isso por fundo na entrega. Sem configuração específica, valem os padrões da tabela acima. As exceções são o quota_mec em CSV, que usa ; por definição do relatório, e o assignment_documents, que usa sempre , como delimitador e . como separador decimal.

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.

Os relatórios do momento de abertura têm como data de referência o dia útil anterior à data contábil que está sendo aberta — é essa data que aparece no nome do arquivo.

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 entregues no destino definido na configuração de cessão.

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 DTVM 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