Skip to content

POLICY_TRUE_UP_QUOTING

True-Up a policy.

Submit this event using Firing an Event. Product configuration and enabled actions determine the workflow behavior. Use identifiers and snapshots from the same environment.

Request payload#

HTTPPOST
POST https://api.{ENV}.dais.com/ioi/v3/event/fire
cURL
curl --location --request POST 'https://api.{ENV}.dais.com/ioi/v3/event/fire' \
--header 'Authorization: Basic <Base64-encoded API key and secret>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "lineId": "<UUID of the product ID>",
  "type": "POLICY_TRUE_UP_QUOTING",
  "payload": {
    "intakeMap": {},
    "billingCycleIntakeList": [
      {
        "startDate": "2026-11-01",
        "billingCycle": 1,
        "intake": {
          "<Employee count question ID>": {
            "type": "ANSWER",
            "qid": "<Employee count question ID>",
            "answer": "62"
          },
          "<Annual revenue question ID>": {
            "type": "ANSWER",
            "qid": "<Annual revenue question ID>",
            "answer": "1500000"
          }
        }
      }
    ],
    "eventMap": {},
    "policyDto": {
      "id": "<UUID of the policy ID>",
      "policyNumber": "<Policy number>",
      "issuingOrganizationId": "<UUID of the issuing organization ID>",
      "sellerOrganizationId": "<UUID of the seller organization ID>",
      "clientId": "<UUID of the client ID>",
      "quoteId": "<UUID of the quote request ID>",
      "productId": "<UUID of the product ID>",
      "actionId": "<UUID of the original rating action ID>",
      "premium": 4200.0,
      "effectiveDate": "2026-11-01",
      "expirationDate": "2027-11-01",
      "lastDayWithCoverage": "2027-10-31",
      "asRatingConfiguredAtTimestamp": "2026-10-01T00:00:00Z"
    },
    "requestSource": "TRUE_UP"
  }
}'
JSON
{
  "lineId": "<UUID of the product ID>",
  "type": "POLICY_TRUE_UP_QUOTING",
  "payload": {
    "intakeMap": {},
    "billingCycleIntakeList": [
      {
        "startDate": "2026-11-01",
        "billingCycle": 1,
        "intake": {
          "<Employee count question ID>": {
            "type": "ANSWER",
            "qid": "<Employee count question ID>",
            "answer": "62"
          },
          "<Annual revenue question ID>": {
            "type": "ANSWER",
            "qid": "<Annual revenue question ID>",
            "answer": "1500000"
          }
        }
      }
    ],
    "eventMap": {},
    "policyDto": {
      "id": "<UUID of the policy ID>",
      "policyNumber": "<Policy number>",
      "issuingOrganizationId": "<UUID of the issuing organization ID>",
      "sellerOrganizationId": "<UUID of the seller organization ID>",
      "clientId": "<UUID of the client ID>",
      "quoteId": "<UUID of the quote request ID>",
      "productId": "<UUID of the product ID>",
      "actionId": "<UUID of the original rating action ID>",
      "premium": 4200.0,
      "effectiveDate": "2026-11-01",
      "expirationDate": "2027-11-01",
      "lastDayWithCoverage": "2027-10-31",
      "asRatingConfiguredAtTimestamp": "2026-10-01T00:00:00Z"
    },
    "requestSource": "TRUE_UP"
  }
}

Request Fields#

See the shared event envelope. Set type to POLICY_TRUE_UP_QUOTING and provide the payload below.

Payload Fields#

PropertyRequiredDescription
intakeMapYesDeclared legacy map of UUIDs to question-answer maps. The built-in action reads billingCycleIntakeList instead; this example supplies an empty map.
eventMapYesDeclared legacy map of UUIDs to policy-event snapshots. The built-in action does not read this map; this example supplies an empty map.
policyDtoYesComplete stored policy snapshot, including actionId and the original rating version or timestamp context.
requestSourceYesSource of the request. Values: PRE_POLICY_QUOTING, PRE_ISSUANCE, ISSUANCE, ENDORSEMENT, CANCELLATION, RENEWAL, WORKFLOW, PACKAGE_RATER, TRUE_UP, TRUE_UP_SUMMARY.
billingCycleIntakeListYes for quotingNonempty list of billing cycles to quote. Each item supplies startDate (YYYY-MM-DD), integer billingCycle, and an intake answer map.

Use the stored policy's original actionId and rating context. When productVersionId is present, preserve its versionSystemSource; otherwise the action is resolved using asRatingConfiguredAtTimestamp or the policy's creation timestamp. An empty billingCycleIntakeList produces no billing-cycle quotes.

Response#

This example illustrates the common trigger response structure. Action counts and metadata depend on the actions that run; action-specific result fields are described where applicable.

JSON
{
  "triggerRequestId": "<UUID of the trigger request ID>",
  "executedActionCount": 0,
  "expectedResponseCount": 0,
  "metadata": {}
}

The built-in action returns its quote map under metadata.POLICY_TRUE_UP_QUOTING, keyed by billing-cycle start date. Each value uses the shared quote structure.

Response Fields#

PropertyDescription
triggerRequestIdUUID identifying this trigger execution.
executedActionCountNumber of actions reported as executed.
expectedResponseCountNumber of expected action responses.
metadataAction-specific results; may be empty.

See Firing an Event for execution modes and response handling.