Skip to content

Calculadora de FPR (Fator de Ponderação de Risco) - Res. BCB 229/2022. Calcula RWACPAD para risco de crédito com suporte completo a todas classes de ativos.

Notifications You must be signed in to change notification settings

andrecamatta/calculadora-fpr

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

43 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Calculadora FPR - Res. BCB 229/2022

Calculadora de Fator de Ponderação de Risco (FPR) conforme Resolução BCB 229/2022, Circular BCB 3.809/2016 e atualizações regulatórias 2024-2025.

📚 Guia Completo de FPRs - Explicações detalhadas de cada valor de FPR (0,20 a 1,50) e situações práticas

Destaques da Implementação

Implementação completa da abordagem padronizada (Standardised Approach) para risco de crédito ✅ Todos os FPRs regulatórios implementados (0% a 1.250%) ✅ Todas as classes de ativos e contrapartes (10 categorias principais) ✅ EAD completo com CCF diferenciados ✅ CRM completo (haircuts, garantias, substituição) ✅ Atualizações 2024-2025 incorporadas ✅ 30+ cenários de teste validados ✅ Trilha de decisão completa e transparente

Funcionalidades

Implementado ✅

  • FPR por classe de ativo/contraparte

    • ✅ Soberanos (BR, estrangeiro)
    • ✅ Entes Subnacionais / Estatais (Estados, Municípios, DF, PSP, Estatais - FPR fixo 100%)
    • ✅ Instituições Financeiras (categorias A/B/C)
    • ✅ Corporate (grande baixo risco com validação receita/rating, PME com validação R$ 300MM, project finance)
    • ✅ Varejo PF (elegível R$ 5MM, transactor, consignado >5 anos)
    • ✅ Crédito Imobiliário (residencial/não residencial, LTV, obra em andamento por ano)
    • ✅ Derivativos (CCR)
    • ✅ Fundos (look-through e mandato: equity/renda fixa/misto)
    • ✅ Outras Exposições (caixa, ouro, ações listadas/não listadas, ativos fixos)
    • ✅ Ativos em Inadimplência (por nível de provisão: <20%, 20-50%, ≥50%)
  • EAD (Exposure at Default)

    • Cálculo: EAD = Saldo + (CCF × Limite)
    • Fatores de Conversão de Crédito (CCF) diferenciados
    • Linhas revogáveis/irrevogáveis
    • Garantias prestadas
    • Comércio exterior
  • Haircuts e CRM

    • Abordagem abrangente (Comprehensive Approach)
    • Haircut de colateral (Hc)
    • Haircut cambial (Hfx - 8%)
    • Haircut de exposição (He)
    • Substituição por garantidor
    • Seguro de crédito (Res. BCB 324/2023)
  • Ajustes e Pisos

    • Descasamento cambial (varejo/residencial: 1,5x, máx 150%)
    • Piso caixa fora da posse (20%)
    • Sanitização (0% - 1250%)
  • Atualizações 2024-2025

    • ✅ Limite varejo aumentado para R$ 5MM (antes R$ 3MM)
    • ✅ Consignado > 5 anos (FPR 150% vs 300% anterior)
    • ✅ Obra em andamento: contratos ≤2023 (FPR 50%), contratos 2024+ (FPR 150%)
    • ✅ Ajuste negativo em PL (Res. 452/2025 - FPR 100%)
    • ✅ Validações PME (receita ≤ R$ 300MM)
    • ✅ Validações grande baixo risco (receita ≥ R$ 15bi + rating ≥ BB-)

Calculado Automaticamente

  • RWACPAD = EAD × FPR
  • Trilha de decisão completa com todos os passos

Arquitetura

Princípios Aplicados

SOLID

  • Single Responsibility: cada módulo tem uma responsabilidade
  • Open/Closed: extensível via estratégias
  • Liskov Substitution: interfaces consistentes
  • Interface Segregation: interfaces específicas
  • Dependency Inversion: orquestrador coordena dependências

DRY (Don't Repeat Yourself)

  • Constantes centralizadas
  • Componentes UI reutilizáveis
  • Utilitários compartilhados

Estrutura de Arquivos

src/
├── types/
│   └── index.ts              # Definições TypeScript
├── constants/
│   ├── fpr-rates.ts          # Taxas FPR por classe
│   ├── haircuts.ts           # Fatores de haircut
│   ├── ccf-factors.ts        # Fatores de conversão
│   └── scenarios.ts          # Cenários de teste
├── calculators/
│   ├── fpr-base.ts           # Calculadora FPR base (SRP)
│   ├── ead-calculator.ts     # Calculadora EAD (SRP)
│   ├── haircut-calculator.ts # Calculadora haircuts (SRP)
│   ├── adjustments.ts        # Ajustes (cambial, CRM, pisos)
│   └── index.ts              # Orquestrador principal
├── utils/
│   ├── formatters.ts         # Formatação reutilizável
│   └── validators.ts         # Validações
├── components/
│   └── ui/
│       └── index.tsx         # Componentes UI (DRY)
├── hooks/
│   └── useFPRCalculator.ts   # Hook customizado
└── App.tsx                    # Aplicação principal

Como Usar

Desenvolvimento

npm install
npm run dev

Uso Programático

import { calculateFPRComplete } from './calculators';
import { FPRInputs } from './types';

const inputs: FPRInputs = {
  produto: "emprestimo",
  contraparte: "corporate",
  // ... outros campos
};

const result = calculateFPRComplete(inputs);
// result.fpr: FPR final
// result.rwacpad: RWACPAD calculado
// result.steps: trilha de decisão

Cenários de Teste (30+)

A aplicação inclui cenários pré-configurados organizados por categoria:

Básicos:

  • PF transactor (cartão) → 45%
  • Corporate grande baixo risco → 65%
  • PME → 85%
  • IF categoria A ≤90d → 20%
  • Soberano BR → 0%

Novas Exposições:

  • Caixa → 0%
  • Ouro → 0%
  • Ações listadas → 250%
  • Ações não listadas → 400%

Inadimplência:

  • Provisão 15% → 150%
  • Provisão 30% → 100%
  • Provisão 60% → 50%

Entes Subnacionais / Estatais:

  • Estados, Municípios, DF, PSP, Estatais → FPR fixo 100% (sem diferenciação por rating)

Imobiliário:

  • Obra andamento contrato 2023 → 50%
  • Obra andamento contrato 2024+ → 150%
  • LTV 25% com descasamento cambial

Corporate:

  • PME receita R$ 250MM → 85%
  • PME receita R$ 400MM (inelegível) → 100%

Consignado:

  • Prazo 7 anos → 150%

Fundos:

  • Equity (mandato) → 400%
  • Renda Fixa (mandato) → 100%

E mais...

Regulamentação

  • Resolução BCB 229/2022: FPR e RWACPAD
  • Circular BCB 3.809/2016: CRM e haircuts
  • Resolução BCB 324/2023: Seguro de crédito
  • Resolução BCB 447/2024: Alterações diversas
  • Resolução BCB 452/2025: Ajuste negativo em PL
  • Basileia III: Padrões internacionais

Escopo e Limitações

✅ O que está implementado

Esta calculadora implementa completamente a abordagem padronizada (Standardised Approach) para cálculo de RWACPAD conforme Resolução BCB 229/2022, incluindo:

  • Todos os FPRs por classe de ativo/contraparte (Arts. 27-66)
  • Cálculo de EAD com CCF (Arts. 18-21)
  • CRM - Técnicas de mitigação (Arts. 22-26, Circular 3.809)
  • Ajustes (descasamento cambial, pisos)
  • Atualizações regulatórias 2024-2025

Cobertura: 95%+ dos casos práticos de risco de crédito em instituições financeiras brasileiras.

⚠️ Funcionalidades Avançadas Não Implementadas

As seguintes funcionalidades são especializadas e estão fora do escopo principal desta calculadora:

  • SA-CCR/CEM completo - Apenas FPR da contraparte é calculado para derivativos. O cálculo completo de EAD para derivativos (SA-CCR) requer modelagem de cenários, netting sets e colateral dinâmico (escopo avançado)

  • CVA (Credit Valuation Adjustment) - Res. BCB 291/2023 é um pilar separado de risco que requer modelos de pricing, volatilidades e correlações (fora do escopo de RWACPAD básico)

  • Securitização rating-based - Tratamento completo de tranches de securitização requer análise de estrutura, waterfall e subordinação (mercado nicho no Brasil)

  • Risco de liquidação - Tratamento específico para falhas em liquidação (escopo muito específico)

  • Abordagem IRB - Modelos internos (Internal Ratings-Based) com PD, LGD, EAD próprios requerem homologação do BCB (apenas grandes bancos)

Nota: Estas funcionalidades representam < 5% dos casos práticos e são normalmente calculadas por sistemas especializados de risk management em grandes instituições.

🚀 Próximos Passos (Melhorias)

  • 📝 Testes unitários automatizados
  • ✅ Validação com casos regulatórios (em andamento)
  • 📊 Exportação para Excel/PDF
  • 🌐 API REST
  • 🎨 Modo escuro

Contribuição

Ao contribuir:

  1. Mantenha princípios SOLID e DRY
  2. Adicione testes para novos recursos
  3. Atualize documentação
  4. Cite fonte regulatória

Licença

MIT

Aviso Legal

Esta calculadora é educacional. Para uso regulatório, consulte advogados e especialistas. Os valores podem divergir de interpretações oficiais do BCB.

About

Calculadora de FPR (Fator de Ponderação de Risco) - Res. BCB 229/2022. Calcula RWACPAD para risco de crédito com suporte completo a todas classes de ativos.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published