Razão Contábil

Visão Geral

O relatório accounting_ledger apresenta o razão contábil do fundo em um intervalo de datas. Para cada conta do plano de contas com movimentações no período, o relatório exibe uma linha de saldo inicial, todos os lançamentos individuais com data, contrapartida, valor e descrição, e uma linha de saldo final com totais de débito e crédito. Auditores, administradores e analistas utilizam este relatório para rastrear a origem de cada lançamento contábil e verificar a evolução dos saldos conta a conta.

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}_accounting_ledger_{YYYY-MM-DD}.xlsx

Conteúdo da Planilha

Cabeçalho do Fundo

Apresentado nas primeiras linhas da planilha:

Campo	Descrição
Fundo	Nome completo da classe de fundo.
CNPJ	CNPJ da classe de fundo.

O sinal do saldo aqui é diferente do Relatório de Balanço

Neste relatório o saldo é o valor cru do fechamento (crédito positivo, débito negativo). No Relatório de Balanço o mesmo saldo é normalizado pela natureza da conta. A mesma conta pode, portanto, aparecer como -45000.00 aqui e 45000.00 lá — são a mesma posição, em convenções de sinal diferentes.

Lançamentos por Conta

Para cada conta com movimentações no período, o relatório exibe:

1. Linha de saldo inicial (em negrito) — saldo da conta na Data de Início.
2. Linhas de lançamento — um registro por movimento contábil.
3. Linha de saldo final (em negrito) — saldo da conta na Data Final com totais de débito e crédito.

Coluna	Tipo	Formato / Exemplo	Descrição
Data	data	2026-07-15	Data contábil do lançamento. Nas linhas de saldo inicial e final, exibe a Data de Início e a Data Final respectivamente.
Conta	string	"1.2.1.10.00.001.001-9"	Número da conta no plano de contas, com dígito verificador.
Nome da Conta	string	"Direitos Creditórios sem Coobrigação"	Nome descritivo da conta contábil.
Tipo do Lançamento	string (enum)	"A"	Tipo do lançamento: "A" para automático; "M" para manual; "I" para linha de saldo inicial; "F" para linha de saldo final.
ContraPartida	string	"7.9.1.20.00.001.001-1"	Número da conta de contrapartida do lançamento. Vazio nas linhas de saldo inicial e final.
Débito	número	1500.00	Valor do lançamento a débito (em reais). Zero quando o lançamento é a crédito.
Crédito	número	0.00	Valor do lançamento a crédito (em reais). Zero quando o lançamento é a débito.
Saldo	número	-196500.00	Saldo acumulado da conta após o lançamento (em reais). Crédito soma e débito subtrai, sem normalização pela natureza da conta — por isso uma conta de ativo com saldo devedor aparece negativa aqui.
Descrição	string	"ACRUO DE ATIVOS - CCBs"	Descrição do evento contábil associado ao lançamento.