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, os lançamentos do período 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.

Os lançamentos listados 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.

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

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

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:

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

Em entregas configuradas em inglês, os rótulos, os cabeçalhos da tabela, os nomes das contas e as descrições vêm traduzidos.

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 — lançamentos de mesma data, contrapartida, descrição, tipo e lado (débito ou crédito) vêm somados em uma única linha.
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	string	"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.