Skip to content
HALOWERK

Finopswerk

fvoci debt impairment bridge

Reconciles one held-period debt FVOCI financial asset with measured ECL impairment, without deducting the allowance from the fair-value carrying amount. The caller supplies opening gross amortised-cost reference G, opening ECL A0, opening fair value F0, original periodic EIR r, end-period cash C, closing ECL A1 and closing fair value F1. Interest = G*r; G1 = G + interest - C; impairment expense = A1 - A0. The balance-sheet asset is F1, never F1 - A1.

POST https://finops.halowerk.com/v1/fvoci-debt-impairment-bridge

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
gross_nintegerYes
opening_ecl_nintegerYes
opening_fv_nintegerYes
rate_bpintegerYes
cash_nintegerYes
closing_ecl_nintegerYes
closing_fv_nintegerYes
amount_denominatorintegerYes
reportobjectYes
Show full input schema
{
  "type": "object",
  "required": [
    "gross_n",
    "opening_ecl_n",
    "opening_fv_n",
    "rate_bp",
    "cash_n",
    "closing_ecl_n",
    "closing_fv_n",
    "amount_denominator",
    "report"
  ],
  "properties": {
    "gross_n": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1000000
    },
    "opening_ecl_n": {
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000
    },
    "opening_fv_n": {
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000
    },
    "rate_bp": {
      "type": "integer",
      "minimum": 0,
      "maximum": 10000
    },
    "cash_n": {
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000
    },
    "closing_ecl_n": {
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000
    },
    "closing_fv_n": {
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000
    },
    "amount_denominator": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "report": {
      "type": "object",
      "minProperties": 24,
      "maxProperties": 24,
      "propertyNames": {
        "enum": [
          "opening_gross",
          "opening_ECL",
          "opening_FV",
          "period_rate",
          "cash_received",
          "interest_income",
          "closing_gross",
          "closing_ECL",
          "closing_FV",
          "impairment_expense",
          "PL",
          "opening_AC_net",
          "closing_AC_net",
          "opening_OCI_reserve",
          "closing_OCI_reserve",
          "OCI",
          "TCI",
          "asset_carrying",
          "allowance_asset_deduction",
          "allowance_OCI_change",
          "FV_change",
          "total_asset_plus_cash_change",
          "PL_AC_bridge",
          "OCI_balance_gap"
        ]
      },
      "additionalProperties": {
        "type": "object",
        "required": [
          "n",
          "d"
        ],
        "propertyNames": {
          "enum": [
            "n",
            "d"
          ]
        },
        "additionalProperties": {
          "type": [
            "string",
            "null"
          ],
          "minLength": 1,
          "maxLength": 64
        }
      }
    }
  },
  "additionalProperties": false
}

Open original schema

Published input example

{
  "gross_n": 100,
  "opening_ecl_n": 0,
  "opening_fv_n": 100,
  "rate_bp": 0,
  "cash_n": 0,
  "closing_ecl_n": 10,
  "closing_fv_n": 95,
  "amount_denominator": 1,
  "report": {
    "opening_gross": {
      "n": "100",
      "d": "1"
    },
    "opening_ECL": {
      "n": "0",
      "d": "1"
    },
    "opening_FV": {
      "n": "100",
      "d": "1"
    },
    "period_rate": {
      "n": "0",
      "d": "1"
    },
    "cash_received": {
      "n": "0",
      "d": "1"
    },
    "interest_income": {
      "n": "0",
      "d": "1"
    },
    "closing_gross": {
      "n": "100",
      "d": "1"
    },
    "closing_ECL": {
      "n": "10",
      "d": "1"
    },
    "closing_FV": {
      "n": "95",
      "d": "1"
    },
    "impairment_expense": {
      "n": "10",
      "d": "1"
    },
    "PL": {
      "n": "-10",
      "d": "1"
    },
    "opening_AC_net": {
      "n": "100",
      "d": "1"
    },
    "closing_AC_net": {
      "n": "90",
      "d": "1"
    },
    "opening_OCI_reserve": {
      "n": "0",
      "d": "1"
    },
    "closing_OCI_reserve": {
      "n": "5",
      "d": "1"
    },
    "OCI": {
      "n": "5",
      "d": "1"
    },
    "TCI": {
      "n": "-5",
      "d": "1"
    },
    "asset_carrying": {
      "n": "95",
      "d": "1"
    },
    "allowance_asset_deduction": {
      "n": "0",
      "d": "1"
    },
    "allowance_OCI_change": {
      "n": "10",
      "d": "1"
    },
    "FV_change": {
      "n": "-5",
      "d": "1"
    },
    "total_asset_plus_cash_change": {
      "n": "-5",
      "d": "1"
    },
    "PL_AC_bridge": {
      "n": "0",
      "d": "1"
    },
    "OCI_balance_gap": {
      "n": "0",
      "d": "1"
    }
  }
}

Result & documentation

Machine-readable documentation of this hub

Source of this page: the published HALOWERK catalog. Updated: 2026-11-17 UTC.

More endpoints in this hub

All endpoints in this hub โ†’