Create peril converter job

Creates a PERIL_CONVERTER job that converts the perils covered by the policies assigned to the specified list of accounts and portfolios.

A PERIL_CONVERTER job updates the location coverage applied to a list of exposures (account and portfolio resources) by converting the existing peril (as defined in the sourcePeril parameter) into another peril or list of perils (as defined in the targetPerils parameter). Both the original perils (sourcePeril) and updated perils (targetPerils) can be defined by peril and newCauseOfLoss values (for policies and step policies) or by causeOfLoss values alone (for HD step policies).

Peril conversion can optionally include sub-policy terms, endorsements, policy restrictions and sublimit restrictions.

This operation accepts four required parameters: the x-rms-resource-group-id header parameter and the resourceUris, resourceTypes, and settings body parameters.

The request must pass a valid resource group ID in the required x-rms-resource-group-id header parameter.

Policies and Non-HD Step Policies

If peril coverage is defined by a policy or step policy, the settings object must specifiy peril and newCauseOfLoss values.

Both the sourcePeril object and targetPerils objects identify perils by specifying two parameters: a peril value and a newCauseOfLoss value.

The resourceUris, resourceTypes, and settings body parameters are required:

{
  "resourceUris": [
    "/platform/riskdata/v1/exposures/{exposureId}/portfolios/2",
    "/platform/riskdata/v1/exposures/1002106/accounts/83"
  ],
  "resourceTypes": ["portfolios", "accounts"],
  "settings": {
    "sourcePeril": {
      "peril": 2,
      "newCauseOfLoss": 27
    },
    "targetPerils": [
      {
        "peril": 4,
        "newCauseOfLoss": 28
      }
    ],
    "countryCodesFilter": ["CA"],
    "includeSubPolicyConditions": true,
    "includePolicyReinsurance": true,
    "overwriteExistingCoverage": false,
    "createBackup": false
  }
}

Both the sourcePerils targetPerils are identified by both peril and newCauseOfLoss values. These value correspond to values stored in the EDM schema.

Peril Values

RMS_EDM.policy.POLICYTYPE:

New Cause of Loss Values

RMS_EDM.policy.NEWCAUSEOFLOSS

HD Step Policies

If peril coverage is defined by an HD step policy, the settings object is defined by CauseOfLoss value alone.

The resourceUris, resourceTypes, and settings body parameters are required:

{
  "resourceUris": [
    "/platform/riskdata/v1/exposures/{exposureId}/portfolios/2",
    "/platform/riskdata/v1/exposures/1002106/accounts/83"
  ],
  "resourceTypes": ["portfolios", "accounts"],
  "settings": {
    "sourcePeril": {
      "causeOfLoss": 27
    },
    "targetPerils": [
--i
      {
        "causeOfLoss": 28
      }
    ],
    "countryCodesFilter": ["CA"],
    "includeSubPolicyConditions": true,
    "includePolicyReinsurance": true,
    "overwriteExistingCoverage": false,
    "createBackup": false
  }
}

Cause Of Loss

RMS_EDM.policy.POLICYTYPE:

u

/platform/perilconverter/v1/jobs createperilconverterjob countryCodesFilter createBackup includePolicyReinsurance includeSubPolicyConditions newCauseOfLoss newCauseOfLoss overwriteExistingCoverage peril peril resourceTypes resourceUris settings sourcePeril targetPerils