Composição de Carteira de Ativos
Visão Geral
O relatório assets_wallet_composition apresenta a posição completa de todos os ativos que compõem o estoque do fundo em uma determinada data de referência. Ele é gerado uma vez ao dia e consolida quatro categorias de ativos:
- operações de crédito (ex: CCB) — uma linha por parcela da operação;
- direitos creditórios descontados (ex: duplicatas, CT-e, contratos descontados) — uma linha por título;
- contratos (
contract,financing_contract,debt_acknowledgment) — uma linha por parcela do contrato; - títulos privados (ex: debêntures, notas comerciais) — uma linha por parcela do título.
Gestores e analistas utilizam este relatório para acompanhar o estoque, avaliar provisões para devedores duvidosos e monitorar a evolução da carteira.
Para operações de crédito parceladas, a mesma operação aparece em várias linhas — uma por parcela — repetindo os dados cadastrais (external_id, contract_number, purchase_value) e variando installment_number, face_value, maturity_date e installment_purchase_value.
Este relatório está descrito em linguagem de negócio no Manual de Relatórios QI Tech — revisão 3, outubro de 2026. O manual cobre quatro relatórios: este, a Composição de Ativos da Cessão, a Aquisição Consolidada e a Conciliação Consolidada de Direitos Creditórios.
Nesta seção do manual os nomes das colunas aparecem em maiúsculas. No arquivo entregue eles vêm sempre em minúsculas, conforme a tabela de colunas abaixo.
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 | Data de referência, no formato AAAA-MM-DD. |
Para os fundos que operam com relatório de cota de abertura, a posição entregue é a do dia anterior à data de referência informada.
Estrutura do Arquivo
| Atributo | Valor |
|---|---|
| Formato | CSV |
| Encoding | UTF-8 |
| Delimitador | , (vírgula) |
| Cabeçalho | Sim (primeira linha) |
| Nomenclatura | {nome_resumido_fundo}_assets_wallet_composition_{AAAA-MM-DD}.csv |
Os nomes das colunas são gerados em minúsculas. Datas são escritas no formato AAAA-MM-DD e valores decimais usam ponto como separador, com até 8 casas decimais.
Colunas
| Coluna | Tipo | Formato / Exemplo | Descrição |
|---|---|---|---|
fund_name | string | "FUNDO EXEMPLO FIDC RESPONSABILIDADE LIMITADA" | Nome da classe de fundo. |
fund_document | string | "11.222.333/0001-81" | CNPJ da classe de fundo. |
report_date | data | 2026-07-30 | Data em que o relatório foi gerado. Nas linhas de títulos privados, esta coluna traz a data de referência da carteira. |
originator_name | string | "ORIGINADOR EXEMPLO S.A." | Nome da empresa originadora da operação. Para títulos privados, o valor é -. |
originator_document | string | "22.222.222/0001-91" | CNPJ do originador. Para títulos privados, o valor é -. |
assignor_name | string | "CEDENTE EXEMPLO S.A." | Nome do cedente da operação. Para títulos privados, o valor é -. |
assignor_document | string | "33.333.333/0001-91" | CNPJ do cedente. Para títulos privados, o valor é -. |
borrower_name | string | "MARIA APARECIDA DE SOUZA" | Nome do devedor. Para direitos creditórios descontados, é o sacado; para títulos privados, é o emissor. Vazio para contratos. |
borrower_document | string | "969.698.790-03" | CPF ou CNPJ do devedor / sacado / emissor. |
external_id | string | "10a20b30-0001-4bbb-9222-000000000201" | Identificador externo do ativo, conforme informado na criação. |
contract_number | string | "0900112233/EXA" | Número do contrato ou número do pedido (order_number) associado à operação. |
asset_type | string (enum) | "ccb" | Tipo do ativo. Exemplos: ccb, duplicata_mercantil, duplicata_servicos, cte, discounted_contract, debenture. |
face_value | número | 1678.90 | Valor de face da parcela (ou do título) na data de referência, em reais. |
present_value | número | 1663.48 | Valor presente da parcela (ou do título) na data de referência, em reais. |
purchase_value | texto numérico | 4690.80 | Valor pelo qual o ativo foi adquirido pelo fundo, em reais. Repetido em todas as parcelas da mesma operação. |
bad_provision_value | número | 0.0 | Valor da provisão para devedores duvidosos (PDD) constituída sobre o ativo, em reais. |
bad_provision_range | string | "AA" | Faixa de classificação de risco da PDD — as usuais são AA, A, B, C, D, E, F, G e H, e ativos baixados podem trazer WO. Quando não há classificação, o relatório traz AA. |
fund_date | data | 2026-07-29 | Data de referência da carteira. |
maturity_date | data | 2026-08-28 | Data de vencimento da parcela (ou do título). |
business_maturity_date | data | 2026-08-28 | Data de vencimento ajustada para dia útil. Para títulos privados, repete o maturity_date. |
issue_date | texto de data | 2026-07-28 | Data de emissão do contrato. Para direitos creditórios descontados e contratos, corresponde à data de aquisição. |
purchase_date | texto de data | 2026-07-29 | Data de aquisição do ativo pelo fundo. |
total_duration | inteiro | 30 | Prazo total em dias corridos, da aquisição até o vencimento. |
present_duration | inteiro | 30 | Prazo remanescente em dias corridos, da data de referência até o vencimento. Fica negativo quando o ativo está vencido. |
asset_maturity_status | string (enum) | "on_time" | Situação do vencimento: OVERDUE quando vencido, on_time quando dentro do prazo. |
assignment_rate_of_return | número | 0.0312 | Taxa interna de retorno (TIR) da cessão. Vazio para títulos privados. |
purchase_rate_of_return | texto numérico | 0.031874210 | TIR corrente da operação no momento da aquisição. Para títulos privados, o valor é -. |
has_assignor_coobligation | string | "False" | Indica coobrigação do cedente: True ou False. Para títulos privados, o valor é -. |
installment_number | inteiro | 1 | Número da parcela. Para direitos creditórios descontados, é sempre 1. |
bad_debt_type | string | "default" | Tipo de classificação da PDD aplicada ao ativo. |
nominal_rate | número | 0.0231 | Taxa nominal mensal pré-fixada da operação. Vazio para direitos creditórios descontados e títulos privados. |
operation_type | string | "ccb" | Tipo da operação registrado no cadastro do ativo. Vazio para títulos privados. |
installment_purchase_value | texto numérico | 1598.74210000 | Valor pago pelo fundo pela parcela específica, em reais. Vazio para direitos creditórios descontados e títulos privados. |
asset_key | string | "1a2b3c40-0001-4aaa-9111-000000000101" | Chave interna do ativo gerada pela QI Tech (UUID). |
asset_external_id | string | "10a20b30-0001-4bbb-9222-000000000201" | Identificador externo do ativo. Em operações de crédito, external_id pode trazer o identificador da parcela; asset_external_id é sempre o do ativo. |
Quando a entrega é configurada com a opção benefit_number, o relatório traz uma coluna extra benefit_type ao final, com o tipo de benefício associado à garantia da operação. Com a opção original_face_value, traz também a coluna original_face_value (valor de face original da parcela; vazia para direitos creditórios descontados e títulos privados).