Relatório de Balanço

Visão Geral

O relatório balance_report apresenta o balanço contábil consolidado do fundo entre duas datas de referência. Ele exibe, para cada conta do plano de contas, o saldo inicial (Data de Início), os movimentos de débito e crédito ocorridos no período e o saldo final (Data Final). O relatório organiza as contas em uma estrutura hierárquica (grupos e subgrupos) e inclui totalizadores para ativo, passivo, patrimônio líquido, receitas, despesas e compensações. Administradores e analistas utilizam este relatório para verificar a consistência contábil e auditar a evolução do balanço do fundo.

O que você precisa informar

Variável	Obrigatória	Descrição
fund_class_key	sim	Identificador da classe de fundo sobre a qual o relatório é gerado.
start_date	sim	Data de início do período, no formato AAAA-MM-DD.
end_date	sim	Data de fim do período, no formato AAAA-MM-DD. Precisa ser posterior à data de início.

É preciso haver contabilidade fechada nas duas datas

O relatório só é gerado se existir fechamento contábil na data de início e na data de fim. Sem isso a solicitação é recusada com a mensagem "Não existe contabil na data ...".

As duas datas têm de estar no mesmo exercício contábil

Além de existir fechamento nas duas datas, elas precisam pertencer ao mesmo exercício (mesmo ledger). Um período que atravessa o encerramento de exercício faz a geração falhar.

Estrutura do Arquivo

Atributo	Valor
Formato	XLSX
Nomenclatura	{nome_resumido_fundo}_balance_report_{YYYY-MM-DD}.xlsx

Conteúdo da Planilha

Cabeçalho do Fundo

Apresentado nas primeiras linhas da planilha:

Campo	Descrição
Nome do Fundo	Nome completo da classe de fundo.
CNPJ do Fundo	CNPJ da classe de fundo.
Data de Início	Data de início do período no formato YYYY-MM-DD.
Data Final	Data de fim do período no formato YYYY-MM-DD.
Total do Ativo	Soma do saldo final das contas de ativo.
Total do Passivo	Soma do saldo final das contas de passivo.
Total de PL	Saldo final das contas de patrimônio líquido.
Total de Receitas	Saldo final das contas de receita.
Total de Despesas	Saldo final das contas de despesa.
Total de Compensação Ativa	Saldo final das contas de compensação ativa (grupo 3).
Total de Compensação Passiva	Saldo final das contas de compensação passiva (grupo 9).
PL por Contas Patrimoniais	Total do Ativo - Total do Passivo
PL por Contas de Resultado	Total de PL + Total de Receitas + Total de Despesas
Bate Compensação	Total de Compensação Ativa - Total de Compensação Passiva

Os totais são fórmulas do Excel

As células do cabeçalho não são valores fixos: elas referenciam as linhas de total da tabela de contas (por exemplo, Total do Ativo é =G20). Ao abrir o arquivo, o Excel recalcula tudo — e, se você editar a tabela, os totais acompanham.

Tabela de Contas

Linhas organizadas hierarquicamente por número de conta, sem formatação especial — apenas a linha de cabeçalho da tabela vem em negrito:

Coluna	Tipo	Formato / Exemplo	Descrição
Número da Conta	string	"1.1.2.80.00.010.001-8"	Número da conta no plano de contas, com dígito verificador. As linhas de grupo trazem o número do nível correspondente — por exemplo 1-7 (ATIVO) e 1.1-6 (DISPONIBILIDADES).
Nome da Conta	string	"Conta Caixa - Banco Exemplo"	Nome descritivo da conta contábil.
Tipo da Conta	string (enum)	"A"	Tipo da linha: "A" para conta analítica; "S" para conta sintética (agrupadora, exibida em negrito).
Saldo em Término de {Data de Início}	número	40000.00	Saldo da conta na Data de Início, em reais. Negativo indica saldo de natureza contrária à conta.
Movimentos de Débito	número	5000.00	Soma dos lançamentos a débito no período (em reais). O sinal segue a natureza da conta: positivo nas contas devedoras, negativo nas credoras.
Movimentos de Crédito	número	0.00	Soma dos lançamentos a crédito no período (em reais). Sinal invertido em relação à coluna de débito: negativo nas contas devedoras, positivo nas credoras.
Saldo em Término de {Data Final}	número	45000.00	Saldo da conta na Data Final, em reais.