Skip to content
HALOWERK

Finopswerk

defined benefit amendment ceiling bridge

Reconstructs one defined-benefit plan amendment with asset-ceiling interaction. Inputs: PV of earned benefits before/after the changed terms (D0/D1), unchanged plan asset fair value A, ceilings K0/K1 and opening book B, which must equal R0. Computes surpluses S0=A-D0 and S1=A-D1, blocked amounts C0=max(S0-K0,0) and C1=max(S1-K1,0), recognized net assets R0/R1, past-service cost PSC=D1-D0 measured first without the ceiling, and the ceiling effect change C1-C0.

POST https://finops.halowerk.com/v1/defined-benefit-amendment-ceiling-bridge

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
DBO_before_nintegerYes
DBO_after_nintegerYes
plan_assets_nintegerYes
ceiling_before_nintegerYes
ceiling_after_nintegerYes
book_net_asset_nintegerYes
amount_denominatorintegerYes
reportobjectYes
Show full input schema
{
  "type": "object",
  "required": [
    "DBO_before_n",
    "DBO_after_n",
    "plan_assets_n",
    "ceiling_before_n",
    "ceiling_after_n",
    "book_net_asset_n",
    "amount_denominator",
    "report"
  ],
  "properties": {
    "DBO_before_n": {
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000
    },
    "DBO_after_n": {
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000
    },
    "plan_assets_n": {
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000
    },
    "ceiling_before_n": {
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000
    },
    "ceiling_after_n": {
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000
    },
    "book_net_asset_n": {
      "type": "integer",
      "minimum": -1000000,
      "maximum": 1000000
    },
    "amount_denominator": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "report": {
      "type": "object",
      "minProperties": 19,
      "maxProperties": 19,
      "propertyNames": {
        "enum": [
          "DBO_before",
          "DBO_after",
          "plan_asset_FV",
          "surplus_before",
          "surplus_after",
          "ceiling_before",
          "ceiling_after",
          "blocked_before",
          "blocked_after",
          "recognized_before_net_asset",
          "recognized_after_net_asset",
          "past_service_PL_expense",
          "ceiling_OCI_expense",
          "total_comprehensive_expense",
          "recognized_net_asset_change",
          "PL_gain",
          "OCI_gain",
          "cash_flow",
          "asset_movement_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

{
  "DBO_before_n": 100,
  "DBO_after_n": 80,
  "plan_assets_n": 120,
  "ceiling_before_n": 5,
  "ceiling_after_n": 5,
  "book_net_asset_n": 5,
  "amount_denominator": 1,
  "report": {
    "DBO_before": {
      "n": "100",
      "d": "1"
    },
    "DBO_after": {
      "n": "80",
      "d": "1"
    },
    "plan_asset_FV": {
      "n": "120",
      "d": "1"
    },
    "surplus_before": {
      "n": "20",
      "d": "1"
    },
    "surplus_after": {
      "n": "40",
      "d": "1"
    },
    "ceiling_before": {
      "n": "5",
      "d": "1"
    },
    "ceiling_after": {
      "n": "5",
      "d": "1"
    },
    "blocked_before": {
      "n": "15",
      "d": "1"
    },
    "blocked_after": {
      "n": "35",
      "d": "1"
    },
    "recognized_before_net_asset": {
      "n": "5",
      "d": "1"
    },
    "recognized_after_net_asset": {
      "n": "5",
      "d": "1"
    },
    "past_service_PL_expense": {
      "n": "-20",
      "d": "1"
    },
    "ceiling_OCI_expense": {
      "n": "20",
      "d": "1"
    },
    "total_comprehensive_expense": {
      "n": "0",
      "d": "1"
    },
    "recognized_net_asset_change": {
      "n": "0",
      "d": "1"
    },
    "PL_gain": {
      "n": "20",
      "d": "1"
    },
    "OCI_gain": {
      "n": "-20",
      "d": "1"
    },
    "cash_flow": {
      "n": "0",
      "d": "1"
    },
    "asset_movement_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 โ†’