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. |
Os movimentos considerados são os de data contábil posterior à Data de Início e até a Data Final, inclusive. Os lançamentos da própria Data de Início já estão no saldo inicial.
O relatório só é gerado se existir fechamento contábil na data de início e na data de fim. Numa solicitação avulsa, sem isso a solicitação é recusada com a mensagem "Não existe contabil na data ...". Numa entrega por rotina essa checagem não acontece na solicitação: a geração falha e o relatório fica com status failed.
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 |
A data do nome é a reference_date da solicitação, e não a end_date. Se a solicitação não informar reference_date, vale a data da geração do arquivo, no horário de Brasília.
Conteúdo da Planilha
Cabeçalho do Fundo
Apresentado nas primeiras linhas da planilha, com o rótulo na coluna A e o valor na coluna B. Os rótulos abaixo são os textos literais da planilha, com os dois-pontos:
| 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 |
Em entregas configuradas em inglês, os rótulos, os cabeçalhos da tabela e os nomes das contas vêm traduzidos.
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. Além das contas e grupos do plano de contas, a tabela traz duas linhas de total: TOTAL DO ATIVO (3.9.9.99.99-3, soma dos grupos 1 e 3) e TOTAL DO PASSIVO (9.9.9.99.99-5, soma dos grupos 4, 6, 7, 8 e 9).
| 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). |
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. |