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