POLICY_TRUE_UP_QUOTING

This event is fired when performing a True-Up operation on an existing policy.
A True-Up is a recalculation or adjustment process that updates a policy premium, coverage, or limits based on new or corrected information about the insured entity.

When and what fires this event?

If this event is defined on a product, and it has actions that are enabled:

Copilot: fires when an underwriter or admin updates policy details that require re-rating;
API: can fire this event externally on demand.

Request payload

POST: https://api.{ENV}.dais.com/ioi/v3/event/fire

curl --location --request POST 'https://api.{ENV}.dais.com/ioi/v3/event/fire' \
--header 'Authorization: Basic <yourAuthHere>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "policyId": "<UUID of the policy>",
  "type": "POLICY_TRUE_UP_QUOTING",
  "payload": {
    "trueUpRequest": {
      "effectiveDate": "2024-07-01T00:00:00Z",
      "exposures": [
        {
          "type": "PAYROLL",
          "previousAmount": 150000,
          "updatedAmount": 165000
        },
        {
          "type": "SALES",
          "previousAmount": 500000,
          "updatedAmount": 520000
        }
      ],
      "requestedBy": "system@dais.com"
    }
  }
}'

{
  "policyId": "77a4fba1-402e-4ef3-9b10-8e59a69a6e40",
  "type": "POLICY_TRUE_UP_QUOTING",
  "payload": {
    "trueUpRequest": {
      "effectiveDate": "2024-07-01T00:00:00Z",
      "exposures": [
        {
          "type": "PAYROLL",
          "previousAmount": 150000,
          "updatedAmount": 165000
        },
        {
          "type": "SALES",
          "previousAmount": 500000,
          "updatedAmount": 520000
        }
      ],
      "requestedBy": "system@dais.com"
    }
  }
}

Request fields

Property	Required	Description
`policyId`	`true`	UUID of the policy being recalculated.
`type`	`true`	Must be set to `POLICY_TRUE_UP_QUOTING`.
`payload`	`true`	Contains the recalculation (True-Up) data.

Payload fields

Property	Required	Description
`trueUpRequest`	`true`	Object representing the True-Up request data.
`trueUpRequest.effectiveDate`	`false`	Date when the recalculated values take effect.
`trueUpRequest.exposures`	`false`	Array of exposure categories and their updated amounts.
`trueUpRequest.requestedBy`	`false`	Email or user identifier that initiated the True-Up process.

Response json

The response confirms that the True-Up recalculation was triggered and provides metadata on executed actions such as recalculated premiums or generated reports.

{
  "triggerRequestId": "a0c7b2f3-2d2d-48ac-8b44-8f37d0d08c13",
  "executedActionCount": 1,
  "expectedResponseCount": 1,
  "metadata": {
    "POLICY_TRUE_UP_QUOTING": {
      "status": "Recalculation completed",
      "premiumAdjustment": 120.45,
      "effectiveDate": "2024-07-01T00:00:00Z"
    }
  }
}

Response fields

Property	Required	Description
`triggerRequestId`	`true`	UUID that identifies the execution of the trigger.
`executedActionCount`	`true`	Number of workflow actions executed for this trigger.
`expectedResponseCount`	`true`	Number of responses expected from executed actions.
`metadata`	`true`	Contains dynamically generated data from payment setup actions.