Provisions Specification¶
Provision treatment, expected loss calculation, and EL vs provisions comparison.
Regulatory Reference: CRR Articles 110, 111(2), 158-159
Test Group: CRR-G
Requirements Status¶
| ID | Requirement | Priority | Status |
|---|---|---|---|
| FR-2.7 | Provision resolution: drawn-first deduction for SA, EL shortfall/excess for IRB | P0 | Done |
| FR-2.8 | Portfolio-level EL summary with T2 credit cap (CRR Art. 62(d), Art. 159) | P1 | Done |
Pipeline Position¶
Provisions are resolved before CCF application in the pipeline:
This ordering complies with CRR Art. 111(2), which requires provisions to reduce the exposure value before credit conversion factors are applied to off-balance sheet items.
Multi-Level Beneficiary Resolution¶
Provisions can be allocated at different levels and are resolved in priority order:
| Level | Resolution | Description |
|---|---|---|
| Direct | loan / exposure / contingent |
Matched directly to a specific exposure |
| Facility | facility |
Distributed pro-rata across the facility's exposures by ead_gross |
| Counterparty | counterparty |
Distributed pro-rata across all counterparty exposures by ead_gross |
Direct allocations are applied first. Facility-level and counterparty-level provisions are distributed proportionally based on each exposure's share of the total ead_gross.
SA Approach (CRR Art. 110, 111(2))¶
Under the Standardised Approach, provisions use a drawn-first deduction approach:
# Step 1: Absorb provision against drawn amount first
provision_on_drawn = min(provision_allocated, max(0, drawn_amount))
# Step 2: Remainder reduces nominal before CCF (capped at nominal)
provision_on_nominal = min(provision_allocated - provision_on_drawn, nominal_amount)
nominal_after_provision = nominal_amount - provision_on_nominal
# Step 3: CCF applied to adjusted nominal
ead_from_ccf = nominal_after_provision × CCF
# Step 4: Final EAD (provisions already baked in)
EAD = (max(0, drawn) - provision_on_drawn) + interest + ead_from_ccf
The finalize_ead() step does not subtract provisions again — they are already reflected in ead_pre_crm via the drawn-first deduction.
New Columns (SA)¶
| Column | Type | Description |
|---|---|---|
provision_on_drawn |
Float64 |
Provision absorbed by drawn amount |
provision_on_nominal |
Float64 |
Provision reducing nominal before CCF |
nominal_after_provision |
Float64 |
nominal_amount - provision_on_nominal |
provision_deducted |
Float64 |
Total = provision_on_drawn + provision_on_nominal |
provision_allocated |
Float64 |
Total provision matched to this exposure |
IRB Approach (CRR Art. 158-159)¶
Under IRB, provisions are tracked (provision_allocated) but not deducted from EAD. The provision columns are set to zero:
Instead, the calculator computes Expected Loss for comparison:
EL vs Provisions Comparison¶
- EL > Provisions (shortfall): The difference is deducted 50/50 from CET1 and T2 capital (CRR Art. 159)
- EL < Provisions (excess): The surplus may be added to Tier 2 capital, capped at 0.6% of IRB RWA (CRR Art. 62(d))
Portfolio-Level Summary (ELPortfolioSummary)¶
The aggregator computes a portfolio-level ELPortfolioSummary with:
| Field | Formula | Regulatory Reference |
|---|---|---|
total_el_shortfall |
sum(el_shortfall) across all IRB exposures |
CRR Art. 159 |
total_el_excess |
sum(el_excess) across all IRB exposures |
CRR Art. 62(d) |
t2_credit_cap |
total_irb_rwa × 0.006 |
CRR Art. 62(d) |
t2_credit |
min(total_el_excess, t2_credit_cap) |
CRR Art. 62(d) |
cet1_deduction |
total_el_shortfall × 0.5 |
CRR Art. 159 |
t2_deduction |
total_el_shortfall × 0.5 |
CRR Art. 159 |
Slotting Approach¶
Same as IRB: provisions are tracked but not deducted from EAD.
Key Scenarios¶
| Scenario ID | Description |
|---|---|
| CRR-G | SA exposure with drawn-first provision deduction |
| CRR-G | SA off-balance sheet: provision reduces nominal before CCF |
| CRR-G | Multi-level beneficiary resolution (direct, facility, counterparty) |
| CRR-G | IRB expected loss calculation (provisions not deducted) |
| CRR-G | EL vs provisions: shortfall case |
| CRR-G | EL vs provisions: excess case |
Acceptance Tests¶
| Group | Scenarios | Tests | Pass Rate |
|---|---|---|---|
| CRR-G: Provisions | G1–G3 | 17 | 100% |
| B31-G: Provisions | G1–G3 | 24 | 100% |