--- id: financeiros/carteira-do-fundo industria: Serviços financeiros uso: comum esforco: alto grao: Contrato x data de fechamento (fita); título x data de referência (estoque); conta contábil x data (balancete); série de cota x data --- # Carteira do fundo Uma fita da carteira por contrato em cada data de fechamento, com saldo, status, provisão, receita diferida e cotas do fundo, que bate com o administrador e serve para reportar, auditar e vender carteira. ## Resumo executivo **Para quem:** Gestores de FIDC, securitizadoras, fintechs de crédito e plataformas de funding que fecham a carteira todo mês e reportam a investidores. **O que resolve** - Saldo, status e provisão de cada contrato na data de fechamento batem com o administrador e não mudam depois de reportados. - Balanço, DRE e cotas do fundo saem dos arquivos do administrador, sem planilha montada à mão. - A base para vender ou ceder carteira fica pronta, com os dados pessoais isolados. **Por que importa:** A carteira é o ativo do fundo: dela saem a cota, a provisão, a receita e o preço numa venda. Quando a fita é recalculada por cima, um contrato vendido volta para a carteira ou uma baixa para perda some, e o número enviado ao investidor deixa de bater com o do auditor. Montar balanço e cotas a partir dos arquivos do administrador transforma a Nekt no razão analítico do fundo. **Perguntas de negócio que responde** - Qual o saldo de principal e juros da carteira no fechamento de setembro? - Quanto da carteira está em atraso, baixada para perda ou vendida neste fechamento? - Quanto de tarifa de originação ainda está diferida? - Qual o patrimônio líquido e a cota sênior e subordinada do fundo no mês? - O que mudou na carteira entre este fechamento e o anterior, e por quê? - Quais contratos entram na base de venda desta carteira? **O que você precisa** - A fonte dos contratos ou títulos conectada na Nekt: core, servicer ou sistema de recebíveis - Os arquivos do administrador fiduciário chegando por SFTP ou pasta compartilhada - A data de corte do fechamento e a política de status, provisão e baixa para perda **O que você recebe** - Uma fita por contrato e data de fechamento, que só cresce - Balancete, razão, balanço patrimonial, DRE e cotas por fundo e data - Uma checagem mês contra mês que bloqueia o fechamento fora do esperado - Um agente de IA que responde sobre a carteira com o status e a data certos ## Detalhado ### O problema O core mostra o contrato como ele está hoje: o vendido some, o baixado para perda aparece com saldo zero e a tarifa de originação já aparece inteira como receita. O administrador entrega balancete, razão e composição da carteira em arquivos que se repetem e mudam de cabeçalho. Quem monta o fechamento com a foto de hoje e soma os arquivos sem deduplicar reescreve o passado, conta lançamento duas vezes e chega a uma cota que não bate com a do administrador. ### Regras de negócio 1. **A fita é uma foto por data de fechamento.** Grave uma linha por contrato em cada data de fechamento, com saldos, status, dias de atraso, provisão e receita diferida. A tabela só cresce: cada execução acrescenta as datas de fechamento posteriores à última gravada e nunca reescreve uma data já fechada. Reprocessar o mês corrente é permitido até o fechamento; depois, ajuste entra no fechamento seguinte. (Evite: Recalcular todos os fechamentos a partir da foto atual do core.) 2. **Status exclusivo, em ordem de prioridade.** Cada contrato tem um único status na data: vendido ou cedido (só a partir da data da venda), em recuperação judicial ou falência, baixado para perda, quitado e em carteira. Contrato liberado depois da data de corte fica fora daquele fechamento. O status decide o saldo: em carteira leva o saldo devedor; baixado para perda tem saldo zero e o valor vai para a baixa acumulada; recuperação judicial mantém o saldo enquanto o pedido corre e vira perda quando é aprovado ou encerrado; vendido sai da carteira e da provisão. (Evite: Marcar como vendido, em todos os fechamentos, o contrato que foi vendido hoje.) 3. **Baixa para perda não volta.** O core pode zerar o valor baixado depois de uma renegociação ou de uma migração. Na fita, a baixa acumulada do contrato é o maior valor entre o que o core informa e o da fita anterior. Recuperação depois da baixa entra numa coluna própria, sem reduzir a baixa. (Evite: Ler a baixa para perda do core a cada fechamento.) 4. **Métrica ausente herda o último fechamento, marcada.** Quando o core não manda uma métrica de um contrato numa data (juros pagos, tarifa, saldo não pago), use o último valor não nulo de um fechamento anterior e guarde a data de onde ele veio. Assim um arquivo incompleto não zera o contrato, e a origem do número fica rastreável. (Evite: Preencher com zero o que veio nulo.) 5. **Tarifa de originação é receita diferida.** A tarifa cobrada na originação é apropriada ao longo do contrato. Receita diferida = tarifa recebida menos a parte já apropriada, pela proporção paga ou pelo prazo decorrido, conforme a política. Contrato vendido ou baixado para perda reconhece ou estorna o saldo diferido no fechamento do evento. (Evite: Reconhecer a tarifa inteira no mês da originação.) 6. **O estoque do administrador é a fonte quando existe.** O arquivo de estoque traz, por título e data de referência, valor nominal, valor presente, valor de aquisição, faixa e valor de PDD, data de aquisição pelo fundo e vencimento ajustado. Use os valores prontos e a última data de referência para a posição. Títulos nas faixas de write-off ficam fora do estoque ativo e entram na perda. (Evite: Recalcular a PDD e o valor presente que o administrador já entregou.) 7. **Fundo, securitizadora e veículos separados.** Um mesmo sistema costuma guardar o fundo e outras empresas do grupo, como a securitizadora, com um código de empresa. Toda resposta declara se é do fundo, de outro veículo ou consolidada. Cessão entre veículos dentro do escopo não muda o saldo do ativo; cessão para fora do escopo sai da carteira na data da cessão. (Evite: Somar fundo e securitizadora sem dizer.) 8. **Contabilidade do fundo pelo arquivo certo.** Balanço patrimonial sai do balancete do administrador. DRE sai do razão contábil, só com lançamentos efetivos (tipos A e M); linhas de saldo inicial (I) e de fechamento ou totalizador (F) não entram. O razão vem em arquivos acumulados que repetem o período: deduplique pelo hash do lançamento, sem o nome do arquivo, ficando com o arquivo mais recente. A última data de cada mês é o fechamento; o mês corrente é posição atual. (Evite: Montar a DRE pelo balancete ou somar todos os arquivos do razão.) 9. **PL e cotas na mesma data.** O PL econômico é o PL contábil mais o resultado ainda não incorporado, igual a ativo menos passivo. Cotas sênior e subordinada vêm da composição da carteira da mesma data, ou da última anterior dentro da mesma competência, nunca de uma data futura. A diferença entre o PL e a soma das séries fica numa linha de ajuste não alocado, visível. (Evite: Usar a composição de carteira mais recente para qualquer data.) 10. **Checagem mês contra mês antes de publicar.** Compare cada métrica com o fechamento anterior e bloqueie o fechamento quando a variação passar do limite: por exemplo, 10% na quantidade de contratos, 15% no saldo de principal, 20% em juros e receita diferida, 25% na provisão, 30% na baixa para perda e 40% na recuperação. Primeiro fechamento e métrica sem histórico ficam como aviso, não como aprovação. (Evite: Publicar o fechamento porque o pipeline rodou sem erro.) ### Como cada contrato entra na fita Status na data de fechamento, em ordem de prioridade. - **data da venda ou cessão <= data de fechamento** → Vendido ou cedido (`fora da carteira e da provisão`) - **pedido em andamento; aprovado ou encerrado vira perda** → Recuperação judicial ou falência (`saldo mantido, provisão por fator fixo`) - **baixado para perda no core ou faixa de write-off** → Baixado para perda (`saldo 0, baixa acumulada`) - **saldo quitado até a data** → Quitado (`saldo 0`) - **ativo, liberado até a data de corte** → Em carteira (`saldo devedor, dias de atraso, provisão`) - **liberado depois da data de corte** → Fora deste fechamento ### Definições | Métrica | Definição | |---|---| | Saldo de principal | principal não pago dos contratos em carteira na data de fechamento; zero para vendido, quitado e baixado | | Saldo devedor | principal mais juros e encargos não pagos dos contratos em carteira, na data de fechamento | | Baixa para perda acumulada | maior valor entre a baixa informada pelo core e a da fita anterior, por contrato | | Provisão | saldo devedor vezes os fatores da política (por faixa de atraso, por faixa de saldo e por convênio ou empregador, multiplicados); recuperação judicial com fator fixo; ou o valor de PDD do estoque do administrador quando ele existe | | Receita diferida de originação | tarifa de originação recebida menos a parte apropriada até a data de fechamento, por contrato | | Valor presente do estoque | soma do valor presente informado pelo administrador por título, na última data de referência, sem as faixas de write-off | | PL econômico | contas de patrimônio líquido mais o saldo das contas de resultado do período, igual a ativo menos passivo, por fundo e data | | Índice de subordinação | PL das cotas subordinadas / PL econômico do fundo, na mesma data | ### Armadilhas - **Arquivo errado na mesma pasta.** Dois arquivos do administrador com nomes parecidos (composição da carteira e composição de ativos) foram lidos juntos e misturaram cotas com títulos. Como evitar: Filtre os arquivos por padrão de nome exato e falhe quando um arquivo válido não puder ser lido. - **Razão em dobro.** Os relatórios de razão acumulados repetiam todo o período a cada dia, e o hash com o nome do arquivo deixava passar o mesmo lançamento várias vezes. Como evitar: Hash do lançamento sem o arquivo de origem, mantendo o mais recente. - **Ajuste escondido no código.** Dias de atraso de alguns contratos estavam fixados direto na consulta, por id, e ninguém sabia mais o motivo. Como evitar: Uma tabela de exceções por contrato, com motivo, autor e data. - **Baixa que some.** Depois de uma renegociação, o core zerou o valor baixado para perda e a perda do mês passado desapareceu do fechamento seguinte. Como evitar: Baixa acumulada pelo maior valor entre o atual e o anterior. - **Renomear quebra quem consome.** Tabelas promovidas de homologação para produção com outro nome deixaram relatórios e o agente lendo tabelas paradas. Como evitar: Nome de saída estável e versão em coluna, não no nome. - **Dado pessoal na base de venda.** A base para o comprador da carteira juntava contato, emprego e situação de falência dos devedores na camada aberta. Como evitar: Gere a base de venda numa camada restrita e entregue só os campos do contrato de cessão. ### Teste de aceitação - [ ] Para cada data de fechamento, o saldo de principal da fita bate com o relatório do core ou do administrador (diferença abaixo de 0,5%). - [ ] Cada contrato tem exatamente um status por data de fechamento, e nenhum vendido aparece com saldo ou provisão a partir da data da venda. - [ ] Rodar o pipeline de novo não altera nenhuma linha de uma data de fechamento já gravada. - [ ] Ativo menos passivo do balanço é igual ao PL econômico, e cotas sênior mais subordinadas mais ajuste não alocado é igual ao PL, por fundo e data. - [ ] Nenhum lançamento do razão aparece duas vezes na DRE, e a DRE não tem linhas de saldo inicial nem de fechamento. ### Context document ```text Carteira do fundo - Fita: uma linha por contrato e data de fechamento em . Data de fechamento fechada nunca é recalculada. Sempre filtre a data de fechamento. - Status por prioridade: vendido ou cedido (a partir da data da venda), recuperação judicial ou falência, baixado para perda, quitado, em carteira. Liberado depois da data de corte fica fora do fechamento. - Saldo: em carteira = saldo devedor; baixado = 0 com baixa acumulada; vendido = fora da carteira e da provisão. - Baixa acumulada = maior entre o valor do core e o da fita anterior. Recuperação em coluna própria. - Receita diferida de originação = tarifa recebida - parte apropriada até a data. - Estoque do administrador em : use valor nominal, valor presente, faixa e PDD prontos, da última data de referência. Faixas são write-off e ficam fora do estoque ativo. - Empresa: = fundo, = securitizadora. Se a pergunta não disser qual, pergunte se quer separado, uma delas ou consolidado. - Balanço pelo balancete; DRE pelo razão com lançamentos A e M, sem I e F. Último dia do mês = fechamento. - PL econômico = ativo - passivo. Cotas sênior e subordinada da composição da carteira da mesma data. - Nunca exponha dados pessoais de devedores. A base de venda fica em . Exceções por cliente: - : contratos vendidos antes de não têm data de venda; tratar como vendidos a partir de . - : fator de provisão diferente para o empregador ou convênio . ``` ### Variações - **Venda ou cessão de carteira:** Base do último fechamento com os campos combinados com o comprador, gerada numa camada restrita e conferida contra a fita. - **FIDC de recebíveis comerciais:** Estoque por título com cedente, sacado e rótulo de cobrança, exposição por cedente e PDD do administrador. - **Funding imobiliário:** Saldo de capital aplicado por empreendimento, aportes menos recompras realizados, conciliado entre o controle do financeiro e a base operacional.