Skip to content
HALOWERK

Finopswerk

defined benefit surplus asset ceiling bridge

Reconstructs one defined-benefit surplus plan with an externally qualified asset ceiling from opening/closing DBO, opening plan asset FV, current service cost, employer contributions, benefits, actual plan return, opening/closing economic-benefit PV caps and opening discount rate. Recognized asset = min(surplus, cap); blocked ceiling effect = surplus - recognized asset. Both surpluses must be >= 0. Returns 24 fractions, including interest and remeasurements.

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

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
actual_return_nintegerYes
rate_bpintegerYes
amount_denominatorintegerYes
reportobjectYes
Show full input schema
{
  "type": "object",
  "required": [
    "opening_obligation_n",
    "opening_assets_n",
    "closing_obligation_n",
    "service_cost_n",
    "contributions_n",
    "benefits_n",
    "opening_ceiling_n",
    "closing_ceiling_n",
    "actual_return_n",
    "rate_bp",
    "amount_denominator",
    "report"
  ],
  "properties": {
    "actual_return_n": {
      "type": "integer",
      "minimum": -1000000,
      "maximum": 1000000
    },
    "rate_bp": {
      "type": "integer",
      "minimum": 0,
      "maximum": 10000
    },
    "amount_denominator": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "report": {
      "type": "object",
      "minProperties": 24,
      "maxProperties": 24,
      "propertyNames": {
        "enum": [
          "opening_surplus",
          "closing_surplus",
          "opening_asset_ceiling",
          "closing_asset_ceiling",
          "opening_blocked_surplus",
          "closing_blocked_surplus",
          "opening_recognized_asset",
          "closing_recognized_asset",
          "obligation_interest",
          "plan_asset_interest",
          "gross_net_interest_expense",
          "ceiling_interest_expense",
          "recognized_net_interest_expense",
          "current_service_expense",
          "expected_obligation",
          "closing_plan_assets",
          "actuarial_loss",
          "asset_return_remeasurement_expense",
          "ceiling_total_change",
          "ceiling_remeasurement_expense",
          "total_PL_expense",
          "total_OCI_expense",
          "recognized_asset_change",
          "asset_movement_gap"
        ]
      },
      "additionalProperties": {
        "type": "object",
        "required": [
          "n",
          "d"
        ],
        "propertyNames": {
          "enum": [
            "n",
            "d"
          ]
        },
        "additionalProperties": {
          "type": [
            "string",
            "null"
          ],
          "minLength": 1,
          "maxLength": 64
        }
      }
    }
  },
  "additionalProperties": {
    "type": "integer",
    "minimum": 0,
    "maximum": 1000000
  },
  "propertyNames": {
    "enum": [
      "opening_obligation_n",
      "opening_assets_n",
      "closing_obligation_n",
      "service_cost_n",
      "contributions_n",
      "benefits_n",
      "opening_ceiling_n",
      "closing_ceiling_n",
      "actual_return_n",
      "rate_bp",
      "amount_denominator",
      "report"
    ]
  }
}

Open original schema

Published input example

{
  "opening_obligation_n": 100,
  "opening_assets_n": 120,
  "closing_obligation_n": 110,
  "service_cost_n": 0,
  "contributions_n": 0,
  "benefits_n": 0,
  "opening_ceiling_n": 5,
  "closing_ceiling_n": 5,
  "actual_return_n": 12,
  "rate_bp": 1000,
  "amount_denominator": 1,
  "report": {
    "opening_surplus": {
      "n": "20",
      "d": "1"
    },
    "closing_surplus": {
      "n": "22",
      "d": "1"
    },
    "opening_asset_ceiling": {
      "n": "5",
      "d": "1"
    },
    "closing_asset_ceiling": {
      "n": "5",
      "d": "1"
    },
    "opening_blocked_surplus": {
      "n": "15",
      "d": "1"
    },
    "closing_blocked_surplus": {
      "n": "17",
      "d": "1"
    },
    "opening_recognized_asset": {
      "n": "5",
      "d": "1"
    },
    "closing_recognized_asset": {
      "n": "5",
      "d": "1"
    },
    "obligation_interest": {
      "n": "10",
      "d": "1"
    },
    "plan_asset_interest": {
      "n": "12",
      "d": "1"
    },
    "gross_net_interest_expense": {
      "n": "-2",
      "d": "1"
    },
    "ceiling_interest_expense": {
      "n": "3",
      "d": "2"
    },
    "recognized_net_interest_expense": {
      "n": "-1",
      "d": "2"
    },
    "current_service_expense": {
      "n": "0",
      "d": "1"
    },
    "expected_obligation": {
      "n": "110",
      "d": "1"
    },
    "closing_plan_assets": {
      "n": "132",
      "d": "1"
    },
    "actuarial_loss": {
      "n": "0",
      "d": "1"
    },
    "asset_return_remeasurement_expense": {
      "n": "0",
      "d": "1"
    },
    "ceiling_total_change": {
      "n": "2",
      "d": "1"
    },
    "ceiling_remeasurement_expense": {
      "n": "1",
      "d": "2"
    },
    "total_PL_expense": {
      "n": "-1",
      "d": "2"
    },
    "total_OCI_expense": {
      "n": "1",
      "d": "2"
    },
    "recognized_asset_change": {
      "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 โ†’