Skip to content
HALOWERK

Finopswerk

ifrs17 mutualisation csm loss allocation

Applies a caller-qualified contract waterfall (not a universal IFRS allocation) for IFRS17 B67-B70 mutualisation between two recognized groups A/B sharing a specified pool. From each pool share r and minimum guarantee g: short = max(g-r,0), excess = max(r-g,0); transfer AtoB = min(excessA, shortB), BtoA = min(excessB, shortA). Remaining excess funds benefits to future policyholders up to supplied caps; the insurer pays the remaining shortfall.

POST https://finops.halowerk.com/v1/ifrs17-mutualisation-csm-loss-allocation

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
pool_shares_narrayYes
guarantee_floor_narrayYes
future_policyholder_caps_narrayYes
premium_today_narrayYes
other_PV_outflow_narrayYes
risk_adjustment_narrayYes
scenario_probability_narrayYes
probability_denominatorintegerYes
discount_factor_nintegerYes
discount_factor_dintegerYes
money_denominatorintegerYes
reportSee schemaYes
Show full input schema
{
  "type": "object",
  "properties": {
    "pool_shares_n": {
      "type": "array",
      "items": {
        "type": "array",
        "items": {
          "type": "integer",
          "minimum": 0,
          "maximum": 1000000
        },
        "minItems": 2,
        "maxItems": 2
      },
      "minItems": 2,
      "maxItems": 2
    },
    "guarantee_floor_n": {
      "type": "array",
      "items": {
        "type": "integer",
        "minimum": 0,
        "maximum": 1000000
      },
      "minItems": 2,
      "maxItems": 2
    },
    "future_policyholder_caps_n": {
      "type": "array",
      "items": {
        "type": "integer",
        "minimum": 0,
        "maximum": 1000000
      },
      "minItems": 2,
      "maxItems": 2
    },
    "premium_today_n": {
      "type": "array",
      "items": {
        "type": "integer",
        "minimum": 0,
        "maximum": 1000000
      },
      "minItems": 2,
      "maxItems": 2
    },
    "other_PV_outflow_n": {
      "type": "array",
      "items": {
        "type": "integer",
        "minimum": 0,
        "maximum": 1000000
      },
      "minItems": 2,
      "maxItems": 2
    },
    "risk_adjustment_n": {
      "type": "array",
      "items": {
        "type": "integer",
        "minimum": 0,
        "maximum": 1000000
      },
      "minItems": 2,
      "maxItems": 2
    },
    "scenario_probability_n": {
      "type": "array",
      "items": {
        "type": "integer",
        "minimum": 1,
        "maximum": 1000
      },
      "minItems": 2,
      "maxItems": 2
    },
    "probability_denominator": {
      "type": "integer",
      "minimum": 2,
      "maximum": 1000
    },
    "discount_factor_n": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "discount_factor_d": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "money_denominator": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "report": {
      "anyOf": [
        {
          "type": "null"
        },
        {
          "type": "object",
          "minProperties": 6,
          "maxProperties": 6,
          "propertyNames": {
            "enum": [
              "FCF_A",
              "CSM_A",
              "loss_A",
              "FCF_B",
              "CSM_B",
              "loss_B"
            ]
          },
          "additionalProperties": {
            "type": "object",
            "properties": {
              "n": {},
              "d": {}
            },
            "required": [
              "n",
              "d"
            ],
            "additionalProperties": false,
            "oneOf": [
              {
                "properties": {
                  "n": {
                    "type": "string",
                    "pattern": "^(0|-[1-9][0-9]*|[1-9][0-9]*)$",
                    "maxLength": 64
                  },
                  "d": {
                    "type": "string",
                    "pattern": "^[1-9][0-9]*$",
                    "maxLength": 64
                  }
                }
              },
              {
                "properties": {
                  "n": {
                    "type": "null"
                  },
                  "d": {
                    "type": "null"
                  }
                }
              }
            ]
          }
        }
      ]
    }
  },
  "required": [
    "pool_shares_n",
    "guarantee_floor_n",
    "future_policyholder_caps_n",
    "premium_today_n",
    "other_PV_outflow_n",
    "risk_adjustment_n",
    "scenario_probability_n",
    "probability_denominator",
    "discount_factor_n",
    "discount_factor_d",
    "money_denominator",
    "report"
  ],
  "additionalProperties": false
}

Open original schema

Published input example

{
  "pool_shares_n": [
    [
      350,
      0
    ],
    [
      250,
      0
    ]
  ],
  "guarantee_floor_n": [
    50,
    100
  ],
  "future_policyholder_caps_n": [
    0,
    0
  ],
  "premium_today_n": [
    330,
    5
  ],
  "other_PV_outflow_n": [
    0,
    0
  ],
  "risk_adjustment_n": [
    10,
    5
  ],
  "scenario_probability_n": [
    1,
    1
  ],
  "probability_denominator": 2,
  "discount_factor_n": 1,
  "discount_factor_d": 1,
  "money_denominator": 1,
  "report": {
    "FCF_A": {
      "n": "310",
      "d": "1"
    },
    "CSM_A": {
      "n": "20",
      "d": "1"
    },
    "loss_A": {
      "n": "0",
      "d": "1"
    },
    "FCF_B": {
      "n": "5",
      "d": "1"
    },
    "CSM_B": {
      "n": "0",
      "d": "1"
    },
    "loss_B": {
      "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 โ†’