Composição da Carteira
Visão Geral
O relatório wallet_composition_by_composition é a foto consolidada da carteira do fundo ao fim do dia. Ele reúne, em uma única planilha, o patrimônio e a cota de cada série de emissão, a posição por classe de ativo (títulos públicos, emissões, operações de crédito, direitos creditórios descontados, cotas de fundo, swaps e imóveis), os valores a pagar e a receber, os saldos de caixa e a rentabilidade das séries — sempre com o percentual que cada linha representa do patrimônio líquido.
É o relatório usado por gestores e administradores para conferir o fechamento do dia: o somatório das seções de ativos, menos os valores a pagar e mais os valores a receber, reconcilia com o patrimônio líquido informado no cabeçalho.
O relatório é gerado a partir de uma composição de carteira já fechada — confirmada ou aguardando confirmação. Por padrão é usada a composição de cota de fechamento (final_quota); mediante configuração, também pode ser gerado sobre a composição de cota de abertura (opening_quota) ou pré-cota (pre_quota).
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. |
reference_date | sim, se não informar composition_key | Data de referência, no formato AAAA-MM-DD. |
composition_key | alternativa à data | Identificador de uma composição específica. |
composition_type | não | final_quota (padrão), opening_quota ou pre_quota. Qualquer outro valor é recusado. |
Se não houver composição do tipo pedido na data de referência, a solicitação é recusada com a mensagem "Não existe composition para esta 'reference_date'".
Estrutura do Arquivo
| Atributo | Valor |
|---|---|
| Formato | XLSX |
| Abas | Sheet (composição) e P&L (receitas e despesas do dia) |
| Nomenclatura | {nome_resumido_fundo}_wallet_composition_{AAAA-MM-DD}.xlsx |
O modelo a ser solicitado é wallet_composition_by_composition, mas o arquivo entregue é nomeado wallet_composition, sem o sufixo.
Cada seção é apresentada com um título em negrito, uma linha de cabeçalho e, ao final, linhas de total por tipo de ativo e um total geral da seção — essas linhas de total aparecem em negrito e com fundo cinza. Seções sem posição na data não são impressas: um fundo que não tem imóveis, por exemplo, não terá a seção IMÓVEIS.
Somando a coluna % do PL dos totais gerais de todas as seções — ativos, mais valores a receber, menos valores a pagar, mais caixa — o resultado é 100% do patrimônio líquido do cabeçalho.
Uma diferença pequena pode aparecer quando o fundo tem emissões com ágio ainda não diferido: na seção EMISSÕES o Valor D0 (R$) é apurado pelo valor contábil do papel, enquanto nas demais classes ele considera o valor justo. O ágio a diferir, nesse caso, fica fora da soma das seções, mas está dentro do patrimônio líquido.
Aba Sheet
Cabeçalho do fundo
| Campo | Descrição |
|---|---|
| Data de referência | Data da composição, no formato AAAA-MM-DD. |
| Nome da classe de fundo | Nome completo da classe de fundo. |
| CNPJ da classe de fundo | CNPJ da classe de fundo. |
| Nome da gestora | Nome da gestora do fundo. |
| CNPJ da gestora | CNPJ da gestora do fundo. |
| Patrimônio bruto (R$) | Soma do patrimônio bruto de todas as séries de emissão. |
| Patrimônio líquido (R$) | Soma do patrimônio líquido de todas as séries de emissão. É o denominador da coluna % do PL em todas as seções. |
| Número de cotas | Soma das cotas de todas as séries de emissão. |
SÉRIES DE EMISSÃO
| Coluna | Descrição |
|---|---|
| Nome | Nome da série de emissão. |
| Patrimônio bruto (R$) | Patrimônio bruto da série, antes da provisão de taxa de performance. |
| Cota bruta (R$) | Valor da cota bruta da série. |
| Patrimônio líquido (R$) | Patrimônio líquido da série. |
| Cota líquida (R$) | Valor da cota líquida da série. |
| Número de cotas | Quantidade de cotas da série. |
TÍTULOS PÚBLICOS
Uma linha por título público em estoque (LFT, LTN, NTN-B e suas versões compromissadas).
| Coluna | Descrição |
|---|---|
| Data de referência | Data da composição. |
| Identificador / Código SELIC | Código SELIC do título. |
| Tipo do ativo | LFT, LTN, NTN-B, LFT COMPROMISSADA, etc. |
| Emissor | Tesouro Nacional. |
| Tipo de amortização | No vencimento ou Juros semestrais. |
| Data de emissão / Data de compra / Data de vencimento | Datas do título e da aquisição. |
| Unidades compradas / Unidades atuais | Quantidade de títulos adquirida e em estoque. |
| PU de compra (R$) / PU D0 (R$) | Preço unitário de aquisição e preço unitário na data de referência. |
| Valor de compra (R$) / Valor D0 (R$) | Valor financeiro de aquisição e valor na data de referência. |
| % de Tesouros | Participação do título no total de títulos públicos. |
| % do PL | Participação do título no patrimônio líquido do fundo. |
EMISSÕES
Uma linha por título privado ofertado (debênture, CRI, CRA, CDB, letra financeira). Notas comerciais são apresentadas em seção própria, com colunas equivalentes, em ordem própria.
| Coluna | Descrição |
|---|---|
| Data de referência | Data da composição. |
| Identificador | Código externo do papel. |
| Tipo do ativo | DEBENTURE, CRI, CRA, CDB, Letra Financeira, NOTA COMERCIAL. |
| Código ISIN / Código B3 | Códigos de identificação do papel. |
| Emissor | Nome do emissor. |
| Data de emissão / Data de compra / Data de vencimento | Datas do papel e da aquisição. |
| Unidades compradas / Unidades atuais | Quantidade adquirida e em estoque. |
| PU de compra (R$) / PU do ativo (R$) / PU D0 (R$) | Preço unitário de aquisição, preço unitário contábil e preço unitário líquido de PDD. |
| Valor de compra (R$) / Valor do ativo (R$) / Valor D0 (R$) | Valor de aquisição, valor contábil e valor líquido de PDD. |
| PDD (R$) / PDD (%) | Provisão para devedores duvidosos, em reais (negativa) e em percentual. |
| Valor vencido (R$) / Valor não vencido (R$) | Parcela vencida e não vencida do valor contábil. |
| % de Emissões | Participação do papel no total de emissões. |
| % do PL | Participação do papel no patrimônio líquido do fundo. |
OPERAÇÕES DE CRÉDITO
Operações de crédito (CCB, CCE, NCE e suas versões estruturadas). Para os tipos consolidados — CCB, CCE, NCE — a carteira é apresentada em uma única linha por tipo, identificada como CCB CONSOLIDADO, e não operação a operação; o detalhamento ativo a ativo está no relatório Composição de Carteira de Ativos.
| Coluna | Descrição |
|---|---|
| Data de referência | Data da composição. |
| Identificador | Número do contrato da operação ou {TIPO} CONSOLIDADO nas linhas consolidadas. |
| Tipo do ativo | CCB, CCB ESTRUTURADA, CCE, NCE ESTRUTURADA, etc. |
| Código IF | Código do papel na B3, quando registrado. |
| Data de emissão / Data de compra / Data de vencimento | Datas do contrato e da aquisição. Vazias nas linhas consolidadas. |
| Unidades atuais | Quantidade de operações em estoque. |
| PU de compra (R$) / PU em acruo (R$) / PU D0 (R$) | Preços unitários. Vazios nas linhas consolidadas. |
| Valor D0 (R$) | Valor da posição líquido de PDD. |
| PDD (R$) / PDD (%) | Provisão para devedores duvidosos. |
| Valor do ativo (R$) | Valor contábil da posição. |
| Valor vencido (R$) / Valor em acruo (R$) | Parcela vencida e parcela em acruo do valor contábil. |
| Ágio restante (R$) | Ágio ainda não diferido (valor justo menos valor contábil). |
| Juros pós-vencimento (R$) / Juros de mora (R$) / Multa por atraso (R$) | Encargos por atraso. Estas três colunas só aparecem quando há algum encargo de atraso na carteira de CCB. |
| % de Operações de Crédito | Participação da linha no total de operações de crédito. |
| % do PL | Participação da linha no patrimônio líquido do fundo. |
DC DESCONTADOS
Direitos creditórios descontados (duplicatas mercantis e de serviços, CT-e, contratos descontados). Sempre apresentados de forma consolidada, uma linha por tipo.
| Coluna | Descrição |
|---|---|
| Data de referência | Data da composição. |
| Identificador | {TIPO} CONSOLIDADO. |
| Tipo do ativo | DUPLICATA MERCANTIL, DUPLICATA SERVIÇOS, CTE, CONTRATO. |
| Valor D0 (R$) | Valor da posição líquido de PDD. |
| Valor do ativo (R$) | Valor contábil da posição. |
| Valor vencido (R$) / Valor em acruo (R$) | Parcela vencida e parcela em acruo do valor contábil. |
| PDD (R$) | Provisão para devedores duvidosos (negativa). |
| % de Direitos Creditórios Descontados | Participação da linha no total de direitos creditórios descontados. |
| % do PL | Participação da linha no patrimônio líquido do fundo. |
COTAS DE FUNDOS
| Coluna | Descrição |
|---|---|
| Data de referência | Data da composição. |
| Tipo do ativo | FIDC, RENDA FIXA, MULTIMERCADO, FIA, FIP, FII. |
| Nome do Fundo / Documento do Fundo | Nome e CNPJ do fundo investido. |
| Senioridade | SÊNIOR, MEZANINO ou SUBORDINADA. |
| Código Interno | Código interno da classe investida. |
| Data de compra | Sempre vazia nesta seção. |
| Valor de compra (R$) / Unidades compradas / PU de compra (R$) | Dados da aquisição. |
| Unidades atuais / Valor D0 (R$) / PU D0 (R$) | Posição na data de referência. |
| % de Cotas | Participação da linha no total de cotas de fundos. |
| % do PL | Participação da linha no patrimônio líquido do fundo. |
SWAP e IMÓVEIS
Apresentadas apenas para fundos que possuem esses ativos. SWAP traz contraparte, valores nominais e valores atualizados de ativo e passivo; IMÓVEIS traz número de matrícula, valor e data de avaliação e a próxima avaliação prevista.
VALORES A PAGAR
| Coluna | Descrição |
|---|---|
| Data de referência | Data da composição. |
| Tipo de a pagar | Descrição da despesa (ex: TAXA DE ADMINISTRAÇÃO). |
| Total provisionado | Valor total provisionado da despesa. |
| Valor reconhecido | Valor já reconhecido no resultado, apresentado como negativo. |
| Valor restante | Diferença entre o total provisionado e o valor reconhecido. |
| Inicio da provisão / Fim da provisão / Data do pagamento | Datas da provisão e do pagamento previsto. |
| % do PL | Participação do valor reconhecido no patrimônio líquido (negativa). |
VALORES A RECEBER
Mesma estrutura da seção anterior, com as colunas Total a diferir, Valor diferido, Valor restante, Inicio do diferimento e Fim do diferimento.
CONTAS CAIXA
| Coluna | Descrição |
|---|---|
| Data de referência | Data da composição. |
| Nome da conta | Instituição financeira e identificação contábil da conta. |
| Dados da conta | Agência e conta no formato Ag.: {agência} | Cc.: {conta}-{dígito}. |
| Entrada a conciliar / Saída a conciliar | Valores creditados ou debitados ainda não conciliados. |
| Saldo | Saldo da conta na data de referência. |
| % do PL | Participação do saldo no patrimônio líquido do fundo. |
RENTABILIDADE
Um bloco por série de emissão, com uma linha por janela de apuração.
| Coluna | Descrição |
|---|---|
| Tipo | Diária, Mensal, Anual ou D-N (janela de N dias corridos). |
| Data de Referência | Data inicial da janela de apuração. |
| Cota de Referência | Valor da cota na data inicial da janela. |
| Cota Benchmark | Valor da cota do benchmark (DI) na data inicial da janela. |
| Cota Atual | Valor da cota líquida na data da composição. |
| Rendimento Total | Rentabilidade da cota na janela, em percentual. |
| Rendimento (%CDI) | Rentabilidade como percentual do CDI. - quando não há benchmark na janela. |
| Rendimento (CDI+) | Rentabilidade expressa como CDI mais spread anualizado (252 dias úteis). - quando o resultado é negativo ou não há benchmark. |
Aba P&L
Compara os saldos das contas de resultado (grupos contábeis 07 — receitas — e 08 — despesas) entre o dia útil anterior e a data de referência.
RESUMIDO
| Coluna | Descrição |
|---|---|
| Data de Referência | Data da composição. |
| Tipo | Receitas, Despesas ou Resultado. A classificação usa o sinal do saldo final de cada conta, não o grupo do plano de contas: uma conta de receita com saldo negativo entra em Despesas. |
| Valor (R$) | Variação do dia. Resultado é a soma de receitas e despesas. |
DETALHES
| Coluna | Descrição |
|---|---|
| Nome da Conta | Nome da conta contábil de resultado. |
| Data Inicial / Valor Inicial (R$) | Dia útil anterior e saldo da conta nessa data. |
| Data Final / Valor Final (R$) | Data de referência e saldo da conta nessa data. |
| Resultado (R$) | Variação do saldo no dia. |
| Variação (%) | Variação percentual em relação ao saldo inicial. |
Somente contas com variação no dia aparecem na seção.