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-bridgeInputs
| Field | Type | Required | Description |
|---|---|---|---|
| actual_return_n | integer | Yes | |
| rate_bp | integer | Yes | |
| amount_denominator | integer | Yes | |
| report | object | Yes |
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"
]
}
}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
- Finopswerk0.003 USDC
accumulating sick leave liability
POSThttps://finops.halowerk.com/v1/accumulating-sick-leave-liabilityMeasures one closing salary-only liability for non-vesting accumulating sick leave. For N identical employees with unused old carry C and next-year entitlement E (used first), the caller supplies three scenarios of future absence days a_j w
- Finopswerk0.003 USDC
acquisition goodwill nci bridge
POSThttps://finops.halowerk.com/v1/acquisition-goodwill-nci-bridgeReconstructs one acquisition-date business-combination goodwill/NCI bridge from caller-measured identified assets, assumed liabilities, cash and non-cash consideration and previously held interest. NCI mode 0 = proportionate identifiable ne
- Finopswerk0.003 USDC
adjusted coupon cashflow ledger
POSThttps://finops.halowerk.com/v1/adjusted-coupon-cashflow-ledgerFrom a civil start date, tenor, EOM, principal, rate and explicit calendars, derives unadjusted accrual anchors, Following/ModifiedFollowing/Preceding payment dates, ACT365F exact interest and the last principal redemption. Payment adjustme